X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e53a95bcb122a06a74e116aba717b0d7a5bdc1b8..d60156ac9d764d9ee6cf866a87084732d341abb9:/docs/latex/wx/artprov.tex diff --git a/docs/latex/wx/artprov.tex b/docs/latex/wx/artprov.tex index fedf79d678..8c2b6d4aaf 100644 --- a/docs/latex/wx/artprov.tex +++ b/docs/latex/wx/artprov.tex @@ -13,7 +13,7 @@ replace standard art with their own version. All that is needed is to derive a class from wxArtProvider, override its \helpref{CreateBitmap}{wxartprovidercreatebitmap} method and register the provider with -\helpref{wxArtProvider::PushProvider}{wxartproviderpushprovider}: +\helpref{wxArtProvider::Push}{wxartproviderpush}: \begin{verbatim} class MyProvider : public wxArtProvider @@ -25,7 +25,7 @@ provider with { ... } }; ... - wxArtProvider::PushProvider(new MyProvider); + wxArtProvider::Push(new MyProvider); \end{verbatim} There's another way of taking advantage of this class: you can use it in your code and use @@ -34,6 +34,7 @@ platform native icons as provided by \helpref{wxArtProvider::GetBitmap}{wxartpro possible as of wxWidgets 2.3.3, the set of wxArtProvider bitmaps is too small). + \membersection{Identifying art resources}\label{artprovideridentifying} Every bitmap is known to wxArtProvider under an unique ID that is used by when @@ -74,8 +75,8 @@ constants in the \helpref{artprov}{sampleartprovider} sample): \item wxART\_MISSING\_IMAGE \end{itemize} -Additionally, any string recognized by custom art providers registered using -\helpref{PushProvider}{wxartproviderpushprovider} may be used. +Additionally, any string recognized by custom art providers registered using +\helpref{Push}{wxartproviderpush} may be used. \wxheading{GTK+ Note} @@ -88,6 +89,7 @@ by GTK+ follow the icons, so wxArtProvider may return {\tt wxNullBitmap} or {\tt wxNullIcon}. Default theme is typically installed in {\tt /usr/share/icons/hicolor}. + \membersection{Clients}\label{artproviderclients} Client is the entity that calls wxArtProvider's GetBitmap or GetIcon @@ -125,6 +127,15 @@ See the \helpref{artprov}{sampleartprovider} sample for an example of wxArtProvi \latexignore{\rtfignore{\wxheading{Members}}} + +\membersection{wxArtProvider::\destruct{wxArtProvider}}\label{wxartproviderdtor} + +\func{}{\destruct{wxArtProvider}}{\void} + +The destructor automatically removes the provider from the provider stack used +by \helpref{GetBitmap}{wxartprovidergetbitmap}. + + \membersection{wxArtProvider::CreateBitmap}\label{wxartprovidercreatebitmap} \func{wxBitmap}{CreateBitmap}{\param{const wxArtID\& }{id}, \param{const wxArtClient\& }{client}, \param{const wxSize\& }{size}} @@ -151,6 +162,14 @@ This is {\bf not} part of wxArtProvider's public API, use \helpref{wxArtProvider::GetIcon}{wxartprovidergeticon} to query wxArtProvider for a resource. + +\membersection{wxArtProvider::Delete}\label{wxartproviderdelete} + +\func{static bool}{Delete}{\param{wxArtProvider* }{provider}} + +Delete the given \arg{provider}. + + \membersection{wxArtProvider::GetBitmap}\label{wxartprovidergetbitmap} \func{static wxBitmap}{GetBitmap}{\param{const wxArtID\& }{id}, \param{const wxArtClient\& }{client = wxART\_OTHER}, \param{const wxSize\& }{size = wxDefaultSize}} @@ -169,6 +188,7 @@ Query registered providers for bitmap with given ID. The bitmap if one of registered providers recognizes the ID or wxNullBitmap otherwise. + \membersection{wxArtProvider::GetIcon}\label{wxartprovidergeticon} \func{static wxIcon}{GetIcon}{\param{const wxArtID\& }{id}, \param{const wxArtClient\& }{client = wxART\_OTHER}, \param{const wxSize\& }{size = wxDefaultSize}} @@ -176,29 +196,49 @@ The bitmap if one of registered providers recognizes the ID or wxNullBitmap othe Same as \helpref{wxArtProvider::GetBitmap}{wxartprovidergetbitmap}, but return a wxIcon object (or wxNullIcon on failure). -\func{static wxSize}{GetSizeHint}{\param{const wxArtClient\& }{client}, \param{bool }{platform_default = false}} +\func{static wxSize}{GetSizeHint}{\param{const wxArtClient\& }{client}, \param{bool }{platform\_default = false}} Returns a suitable size hint for the given {\it wxArtClient}. If -{\it platform_default} is \true, return a size based on the current platform, +{\it platform\_default} is \true, return a size based on the current platform, otherwise return the size from the topmost wxArtProvider. {\it wxDefaultSize} may be -returned if the client doesn't have a specified size, like wxART_OTHER for example. +returned if the client doesn't have a specified size, like wxART\_OTHER for example. -\membersection{wxArtProvider::PopProvider}\label{wxartproviderctor} -\func{static bool}{PopProvider}{\void} +\membersection{wxArtProvider::Insert}\label{wxartproviderinsert} + +\func{static void}{Insert}{\param{wxArtProvider* }{provider}} + +Register new art provider and add it to the bottom of providers stack (i.e. +it will be queried as the last one). + +\wxheading{See also} + +\helpref{Push}{wxartproviderpush} + + +\membersection{wxArtProvider::Pop}\label{wxartproviderctor} + +\func{static bool}{Pop}{\void} Remove latest added provider and delete it. -\membersection{wxArtProvider::PushProvider}\label{wxartproviderpushprovider} -\func{static void}{PushProvider}{\param{wxArtProvider* }{provider}} +\membersection{wxArtProvider::Push}\label{wxartproviderpush} + +\func{static void}{Push}{\param{wxArtProvider* }{provider}} + +Register new art provider and add it to the top of providers stack (i.e. it +will be queried as the first provider). + +\wxheading{See also} + +\helpref{Insert}{wxartproviderinsert} -Register new art provider (add it to the top of providers stack). -\membersection{wxArtProvider::RemoveProvider}\label{wxartproviderremoveprovider} +\membersection{wxArtProvider::Remove}\label{wxartproviderremove} -\func{static bool}{RemoveProvider}{\param{wxArtProvider* }{provider}} +\func{static bool}{Remove}{\param{wxArtProvider* }{provider}} -Remove a provider from the stack. The provider must have been added previously -and is {\it not} deleted. +Remove a provider from the stack if it is on it. The provider is {\emph not} +deleted, unlike when using \helpref{Delete()}{wxartproviderdelete}.