]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/doxygen/mainpages/cat_classes.h
Use API_VERSION_NUMBER for debug help API version check.
[wxWidgets.git] / docs / doxygen / mainpages / cat_classes.h
index 28f225d2dba31c66b92b0b98c7f5fdbed4ba99d5..5fed4d6a981d2de460bfe3c65fcc69fe8afe115e 100644 (file)
@@ -3,69 +3,18 @@
 // 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
 /////////////////////////////////////////////////////////////////////////////
 
 /**
 
 @page page_class_cat Summarized Class List by Category
 
+@tableofcontents
+
 This page contains a summarized listing of classes, please see the
 @ref group_class page for a full listing.
 
-@beginInvisibleTable
-<tr><td>
-@li @ref page_class_cat_basicwnd
-@li @ref page_class_cat_winlayout
-@li @ref page_class_cat_managedwnd
-@li @ref page_class_cat_menus
-@li @ref page_class_cat_ctrl
-@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
-@li @ref page_class_cat_propgrid
-</td><td>
-@li @ref page_class_cat_dc
-@li @ref page_class_cat_gdi
-@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
-</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_smartpointers
-@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
-@li @ref page_class_cat_net
-@li @ref page_class_cat_archive
-@li @ref page_class_cat_ipc
-@li @ref page_class_cat_help
-@li @ref page_class_cat_media
-@li @ref page_class_cat_gl
-@li @ref page_class_cat_misc
-</td></tr>
-@endTable
-
-
-<hr>
 
 
 @section page_class_cat_basicwnd Basic Windows
@@ -94,12 +43,12 @@ Related Overviews: @ref overview_sizer
 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
 
@@ -145,10 +94,10 @@ Controls that are not static can have wxValidator associated with them.
 
 @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
@@ -156,15 +105,18 @@ Controls that are not static can have wxValidator associated with them.
 @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
@@ -172,22 +124,27 @@ Controls that are not static can have wxValidator associated with them.
     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 wxTreeListCtrl: Multi-column tree control with simple interface
 @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
@@ -195,6 +152,20 @@ Controls that are not static can have wxValidator associated with them.
 
 
 
+@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
@@ -223,6 +194,8 @@ The following are a variety of classes that are derived from wxWindow.
 @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 wxRichToolTip: A customizable tooltip.
 @li wxSplitterWindow: Window which can be split vertically or horizontally
 @li wxStatusBar: Implements the status bar on a frame
 @li wxToolBar: Toolbar class
@@ -233,9 +206,11 @@ The following are a variety of classes that are derived from wxWindow.
 @li wxSashWindow: Window with four optional sashes that can be dragged
 @li wxSashLayoutWindow: Window that can be involved in an IDE-like layout
     arrangement
+@li wxSimplebook: Another book control but one allowing only the program, not
+    the user, to change its current page.
 @li wxWizardPage: A base class for the page in wizard dialog.
 @li wxWizardPageSimple: A page in wizard dialog.
-
+@li wxCustomBackgroundWindow: A window allowing to set a custom bitmap.
 
 
 @section page_class_cat_aui Window Docking (wxAUI)
@@ -267,19 +242,21 @@ Related Overviews: @ref overview_cmndlg
 @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.
 
 
@@ -299,86 +276,6 @@ classes include a help system based on the HTML widget.
 @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_propgrid Property Grid
-
-wxPropertyGrid is a property sheet control, which API consists of
-various classes listed here.
-
-
 @section page_class_cat_dc Device Contexts
 
 Device contexts are surfaces that may be drawn on, and provide an abstraction
@@ -469,7 +366,7 @@ Related Overviews: @ref overview_bitmap
 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
@@ -492,12 +389,14 @@ Related Overviews: @ref overview_eventhandling
 @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
@@ -524,18 +423,6 @@ Related Overviews: @ref overview_eventhandling
 
 
 
-@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
@@ -619,6 +506,24 @@ system, used internally by the HTML classes.
 
 
 
+@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
@@ -657,7 +562,7 @@ Related Overviews: @ref overview_debugging
 
 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"
 
@@ -675,28 +580,11 @@ Related Overviews: @ref overview_log
 
 
 
-@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
@@ -723,13 +611,13 @@ These are the data structure classes supported by wxWidgets.
 These classes define objects for performing conversions between different
 multibyte and Unicode encodings and wide character strings.
 
-@li wxMBConv: Base class for all convertors, defines the API implemented by all
-    the other convertor classes.
-@li wxMBConvUTF7: Convertor for UTF-7
-@li wxMBConvUTF8: Convertor for UTF-8
-@li wxMBConvUTF16: Convertor for UTF-16
-@li wxMBConvUTF32: Convertor for UTF-32
-@li wxCSConv: Convertor for any system-supported encoding which can be
+@li wxMBConv: Base class for all converters, defines the API implemented by all
+    the other converter classes.
+@li wxMBConvUTF7: Converter for UTF-7
+@li wxMBConvUTF8: Converter for UTF-8
+@li wxMBConvUTF16: Converter for UTF-16
+@li wxMBConvUTF32: Converter for UTF-32
+@li wxCSConv: Converter for any system-supported encoding which can be
     specified by name.
 
 Related Overviews: @ref overview_mbconv
@@ -767,7 +655,7 @@ wxWidgets provides a few smart pointer class templates.
 
 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.
@@ -779,13 +667,16 @@ Related Overviews: @ref overview_file
 @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
@@ -842,7 +733,7 @@ standard stream libraries, and to provide enhanced functionality.
 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
@@ -872,7 +763,7 @@ wxWidgets provides its own classes for socket based networking.
 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