X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c83e60aab58ed216f32f557c88533abb3ed1df61..fbfe2d4e7caa118e1b609151bc72e7e5c7ac0f32:/docs/doxygen/mainpages/cat_classes.h diff --git a/docs/doxygen/mainpages/cat_classes.h b/docs/doxygen/mainpages/cat_classes.h index ef23e000f4..28f225d2db 100644 --- a/docs/doxygen/mainpages/cat_classes.h +++ b/docs/doxygen/mainpages/cat_classes.h @@ -2,51 +2,61 @@ // Name: cat_classes.h // Purpose: Classes-by-category page of the Doxygen manual // Author: wxWidgets team -// RCS-ID: $Id$ +// RCS-ID: $Id: cat_classes.h 52468 2008-03-13 16:30:38Z FM $ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// /** -@page page_class_cat Classes by Category +@page page_class_cat Summarized Class List by Category + +This page contains a summarized listing of classes, please see the +@ref group_class page for a full listing. @beginInvisibleTable +@li @ref page_class_cat_basicwnd +@li @ref page_class_cat_winlayout @li @ref page_class_cat_managedwnd -@li @ref page_class_cat_miscwnd +@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_winlayout @li @ref page_class_cat_cmndlg -@li @ref page_class_cat_ctrl -@li @ref page_class_cat_miscpickers -@li @ref page_class_cat_menus +@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 + @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_data - -@li @ref page_class_cat_containers -@li @ref page_class_cat_smartpointers -@li @ref page_class_cat_logging -@li @ref page_class_cat_debugging -@li @ref page_class_cat_net -@li @ref page_class_cat_ipc -@li @ref page_class_cat_dvf +@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_file @li @ref page_class_cat_vfs -@li @ref page_class_cat_streams -@li @ref page_class_cat_threading @li @ref page_class_cat_rtti -@li @ref page_class_cat_appmanagement -@li @ref page_class_cat_html -@li @ref page_class_cat_richtext -@li @ref page_class_cat_stc +@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 + @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 @@ -58,65 +68,16 @@
-@section page_class_cat_managedwnd Managed Windows - -There are several types of window that are directly controlled by the window -manager (such as MS Windows, or the Motif Window Manager). Frames and dialogs -are similar in wxWidgets, but only dialogs may be modal. +@section page_class_cat_basicwnd Basic Windows -Related Overviews: @ref overview_cmndlg +The following are the most important window classes +@li wxWindow: base class for all windows and controls +@li wxControl: base class (mostly) for native controls/widgets +@li wxPanel: window which can smartly manage child windows +@li ::wxScrolledWindow: Window with automatically managed scrollbars (see + wxScrolled) @li wxTopLevelWindow: Any top level window, dialog or frame -@li wxDialog: Dialog box -@li wxFrame: Normal frame -@li wxMDIChildFrame: MDI child frame -@li wxMDIParentFrame: MDI parent frame -@li wxMiniFrame: A frame with a small title bar -@li wxPropertySheetDialog: Property sheet dialog -@li wxSplashScreen: Splash screen class -@li wxTipWindow: Shows text in a small window -@li wxWizard: A wizard dialog - - - -@section page_class_cat_miscwnd Miscellaneous Windows - -The following are a variety of classes that are derived from wxWindow. - -@li wxPanel: A window whose colour changes according to current user settings -@li wxScrolledWindow: Window with automatically managed scrollbars -@li wxGrid: A grid (table) 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 wxNotebook: Notebook class -@li wxListbook: Similar to notebook but using list control -@li wxChoicebook: Similar to notebook but using choice control -@li wxTreebook: Similar to notebook but using tree control -@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 wxVScrolledWindow: As wxScrolledWindow but supports lines of variable - height -@li wxWizardPage: A base class for the page in wizard dialog. -@li wxWizardPageSimple: A page in wizard dialog. - - - -@section page_class_cat_aui Window Docking (wxAUI) - -wxAUI is a set classes for writing a customizable application interface -with built-in docking, floatable panes and a flexible MDI-like interface. - -Related Overviews: @ref overview_aui - -@li wxAuiManager: The central class for managing the interface -@li wxAuiNotebook: A replacement notebook class with extra features -@li wxAuiPaneInfo: Describes a single pane -@li wxAuiDockArt: Art and metrics provider for customizing the docking user - interface -@li wxAuiTabArt: Art and metrics provider for customizing the notebook user - interface @@ -128,7 +89,7 @@ thinking and calculating and will in almost all cases produce dialogs looking equally well on all platforms, the other is based on so-called constraints and is deprecated, though still available. -Related Overviews: @ref overview_sizer, @ref overview_constraints +Related Overviews: @ref overview_sizer These are the classes relevant to sizer-based layout: @@ -142,43 +103,38 @@ These are the classes relevant to sizer-based layout: @li wxStaticBoxSizer: Same as wxBoxSizer, but with a surrounding static box @li wxWrapSizer: A sizer which wraps its child controls as size permits -These are the classes relevant to constraints-based window layout: - -@li wxIndividualLayoutConstraint: Represents a single constraint dimension -@li wxLayoutConstraints: Represents the constraints for a window class - Other layout classes: @li wxLayoutAlgorithm: An alternative window layout facility -@section page_class_cat_cmndlg Common Dialogs +@section page_class_cat_managedwnd Managed Windows -Common dialogs are ready-made dialog classes which are frequently used in an -application. +There are several types of window that are directly controlled by the window +manager (such as MS Windows, or the Motif Window Manager). Frames and dialogs +are similar in wxWidgets, but only dialogs may be modal. Related Overviews: @ref overview_cmndlg -@li wxDialog: Base class for common dialogs -@li wxColourDialog: Colour chooser dialog -@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 wxPageSetupDialog: Standard page setup dialog -@li wxPrintDialog: Standard print dialog -@li wxProgressDialog: Progress indication dialog -@li wxMessageDialog: Simple message box dialog -@li wxSymbolPickerDialog: Symbol selector dialog -@li wxRichTextFormattingDialog: A dialog for formatting the content of a - wxRichTextCtrl -@li wxWizard: A wizard dialog. +@li wxDialog: Dialog box +@li wxFrame: Normal frame +@li wxMDIChildFrame: MDI child frame +@li wxMDIParentFrame: MDI parent frame +@li wxMiniFrame: A frame with a small title bar +@li wxPopupWindow: A toplevel window without decorations, e.g. for a combobox pop-up +@li wxPropertySheetDialog: Property sheet dialog +@li wxSplashScreen: Splash screen class +@li wxTipWindow: Shows text in a small window +@li wxWizard: A wizard dialog + + + +@section page_class_cat_menus Menus + +@li wxMenu: Displays a series of menu items for selection +@li wxMenuBar: Contains a series of menus for use with a frame +@li wxMenuItem: Represents a single menu item @@ -192,7 +148,6 @@ Controls that are not static can have wxValidator associated with them. @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 wxToggleButton: A button which stays pressed when clicked by user. @li wxBitmapToggleButton: A toggle button with bitmaps. @li wxCalendarCtrl: Control showing an entire calendar month @li wxCheckBox: Checkbox control @@ -203,6 +158,7 @@ Controls that are not static can have wxValidator associated with them. @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 wxEditableListBox: A listbox with editable items. @li wxGauge: A control to represent a varying quantity, such as time remaining @li wxGenericDirCtrl: A control for displaying a directory tree @li wxHtmlListBox: An abstract class for creating listboxes showing HTML @@ -214,25 +170,32 @@ Controls that are not static can have wxValidator associated with them. multicolumn report view @li wxListView: A simpler interface (façade) for wxListCtrl in report mode +@li wxNotebook: A notebook class @li wxOwnerDrawnComboBox: A combobox with owner-drawn list 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 wxScrollBar: Scrollbar control @li wxSpinButton: A spin or `up-down' control -@li wxSpinCtrl: A spin control - i.e. spin button and text 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 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 @li wxVListBox: A listbox supporting variable height rows -@section page_class_cat_miscpickers Picker Controls +@section page_class_cat_pickers Picker Controls A picker control is a control whose appearance and behaviour is highly platform-dependent. @@ -245,12 +208,175 @@ platform-dependent. -@section page_class_cat_menus Menus +@section page_class_cat_miscwnd Miscellaneous Windows + +The following are a variety of classes that are derived from wxWindow. + +@li wxCollapsiblePane: A panel which can be shown/hidden by the user +@li wxPanel: A window whose colour changes according to current user settings +@li ::wxScrolledWindow: Window with automatically managed scrollbars (see + wxScrolled) +@li wxHScrolledWindow: As ::wxScrolledWindow but supports columns of variable + widths +@li wxVScrolledWindow: As ::wxScrolledWindow but supports rows of variable + heights +@li wxHVScrolledWindow: As ::wxScrolledWindow but supports scroll units of + variable sizes. +@li wxGrid: A grid (table) 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 wxNotebook: Notebook class +@li wxListbook: Similar to notebook but using list control +@li wxChoicebook: Similar to notebook but using choice control +@li wxTreebook: Similar to notebook but using tree control +@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 wxWizardPage: A base class for the page in wizard dialog. +@li wxWizardPageSimple: A page in wizard dialog. + + + +@section page_class_cat_aui Window Docking (wxAUI) + +wxAUI is a set classes for writing a customizable application interface +with built-in docking, floatable panes and a flexible MDI-like interface. + +Related Overviews: @ref overview_aui + +@li wxAuiManager: The central class for managing the interface +@li wxAuiNotebook: A replacement notebook class with extra features +@li wxAuiPaneInfo: Describes a single pane +@li wxAuiDockArt: Art and metrics provider for customizing the docking user + interface +@li wxAuiTabArt: Art and metrics provider for customizing the notebook user + interface + + + +@section page_class_cat_cmndlg Common Dialogs + +Common dialogs are ready-made dialog classes which are frequently used in an +application. + +Related Overviews: @ref overview_cmndlg + +@li wxDialog: Base class for common dialogs +@li wxColourDialog: Colour chooser dialog +@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 wxPageSetupDialog: Standard page setup dialog +@li wxPrintDialog: Standard print dialog +@li wxProgressDialog: Progress indication dialog +@li wxMessageDialog: Simple message box dialog +@li wxSymbolPickerDialog: Symbol selector dialog +@li wxRichTextFormattingDialog: A dialog for formatting the content of a + wxRichTextCtrl +@li wxWizard: A wizard dialog. + + + +@section page_class_cat_html HTML + +wxWidgets provides a set of classes to display text in HTML format. These +classes include a help system based on the HTML widget. + +@li wxHtmlHelpController: HTML help controller class +@li wxHtmlWindow: HTML window class +@li wxHtmlEasyPrinting: Simple class for printing HTML +@li wxHtmlPrintout: Generic HTML wxPrintout class +@li wxHtmlParser: Generic HTML parser class +@li wxHtmlTagHandler: HTML tag handler, pluginable into wxHtmlParser +@li wxHtmlWinParser: HTML parser class for wxHtmlWindow +@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. -@li wxMenu: Displays a series of menu items for selection -@li wxMenuBar: Contains a series of menus for use with a frame -@li wxMenuItem: Represents a single menu item +@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 @@ -281,36 +407,63 @@ Related Overviews: @ref overview_dc -@section page_class_cat_gdi Graphics Device Interface +@section page_class_cat_gc Graphics Context classes -These classes are related to drawing on device contexts and windows. +These classes are related to drawing using a new vector based drawing API and +are based on the modern drawing backend GDI+, CoreGraphics and Cairo. -Related Overviews: @ref overview_bitmap +@li wxGraphicsRenderer: Represents a drawing engine. +@li wxGraphicsContext: Represents a graphics context currently being drawn on. +@li wxGraphicsBrush: Brush for drawing into a wxGraphicsContext +@li wxGraphicsPen: Pen for drawing into a wxGraphicsContext +@li wxGraphicsFont: Font for drawing text on a wxGraphicsContext +@li wxGraphicsMatrix: Represents an affine matrix for drawing transformation +@li wxGraphicsPath: Represents a path for drawing + + + +@section page_class_cat_gdi Graphics Device Interface + +These classes are related to drawing on device contexts and windows. @li wxColour: Represents the red, blue and green elements of a colour @li wxDCClipper: Wraps the operations of setting and destroying the clipping region -@li wxBitmap: Represents a bitmap @li wxBrush: Used for filling areas on a device context @li wxBrushList: The list of previously-created brushes -@li wxCursor: A small, transparent bitmap representing the cursor @li wxFont: Represents fonts @li wxFontList: The list of previously-created fonts -@li wxIcon: A small, transparent bitmap for assigning to frames and drawing on - device contexts -@li wxImage: A platform-independent image class -@li wxImageList: A list of images, used with some controls -@li wxMask: Represents a mask to be used with a bitmap for transparent drawing @li wxPen: Used for drawing lines on a device context @li wxPenList: The list of previously-created pens @li wxPalette: Represents a table of indices into RGB values @li wxRegion: Represents a simple or complex region on a window or device context -@li wxAnimation: Represents an animation @li wxRendererNative: Abstracts high-level drawing primitives +@section page_class_cat_image Image and bitmap classes + +These classes represent images and bitmap in various formats and ways +to access and create them. + +Related Overviews: @ref overview_bitmap + +@li wxAnimation: Represents an animation +@li wxBitmap: Represents a platform dependent bitmap +@li wxBitmapHandler: Class for loading a saving a wxBitmap in a specific format +@li wxCursor: A small, transparent bitmap representing the cursor +@li wxIcon: A small, transparent bitmap for assigning to frames and drawing on + device contexts +@li wxImage: A platform-independent image class +@li wxImageHandler: Class for loading a saving a wxImage in a specific format +@li wxImageList: A list of images, used with some controls +@li wxMask: Represents a mask to be used with a bitmap for transparent drawing +@li wxMemoryDC: A device context for drawing into bitmaps +@li wxPixelData: Class template for direct access to wxBitmap's and wxImage's internal data + + + @section page_class_cat_events Events An event object contains information about a specific event. Event handlers @@ -383,77 +536,100 @@ Related Overviews: @ref overview_validator -@section page_class_cat_data Data Structures - -These are the data structure classes supported by wxWidgets. +@section page_class_cat_appmanagement Application and Process Management +@li wxApp: Application class @li wxCmdLineParser: Command line parser class -@li wxDateSpan: A logical time interval. -@li wxDateTime: A class for date/time manipulations -@li wxLongLong: A portable 64 bit integer type -@li wxObject: The root class for most wxWidgets classes -@li wxPathList: A class to help search multiple paths -@li wxPoint: Representation of a point -@li wxRect: A class representing a rectangle -@li wxRegEx: Regular expression support -@li wxRegion: A class representing a region -@li wxString: A string class -@li wxStringTokenizer: A class for interpreting a string as a list of tokens or - words -@li wxRealPoint: Representation of a point using floating point numbers -@li wxSize: Representation of a size -@li wxTimeSpan: A time interval. -@li wxURI: Represents a Uniform Resource Identifier -@li wxVariant: A class for storing arbitrary types that may change at run-time +@li wxDynamicLibrary: Class to work with shared libraries. +@li wxProcess: Process class -@section page_class_cat_containers Containers +@section page_class_cat_printing Printing Framework -These are classes, templates and class macros are used by wxWidgets. Most of -these classes provide a subset or almost complete STL API. +A printing and previewing framework is implemented to make it relatively +straightforward to provide document printing facilities. -Related Overviews: @ref overview_container +Related Overviews: @ref overview_printing -@li wxArray: A type-safe dynamic array implementation (macro based) -@li wxArrayString: An efficient container for storing wxString objects -@li wxHashMap: A type-safe hash map implementation (macro based) -@li wxHashSet: A type-safe hash set implementation(macro based) -@li wxHashTable: A simple hash table implementation (deprecated, use wxHashMap) -@li wxList: A type-safe linked list implementation (macro based) -@li wxVector: Template base vector implementation identical to std::vector +@li wxPreviewFrame: Frame for displaying a print preview +@li wxPreviewCanvas: Canvas for displaying a print preview +@li wxPreviewControlBar: Standard control bar for a print preview +@li wxPrintDialog: Standard print dialog +@li wxPageSetupDialog: Standard page setup dialog +@li wxPrinter: Class representing the printer +@li wxPrinterDC: Printer device context +@li wxPrintout: Class representing a particular printout +@li wxPrintPreview: Class representing a print preview +@li wxPrintData: Represents information about the document being printed +@li wxPrintDialogData: Represents information about the print dialog +@li wxPageSetupDialogData: Represents information about the page setup dialog -@section page_class_cat_smartpointers Smart Pointers +@section page_class_cat_dvf Document/View Framework -wxWidgets provides a few smart pointer class templates. +wxWidgets supports a document/view framework which provides housekeeping for a +document-centric application. -@li wxObjectDataPtr: A shared pointer (using intrusive reference counting) -@li wxScopedPtr: A scoped pointer -@li wxSharedPtr: A shared pointer (using non-intrusive reference counting) -@li wxWeakRef: A weak reference +Related Overviews: @ref overview_docview +@li wxCommand: Base class for undo/redo actions +@li wxCommandProcessor: Maintains the undo/redo stack +@li wxDocument: Represents a document +@li wxView: Represents a view +@li wxDocTemplate: Manages the relationship between a document class and a + view class +@li wxDocManager: Manages the documents and views in an application +@li wxDocChildFrame: A child frame for showing a document view +@li wxDocParentFrame: A parent frame to contain views +@li wxDocMDIChildFrame: An MDI child frame for showing a document view +@li wxDocMDIParentFrame: An MDI parent frame to contain views +@li wxFileHistory: Maintains a list of the most recently visited files -@section page_class_cat_logging Logging -wxWidgets provides several classes and functions for message logging. +@section page_class_cat_dnd Clipboard and Drag & Drop -Related Overviews: @ref overview_log +Related Overviews: @ref overview_dnd + +@li wxDataObject: Data object class +@li wxDataFormat: Represents a data format +@li wxTextDataObject: Text data object class +@li wxFileDataObject: File data object class +@li wxBitmapDataObject: Bitmap data object class +@li wxURLDataObject: URL data object class +@li wxCustomDataObject: Custom data object class +@li wxClipboard: Clipboard class +@li wxDropTarget: Drop target class +@li wxFileDropTarget: File drop target class +@li wxTextDropTarget: Text drop target class +@li wxDropSource: Drop source class -@li wxLog: The base log class -@li wxLogStderr: Log messages to a C STDIO stream -@li wxLogStream: Log messages to a C++ iostream -@li wxLogTextCtrl: Log messages to a wxTextCtrl -@li wxLogWindow: Log messages to a log frame -@li wxLogGui: Default log target for GUI programs -@li wxLogNull: Temporarily suppress message logging -@li wxLogChain: Allows to chain two log targets -@li wxLogInterposer: Allows to filter the log messages -@li wxLogInterposerTemp: Allows to filter the log messages -@li wxStreamToTextRedirector: Allows to redirect output sent to @c cout to a wxTextCtrl -@li Log functions: Error and warning logging functions + + +@section page_class_cat_vfs Virtual File System + +wxWidgets provides a set of classes that implement an extensible virtual file +system, used internally by the HTML classes. + +@li wxFSFile: Represents a file in the virtual file system +@li wxFileSystem: Main interface for the virtual file system +@li wxFileSystemHandler: Class used to announce file system type + + + +@section page_class_cat_rtti Runtime Type Information (RTTI) + +wxWidgets supports runtime manipulation of class information, and dynamic +creation of objects given class names. + +Related Overviews: @ref overview_rtti + +@see @ref group_funcmacro_rtti "RTTI Functions and Macros" + +@li wxClassInfo: Holds runtime class information +@li wxObject: Root class for classes with runtime information @@ -464,9 +640,9 @@ functions and macros. Related Overviews: @ref overview_debugging +@see @ref group_funcmacro_debug "Debugging Functions and Macros" + @li wxDebugContext: Provides memory-checking facilities -@li Debugging macros: Debug macros for assertion and checking -@li WXDEBUG_NEW: Use this macro to give further debugging information @li wxDebugReport: Base class for creating debug reports in case of a program crash. @li wxDebugReportCompress: Class for creating compressed debug reports. @@ -477,98 +653,113 @@ Related Overviews: @ref overview_debugging -@section page_class_cat_net Networking +@section page_class_cat_logging Logging -wxWidgets provides its own classes for socket based networking. +wxWidgets provides several classes and functions for message logging. -@li wxDialUpManager: Provides functions to check the status of network - connection and to establish one -@li wxIPV4address: Represents an Internet address -@li wxIPaddress: Represents an Internet address -@li wxSocketBase: Represents a socket base object -@li wxSocketClient: Represents a socket client -@li wxSocketServer: Represents a socket server -@li wxSocketEvent: A socket event -@li wxFTP: FTP protocol class -@li wxHTTP: HTTP protocol class -@li wxURL: Represents a Universal Resource Locator +Related Overviews: @ref overview_log +@see @ref group_funcmacro_log "Logging Functions and Macros" +@li wxLog: The base log class +@li wxLogStderr: Log messages to a C STDIO stream +@li wxLogStream: Log messages to a C++ iostream +@li wxLogTextCtrl: Log messages to a wxTextCtrl +@li wxLogWindow: Log messages to a log frame +@li wxLogGui: Default log target for GUI programs +@li wxLogNull: Temporarily suppress message logging +@li wxLogChain: Allows to chain two log targets +@li wxLogInterposer: Allows to filter the log messages +@li wxLogInterposerTemp: Allows to filter the log messages +@li wxStreamToTextRedirector: Allows to redirect output sent to @c cout to a wxTextCtrl -@section page_class_cat_ipc Interprocess Communication -wxWidgets provides simple interprocess communications facilities based on -Windows DDE, but available on most platforms using TCP. -Related Overviews: @ref overview_ipc +@section page_class_cat_threading Threading -@li wxClient, wxDDEClient: Represents a client -@li wxConnection, wxDDEConnection: Represents the connection between a client - and a server -@li wxServer, wxDDEServer: Represents a server +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_dvf Document/View Framework -wxWidgets supports a document/view framework which provides housekeeping for a -document-centric application. -Related Overviews: @ref overview_docview +@section page_class_cat_data Data Structures -@li wxCommand: Base class for undo/redo actions -@li wxCommandProcessor: Maintains the undo/redo stack -@li wxDocument: Represents a document -@li wxView: Represents a view -@li wxDocTemplate: Manages the relationship between a document class and a - view class -@li wxDocManager: Manages the documents and views in an application -@li wxDocChildFrame: A child frame for showing a document view -@li wxDocParentFrame: A parent frame to contain views -@li wxDocMDIChildFrame: An MDI child frame for showing a document view -@li wxDocMDIParentFrame: An MDI parent frame to contain views -@li wxFileHistory: Maintains a list of the most recently visited files +These are the data structure classes supported by wxWidgets. +@li wxCmdLineParser: Command line parser class +@li wxDateSpan: A logical time interval. +@li wxDateTime: A class for date/time manipulations +@li wxLongLong: A portable 64 bit integer type +@li wxObject: The root class for most wxWidgets classes +@li wxPathList: A class to help search multiple paths +@li wxPoint: Representation of a point +@li wxRect: A class representing a rectangle +@li wxRegEx: Regular expression support +@li wxRegion: A class representing a region +@li wxString: A string class +@li wxStringTokenizer: A class for interpreting a string as a list of tokens or + words +@li wxRealPoint: Representation of a point using floating point numbers +@li wxSize: Representation of a size +@li wxTimeSpan: A time interval. +@li wxURI: Represents a Uniform Resource Identifier +@li wxVariant: A class for storing arbitrary types that may change at run-time -@section page_class_cat_printing Printing Framework -A printing and previewing framework is implemented to make it relatively -straightforward to provide document printing facilities. +@section page_class_cat_conv Text Conversion -Related Overviews: @ref overview_printing +These classes define objects for performing conversions between different +multibyte and Unicode encodings and wide character strings. -@li wxPreviewFrame: Frame for displaying a print preview -@li wxPreviewCanvas: Canvas for displaying a print preview -@li wxPreviewControlBar: Standard control bar for a print preview -@li wxPrintDialog: Standard print dialog -@li wxPageSetupDialog: Standard page setup dialog -@li wxPrinter: Class representing the printer -@li wxPrinterDC: Printer device context -@li wxPrintout: Class representing a particular printout -@li wxPrintPreview: Class representing a print preview -@li wxPrintData: Represents information about the document being printed -@li wxPrintDialogData: Represents information about the print dialog -@li wxPageSetupDialogData: Represents information about the page setup dialog +@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 + specified by name. +Related Overviews: @ref overview_mbconv -@section page_class_cat_dnd Clipboard and Drag & Drop +@section page_class_cat_containers Containers -Related Overviews: @ref overview_dnd +These are classes, templates and class macros are used by wxWidgets. Most of +these classes provide a subset or almost complete STL API. -@li wxDataObject: Data object class -@li wxDataFormat: Represents a data format -@li wxTextDataObject: Text data object class -@li wxFileDataObject: File data object class -@li wxBitmapDataObject: Bitmap data object class -@li wxURLDataObject: URL data object class -@li wxCustomDataObject: Custom data object class -@li wxClipboard: Clipboard class -@li wxDropTarget: Drop target class -@li wxFileDropTarget: File drop target class -@li wxTextDropTarget: Text drop target class -@li wxDropSource: Drop source class +Related Overviews: @ref overview_container + +@li wxArray: A type-safe dynamic array implementation (macro based) +@li wxArrayString: An efficient container for storing wxString objects +@li wxHashMap: A type-safe hash map implementation (macro based) +@li wxHashSet: A type-safe hash set implementation(macro based) +@li wxHashTable: A simple hash table implementation (deprecated, use wxHashMap) +@li wxList: A type-safe linked list implementation (macro based) +@li wxVector: Template base vector implementation identical to std::vector + + + +@section page_class_cat_smartpointers Smart Pointers + +wxWidgets provides a few smart pointer class templates. + +@li wxObjectDataPtr: A shared pointer (using intrusive reference counting) +@li wxScopedPtr: A scoped pointer +@li wxSharedPtr: A shared pointer (using non-intrusive reference counting) +@li wxWeakRef: A weak reference @@ -591,17 +782,6 @@ Related Overviews: @ref overview_file -@section page_class_cat_vfs Virtual File System - -wxWidgets provides a set of classes that implement an extensible virtual file -system, used internally by the HTML classes. - -@li wxFSFile: Represents a file in the virtual file system -@li wxFileSystem: Main interface for the virtual file system -@li wxFileSystemHandler: Class used to announce file system type - - - @section page_class_cat_streams Streams wxWidgets has its own set of stream classes, as an alternative to often buggy @@ -641,119 +821,63 @@ standard stream libraries, and to provide enhanced functionality. -@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 -creation of objects given class names. - -Related Overviews: @ref overview_rtti - -See also: @ref page_macro_cat_rtti - -@li wxClassInfo: Holds runtime class information -@li wxObject: Root class for classes with runtime information - - - -@section page_class_cat_appmanagement Application and Process Management - -@li wxApp: Application class -@li wxCmdLineParser: Command line parser class -@li wxDllLoader: Class to work with shared libraries. -@li wxProcess: Process class - - - -@section page_class_cat_html HTML +@section page_class_cat_xml XML -wxWidgets provides a set of classes to display text in HTML format. These -classes include a help system based on the HTML widget. +@li wxXmlDocument: A class to parse XML files +@li wxXmlNode: A class which represents XML nodes +@li wxXmlAttribute: A class which represent an XML attribute -@li wxHtmlHelpController: HTML help controller class -@li wxHtmlWindow: HTML window class -@li wxHtmlEasyPrinting: Simple class for printing HTML -@li wxHtmlPrintout: Generic HTML wxPrintout class -@li wxHtmlParser: Generic HTML parser class -@li wxHtmlTagHandler: HTML tag handler, pluginable into wxHtmlParser -@li wxHtmlWinParser: HTML parser class for wxHtmlWindow -@li wxHtmlWinTagHandler: HTML tag handler, pluginable into wxHtmlWinParser +@section page_class_cat_archive Archive -@section page_class_cat_richtext Rich Text +@li wxArchiveInputStream +@li wxArchiveOutputStream +@li wxArchiveEntry -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_xrc XML Based Resource System (XRC) +Resources allow your application to create controls and other user interface +elements from specifications stored in an XML format. -@section page_class_cat_stc Scintilla Text Editor +Related Overviews: @ref overview_xrc -wxWidgets also provides a wrapper around the Scintilla text editor control, -which is a control for plain-text editing with support for highlighting, smart -indentation, etc. +@li wxXmlResource: The main class for working with resources +@li wxXmlResourceHandler: The base class for XML resource handlers -@li wxStyledTextCtrl: A wxWidgets implementation of the Scintilla source code - editing component. +@section page_class_cat_net Networking -@section page_class_cat_xml XML +wxWidgets provides its own classes for socket based networking. -@li wxXmlDocument: A class to parse XML files -@li wxXmlNode: A class which represents XML nodes -@li wxXmlAttribute: A class which represent an XML attribute +@li wxDialUpManager: Provides functions to check the status of network + connection and to establish one +@li wxIPV4address: Represents an Internet address +@li wxIPaddress: Represents an Internet address +@li wxSocketBase: Represents a socket base object +@li wxSocketClient: Represents a socket client +@li wxSocketServer: Represents a socket server +@li wxSocketEvent: A socket event +@li wxFTP: FTP protocol class +@li wxHTTP: HTTP protocol class +@li wxURL: Represents a Universal Resource Locator -@section page_class_cat_xrc XML Based Resource System (XRC) +@section page_class_cat_ipc Interprocess Communication -Resources allow your application to create controls and other user interface -elements from specifications stored in an XML format. +wxWidgets provides simple interprocess communications facilities based on +Windows DDE, but available on most platforms using TCP. -Related Overviews: @ref overview_xrc +Related Overviews: @ref overview_ipc -@li wxXmlResource: The main class for working with resources -@li wxXmlResourceHandler: The base class for XML resource handlers +@li wxClient, wxDDEClient: Represents a client +@li wxConnection, wxDDEConnection: Represents the connection between a client + and a server +@li wxServer, wxDDEServer: Represents a server