wxWidgets/docs/latex/wx/gauge.tex
1998-06-14 12:11:50 +00:00

179 lines
4.5 KiB
TeX

\section{\class{wxGauge}}\label{wxgauge}
A gauge is a horizontal or vertical bar which shows a quantity (often time).
There are no user commands for the gauge.
\wxheading{Derived from}
\helpref{wxControl}{wxcontrol}\\
\helpref{wxWindow}{wxwindow}\\
\helpref{wxEvtHandler}{wxEvtHandler}\\
\helpref{wxObject}{wxobject}
\wxheading{Window styles}
\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{\windowstyle{wxGA\_HORIZONTAL}}{Creates a horizontal gauge.}
\twocolitem{\windowstyle{wxGA\_VERTICAL}}{Creates a vertical gauge.}
\twocolitem{\windowstyle{wxGA\_PROGRESSBAR}}{Under Windows 95, creates a horizontal progress bar.}
\end{twocollist}
See also \helpref{window styles overview}{windowstyles}.
\wxheading{See also}
\helpref{wxSlider}{wxslider}, \helpref{wxScrollBar}{wxscrollbar}
\latexignore{\rtfignore{\wxheading{Members}}}
\membersection{wxGauge::wxGauge}\label{wxgaugeconstr}
\func{}{wxGauge}{\void}
Default constructor.
\func{}{wxGauge}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
\param{int}{ range}, \param{const wxPoint\& }{ pos = wxDefaultPosition}, \param{const wxSize\&}{ size = wxDefaultSize},\rtfsp
\param{long}{ style = wxGA\_HORIZONTAL}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``gauge"}}
Constructor, creating and showing a gauge.
\wxheading{Parameters}
\docparam{parent}{Window parent.}
\docparam{id}{Window identifier.}
\docparam{range}{Integer range (maximum value) of the gauge.}
\docparam{pos}{Window position.}
\docparam{size}{Window size.}
\docparam{style}{Gauge style. See \helpref{wxGauge}{wxgauge}.}
\docparam{name}{Window name.}
\wxheading{Remarks}
Under Windows 95, there are two different styles of gauge: normal gauge, and progress bar (when
the {\bf wxGA\_PROGRESSBAR} style is used). A progress bar is always horizontal.
\wxheading{See also}
\helpref{wxGauge::Create}{wxgaugecreate}
\membersection{wxGauge::\destruct{wxGauge}}
\func{}{\destruct{wxGauge}}{\void}
Destructor, destroying the gauge.
\membersection{wxGauge::Create}\label{wxgaugecreate}
\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
\param{int}{ range}, \param{const wxPoint\& }{ pos = wxDefaultPosition}, \param{const wxSize\&}{ size = wxDefaultSize},\rtfsp
\param{long}{ style = wxGA\_HORIZONTAL}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``gauge"}}
Creates the gauge for two-step construction. See \helpref{wxGauge::wxGauge}{wxgaugeconstr}\rtfsp
for further details.
\membersection{wxGauge::GetBezelFace}\label{wxgaugegetbezelface}
\constfunc{int}{GetBezelFace}{\void}
Returns the width of the 3D bezel face.
\wxheading{Remarks}
Windows only, not for {\bf wxGA\_PROGRESSBAR}.
\wxheading{See also}
\helpref{wxGauge::SetBezelFace}{wxgaugesetbezelface}
\membersection{wxGauge::GetRange}\label{wxgaugegetrange}
\constfunc{int}{GetRange}{\void}
Returns the maximum position of the gauge.
\wxheading{See also}
\helpref{wxGauge::SetRange}{wxgaugesetrange}
\membersection{wxGauge::GetShadowWidth}\label{wxgaugegetshadowwidth}
\constfunc{int}{GetShadowWidth}{\void}
Returns the 3D shadow margin width.
\wxheading{Remarks}
Windows only, not for {\bf wxGA\_PROGRESSBAR}.
\wxheading{See also}
\helpref{wxGauge::SetShadowWidth}{wxgaugesetshadowwidth}
\membersection{wxGauge::GetValue}\label{wxgaugegetvalue}
\constfunc{int}{GetValue}{\void}
Returns the current position of the gauge.
\wxheading{See also}
\helpref{wxGauge::SetValue}{wxgaugesetvalue}
\membersection{wxGauge::SetBezelFace}\label{wxgaugesetbezelface}
\func{void}{SetBezelFace}{\param{int }{width}}
Sets the 3D bezel face width.
\wxheading{Remarks}
Windows only, not for {\bf wxGA\_PROGRESSBAR}.
\wxheading{See also}
\helpref{wxGauge::GetBezelFace}{wxgaugegetbezelface}
\membersection{wxGauge::SetRange}\label{wxgaugesetrange}
\func{void}{SetRange}{\param{int }{range}}
Sets the range (maximum value) of the gauge.
\wxheading{See also}
\helpref{wxGauge::GetRange}{wxgaugegetrange}
\membersection{wxGauge::SetShadowWidth}\label{wxgaugesetshadowwidth}
\func{void}{SetShadowWidth}{\param{int }{width}}
Sets the 3D shadow width.
\wxheading{Remarks}
Windows only, not for {\bf wxGA\_PROGRESSBAR}.
\membersection{wxGauge::SetValue}\label{wxgaugesetvalue}
\func{void}{SetValue}{\param{int }{pos}}
Sets the position of the gauge.
\wxheading{Parameters}
\docparam{pos}{Position for the gauge level.}
\wxheading{See also}
\helpref{wxGauge::GetValue}{wxgaugegetvalue}