wxPropertyGrid Window Styles

SetWindowStyleFlag method can be used to modify some of these at run-time. More...

Defines

#define wxPG_ALPHABETIC_MODE   (wxPG_HIDE_CATEGORIES|wxPG_AUTO_SORT)
#define wxPG_AUTO_SORT   0x00000010
#define wxPG_BOLD_MODIFIED   0x00000040
#define wxPG_COMPACTOR   0x00004000
#define wxPG_DEFAULT_STYLE   (0)
#define wxPG_DESCRIPTION   0x00002000
#define wxPG_EX_AUTO_UNSPECIFIED_VALUES   0x00200000
#define wxPG_EX_GREY_LABEL_WHEN_DISABLED   0x00040000
#define wxPG_EX_HELP_AS_TOOLTIPS   0x00010000
#define wxPG_EX_INIT_NOCAT   0x00001000
#define wxPG_EX_MODE_BUTTONS   0x00008000
#define wxPG_EX_NATIVE_DOUBLE_BUFFERING   0x00080000
#define wxPG_EX_NO_FLAT_TOOLBAR   0x00002000
#define wxPG_EX_PROCESS_EVENTS_IMMEDIATELY   0x00100000
#define wxPG_HIDE_CATEGORIES   0x00000020
#define wxPG_HIDE_MARGIN   0x00000200
#define wxPG_LIMITED_EDITING   0x00000800
#define wxPG_SPLITTER_AUTO_CENTER   0x00000080
#define wxPG_STATIC_LAYOUT   (wxPG_HIDE_MARGIN|wxPG_STATIC_SPLITTER)
#define wxPG_STATIC_SPLITTER   0x00000400
#define wxPG_TOOLBAR   0x00001000
#define wxPG_TOOLTIPS   0x00000100
#define wxPGMAN_DEFAULT_STYLE   (0)
#define wxTAB_TRAVERSAL   0x00080000

Detailed Description

SetWindowStyleFlag method can be used to modify some of these at run-time.


Define Documentation

#define wxPG_AUTO_SORT   0x00000010
 

This will cause Sort() automatically after an item is added.

When inserting a lot of items in this mode, it may make sense to use Freeze() before operations and Thaw() afterwards to increase performance.

#define wxPG_BOLD_MODIFIED   0x00000040
 

Modified values are shown in bold font.

Changing this requires Refresh() to show changes.

#define wxPG_COMPACTOR   0x00004000
 

wxPropertyGridManager only: Show compactor button that toggles hidden state of low-priority properties.

#define wxPG_DEFAULT_STYLE   (0)
 

Combines various styles.

#define wxPG_DESCRIPTION   0x00002000
 

wxPropertyGridManager only: Show adjustable text box showing description or help text, if available, for currently selected property.

#define wxPG_EX_AUTO_UNSPECIFIED_VALUES   0x00200000
 

Set this style to let user have ability to set values of properties to unspecified state.

Currently, this applies to following properties:

  • wxIntProperty, wxUIntProperty, and wxFloatProperty: Clear the text field.

#define wxPG_EX_GREY_LABEL_WHEN_DISABLED   0x00040000
 

Set this style to have labels of disabled properties become greyed along with the values.

#define wxPG_EX_HELP_AS_TOOLTIPS   0x00010000
 

Show property help strings as tool tips instead as text on the status bar.

You can set the help strings using SetPropertyHelpString member function.

#define wxPG_EX_INIT_NOCAT   0x00001000
 

NOTE: wxPG_EX_xxx are extra window styles and must be set using SetExtraStyle() member function.

Speeds up switching to wxPG_HIDE_CATEGORIES mode. Initially, if wxPG_HIDE_CATEGORIES is not defined, the non-categorized data storage is not activated, and switching the mode first time becomes somewhat slower. wxPG_EX_INIT_NOCAT activates the non-categorized data storage right away. IMPORTANT NOTE: If you do plan not switching to non-categoric mode, or if you don't plan to use categories at all, then using this style will result in waste of resources.

#define wxPG_EX_MODE_BUTTONS   0x00008000
 

Shows alphabetic/categoric mode buttons from toolbar.

#define wxPG_EX_NATIVE_DOUBLE_BUFFERING   0x00080000
 

Allows relying on native double-buffering.

#define wxPG_EX_NO_FLAT_TOOLBAR   0x00002000
 

Extended window style that sets wxPropertyGridManager toolbar to not use flat style.

#define wxPG_EX_PROCESS_EVENTS_IMMEDIATELY   0x00100000
 

Process all events immediately, if possible.

That is, ProcessEvent is called instead of AddPendingEvent.

#define wxPG_HIDE_CATEGORIES   0x00000020
 

Categories are not initially shown (even if added).

IMPORTANT NOTE: If you do not plan to use categories, then this style will waste resources. This flag can also be changed using wxPropertyGrid::EnableCategories method.

#define wxPG_HIDE_MARGIN   0x00000200
 

Disables margin and hides all expand/collapse buttons that would appear outside the margin (for sub-properties).

Toggling this style automatically expands all collapsed items.

#define wxPG_LIMITED_EDITING   0x00000800
 

Disables wxTextCtrl based editors for properties which can be edited in another way.

Equals calling wxPropertyGrid::LimitPropertyEditing for all added properties.

#define wxPG_SPLITTER_AUTO_CENTER   0x00000080
 

When wxPropertyGrid is resized, splitter moves to the center.

This behaviour stops once the user manually moves the splitter.

#define wxPG_STATIC_LAYOUT   (wxPG_HIDE_MARGIN|wxPG_STATIC_SPLITTER)
 

Combination of other styles that make it impossible for user to modify the layout.

#define wxPG_STATIC_SPLITTER   0x00000400
 

This style prevents user from moving the splitter.

#define wxPG_TOOLBAR   0x00001000
 

wxPropertyGridManager only: Show toolbar for mode and page selection.

#define wxPG_TOOLTIPS   0x00000100
 

Display tooltips for cell text that cannot be shown completely.

If wxUSE_TOOLTIPS is 0, then this doesn't have any effect.

#define wxPGMAN_DEFAULT_STYLE   (0)
 

Combines various styles.

#define wxTAB_TRAVERSAL   0x00080000
 

wxTAB_TRAVERSAL allows using Tab/Shift-Tab to travel between properties in grid.

Travelling forwards from last property will navigate to the next control, and backwards from first will navigate to the previous one.


Generated on Mon Oct 29 16:56:25 2007 for wxPropertyGrid by doxygen 1.3.6