// Purpose: Classes-by-category page of the Doxygen manual
// Author: wxWidgets team
// RCS-ID: $Id: cat_classes.h 52468 2008-03-13 16:30:38Z FM $
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
@li @ref page_class_cat_managedwnd
@li @ref page_class_cat_menus
@li @ref page_class_cat_ctrl
+@li @ref page_class_cat_validator
@li @ref page_class_cat_pickers
@li @ref page_class_cat_aui
@li @ref page_class_cat_cmndlg
@li @ref page_class_cat_html
-@li @ref page_class_cat_richtext
-@li @ref page_class_cat_grid
@li @ref page_class_cat_miscwnd
</td><td>
@li @ref page_class_cat_dc
@li @ref page_class_cat_gc
@li @ref page_class_cat_image
@li @ref page_class_cat_events
-@li @ref page_class_cat_validator
@li @ref page_class_cat_appmanagement
@li @ref page_class_cat_printing
@li @ref page_class_cat_dvf
@li @ref page_class_cat_dnd
@li @ref page_class_cat_vfs
+@li @ref page_class_cat_threading
</td><td>
@li @ref page_class_cat_rtti
@li @ref page_class_cat_debugging
@li @ref page_class_cat_logging
-@li @ref page_class_cat_threading
@li @ref page_class_cat_data
@li @ref page_class_cat_conv
@li @ref page_class_cat_containers
@li @ref page_class_cat_file
@li @ref page_class_cat_streams
@li @ref page_class_cat_xml
-</td><td>
@li @ref page_class_cat_xrc
+</td><td>
@li @ref page_class_cat_net
@li @ref page_class_cat_archive
@li @ref page_class_cat_ipc
These are the classes relevant to sizer-based layout:
@li wxSizer: Abstract base class
+@li wxBoxSizer: A sizer for laying out windows in a row or column
@li wxGridSizer: A sizer for laying out windows in a grid with all fields
having the same size
@li wxFlexGridSizer: A sizer for laying out windows in a flexible grid
@li wxGridBagSizer: Another grid sizer that lets you specify the cell an item
is in, and items can span rows and/or columns.
-@li wxBoxSizer: A sizer for laying out windows in a row or column
@li wxStaticBoxSizer: Same as wxBoxSizer, but with a surrounding static box
@li wxWrapSizer: A sizer which wraps its child controls as size permits
@li wxAnimationCtrl: A control to display an animation
@li wxControl: The base class for controls
-@li wxButton: Push button control, displaying text
@li wxBitmapButton: Push button control, displaying a bitmap
@li wxBitmapComboBox: A combobox with bitmaps next to text items
@li wxBitmapToggleButton: A toggle button with bitmaps.
+@li wxButton: Push button control, displaying text
@li wxCalendarCtrl: Control showing an entire calendar month
@li wxCheckBox: Checkbox control
@li wxCheckListBox: A listbox with a checkbox to the left of each item
@li wxCollapsiblePane: A panel which can be shown/hidden by the user
@li wxComboBox: A choice with an editable area
@li wxComboCtrl: A combobox with application defined popup
-@li wxDataViewCtrl: A control to tabular or tree like data
-@li wxDataViewTreeCtrl: A specialized wxDataViewCtrl with wxTreeCtrl-like API
+@li wxDataViewCtrl: A control to display tabular or tree like data
+@li wxDataViewTreeCtrl: A specialized wxDataViewCtrl with a wxTreeCtrl-like API
+@li wxDataViewListCtrl: A specialized wxDataViewCtrl for displaying and editing simple tables.
@li wxEditableListBox: A listbox with editable items.
+@li wxFileCtrl: A control for selecting a file. Useful for custom file dialogs.
@li wxGauge: A control to represent a varying quantity, such as time remaining
@li wxGenericDirCtrl: A control for displaying a directory tree
+@li wxGrid: A control to display spread-sheet like data in tabular form
+@li wxHeaderCtrl: a small control to display the top header of tabular data
@li wxHtmlListBox: An abstract class for creating listboxes showing HTML
content
-@li wxSimpleHtmlListBox: A listbox showing HTML content
-@li wxStaticBox: A static, or group box for visually grouping related controls
+@li wxHyperlinkCtrl: A static text which opens an URL when clicked
@li wxListBox: A list of strings for single or multiple selection
@li wxListCtrl: A control for displaying lists of strings and/or icons, plus a
multicolumn report view
mode
@li wxNotebook: A notebook class
@li wxOwnerDrawnComboBox: A combobox with owner-drawn list items
+@li wxPropertyGrid: A complex control to display hierachical, editable information
+@li wxRadioBox: A group of radio buttons
+@li wxRadioButton: A round button to be used with others in a mutually
+ exclusive way
+@li wxRearrangeCtrl: A control allowing the user to rearrange a list of items.
@li wxRichTextCtrl: Generic rich text editing control
-@li wxTextCtrl: Single or multiline text editing control
-@li wxToggleButton: A button which stays pressed when clicked by user.
-@li wxTreeCtrl: Tree (hierarchy) control
+@li wxSimpleHtmlListBox: A listbox showing HTML content
+@li wxStaticBox: A static, or group box for visually grouping related controls
@li wxScrollBar: Scrollbar control
+@li wxSearchCtrl: A text input control used to initiate a search
@li wxSpinButton: A spin or `up-down' control
@li wxSpinCtrl: A spin control - i.e. spin button and text control displaying
an integer
@li wxSpinCtrlDouble: A spin control - i.e. spin button and text control displaying
a real number
@li wxStaticText: One or more lines of non-editable text
-@li wxHyperlinkCtrl: A static text which opens an URL when clicked
+@li wxTextCtrl: Single or multiline text editing control
+@li wxToggleButton: A button which stays pressed when clicked by user.
+@li wxTreeCtrl: Tree (hierarchy) control
@li wxStaticBitmap: A control to display a bitmap
-@li wxRadioBox: A group of radio buttons
-@li wxRadioButton: A round button to be used with others in a mutually
- exclusive way
@li wxStyledTextCtrl: A wxWidgets implementation of the Scintilla source code
editing component for plain text editing.
@li wxSlider: A slider that can be dragged by the user
+@section page_class_cat_validator Validators
+
+These are the window validators, used for filtering and validating user input.
+
+Related Overviews: @ref overview_validator
+
+@li wxValidator: Base validator class
+@li wxTextValidator: Text control validator class
+@li wxGenericValidator: Generic control validator class
+@li wxIntegerValidator: Text control validator class for integer numbers
+@li wxFloatingPointValidator: Text control validator class for floating point numbers
+
+
+
@section page_class_cat_pickers Picker Controls
A picker control is a control whose appearance and behaviour is highly
@li wxHVScrolledWindow: As ::wxScrolledWindow but supports scroll units of
variable sizes.
@li wxGrid: A grid (table) window
+@li wxInfoBar: An information bar usually shown on top of the main window.
@li wxSplitterWindow: Window which can be split vertically or horizontally
@li wxStatusBar: Implements the status bar on a frame
@li wxToolBar: Toolbar class
@li wxDirDialog: Directory selector dialog
@li wxFileDialog: File selector dialog
@li wxFindReplaceDialog: Text search/replace dialog
-@li wxMultiChoiceDialog: Dialog to get one or more selections from a list
-@li wxSingleChoiceDialog: Dialog to get a single selection from a list and
- return the string
-@li wxTextEntryDialog: Dialog to get a single line of text from the user
-@li wxPasswordEntryDialog: Dialog to get a password from the user
@li wxFontDialog: Font chooser dialog
+@li wxMessageDialog: Simple message box dialog
+@li wxMultiChoiceDialog: Dialog to get one or more selections from a list
@li wxPageSetupDialog: Standard page setup dialog
+@li wxPasswordEntryDialog: Dialog to get a password from the user
@li wxPrintDialog: Standard print dialog
@li wxProgressDialog: Progress indication dialog
-@li wxMessageDialog: Simple message box dialog
-@li wxSymbolPickerDialog: Symbol selector dialog
+@li wxRearrangeDialog: Dialog allowing the user to rearrange a list of items.
@li wxRichTextFormattingDialog: A dialog for formatting the content of a
wxRichTextCtrl
+@li wxRichMessageDialog: Nicer message box dialog
+@li wxSingleChoiceDialog: Dialog to get a single selection from a list and
+ return the string
+@li wxSymbolPickerDialog: Symbol selector dialog
+@li wxTextEntryDialog: Dialog to get a single line of text from the user
@li wxWizard: A wizard dialog.
@li wxHtmlWinTagHandler: HTML tag handler, pluginable into wxHtmlWinParser
-
-@section page_class_cat_richtext Rich Text
-
-wxWidgets provides a set of generic classes to edit and print simple rich text
-with character and paragraph formatting.
-
-@li wxTextAttr: Attributes specifying text styling.
-@li wxRichTextCtrl: A rich text control.
-@li wxRichTextBuffer: The content of a rich text control.
-@li wxRichTextCharacterStyleDefinition: Definition of character styling.
-@li wxRichTextParagraphStyleDefinition: Definition of paragraph styling.
-@li wxRichTextListStyleDefinition: Definition of list styling.
-@li wxRichTextStyleSheet: A set of style definitions.
-@li wxRichTextStyleComboCtrl: A drop-down control for applying styles.
-@li wxRichTextStyleListBox: A listbox for applying styles.
-@li wxRichTextStyleOrganiserDialog: A dialog that can be used for managing or
- browsing styles.
-@li wxRichTextEvent: A rich text event.
-@li wxRichTextRange: Specification for ranges in a rich text control or buffer.
-@li wxRichTextFileHandler: File handler base class.
-@li wxRichTextHTMLHandler: A handler for converting rich text to HTML.
-@li wxRichTextXMLHandler: A handler for loading and saving rich text XML.
-@li wxRichTextFormattingDialog: A dialog for rich text formatting.
-@li wxRichTextPrinting: A class for easy printing of rich text buffers.
-@li wxRichTextPrintout: A class used by wxRichTextPrinting.
-@li wxRichTextHeaderFooterData: Header and footer data specification.
-
-
-@section page_class_cat_grid Grid
-
-wxGrid represents a two-dimensional table of data. It supports custom
-attributes for the table cells, allowing to completely customize its
-appearance and uses a separate grid table (wxGridTableBase-derived) class for
-the data management meaning that it can be used to display arbitrary amounts of
-data.
-
-@li wxGrid: The main grid control class itself.
-@li wxGridTableBase: The base class for grid data provider.
-@li wxGridStringTable: Simple wxGridTableBase implementation supporting only
- string data items and storing them all in memory (hence suitable for not
- too large grids only).
-@li wxGridCellAttr: A cell attribute, allowing to customize its appearance as
- well as the renderer and editor used for displaying and editing it.
-@li wxGridCellAttrProvider: The object responsible for storing and retrieving
- the cell attributes.
-@li wxGridColLabelWindow: The window showing the grid columns labels.
-@li wxGridRowLabelWindow: The window showing the grid rows labels.
-@li wxGridCornerLabelWindow: The window used in the upper left grid corner.
-@li wxGridWindow: The window representing the main part of the grid.
-@li wxGridCellRenderer: Base class for objects used to display a cell value.
-@li wxGridCellStringRenderer: Renderer showing the cell as a text string.
-@li wxGridCellNumberRenderer: Renderer showing the cell as an integer number.
-@li wxGridCellFloatRenderer: Renderer showing the cell as a floating point
- number.
-@li wxGridCellBoolRenderer: Renderer showing the cell as checked or unchecked
- box.
-@li wxGridCellEditor: Base class for objects used to edit the cell value.
-@li wxGridCellStringEditor: Editor for cells containing text strings.
-@li wxGridCellNumberEditor: Editor for cells containing integer numbers.
-@li wxGridCellFloatEditor: Editor for cells containing floating point numbers.
-@li wxGridCellBoolEditor: Editor for boolean-valued cells.
-@li wxGridCellChoiceEditor: Editor allowing to choose one of the predefined
- strings (and possibly enter new one).
-@li wxGridEvent: The event sent by most of wxGrid actions.
-@li wxGridSizeEvent: The special event sent when a grid column or row is
- resized.
-@li wxGridRangeSelectEvent: The special event sent when a range of cells is
- selected in the grid.
-@li wxGridEditorCreatedEvent: The special event sent when a cell editor is
- created.
-@li wxGridSelection: The object efficiently representing the grid selection.
-@li wxGridTypeRegistry: Contains information about the data types supported by
- the grid.
-
@section page_class_cat_dc Device Contexts
Device contexts are surfaces that may be drawn on, and provide an abstraction
An event object contains information about a specific event. Event handlers
(usually member functions) have a single, event argument.
-Related Overviews: @ref overview_eventhandling
+Related Overviews: @ref overview_events
@li wxActivateEvent: A window or application activation event
@li wxCalendarEvent: Used with wxCalendarCtrl
@li wxIdleEvent: An idle event
@li wxInitDialogEvent: A dialog initialisation event
@li wxJoystickEvent: A joystick event
+@li wxKeyboardState: State of the keyboard modifiers.
@li wxListEvent: A list control event
@li wxMaximizeEvent: A maximize event
@li wxMenuEvent: A menu event
@li wxMouseCaptureChangedEvent: A mouse capture changed event
@li wxMouseCaptureLostEvent: A mouse capture lost event
@li wxMouseEvent: A mouse event
+@li wxMouseState: State of the mouse
@li wxMoveEvent: A move event
@li wxNavigationKeyEvent: An event set by navigation keys such as tab
@li wxNotebookEvent: A notebook control event
-@section page_class_cat_validator Validators
-
-These are the window validators, used for filtering and validating user input.
-
-Related Overviews: @ref overview_validator
-
-@li wxValidator: Base validator class
-@li wxTextValidator: Text control validator class
-@li wxGenericValidator: Generic control validator class
-
-
-
@section page_class_cat_appmanagement Application and Process Management
@li wxApp: Application class
+@section page_class_cat_threading Threading
+
+wxWidgets provides a set of classes to make use of the native thread
+capabilities of the various platforms.
+
+Related Overviews: @ref overview_thread
+
+@li wxThread: Thread class
+@li wxThreadHelper: Manages background threads easily
+@li wxMutex: Mutex class
+@li wxMutexLocker: Mutex locker utility class
+@li wxCriticalSection: Critical section class
+@li wxCriticalSectionLocker: Critical section locker utility class
+@li wxCondition: Condition class
+@li wxSemaphore: Semaphore class
+
+
+
@section page_class_cat_rtti Runtime Type Information (RTTI)
wxWidgets supports runtime manipulation of class information, and dynamic
wxWidgets provides several classes and functions for message logging.
-Related Overviews: @ref overview_log
+Related overview: @ref overview_log
@see @ref group_funcmacro_log "Logging Functions and Macros"
-@section page_class_cat_threading Threading
-
-wxWidgets provides a set of classes to make use of the native thread
-capabilities of the various platforms.
-
-Related Overviews: @ref overview_thread
-
-@li wxThread: Thread class
-@li wxThreadHelper: Manages background threads easily
-@li wxMutex: Mutex class
-@li wxMutexLocker: Mutex locker utility class
-@li wxCriticalSection: Critical section class
-@li wxCriticalSectionLocker: Critical section locker utility class
-@li wxCondition: Condition class
-@li wxSemaphore: Semaphore class
-
-
-
@section page_class_cat_data Data Structures
These are the data structure classes supported by wxWidgets.
+@li wxAny: A class for storing arbitrary types that may change at run-time
@li wxCmdLineParser: Command line parser class
@li wxDateSpan: A logical time interval.
@li wxDateTime: A class for date/time manipulations
wxWidgets has several small classes to work with disk files and directories.
-Related Overviews: @ref overview_file
+Related overview: @ref overview_file
@li wxFileName: Operations with the file name and attributes
@li wxDir: Class for enumerating files/subdirectories.
@li wxTextFile: Class for working with text files as with arrays of lines
@li wxStandardPaths: Paths for standard directories
@li wxPathList: A class to help search multiple paths
+@li wxFileSystemWatcher: Class providing notifications of file system changes
@section page_class_cat_streams Streams
-wxWidgets has its own set of stream classes, as an alternative to often buggy
-standard stream libraries, and to provide enhanced functionality.
+wxWidgets has its own set of stream classes as an alternative to the
+standard stream libraries and to provide enhanced functionality.
+
+Related overview: @ref overview_stream
@li wxStreamBase: Stream base class
@li wxStreamBuffer: Stream buffer class
Resources allow your application to create controls and other user interface
elements from specifications stored in an XML format.
-Related Overviews: @ref overview_xrc
+Related overview: @ref overview_xrc
@li wxXmlResource: The main class for working with resources
@li wxXmlResourceHandler: The base class for XML resource handlers
wxWidgets provides simple interprocess communications facilities based on
Windows DDE, but available on most platforms using TCP.
-Related Overviews: @ref overview_ipc
+Related overview: @ref overview_ipc
@li wxClient, wxDDEClient: Represents a client
@li wxConnection, wxDDEConnection: Represents the connection between a client