The V C++ GUI Framework:Standard Values

Standard V Values

Predefined ItemVals

A useful collection of predefined values. Most are useful for defining dialogs, buttons, and menus.

Predefined ItemVals

A useful collection of predefined values. Most are useful for defining dialogs, buttons, and menus.

Synopsis

Header:

<v/v_defs.h>

Description

When defining dialogs, menus, and command bars, you are required to provide an id for each item. There are many common operations used in GUI designs, and V provides various predefined values for building your programs. The natural interpretation of most of these values should be obvious, and the descriptions are kept to a minimum. Most of the definitions describe the accepted practice for menu or button items with the given title. While these ItemVals can be used anywhere, some have ``standard'' usage.

Control Values

M_About Shows an informative message about current application.

M_All Select all.

M_Cancel Cancel. Usually used with a dialog. V will automatically reset dialog commands to their original state when a M_Cancel is selected from a vDialog descended object.

M_Clear Used to clear a screen.

M_Close Used to close a file. The user is usually prompted to save or ignore changes if any were made to the file. This is usually not used to close a menu.

M_Copy Copy the highlighted text or item, and save into the clipboard.

M_Cut Cut the highlighted text or item from the file, and usually save into the clipboard.

M_Delete Delete the selected item or text - usually does not copy into the clipboard.

M_Done Done with operation.

M_Edit Typically a menu bar button to pulldown an edit menu.

M_Exit Exit from the program - checking to see if files need to be saved, of course.

M_File Typically a menu bar button to pulldown a file menu.

M_Find Find a pattern.

M_FindAgain Find pattern again.

M_Font Typically a menu bar button to pulldown a font menu.

M_FontSelect Select a font. (This is different from the M_Font value in that M_Font is intended as a main menu bar item, while this one is for a pulldown menu.

M_Format Typically a menu bar button to pulldown a format menu, which allows the user to select formatting options.

M_Help Show help.

M_Insert Typically a menu bar button to pulldown an insert menu.

M_Line M_Line is one of a few of these values that gets special treatment by the system. It is required for defining line separators in menus.

M_New Used to create a new file.

M_No Answer No.

M_None Select none.

M_OK OK, accept operation or information. Causes return from dialog.

M_Open Used to open an existing file.

M_Options Typically a menu bar button to pulldown an options menu.

M_Paste Paste the contents of the clipboard into the insertion point of the current file or item.

M_Preferences Set preferences.

M_Print Print current file.

M_PrintPreview On screen preview how the current file would look if printed.

M_Replace Replace pattern.

M_Save Used to save current file in its current name.

M_SaveAs Save current file under new name.

M_Search Typically a menu bar button to pulldown a search menu.

M_SetDebug Set debug stuff.

M_Test Typically a menu bar button to pulldown a test menu.

M_Tools Typically a menu bar button to pulldown a tools menu.

M_UnDo Undo the last action.

M_View Typically a menu bar button to pulldown a view menu, which allows the user to select different views of the document.

M_Window Typically a menu bar button to pulldown a window menu, which lets the user select different windows.

M_Yes Answer Yes.

Version Values

A useful collection of predefined values to determine the version of V and the platform.

Synopsis

Vdefines several values useful for determining the revision of V, and the platform Vis compiled on.

Header:

<v/v_defs.h>

Version Values

V_VersMajor The major version of V, such as 1.

V_VersMinor The minor release of V, such as 12.

V_Version A text string describing the version of V, such as V 1.12 - 8/4/96.

V_VersionX Defined if the is the standard X version of V.

V_VersionMotif Defined if the Motif version of V.

V_VersionWindows Defined if the Windows version of V.

V_VersionWin95 Defined if the Windows 95 version of V.

V_VersionOS2 Defined for the OS2 version of V.