X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c894d475daeb2463152c44640b1d90239c8e2723..2cb94e7ad66471a655561084056bfc77ccf6d0ac:/docs/latex/wx/window.tex diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex index 7fdb71cc7f..e61faddd2a 100644 --- a/docs/latex/wx/window.tex +++ b/docs/latex/wx/window.tex @@ -615,32 +615,32 @@ The search is recursive in both cases. \helpref{FindWindow}{wxwindowfindwindow} -\membersection{wxWindow::FindWindowByName}\label{wxwindowfindwindowbyname} +\membersection{wxWindow::FindWindowByLabel}\label{wxwindowfindwindowbylabel} -\func{static wxWindow*}{FindWindowByName}{\param{const wxString\&}{ name}, \param{wxWindow*}{ parent = NULL}} +\func{static wxWindow*}{FindWindowByLabel}{\param{const wxString\&}{ label}, \param{wxWindow*}{ parent = NULL}} -Find a window by its name (as given in a window constructor or {\bf Create} function call). -If {\it parent} is NULL, the search will start from all top-level +Find a window by its label. Depending on the type of window, the label may be a window title +or panel item label. If {\it parent} is NULL, the search will start from all top-level frames and dialog boxes; if non-NULL, the search will be limited to the given window hierarchy. The search is recursive in both cases. -If no window with such name is found, -\helpref{FindWindowByLabel}{wxwindowfindwindowbylabel} is called. - \wxheading{See also} \helpref{FindWindow}{wxwindowfindwindow} -\membersection{wxWindow::FindWindowByLabel}\label{wxwindowfindwindowbylabel} +\membersection{wxWindow::FindWindowByName}\label{wxwindowfindwindowbyname} -\func{static wxWindow*}{FindWindowByLabel}{\param{const wxString\&}{ label}, \param{wxWindow*}{ parent = NULL}} +\func{static wxWindow*}{FindWindowByName}{\param{const wxString\&}{ name}, \param{wxWindow*}{ parent = NULL}} -Find a window by its label. Depending on the type of window, the label may be a window title -or panel item label. If {\it parent} is NULL, the search will start from all top-level +Find a window by its name (as given in a window constructor or {\bf Create} function call). +If {\it parent} is NULL, the search will start from all top-level frames and dialog boxes; if non-NULL, the search will be limited to the given window hierarchy. The search is recursive in both cases. +If no window with such name is found, +\helpref{FindWindowByLabel}{wxwindowfindwindowbylabel} is called. + \wxheading{See also} \helpref{FindWindow}{wxwindowfindwindow} @@ -772,13 +772,6 @@ same as the size the window would have had after calling \helpref{Fit}{wxwindowfit}. -\membersection{wxWindow::GetCaret}\label{wxwindowgetcaret} - -\constfunc{wxCaret *}{GetCaret}{\void} - -Returns the \helpref{caret}{wxcaret} associated with the window. - - \membersection{wxWindow::GetCapture}\label{wxwindowgetcapture} \func{static wxWindow *}{GetCapture}{\void} @@ -793,6 +786,13 @@ Returns the currently captured window. \helpref{wxMouseCaptureChangedEvent}{wxmousecapturechangedevent} +\membersection{wxWindow::GetCaret}\label{wxwindowgetcaret} + +\constfunc{wxCaret *}{GetCaret}{\void} + +Returns the \helpref{caret}{wxcaret} associated with the window. + + \membersection{wxWindow::GetCharHeight}\label{wxwindowgetcharheight} \constfunc{virtual int}{GetCharHeight}{\void} @@ -1498,8 +1498,11 @@ This is just a wrapper for \helpref{ScrollLines}{wxwindowscrolllines}$(-1)$. \func{void}{Lower}{\void} -Lowers the window to the bottom of the window hierarchy if it is a managed window (dialog -or frame). +Lowers the window to the bottom of the window hierarchy. + +\wxheading{See also} + +\helpref{Raise}{wxwindowraise} \membersection{wxWindow::MakeModal}\label{wxwindowmakemodal} @@ -2217,8 +2220,13 @@ remove the event handler. \func{void}{Raise}{\void} -Raises the window to the top of the window hierarchy if it is a managed window (dialog -or frame). +Raises the window to the top of the window hierarchy. + +In current version of wxWidgets this works both for manage and child windows. + +\wxheading{See also} + +\helpref{Lower}{wxwindowlower} \membersection{wxWindow::Refresh}\label{wxwindowrefresh} @@ -2440,14 +2448,14 @@ Physically scrolls the pixels in the window and move child windows accordingly. \docparam{dy}{Amount to scroll vertically.} -\docparam{rect}{Rectangle to invalidate. If this is NULL, the whole window is invalidated. If you -pass a rectangle corresponding to the area of the window exposed by the scroll, your painting handler -can optimize painting by checking for the invalidated region. This parameter is ignored under GTK.} +\docparam{rect}{Rectangle to scroll, if it is \NULL, the whole window is +scrolled (this is always the case under wxGTK which doesn't support this +parameter)} \wxheading{Remarks} -Use this function to optimise your scrolling implementations, to minimise the area that must be -redrawn. Note that it is rarely required to call this function from a user program. +Note that you can often use \helpref{wxScrolledWindow}{wxscrolledwindow} +instead of using this function directly. \membersection{wxWindow::SetAcceleratorTable}\label{wxwindowsetacceleratortable} @@ -2601,36 +2609,6 @@ implements the following methods:\par } -\membersection{wxWindow::SetContainingSizer}\label{wxwindowsetcontainingsizer} - -\func{void}{SetContainingSizer}{\param{wxSizer* }{sizer}} - -This normally does not need to be called by user code. It is called -when a window is added to a sizer, and is used so the window can -remove itself from the sizer when it is destroyed. - - -\membersection{wxWindow::SetCursor}\label{wxwindowsetcursor} - -\func{virtual void}{SetCursor}{\param{const wxCursor\&}{cursor}} - -% VZ: the docs are correct, if the code doesn't behave like this, it must be -% changed -Sets the window's cursor. Notice that the window cursor also sets it for the -children of the window implicitly. - -The {\it cursor} may be {\tt wxNullCursor} in which case the window cursor will -be reset back to default. - -\wxheading{Parameters} - -\docparam{cursor}{Specifies the cursor that the window should normally display.} - -\wxheading{See also} - -\helpref{::wxSetCursor}{wxsetcursor}, \helpref{wxCursor}{wxcursor} - - \membersection{wxWindow::SetConstraints}\label{wxwindowsetconstraints} \func{void}{SetConstraints}{\param{wxLayoutConstraints* }{constraints}} @@ -2652,66 +2630,34 @@ the constraints automatically in OnSize; otherwise, you must override OnSize and explicitly. When setting both a wxLayoutConstraints and a \helpref{wxSizer}{wxsizer}, only the sizer will have effect. -\membersection{wxWindow::SetInitialBestSize}\label{wxwindowsetinitialbestsize} - -\func{virtual void}{SetInitialBestSize}{\param{const wxSize\& }{size}} - -Sets the initial window size if none is given (i.e. at least one of the -components of the size passed to ctor/Create() is wxDefaultCoord). - -\membersection{wxWindow::SetMaxSize}\label{wxwindowsetmaxsize} - -\func{void}{SetMaxSize}{\param{const wxSize\& }{size}} - -Sets the maximum size of the window, to indicate to the sizer layout mechanism -that this is the maximum possible size. - -\membersection{wxWindow::SetMinSize}\label{wxwindowsetminsize} - -\func{void}{SetMinSize}{\param{const wxSize\& }{size}} - -Sets the minimum size of the window, to indicate to the sizer layout mechanism -that this is the minimum required size. You may need to call this -if you change the window size after construction and before adding -to its parent sizer. - -\membersection{wxWindow::SetOwnBackgroundColour}\label{wxwindowsetownbackgroundcolour} - -\func{void}{SetOwnBackgroundColour}{\param{const wxColour\& }{colour}} - -Sets the background colour of the window but prevents it from being inherited -by the children of this window. - -\wxheading{See also} - -\helpref{SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp -\helpref{InheritAttributes}{wxwindowinheritattributes} +\membersection{wxWindow::SetContainingSizer}\label{wxwindowsetcontainingsizer} +\func{void}{SetContainingSizer}{\param{wxSizer* }{sizer}} -\membersection{wxWindow::SetOwnFont}\label{wxwindowsetownfont} +This normally does not need to be called by user code. It is called +when a window is added to a sizer, and is used so the window can +remove itself from the sizer when it is destroyed. -\func{void}{SetOwnFont}{\param{const wxFont\& }{font}} -Sets the font of the window but prevents it from being inherited by the -children of this window. - -\wxheading{See also} +\membersection{wxWindow::SetCursor}\label{wxwindowsetcursor} -\helpref{SetFont}{wxwindowsetfont},\rtfsp -\helpref{InheritAttributes}{wxwindowinheritattributes} +\func{virtual void}{SetCursor}{\param{const wxCursor\&}{cursor}} +% VZ: the docs are correct, if the code doesn't behave like this, it must be +% changed +Sets the window's cursor. Notice that the window cursor also sets it for the +children of the window implicitly. -\membersection{wxWindow::SetOwnForegroundColour}\label{wxwindowsetownforegroundcolour} +The {\it cursor} may be {\tt wxNullCursor} in which case the window cursor will +be reset back to default. -\func{void}{SetOwnForegroundColour}{\param{const wxColour\& }{colour}} +\wxheading{Parameters} -Sets the foreground colour of the window but prevents it from being inherited -by the children of this window. +\docparam{cursor}{Specifies the cursor that the window should normally display.} \wxheading{See also} -\helpref{SetForegroundColour}{wxwindowsetforegroundcolour},\rtfsp -\helpref{InheritAttributes}{wxwindowinheritattributes} +\helpref{::wxSetCursor}{wxsetcursor}, \helpref{wxCursor}{wxcursor} \membersection{wxWindow::SetDropTarget}\label{wxwindowsetdroptarget} @@ -2729,6 +2675,13 @@ If the window already has a drop target, it is deleted. +\membersection{wxWindow::SetInitialBestSize}\label{wxwindowsetinitialbestsize} + +\func{virtual void}{SetInitialBestSize}{\param{const wxSize\& }{size}} + +Sets the initial window size if none is given (i.e. at least one of the +components of the size passed to ctor/Create() is wxDefaultCoord). + \membersection{wxWindow::SetEventHandler}\label{wxwindowseteventhandler} \func{void}{SetEventHandler}{\param{wxEvtHandler* }{handler}} @@ -2923,6 +2876,22 @@ Sets the window's label. \helpref{wxWindow::GetLabel}{wxwindowgetlabel} +\membersection{wxWindow::SetMaxSize}\label{wxwindowsetmaxsize} + +\func{void}{SetMaxSize}{\param{const wxSize\& }{size}} + +Sets the maximum size of the window, to indicate to the sizer layout mechanism +that this is the maximum possible size. + +\membersection{wxWindow::SetMinSize}\label{wxwindowsetminsize} + +\func{void}{SetMinSize}{\param{const wxSize\& }{size}} + +Sets the minimum size of the window, to indicate to the sizer layout mechanism +that this is the minimum required size. You may need to call this +if you change the window size after construction and before adding +to its parent sizer. + \membersection{wxWindow::SetName}\label{wxwindowsetname} \func{virtual void}{SetName}{\param{const wxString\& }{name}} @@ -2938,6 +2907,45 @@ Sets the window's name. \helpref{wxWindow::GetName}{wxwindowgetname} +\membersection{wxWindow::SetOwnBackgroundColour}\label{wxwindowsetownbackgroundcolour} + +\func{void}{SetOwnBackgroundColour}{\param{const wxColour\& }{colour}} + +Sets the background colour of the window but prevents it from being inherited +by the children of this window. + +\wxheading{See also} + +\helpref{SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp +\helpref{InheritAttributes}{wxwindowinheritattributes} + + +\membersection{wxWindow::SetOwnFont}\label{wxwindowsetownfont} + +\func{void}{SetOwnFont}{\param{const wxFont\& }{font}} + +Sets the font of the window but prevents it from being inherited by the +children of this window. + +\wxheading{See also} + +\helpref{SetFont}{wxwindowsetfont},\rtfsp +\helpref{InheritAttributes}{wxwindowinheritattributes} + + +\membersection{wxWindow::SetOwnForegroundColour}\label{wxwindowsetownforegroundcolour} + +\func{void}{SetOwnForegroundColour}{\param{const wxColour\& }{colour}} + +Sets the foreground colour of the window but prevents it from being inherited +by the children of this window. + +\wxheading{See also} + +\helpref{SetForegroundColour}{wxwindowsetforegroundcolour},\rtfsp +\helpref{InheritAttributes}{wxwindowinheritattributes} + + \membersection{wxWindow::SetPalette}\label{wxwindowsetpalette} \func{virtual void}{SetPalette}{\param{wxPalette* }{palette}} @@ -3133,16 +3141,20 @@ value should be used.} \docparam{sizeFlags}{Indicates the interpretation of other parameters. It is a bit list of the following: -{\bf wxSIZE\_AUTO\_WIDTH}: a -1 width value is taken to indicate +{\bf wxSIZE\_AUTO\_WIDTH}: a $-1$ width value is taken to indicate a wxWidgets-supplied default width.\\ -{\bf wxSIZE\_AUTO\_HEIGHT}: a -1 height value is taken to indicate +{\bf wxSIZE\_AUTO\_HEIGHT}: a $-1$ height value is taken to indicate a wxWidgets-supplied default width.\\ {\bf wxSIZE\_AUTO}: -1 size values are taken to indicate a wxWidgets-supplied default size.\\ {\bf wxSIZE\_USE\_EXISTING}: existing dimensions should be used if -1 values are supplied.\\ -{\bf wxSIZE\_ALLOW\_MINUS\_ONE}: allow dimensions of -1 and less to be interpreted +{\bf wxSIZE\_ALLOW\_MINUS\_ONE}: allow dimensions of $-1$ and less to be interpreted as real dimensions, not default values. +{\bf wxSIZE\_FORCE}: normally, if the position and the size of the window are +already the same as the parameters of this function, nothing is done. but with +this flag a window resize may be forced even in this case (supported in wx +2.6.2 and later and only implemented for MSW and ignored elsewhere currently) } \wxheading{Remarks} @@ -3248,21 +3260,6 @@ The same as \helpref{SetSizer}{wxwindowsetsizer}, except it also sets the size h for the window based on the sizer's minimum size. -\membersection{wxWindow::SetTitle}\label{wxwindowsettitle} - -\func{virtual void}{SetTitle}{\param{const wxString\& }{title}} - -Sets the window's title. Applicable only to frames and dialogs. - -\wxheading{Parameters} - -\docparam{title}{The window's title.} - -\wxheading{See also} - -\helpref{wxWindow::GetTitle}{wxwindowgettitle} - - \membersection{wxWindow::SetThemeEnabled}\label{wxwindowsetthemeenabled} \func{virtual void}{SetThemeEnabled}{\param{bool }{enable}} @@ -3278,6 +3275,21 @@ Dialogs, notebook pages and the status bar have this flag set to true by default so that the default look and feel is simulated best. +\membersection{wxWindow::SetTitle}\label{wxwindowsettitle} + +\func{virtual void}{SetTitle}{\param{const wxString\& }{title}} + +Sets the window's title. Applicable only to frames and dialogs. + +\wxheading{Parameters} + +\docparam{title}{The window's title.} + +\wxheading{See also} + +\helpref{wxWindow::GetTitle}{wxwindowgettitle} + + \membersection{wxWindow::SetToolTip}\label{wxwindowsettooltip} \func{void}{SetToolTip}{\param{const wxString\& }{tip}}