Window styles are used to specify alternative behaviour and appearances for windows, when they are created. The symbols are defined in such as way that they can be combined in a 'bit-list' using the C++ bitwise-or operator. For example:
wxCAPTION | wxMINIMIZE_BOX | wxMINIMIZE_BOX | wxTHICK_FRAMEwxFrame styles
The following styles apply to wxFrame windows.
| wxICONIZE | Display the frame iconized (minimized) (Windows only). |
| wxCAPTION | Puts a caption on the frame (Windows and XView only). |
| wxDEFAULT_FRAME | Defined as wxMINIMIZE_BOX | wxMAXIMIZE_BOX | wxTHICK_FRAME | wxSYSTEM_MENU | wxCAPTION. |
| wxMDI_CHILD | Specifies a Windows MDI (multiple document interface) child frame. |
| wxMDI_PARENT | Specifies a Windows MDI (multiple document interface) parent frame. |
| wxMINIMIZE | Identical to wxICONIZE. |
| wxMINIMIZE_BOX | Displays a minimize box on the frame (Windows and Motif only). |
| wxMAXIMIZE | Displays the frame maximized (Windows only). |
| wxMAXIMIZE_BOX | Displays a maximize box on the frame (Windows and Motif only). |
| wxSDI | Specifies a normal SDI (single document interface) frame. |
| wxSTAY_ON_TOP | Stay on top of other windows (Windows only). |
| wxSYSTEM_MENU | Displays a system menu (Windows and Motif only). |
| wxTHICK_FRAME | Displays a thick frame around the window (Windows and Motif only). |
| wxRESIZE_BORDER | Displays a resizeable border around the window (Motif only). |
| wxTINY_CAPTION_HORIZ | Under Windows 3.1, displays a small horizontal caption if USE_ITSY_BITSY is set to 1 in wx_setup.h and the Microsoft ItsyBitsy library has been compiled. Use instead of wxCAPTION. |
| wxTINY_CAPTION_VERT | Under Windows 3.1, displays a small vertical caption if USE_ITSY_BITSY is set to 1 in wx_setup.h and the Microsoft ItsyBitsy library has been compiled. Use instead of wxCAPTION. |
The following styles apply to wxDialogBox windows.
| wxCAPTION | Puts a caption on the dialog box (Motif only). |
| wxDEFAULT_DIALOG_STYLE | Equivalent to wxCAPTION | wxSYSTEM_MENU | wxTHICK_FRAME |
| wxRESIZE_BORDER | Display a resizeable frame around the window (Motif only). |
| wxSYSTEM_MENU | Display a system menu (Motif only). |
| wxTHICK_FRAME | Display a thick frame around the window (Motif only). |
| wxUSER_COLOURS | Under Windows, overrides standard control processing to allow setting of the dialog box background colour. |
| wxVSCROLL | Give the dialog box a vertical scrollbar (XView only). |
The following styles apply to all wxItem derived windows.
| wxHORIZONTAL_LABEL | The item will be created with a horizontal label. |
| wxVERTICAL_LABEL | The item will be created with a vertical label. |
| wxFIXED_LENGTH | Allows the values of a column of items to be left-aligned. Create an item with this style, and pad out your labels with spaces to the same length. The item labels will initially created with a string of identical characters, positioning all the values at the same x-position. Then the real label is restored. |
There are no styles specific to wxButton.
The following styles apply to wxComboBox items.
| wxCB_SIMPLE | Creates a combobox with a permanently displayed list. |
| wxCB_DROPDOWN | Creates a combobox with a drop-down list. |
| wxCB_READONLY | Creates a combo box consisting of a drop-down list and static text item displaying the current selection. |
| wxCB_SORT | Sorts the entries in the list alphabetically (Windows only). |
The following styles apply to wxGauge items.
| wxGA_HORIZONTAL | The item will be created as a horizontal gauge. |
| wxGA_VERTICAL | The item will be created as a vertical gauge. |
| wxGA_PROGRESSBAR | Under Windows 95, the item will be created as a horizontal progress bar. |
There are no styles specific to wxGroupBox.
The following styles apply to wxListBox items.
| wxNEEDED_SB | Create scrollbars if needed. |
| wxLB_NEEDED_SB | Same as wxNEEDED_SB. |
| wxALWAYS_SB | Create scrollbars immediately. |
| wxLB_ALWAYS_SB | Same as wxALWAYS_LB. |
| wxLB_SINGLE | Single-selection list. |
| wxLB_MULTIPLE | Multiple-selection list. |
| wxLB_EXTENDED | Extended-selection list (Motif only). |
| wxHSCROLL | Create horizontal scrollbar if contents are too wide (Windows only). |
There are no styles specific to wxMessage.
The following styles apply to wxRadioBox items.
| wxVERTICAL | Lays the radiobox out in columns. |
| wxHORIZONTAL | Lays the radiobox out in rows. |
The following styles apply to wxRadioButton items.
| wxRB_GROUP | Specifies the start or end of a group of radio buttons under MS Windows. |
The following styles apply to wxSlider items.
| wxHORIZONTAL | The item will be created as a horizontal slider. |
| wxVERTICAL | The item will be created as a vertical slider. |
The following styles apply to wxText and wxMultiText items.
| wxTE_PROCESS_ENTER | The callback function will receive the event wxEVENT_TYPE_TEXT_ENTER_COMMAND. Note that this will break tab traversal for this panel item under Windows. Single-line text only. |
| wxTE_PASSWORD | The text will be echoed as asterisks. Single-line text only. |
| wxTE_READONLY | The text will not be user-editable. |
| wxHSCROLL | A horizontal scrollbar will be displayed. If wxHSCROLL is omitted, only a vertical scrollbar is displayed, and lines will be wrapped. This parameter is ignored under XView. Multi-line text only. |
The following styles apply to wxTextWindow objects.
| wxBORDER | Use this style to draw a thin border in Windows 3 (non-native implementation only). |
| wxNATIVE_IMPL | Use this style to allow editing under Windows 3.1, albeit with a 64K limitation. |
| wxREADONLY | Use this style to disable editing. |
| wxHSCROLL | Use this style to enable a horizontal scrollbar, or leave it out to allow line wrapping. Windows and Motif only. |
The following styles apply to wxPanel windows.
| wxBORDER | Draws a thin border around the panel. |
| wxUSER_COLOURS | Under Windows, overrides standard control processing to allow setting of the panel background colour. |
| wxVSCROLL | Gives the dialog box a vertical scrollbar (XView only). |
The following styles apply to wxCanvas windows.
| wxBORDER | Gives the canvas a thin border (Windows 3 and Motif only). |
| wxRETAINED | Gives the canvas a wxWindows-implemented backing store, making repainting much faster but at a potentially costly memory premium (XView and Motif only). |
The following styles apply to wxToolBar objects.
| wxTB_3DBUTTONS | Gives a 3D look to the buttons, but not to the same extent as wxButtonBar. |