X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/28792a701fb0cdcc6bb73dd1ad4aa6b084f875bb..7447d53c35249d42128d6243c90998f03882859a:/docs/doxygen/mainpages/cat_classes.h diff --git a/docs/doxygen/mainpages/cat_classes.h b/docs/doxygen/mainpages/cat_classes.h index 058856819a..fd4c127f37 100644 --- a/docs/doxygen/mainpages/cat_classes.h +++ b/docs/doxygen/mainpages/cat_classes.h @@ -3,7 +3,7 @@ // 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 ///////////////////////////////////////////////////////////////////////////// /** @@ -20,40 +20,39 @@ This page contains a summarized listing of classes, please see the @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_miscwnd @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_stc +@li @ref page_class_cat_miscwnd @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 +@li @ref page_class_cat_threading @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 -@li @ref page_class_cat_archive - @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 @@ -87,25 +86,20 @@ 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: @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 -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 @@ -148,11 +142,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 wxToggleButton: A button which stays pressed when clicked by user. @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 @@ -160,37 +153,67 @@ 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 @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 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 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 +@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 @li wxVListBox: A listbox supporting variable height rows +@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 @@ -208,6 +231,7 @@ platform-dependent. 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) @@ -218,6 +242,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 @@ -230,7 +256,7 @@ The following are a variety of classes that are derived from wxWindow. arrangement @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) @@ -262,19 +288,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. @@ -294,46 +322,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_stc Scintilla Text Editor - -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 wxStyledTextCtrl: A wxWidgets implementation of the Scintilla source code - editing component. - - - @section page_class_cat_dc Device Contexts Device contexts are surfaces that may be drawn on, and provide an abstraction @@ -373,6 +361,7 @@ are based on the modern drawing backend GDI+, CoreGraphics and Cairo. @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 @@ -423,7 +412,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 @@ -446,12 +435,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 @@ -478,23 +469,11 @@ 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 @li wxCmdLineParser: Command line parser class -@li wxDllLoader: Class to work with shared libraries. +@li wxDynamicLibrary: Class to work with shared libraries. @li wxProcess: Process class @@ -573,6 +552,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 @@ -611,7 +608,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" @@ -629,28 +626,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 @@ -672,6 +652,23 @@ These are the data structure classes supported by wxWidgets. +@section page_class_cat_conv Text Conversion + +These classes define objects for performing conversions between different +multibyte and Unicode encodings and wide character strings. + +@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 + + @section page_class_cat_containers Containers These are classes, templates and class macros are used by wxWidgets. Most of @@ -704,7 +701,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. @@ -716,13 +713,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 @@ -779,7 +779,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 @@ -809,7 +809,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