classes by category

a classification of wxwidgets classes by category.

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.

wxtoplevelwindow	any top level window, dialog or frame
wxdialog	dialog box
wxframe	normal frame
wxmdichildframe	mdi child frame
wxmdiparentframe	mdi parent frame
wxminiframe	a frame with a small title bar
wxpropertysheetdialog	property sheet dialog
wxsplashscreen	splash screen class
wxtipwindow	shows text in a small window
wxwizard	a wizard dialog

see also common dialogs.

miscellaneous windows

the following are a variety of classes that are derived from wxwindow.

wxpanel	a window whose colour changes according to current user settings
wxscrolledwindow	window with automatically managed scrollbars
wxgrid	a grid (table) window
wxsplitterwindow	window which can be split vertically or horizontally
wxstatusbar	implements the status bar on a frame
wxtoolbar	toolbar class
wxnotebook	notebook class
wxlistbook	similar to notebook but using list control
wxchoicebook	similar to notebook but using choice control
wxtreebook	similar to notebook but using tree control
wxsashwindow	window with four optional sashes that can be dragged
wxsashlayoutwindow	window that can be involved in an ide-like layout arrangement
wxvscrolledwindow	as wxscrolledwindow but supports lines of variable height
wxwizardpage	a base class for the page in wizard dialog.
wxwizardpagesimple	a page in wizard dialog.

common dialogs

overview

common dialogs are ready-made dialog classes which are frequently used in an application.

wxdialog	base class for common dialogs
wxcolourdialog	colour chooser dialog
wxdirdialog	directory selector dialog
wxfiledialog	file selector dialog
wxfindreplacedialog	text search/replace dialog
wxmultichoicedialog	dialog to get one or more selections from a list
wxsinglechoicedialog	dialog to get a single selection from a list and return the string
wxtextentrydialog	dialog to get a single line of text from the user
wxpasswordentrydialog	dialog to get a password from the user
wxfontdialog	font chooser dialog
wxpagesetupdialog	standard page setup dialog
wxprintdialog	standard print dialog
wxprogressdialog	progress indication dialog
wxmessagedialog	simple message box dialog
wxsymbolpickerdialog	symbol selector dialog
wxrichtextformattingdialog	a dialog for formatting the content of a wxrichtextctrl
wxwizard	a wizard dialog.

controls

typically, these are small windows which provide interaction with the user. controls that are not static can have validators associated with them.

wxanimationctrl	a control to display an animation
wxcontrol	the base class for controls
wxbutton	push button control, displaying text
wxbitmapbutton	push button control, displaying a bitmap
wxbitmapcombobox	a combobox with bitmaps next to text items
wxtogglebutton	a button which stays pressed when clicked by user.
wxcalendarctrl	control showing an entire calendar month
wxcheckbox	checkbox control
wxchecklistbox	a listbox with a checkbox to the left of each item
wxchoice	choice control (a combobox without the editable area)
wxcombobox	a choice with an editable area
wxcomboctrl	a combobox with application defined popup
wxdataviewctrl	a control to tabular or tree like data
wxgauge	a control to represent a varying quantity, such as time remaining
wxgenericdirctrl	a control for displaying a directory tree
wxhtmllistbox	an abstract class for creating listboxes showing html content
wxsimplehtmllistbox	a listbox showing html content
wxstaticbox	a static, or group box for visually grouping related controls
wxlistbox	a list of strings for single or multiple selection
wxlistctrl	a control for displaying lists of strings and/or icons, plus a multicolumn report view
wxlistview	a simpler interface (façade) for wxlistctrl in report mode
wxownerdrawncombobox	a combobox with owner-drawn list items
wxrichtextctrl	generic rich text editing control
wxtextctrl	single or multiline text editing control
wxtreectrl	tree (hierarchy) control
wxscrollbar	scrollbar control
wxspinbutton	a spin or 'up-down' control
wxspinctrl	a spin control - i.e. spin button and text control
wxstatictext	one or more lines of non-editable text
wxhyperlinkctrl	a static text which opens an url when clicked
wxstaticbitmap	a control to display a bitmap
wxradiobox	a group of radio buttons
wxradiobutton	a round button to be used with others in a mutually exclusive way
wxslider	a slider that can be dragged by the user
wxvlistbox	a listbox supporting variable height rows

miscellaneous pickers

a picker control is a control whose appearance and behaviour is highly platform-dependent.

wxcolourpickerctrl	a control which allows the user to choose a colour
wxdirpickerctrl	a control which allows the user to choose a directory
wxfilepickerctrl	a control which allows the user to choose a file
wxfontpickerctrl	a control which allows the user to choose a font
wxdatepickerctrl	small date picker control

menus

wxmenu	displays a series of menu items for selection
wxmenubar	contains a series of menus for use with a frame
wxmenuitem	represents a single menu item

wxaui - advanced user interface

this is a new set of classes for writing a customizable application interface with built-in docking, floatable panes and a flexible mdi-like interface. further classes for custom notebooks with draggable tabs etc. are in progress. see also wxaui overview.

wxauimanager	the central class for managing the interface
wxauinotebook	a replacement notebook class with extra features
wxauipaneinfo	describes a single pane
wxauidockart	art and metrics provider for customizing the docking user interface
wxauitabart	art and metrics provider for customizing the notebook user interface

window layout

there are two different systems for laying out windows (and dialogs in particular). one is based upon so-called sizers and it requires less typing, 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.

sizer overview describes sizer-based layout.

these are the classes relevant to sizer-based layout.

wxsizer	abstract base class
wxgridsizer	a sizer for laying out windows in a grid with all fields having the same size
wxflexgridsizer	a sizer for laying out windows in a flexible grid
wxgridbagsizer	another grid sizer that lets you specify the cell an item is in, and items can span rows and/or columns.
wxboxsizer	a sizer for laying out windows in a row or column
wxstaticboxsizer	same as wxboxsizer, but with a surrounding static box

constraints overview describes constraints-based layout.

these are the classes relevant to constraints-based window layout.

wxindividuallayoutconstraint	represents a single constraint dimension
wxlayoutconstraints	represents the constraints for a window class

device contexts

overview

device contexts are surfaces that may be drawn on, and provide an abstraction that allows parameterisation of your drawing code by passing different device contexts.

wxautobufferedpaintdc	a helper device context for double buffered drawing inside onpaint.
wxbuffereddc	a helper device context for double buffered drawing.
wxbufferedpaintdc	a helper device context for double buffered drawing inside onpaint.
wxclientdc	a device context to access the client area outside onpaint events
wxpaintdc	a device context to access the client area inside onpaint events
wxwindowdc	a device context to access the non-client area
wxscreendc	a device context to access the entire screen
wxdc	the device context base class
wxmemorydc	a device context for drawing into bitmaps
wxmetafiledc	a device context for drawing into metafiles
wxmirrordc	a proxy device context allowing for simple mirroring.
wxpostscriptdc	a device context for drawing into postscript files
wxprinterdc	a device context for drawing to printers

graphics device interface

bitmaps overview

these classes are related to drawing on device contexts and windows.

wxcolour	represents the red, blue and green elements of a colour
wxdcclipper	wraps the operations of setting and destroying the clipping region
wxbitmap	represents a bitmap
wxbrush	used for filling areas on a device context
wxbrushlist	the list of previously-created brushes
wxcursor	a small, transparent bitmap representing the cursor
wxfont	represents fonts
wxfontlist	the list of previously-created fonts
wxicon	a small, transparent bitmap for assigning to frames and drawing on device contexts
wximage	a platform-independent image class
wximagelist	a list of images, used with some controls
wxmask	represents a mask to be used with a bitmap for transparent drawing
wxpen	used for drawing lines on a device context
wxpenlist	the list of previously-created pens
wxpalette	represents a table of indices into rgb values
wxregion	represents a simple or complex region on a window or device context
wxrenderernative	abstracts high-level drawing primitives

events

overview

an event object contains information about a specific event. event handlers (usually member functions) have a single, event argument.

wxactivateevent	a window or application activation event
wxcalendarevent	used with wxcalendarctrl
wxcalculatelayoutevent	used to calculate window layout
wxchildfocusevent	a child window focus event
wxclipboardtextevent	a clipboard copy/cut/paste treebook event event
wxcloseevent	a close window or end session event
wxcommandevent	an event from a variety of standard controls
wxcontextmenuevent	an event generated when the user issues a context menu command
wxdateevent	used with wxdatepickerctrl
wxdialupevent	event send by wxdialupmanager
wxdropfilesevent	a drop files event
wxeraseevent	an erase background event
wxevent	the event base class
wxfinddialogevent	event sent by wxfindreplacedialog
wxfocusevent	a window focus event
wxkeyevent	a keypress event
wxiconizeevent	an iconize/restore event
wxidleevent	an idle event
wxinitdialogevent	a dialog initialisation event
wxjoystickevent	a joystick event
wxlistevent	a list control event
wxmaximizeevent	a maximize event
wxmenuevent	a menu event
wxmousecapturechangedevent	a mouse capture changed event
wxmousecapturelostevent	a mouse capture lost event
wxmouseevent	a mouse event
wxmoveevent	a move event
wxnotebookevent	a notebook control event
wxnotifyevent	a notification event, which can be vetoed
wxpaintevent	a paint event
wxprocessevent	a process ending event
wxquerylayoutinfoevent	used to query layout information
wxrichtextevent	a rich text editing event
wxscrollevent	a scroll event from sliders, stand-alone scrollbars and spin buttons
wxscrollwinevent	a scroll event from scrolled windows
wxsizeevent	a size event
wxsocketevent	a socket event
wxspinevent	an event from wxspinbutton
wxsplitterevent	an event from wxsplitterwindow
wxsyscolourchangedevent	a system colour change event
wxtimerevent	a timer expiration event
wxtreebookevent	a treebook control event
wxtreeevent	a tree control event
wxupdateuievent	a user interface update event
wxwindowcreateevent	a window creation event
wxwindowdestroyevent	a window destruction event
wxwizardevent	a wizard event

validators

overview

these are the window validators, used for filtering and validating user input.

wxvalidator	base validator class
wxtextvalidator	text control validator class
wxgenericvalidator	generic control validator class

data structures

these are the data structure classes supported by wxwidgets.

wxcmdlineparser	command line parser class
wxdatespan	a logical time interval.
wxdatetime	a class for date/time manipulations
wxarray	a dynamic array implementation
wxarraystring	an efficient container for storing wxstring objects
wxhashmap	a simple hash map implementation
wxhashset	a simple hash set implementation
wxhashtable	a simple hash table implementation (deprecated, use wxhashmap)
wxlist	a simple linked list implementation
wxlonglong	a portable 64 bit integer type
wxnode	represents a node in the wxlist implementation
wxobject	the root class for most wxwidgets classes
wxpathlist	a class to help search multiple paths
wxpoint	representation of a point
wxrect	a class representing a rectangle
wxregex	regular expression support
wxregion	a class representing a region
wxstring	a string class
wxstringtokenizer	a class for interpreting a string as a list of tokens or words
wxrealpoint	representation of a point using floating point numbers
wxsize	representation of a size
wxtimespan	a time interval.
wxuri	represents a uniform resource identifier
wxvariant	a class for storing arbitrary types that may change at run-time

run-time class information system

overview

wxwidgets supports run-time manipulation of class information, and dynamic creation of objects given class names.

wxclassinfo	holds run-time class information
wxobject	root class for classes with run-time information
rtti macros	macros for manipulating run-time information

logging features

overview

wxwidgets provides several classes and functions for message logging. please see the wxlog overview for more details.

wxlog	the base log class
wxlogstderr	log messages to a c stdio stream
wxlogstream	log messages to a c++ iostream
wxlogtextctrl	log messages to a wxtextctrl
wxlogwindow	log messages to a log frame
wxloggui	default log target for gui programs
wxlognull	temporarily suppress message logging
wxlogchain	allows to chain two log targets
wxlogpassthrough	allows to filter the log messages
wxstreamtotextredirector	allows to redirect output sent to `cout` to a wxtextctrl
log functions	error and warning logging functions

debugging features

overview

wxwidgets supports some aspects of debugging an application through classes, functions and macros.

wxdebugcontext	provides memory-checking facilities
debugging macros	debug macros for assertion and checking
wxdebug_new	use this macro to give further debugging information
wxdebugreport	base class for creating debug reports in case of a program crash.
wxdebugreportcompress	class for creating compressed debug reports.
wxdebugreportupload	class for uploading compressed debug reports via http.
wxdebugreportpreview	abstract base class for previewing the contents of a debug report.
wxdebugreportpreviewstd	standard implementation of wxdebugreportpreview.

networking classes

wxwidgets provides its own classes for socket based networking.

wxdialupmanager	provides functions to check the status of network connection and to establish one
wxipv4address	represents an internet address
wxipaddress	represents an internet address
wxsocketbase	represents a socket base object
wxsocketclient	represents a socket client
wxsocketserver	represents a socket server
wxsocketevent	a socket event
wxftp	ftp protocol class
wxhttp	http protocol class
wxurl	represents a universal resource locator

interprocess communication

overview

wxwidgets provides simple interprocess communications facilities based on windows dde, but available on most platforms using tcp.

wxclient, wxddeclient	represents a client
wxconnection, wxddeconnection	represents the connection between a client and a server
wxserver, wxddeserver	represents a server

document/view framework

overview

wxwidgets supports a document/view framework which provides housekeeping for a document-centric application.

wxdocument	represents a document
wxview	represents a view
wxdoctemplate	manages the relationship between a document class and a view class
wxdocmanager	manages the documents and views in an application
wxdocchildframe	a child frame for showing a document view
wxdocparentframe	a parent frame to contain views

printing framework

overview

a printing and previewing framework is implemented to make it relatively straightforward to provide document printing facilities.

wxpreviewframe	frame for displaying a print preview
wxpreviewcanvas	canvas for displaying a print preview
wxpreviewcontrolbar	standard control bar for a print preview
wxprintdialog	standard print dialog
wxpagesetupdialog	standard page setup dialog
wxprinter	class representing the printer
wxprinterdc	printer device context
wxprintout	class representing a particular printout
wxprintpreview	class representing a print preview
wxprintdata	represents information about the document being printed
wxprintdialogdata	represents information about the print dialog
wxpagesetupdialogdata	represents information about the page setup dialog

drag and drop and clipboard classes

drag and drop and clipboard overview

wxdataobject	data object class
wxdataformat	represents a data format
wxtextdataobject	text data object class
wxfiledataobject	file data object class
wxbitmapdataobject	bitmap data object class
wxurldataobject	url data object class
wxcustomdataobject	custom data object class
wxclipboard	clipboard class
wxdroptarget	drop target class
wxfiledroptarget	file drop target class
wxtextdroptarget	text drop target class
wxdropsource	drop source class

file related classes

wxwidgets has several small classes to work with disk files, see file classes overview for more details.

wxfilename	operations with the file name and attributes
wxdir	class for enumerating files/subdirectories.
wxdirtraverser	class used together with wxdir for recursively enumerating the files/subdirectories
wxfile	low-level file input/output class.
wxffile	another low-level file input/output class.
wxtempfile	class to safely replace an existing file
wxtextfile	class for working with text files as with arrays of lines
wxstandardpaths	paths for standard directories

stream classes

wxwidgets has its own set of stream classes, as an alternative to often buggy standard stream libraries, and to provide enhanced functionality.

wxstreambase	stream base class
wxstreambuffer	stream buffer class
wxinputstream	input stream class
wxoutputstream	output stream class
wxcountingoutputstream	stream class for querying what size a stream would have.
wxfilterinputstream	filtered input stream class
wxfilteroutputstream	filtered output stream class
wxbufferedinputstream	buffered input stream class
wxbufferedoutputstream	buffered output stream class
wxmemoryinputstream	memory input stream class
wxmemoryoutputstream	memory output stream class
wxdatainputstream	platform-independent binary data input stream class
wxdataoutputstream	platform-independent binary data output stream class
wxtextinputstream	platform-independent text data input stream class
wxtextoutputstream	platform-independent text data output stream class
wxfileinputstream	file input stream class
wxfileoutputstream	file output stream class
wxffileinputstream	another file input stream class
wxffileoutputstream	another file output stream class
wxtempfileoutputstream	stream to safely replace an existing file
wxstringinputstream	string input stream class
wxstringoutputstream	string output stream class
wxzlibinputstream	zlib and gzip (compression) input stream class
wxzliboutputstream	zlib and gzip (compression) output stream class
wxzipinputstream	input stream for reading from zip archives
wxzipoutputstream	output stream for writing from zip archives
wxtarinputstream	input stream for reading from tar archives
wxtaroutputstream	output stream for writing from tar archives
wxsocketinputstream	socket input stream class
wxsocketoutputstream	socket output stream class

threading classes

multithreading overview

wxwidgets provides a set of classes to make use of the native thread capabilities of the various platforms.

wxthread	thread class
wxthreadhelper	manages background threads easily
wxmutex	mutex class
wxmutexlocker	mutex locker utility class
wxcriticalsection	critical section class
wxcriticalsectionlocker	critical section locker utility class
wxcondition	condition class
wxsemaphore	semaphore class

html classes

wxwidgets provides a set of classes to display text in html format. these class include a help system based on the html widget.

wxhtmlhelpcontroller	html help controller class
wxhtmlwindow	html window class
wxhtmleasyprinting	simple class for printing html
wxhtmlprintout	generic html wxprintout class
wxhtmlparser	generic html parser class
wxhtmltaghandler	html tag handler, pluginable into wxhtmlparser
wxhtmlwinparser	html parser class for wxhtmlwindow
wxhtmlwintaghandler	html tag handler, pluginable into wxhtmlwinparser

rich text classes

wxwidgets provides a set of generic classes to edit and print simple rich text with character and paragraph formatting.

wxrichtextctrl	a rich text control.
wxrichtextbuffer	the content of a rich text control.
wxrichtextattr	attributes specifying rich text styling.
wxrichtextcharacterstyledefinition	definition of character styling.
wxrichtextparagraphstyledefinition	definition of paragraph styling.
wxrichtextliststyledefinition	definition of list styling.
wxrichtextstylesheet	a set of style definitions.
wxrichtextstylecomboctrl	a drop-down control for applying styles.
wxrichtextstylelistbox	a listbox for applying styles.
wxrichtextstyleorganiserdialog	a dialog that can be used for managing or browsing styles.
wxrichtextevent	a rich text event.
wxrichtextrange	specification for ranges in a rich text control or buffer.
wxrichtextfilehandler	file handler base class.
wxrichtexthtmlhandler	a handler for converting rich text to html.
wxrichtextxmlhandler	a handler for loading and saving rich text xml.
wxrichtextformattingdialog	a dialog for rich text formatting.
wxrichtextprinting	a class for easy printing of rich text buffers.
wxrichtextprintout	a class used by wxrichtextprinting.
wxrichtextheaderfooterdata	header and footer data specification.

virtual file system classes

wxwidgets provides a set of classes that implement an extensible virtual file system, used internally by the html classes.

wxfsfile	represents a file in the virtual file system
wxfilesystem	main interface for the virtual file system
wxfilesystemhandler	class used to announce file system type

xml classes

wxxmldocument	a class to parse xml files.
wxxmlnode	a class which represents xml nodes.
wxxmlproperty	a class which represents xml properties.

xml-based resource system classes

xml-based resource system (xrc) overview

resources allow your application to create controls and other user interface elements from specifications stored in an xml format.

wxxmlresource	the main class for working with resources.
wxxmlresourcehandler	the base class for xml resource handlers.

online help

wxhelpcontroller	family of classes for controlling help windows
wxhtmlhelpcontroller	html help controller class
wxcontexthelp	class to put application into context-sensitive help mode
wxcontexthelpbutton	button class for putting application into context-sensitive help mode
wxhelpprovider	abstract class for context-sensitive help provision
wxsimplehelpprovider	class for simple context-sensitive help provision
wxhelpcontrollerhelpprovider	class for context-sensitive help provision via a help controller
wxtooltip	class implementing tooltips

database classes

database classes overview

wxwidgets provides a set of classes for accessing microsoft's odbc (open database connectivity) product, donated by remstar. this is known as wxodbc.

wxdb	odbc database connection
wxdbtable	provides access to a database table
wxdbinf
wxdbtableinf
wxdbcoldef
wxdbcolinf
wxdbcoldataptr
wxdbcolfor
wxdbconnectinf
wxdbidxdef

miscellaneous

wxapp	application class
wxcaret	a caret (cursor) object
wxcmdlineparser	command line parser class
wxconfig	classes for configuration reading/writing (using either ini files or registry)
wxdllloader	class to work with shared libraries.
wxglcanvas	canvas that you can render opengl calls to.
wxglcontext	class to ease sharing of opengl data resources.
wxlayoutalgorithm	an alternative window layout facility
wxprocess	process class
wxtimer	timer class
wxstopwatch	stop watch class
wxmimetypesmanager	mime-types manager class
wxsystemsettings	system settings class for obtaining various global parameters
wxsystemoptions	system options class for run-time configuration
wxacceleratortable	accelerator table
wxautomationobject	ole automation class
wxfontmapper	font mapping, finding suitable font for given encoding
wxencodingconverter	encoding conversions
wxcalendardateattr	used with wxcalendarctrl
wxquantize	class to perform quantization, or colour reduction
wxsingleinstancechecker	check that only single program instance is running