X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/81d66cf39f810503baed79213bc3122fda0ccc7b..88594d02eb59a55ac85d3210a49d02918124617b:/docs/latex/wx/statusbr.tex diff --git a/docs/latex/wx/statusbr.tex b/docs/latex/wx/statusbr.tex index 965e30bc28..976d90ddc7 100644 --- a/docs/latex/wx/statusbr.tex +++ b/docs/latex/wx/statusbr.tex @@ -8,6 +8,16 @@ be variable length according to the size of the window. \helpref{wxEvtHandler}{wxevthandler}\\ \helpref{wxObject}{wxobject} +\wxheading{Derived from} + +\helpref{wxWindow}{wxwindow}\\ +\helpref{wxEvtHandler}{wxevthandler}\\ +\helpref{wxObject}{wxobject} + +\wxheading{Include files} + + + \wxheading{Window styles} \twocolwidtha{5cm} @@ -25,7 +35,7 @@ from an {\bf OnSize} event handler. \wxheading{See also} -\helpref{wxFrame}{wxframe} +\helpref{wxFrame}{wxframe}, \helpref{Status bar sample}{samplestatbar} \latexignore{\rtfignore{\wxheading{Members}}} @@ -101,6 +111,9 @@ TRUE if the field index is valid, FALSE otherwise. \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} @@ -125,68 +138,71 @@ The status field string if the field is valid, otherwise the empty string. \helpref{wxStatusBar::SetStatusText}{wxstatusbarsetstatustext} -\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} +%% 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::SetFieldsCount}\label{wxstatusbarsetfieldscount} @@ -194,6 +210,12 @@ and refreshes the window. Sets the number of fields, and optionally the field widths. +\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. +Use SetStatusWidths to set the field widths.} + \wxheading{Parameters} \docparam{number}{The number of fields.} @@ -202,6 +224,14 @@ Sets the number of fields, and optionally the field widths. in pixels. A value of -1 indicates that the field is variable width; at least one field must be -1.} +\membersection{wxStatusBar::SetMinHeight}\label{wxstatusbarsetminheight} + +\func{void}{SetMinHeight}{\param{int}{ height}} + +Sets the minimal possible hight for the status bar. The real height may be +bigger than the height specified here depending on the size of the font used by +the status bar. + \membersection{wxStatusBar::SetStatusText}\label{wxstatusbarsetstatustext} \func{virtual void}{SetStatusText}{\param{const wxString\& }{text}, \param{int}{ i = 0}} @@ -222,24 +252,40 @@ Sets the text for one field. \func{virtual void}{SetStatusWidths}{\param{int}{ n}, \param{int *}{widths}} -Sets the widths of the fields in the status line. +Sets the widths of the fields in the status line. There are two types of +fields: fixed widths one and variable width fields. For the fixed width fields +you should specify their (constant) width in pixels. For the variable width +fields, specify a negative number which indicates how should the field expand: +the space left for all variable width fields is divided between them according +to the absolute value of this number. A variable width field with width of $-2$ +gets twice as much of it as a field with width $-1$ and so on. + +For example, to create one fixed width field of width $50$ in the right part of +the status bar and two more fields which get $66$\% and $33$\% of the remaining +space correspondingly, you should use an array containing $-2$, $-1$ and $100$. \wxheading{Parameters} -\docparam{n}{The number of fields in the status bar.} +\docparam{n}{The number of fields in the status bar. Must be equal to the +number passed to \helpref{SetFieldsCount}{wxstatusbarsetfieldscount} the last +time it was called.} -\docparam{widths}{Must contain 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. You should delete this array after calling {\bf SetStatusWidths}.} +\docparam{widths}{Contains an array of {\it n} integers, each of which is +either an absolute status field width in pixels if positive or indicates a +variable width field if negative} \wxheading{Remarks} The widths of the variable fields are calculated from the total width of all fields, -minus the sum of widths of the non-variable fields, divided by the number of +minus the sum of widths of the non-variable fields, divided by the number of variable fields. \wxheading{See also} \helpref{wxStatusBar::SetFieldsCount}{wxstatusbarsetfieldscount}, \helpref{wxFrame::SetStatusWidths}{wxframesetstatuswidths} +\pythonnote{Only a single parameter is required, a Python list of +integers.} + +\perlnote{In wxPerl this method takes as parameters the field widths.}