\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
-\twocolitem{\windowstyle{wxSB\_SIZEGRIP}}{On Windows 95, displays a gripper at right-hand side of
+\twocolitem{\windowstyle{wxST\_SIZEGRIP}}{On Windows 95, displays a gripper at right-hand side of
the status bar.}
\end{twocollist}
Default constructor.
\func{}{wxStatusBar}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
-\param{const wxPoint\&}{ pos = wxDefaultPosition},\rtfsp
-\param{const wxSize\&}{ size = wxDefaultSize}, \param{long}{ style = 0},\rtfsp
+\param{long}{ style = wxST\_SIZEGRIP},\rtfsp
\param{const wxString\& }{name = ``statusBar"}}
Constructor, creating the window.
\docparam{id}{The window identifier. It may take a value of -1 to indicate a default value.}
-\docparam{pos}{The window position. A value of (-1, -1) indicates a default position, chosen by
-either the windowing system or wxWindows, depending on platform.}
-
-\docparam{size}{The window size. A value of (-1, -1) indicates a default size, chosen by
-either the windowing system or wxWindows, depending on platform.}
-
\docparam{style}{The window style. See \helpref{wxStatusBar}{wxstatusbar}.}
\docparam{name}{The name of the window. This parameter is used to associate a name with the item,
\membersection{wxStatusBar::Create}\label{wxstatusbarcreate}
\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
-\param{const wxPoint\&}{ pos = wxDefaultPosition},\rtfsp
-\param{const wxSize\&}{ size = wxDefaultSize}, \param{long}{ style = 0},\rtfsp
+\param{long}{ style = wxST\_SIZEGRIP},\rtfsp
\param{const wxString\& }{name = ``statusBar"}}
Creates the window, for two-step construction.
\wxheading{Return value}
-TRUE if the field index is valid, FALSE otherwise.
+true if the field index is valid, false otherwise.
\wxheading{See also}
\helpref{wxRect}{wxrect}
+\perlnote{In wxPerl this function returns a {\tt Wx::Rect} if the field
+ index is valid, {\tt undef} otherwise.}
+
\membersection{wxStatusBar::GetFieldsCount}\label{wxstatusbargetfieldscount}
\constfunc{int}{GetFieldsCount}{\void}
\helpref{wxStatusBar::SetStatusText}{wxstatusbarsetstatustext}
-%% VZ: these functions are not in wxStatusBar API, these are just
-%% implementation details of wxStatusBarGeneric
-%%
-%% \membersection{wxStatusBar::DrawField}\label{wxstatusbardrawfield}
-%%
-%% \func{virtual void}{DrawField}{\param{wxDC\& }{dc}, \param{int }{i}}
-%%
-%% Draws a field, including shaded borders and text.
-%%
-%% \wxheading{Parameters}
-%%
-%% \docparam{dc}{The device context to draw onto.}
-%%
-%% \docparam{i}{The field to be drawn.}
-%%
-%% \wxheading{See also}
-%%
-%% \helpref{wxStatusBar::DrawFieldText}{wxstatusbardrawfieldtext}
-%%
-%% \membersection{wxStatusBar::DrawFieldText}\label{wxstatusbardrawfieldtext}
-%%
-%% \func{virtual void}{DrawFieldText}{\param{wxDC\& }{dc}, \param{int }{i}}
-%%
-%% Draws a field's text.
-%%
-%% \wxheading{Parameters}
-%%
-%% \docparam{dc}{The device context to draw onto.}
-%%
-%% \docparam{i}{The field whose text is to be drawn.}
-%%
-%% \wxheading{See also}
-%%
-%% \helpref{wxStatusBar::DrawField}{wxstatusbardrawfield}
-%%
-%% \membersection{wxStatusBar::InitColours}\label{wxstatusbarinitcolours}
-%%
-%% \func{virtual void}{InitColours}{\void}
-%%
-%% Sets up the background colour and shading pens using suitable system colours (Windows) or tasteful shades
-%% of grey (other platforms).
-%%
-%% \wxheading{Remarks}
-%%
-%% This function is called when the window is created, and also
-%% from \helpref{wxStatusBar::OnSysColourChanged}{wxstatusbaronsyscolourchanged} on Windows.
-%%
-%% \wxheading{See also}
-%%
-%% \helpref{wxStatusBar::OnSysColourChanged}{wxstatusbaronsyscolourchanged}
-%%
-%% \membersection{wxStatusBar::OnSysColourChanged}\label{wxstatusbaronsyscolourchanged}
-%%
-%% \func{void}{OnSysColourChanged}{\param{wxSysColourChangedEvent\& }{event}}
-%%
-%% Handles a system colour change by calling \helpref{wxStatusBar::InitColours}{wxstatusbarinitcolours},
-%% and refreshes the window.
-%%
-%% \wxheading{Parameters}
-%%
-%% \docparam{event}{The colour change event.}
-%%
-%% \wxheading{See also}
-%%
-%% \helpref{wxStatusBar::InitColours}{wxstatusbarinitcolours}
+\membersection{wxStatusBar::PopStatusText}\label{wxstatusbarpopstatustext}
+
+\func{void}{PopStatusText}{\param{int}{ field = 0}}
+
+Sets the field text to the top of the stack, and pops the stack of saved
+strings.
+
+\wxheading{See also}
+
+\helpref{wxStatusBar::PushStatusText}{wxstatusbarpushstatustext}
+
+\membersection{wxStatusBar::PushStatusText}\label{wxstatusbarpushstatustext}
+
+\func{void}{PushStatusText}{\param{const wxString&}{ string}, \param{int}{ field = 0}}
+
+Saves the current field text in a per field stack, and sets the field text
+to the string passed as argument.
\membersection{wxStatusBar::SetFieldsCount}\label{wxstatusbarsetfieldscount}
\pythonnote{Only the first parameter is accepted. Use SetStatusWidths
to set the widths of the fields.}
-\perlnote{In wxPerl this function acceps only the {\tt n} parameter.
+\perlnote{In wxPerl this function accepts only the {\tt n} parameter.
Use SetStatusWidths to set the field widths.}
\wxheading{Parameters}
\docparam{number}{The number of fields.}
-\docparam{widths}{An array of {\it n} integers, each of which is a status field width
-in pixels. A value of -1 indicates that the field is variable width; at least one
-field must be -1.}
+\docparam{widths}{An array of {\it n} integers interpreted in the same way as
+in \helpref{SetStatusWidths}{wxstatusbarsetstatuswidths}}
\membersection{wxStatusBar::SetMinHeight}\label{wxstatusbarsetminheight}
projects / wxWidgets.git / blobdiff