X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/684761db46d96d4a919d8e94edd1e9065978e675..f94a790dafd54c290618c97cb3d4feffc400fd15:/docs/latex/wx/renderer.tex diff --git a/docs/latex/wx/renderer.tex b/docs/latex/wx/renderer.tex index b17c215b32..221f659425 100644 --- a/docs/latex/wx/renderer.tex +++ b/docs/latex/wx/renderer.tex @@ -6,18 +6,18 @@ %% Created: 06.08.03 %% RCS-ID: $Id$ %% Copyright: (c) 2003 Vadim Zeitlin -%% License: wxWindows license +%% License: wxWidgets license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxRendererNative}}\label{wxrenderernative} First, a brief introduction to wxRenderer and why it is needed. -Usually wxWindows uses the underlying low level GUI system to draw all the +Usually wxWidgets uses the underlying low level GUI system to draw all the controls -- this is what we mean when we say that it is a ``native'' framework. However not all controls exist under all (or even any) platforms and in this -case wxWindows provides a default, generic, implementation of them written in -wxWindows itself. +case wxWidgets provides a default, generic, implementation of them written in +wxWidgets itself. These controls don't have the native appearance if only the standard line drawing and other graphics primitives are used, because the native @@ -37,24 +37,25 @@ renderer but it may be changed or extended by the user, see All drawing functions take some standard parameters: \begin{itemize} - \item \arg{win} is the window being drawn. It is normally not used and when - it is it should only be used as a generic \helpref{wxWindow}{wxwindow} - (in order to get its low level handle, for example), but you should - \emph{not} assume that it is of some given type as the same renderer - function may be reused for drawing different kinds of control. - \item \arg{dc} is the \helpref{wxDC}{wxdc} to draw on. Only this device - context should be used for drawing. It is not necessary to restore - pens and brushes for it on function exit but, on the other hand, you - shouldn't assume that it is in any specific state on function entry: - the rendering functions should always prepare it. - \item \arg{rect} the bounding rectangle for the element to be drawn. - \item \arg{flags} the optional flags (none by default) which can be a - combination of the \texttt{wxCONTROL\_XXX} constants below. +\item \arg{win} is the window being drawn. It is normally not used and when +it is it should only be used as a generic \helpref{wxWindow}{wxwindow} +(in order to get its low level handle, for example), but you should +\emph{not} assume that it is of some given type as the same renderer +function may be reused for drawing different kinds of control. +\item \arg{dc} is the \helpref{wxDC}{wxdc} to draw on. Only this device +context should be used for drawing. It is not necessary to restore +pens and brushes for it on function exit but, on the other hand, you +shouldn't assume that it is in any specific state on function entry: +the rendering functions should always prepare it. +\item \arg{rect} the bounding rectangle for the element to be drawn. +\item \arg{flags} the optional flags (none by default) which can be a +combination of the \texttt{wxCONTROL\_XXX} constants below. \end{itemize} \wxheading{Constants} The following rendering flags are defined: + \begin{verbatim} enum { @@ -71,7 +72,6 @@ enum }; \end{verbatim} - \wxheading{Derived from} No base class @@ -91,6 +91,16 @@ No base class Virtual destructor as for any base class. +\membersection{wxRendererGeneric::DrawComboBoxDropButton} + +\func{void}{DrawComboBoxDropButton}{\param{wxWindow *}{win}, \param{wxDC\& }{dc}, \param{const wxRect\& }{rect}, \param{int }{flags}} + +Draw a button like the one used by \helpref{wxComboBox}{wxcombobox} to show a +drop down window. The usual appearance is a downwards pointing arrow. + +\arg{flags} may have the \texttt{wxCONTROL\_PRESSED} bit set. + + \membersection{wxRendererNative::DrawHeaderButton}\label{wxrenderernativedrawheaderbutton} \func{void}{DrawHeaderButton}{\param{wxWindow* }{win}, \param{wxDC\& }{dc}, \param{const wxRect\& }{rect}, \param{int }{flags = 0}}