X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/69bc0cca0eecaff172de77b1b35389e6a6490d37..e7bdf0ac8d2f095062b054e1adffd283c1d507a4:/docs/doxygen/mainpages/libs.h diff --git a/docs/doxygen/mainpages/libs.h b/docs/doxygen/mainpages/libs.h index 5bbbe45c97..515e9b123c 100644 --- a/docs/doxygen/mainpages/libs.h +++ b/docs/doxygen/mainpages/libs.h @@ -2,158 +2,214 @@ // Name: libs.h // Purpose: Libraries page of the Doxygen manual // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// +/** -/*! +@page page_libs Library List - @page page_libs Libraries list +@tableofcontents - wxWidgets can be built either as a single large - library (this is called the monolithic build) or as several smaller - libraries (multilib build}). Multilib build is the default. +wxWidgets can be built either as a single large library (this is called a +monolithic build) or as several smaller libraries +(multilib build). Multilib build is the default. - wxWidgets library is divided into libraries briefly described below. This - diagram show dependencies between them: +wxWidgets library is divided into libraries briefly described below. This +diagram shows the dependencies between them: - @image html libs.gif +@dot +digraph Dependancies +{ + node [shape = ellipse, fontname = "Courier", fontsize = 10, style = filled]; - Please note that arrows indicate the "depends from" relation and that - all blue boxes depend from @ref page_libs_wxbase library (i.e. they are non-GUI libraries), - and all green boxes depend from @ref page_libs_wxcore library (i.e. they are GUI libraries). + wxBase [URL = "\ref page_libs_wxbase"]; + wxCore [fillcolor = deepskyblue, URL = "\ref page_libs_wxcore"]; + wxNet [fillcolor = deepskyblue, URL = "\ref page_libs_wxnet"]; + wxXML [fillcolor = deepskyblue, URL = "\ref page_libs_wxxml"]; - + wxAdvanced [fillcolor = green, URL = "\ref page_libs_wxadv"]; + wxAUI [fillcolor = green, URL = "\ref page_libs_wxaui"]; + wxGL [fillcolor = green, URL = "\ref page_libs_wxgl"]; + wxHTML [fillcolor = green, URL = "\ref page_libs_wxhtml"]; + wxMedia [fillcolor = green, URL = "\ref page_libs_wxmedia"]; + wxPropertyGrid [fillcolor = green, URL = "\ref page_libs_wxpropgrid"]; + wxQA [fillcolor = green, URL = "\ref page_libs_wxqa"]; + wxRibbon [fillcolor = green, URL = "\ref page_libs_wxribbon"]; + wxRichText [fillcolor = green, URL = "\ref page_libs_wxrichtext"]; + wxSTC [fillcolor = green, URL = "\ref page_libs_wxstc"]; + wxXRC [fillcolor = green, URL = "\ref page_libs_wxxrc"]; + wxWebView [fillcolor = green, URL = "\ref page_libs_wxwebview"]; + wxCore -> wxBase; + wxNet -> wxBase; + wxXML -> wxBase; - @section page_libs_wxbase wxBase + wxAdvanced -> wxCore; + wxAUI -> wxAdvanced; wxAUI -> wxHTML; + wxGL -> wxCore; + wxHTML -> wxCore; + wxMedia -> wxCore; + wxPropertyGrid -> wxAdvanced; + wxQA -> wxCore; wxQA -> wxXML; + wxRibbon -> wxCore; + wxRichText -> wxAdvanced; wxRichText -> wxHTML; wxRichText -> wxXML; + wxSTC -> wxCore; + wxXRC -> wxAdvanced; wxXRC -> wxHTML; wxXRC -> wxXML; + wxWebView -> wxCore; +} +@enddot - Every wxWidgets application must link against this library. It contains - mandatory classes that any wxWidgets code depends on (e.g. wxString) and - portability classes that abstract differences between platforms. - wxBase can be used to develop console mode applications, - it does not require any GUI libraries or running X Window System on Unix. +Please note that arrows indicate the "depends from" relation and that all blue +libraries depend on the @ref page_libs_wxbase library (i.e. they are non-GUI +libraries), and all green libraries depend on the @ref page_libs_wxcore library +(i.e. they are GUI libraries). - @section page_libs_wxcore wxCore - Basic GUI classes such as GDI classes or controls are in this library. All - wxWidgets GUI applications must link against this library, only console mode - applications don't. +@section page_libs_wxadv wxAdvanced - Requires @ref page_libs_wxbase. +Advanced or rarely used GUI classes: +@li wxCalendarCtrl +@li wxGrid classes +@li wxJoystick +@li wxLayoutAlgorithm +@li wxSplashScreen +@li wxTaskBarIcon +@li wxSound +@li wxWizard +@li wxSashLayoutWindow +@li wxSashWindow +@li ...others - @section page_libs_wxaui wxAui +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - This contains the Advanced User Interface docking library. - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. +@section page_libs_wxaui wxAui +This contains the Advanced User Interface docking library. - @section page_libs_wxnet wxNet +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. - Classes for network access: - @li wxSocket classes (wxSocketClient, wxSocketServer and related classes) - @li wxSocketOutputStream and wxSocketInputStream - @li sockets-based IPC classes (wxTCPServer, wxTCPClient and wxTCPConnection) - @li wxURL - @li wxInternetFSHandler (a wxFileSystem handler) +@section page_libs_wxbase wxBase - Requires @ref page_libs_wxbase. +Every wxWidgets application must link against this library. It contains +mandatory classes that any wxWidgets code depends on (e.g. wxString) and +portability classes that abstract differences between platforms. wxBase can be +used to develop console mode applications, it does not require any GUI +libraries or running X Window System on Unix. - @section page_libs_wxrichtext wxRichText +@section page_libs_wxcore wxCore - This contains generic rich text control functionality. +Basic GUI classes such as GDI classes or controls are in this library. All +wxWidgets GUI applications must link against this library, only console mode +applications don't. - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxbase. - @section page_libs_wxxml wxXML +@section page_libs_wxgl wxGL - This library contains simple classes for parsing XML documents. +This library contains wxGLCanvas class for integrating OpenGL library with +wxWidgets. Unlike all others, this library is @b not part of the monolithic +library, it is always built as separate library. - Requires @ref page_libs_wxbase. +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - @section page_libs_wxadv wxAdvanced +@section page_libs_wxhtml wxHTML - Advanced or rarely used GUI classes: +Simple HTML renderer and other @ref overview_html are contained in this +library, as well as wxHtmlHelpController, wxBestHelpController and +wxHtmlListBox. - @li wxCalendarCtrl - @li wxGrid classes - @li wxJoystick - @li wxLayoutAlgorithm - @li wxSplashScreen - @li wxTaskBarIcon - @li wxSound - @li wxWizard - @li wxSashLayoutWindow - @li wxSashWindow - @li ...others +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +@section page_libs_wxmedia wxMedia - @section page_libs_wxmedia wxMedia +Miscellaneous classes related to multimedia. Currently this library only +contains wxMediaCtrl but more classes will be added in the future. - Miscellaneous classes related to multimedia. Currently this library only - contains wxMediaCtrl but more classes will be added in - the future. +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +@section page_libs_wxnet wxNet - @section page_libs_wxgl wxGL +Classes for network access: - This library contains wxGLCanvas class for integrating - OpenGL library with wxWidgets. Unlike all others, this library is {\em not} - part of the monolithic library, it is always built as separate library. +@li wxSocket classes (wxSocketClient, wxSocketServer and related classes) +@li wxSocketOutputStream and wxSocketInputStream +@li sockets-based IPC classes (wxTCPServer, wxTCPClient and wxTCPConnection) +@li wxURL +@li wxInternetFSHandler (a wxFileSystem handler) - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxbase. - @section page_libs_wxhtml wxHTML +@section page_libs_wxpropgrid wxPropertyGrid - Simple HTML renderer and other @ref html_overview are contained in this library, - as well as wxHtmlHelpController, wxBestHelpController and wxHtmlListBox. +This contains the wxPropertyGrid control. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxadv, @ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxqa wxQA +@section page_libs_wxqa wxQA - This is the library containing extra classes for quality assurance. Currently - it only contains wxDebugReport and related classes, - but more will be added to it in the future. +This is the library containing extra classes for quality assurance. Currently +it only contains wxDebugReport and related classes, but more will be added to +it in the future. - Requires @ref page_libs_wxxml, @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxxml, @ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxxrc wxXRC +@section page_libs_wxribbon wxRibbon - This library contains wxXmlResource class that - provides access to XML resource files in XRC format. +This contains the Ribbon User Interface components library. - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxstc wxSTC +@section page_libs_wxrichtext wxRichText - STC (Styled Text Control) is a wrapper around Scintilla, a syntax-highlighting text editor. - See http://www.scintilla.org for more info about Scintilla. +This contains generic rich text control functionality. - Requires @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. + + +@section page_libs_wxstc wxSTC + +STC (Styled Text Control) is a wrapper around Scintilla, a syntax-highlighting +text editor. See for more info about Scintilla. + +Requires @ref page_libs_wxcore, @ref page_libs_wxbase. + +@section page_libs_wxwebview wxWebView + +The wxWebView library contains the wxWebView control and its associated classes. + +Requires @ref page_libs_wxcore, @ref page_libs_wxbase. + + +@section page_libs_wxxml wxXML + +This library contains simple classes for parsing XML documents. + +Requires @ref page_libs_wxbase. + + +@section page_libs_wxxrc wxXRC + +This library contains wxXmlResource class that provides access to XML resource +files in XRC format. + +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. */