X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/fe161a2685012cf90bb5bfe95f2260aee71d8ad7..917be7ed065337e8a7a67615969ecaade9eea809:/docs/latex/wx/window.tex?ds=inline diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex index 4386be9e9b..437cd23a79 100644 --- a/docs/latex/wx/window.tex +++ b/docs/latex/wx/window.tex @@ -1,6 +1,6 @@ \section{\class{wxWindow}}\label{wxwindow} -wxWindow is the base class for all windows and represents any visible objecto n +wxWindow is the base class for all windows and represents any visible object on screen. All controls, top level windows and so on are windows. Sizers and device contexts are not, however, as they don't appear on screen themselves. @@ -142,7 +142,7 @@ correctly sized. } \docparam{name}{Window name.} -\membersection{wxWindow::\destruct{wxWindow}} +\membersection{wxWindow::\destruct{wxWindow}}\label{wxwindowdtor} \func{}{\destruct{wxWindow}}{\void} @@ -158,7 +158,7 @@ can delete a window only when it is safe to do so, in idle time. \helpref{wxCloseEvent}{wxcloseevent} -\membersection{wxWindow::AddChild} +\membersection{wxWindow::AddChild}\label{wxwindowaddchild} \func{virtual void}{AddChild}{\param{wxWindow* }{child}} @@ -173,6 +173,13 @@ called by the user code. \docparam{child}{Child window to add.} +\membersection{wxWindow::CacheBestSize}\label{wxwindowcachebestsize} + +\constfunc{void}{CacheBestSize}{\param{const wxSize\& }{size}} + +Sets the cached best size value. + + \membersection{wxWindow::CaptureMouse}\label{wxwindowcapturemouse} \func{virtual void}{CaptureMouse}{\void} @@ -287,7 +294,7 @@ Clears the window by filling it with the current background colour. Does not cause an erase background event to be generated. -\membersection{wxWindow::ClientToScreen} +\membersection{wxWindow::ClientToScreen}\label{wxwindowclienttoscreen} \constfunc{virtual void}{ClientToScreen}{\param{int* }{x}, \param{int* }{y}} @@ -426,7 +433,7 @@ Dialog units are used for maintaining a dialog's proportions even if the font ch \helpref{wxWindow::ConvertDialogToPixels}{wxwindowconvertdialogtopixels} -\pythonnote{In place of a single overloaded method name, wxPythonimplements the following methods:\par +\pythonnote{In place of a single overloaded method name, wxPython implements the following methods:\par \indented{2cm}{\begin{twocollist} \twocolitem{{\bf ConvertDialogPointToPixels(point)}}{Accepts and returns a wxPoint} \twocolitem{{\bf ConvertDialogSizeToPixels(size)}}{Accepts and returns a wxSize} @@ -451,7 +458,7 @@ windows. to the list of windows pending real deletion. -\membersection{wxWindow::DestroyChildren} +\membersection{wxWindow::DestroyChildren}\label{wxwindowdestroychildren} \func{virtual void}{DestroyChildren}{\void} @@ -470,6 +477,15 @@ Returns {\tt true} if the window has been disabled, {\tt false} if it had been already disabled before the call to this function. +\membersection{wxWindow::DoGetBestSize}\label{wxwindowdogetbestsize} + +\constfunc{virtual wxSize}{DoGetBestSize}{\void} + +Gets the size which best suits the window: for a control, it would be +the minimal size which doesn't truncate the control, for a panel - the +same size as it would have after a call to \helpref{Fit()}{wxwindowfit}. + + \membersection{wxWindow::DoUpdateWindowUI}\label{wxwindowdoupdatewindowui} \func{virtual void}{DoUpdateWindowUI}{\param{wxUpdateUIEvent\&}{ event}} @@ -655,8 +671,8 @@ be called to reenable window redrawing. Calls to these two functions may be nested. This method is useful for visual appearance optimization (for example, it -is a good idea to use it before inserting large amount of text into a -wxTextCtrl under wxGTK) but is not implemented on all platforms nor for all +is a good idea to use it before doing many large text insertions in a row into +a wxTextCtrl under wxGTK) but is not implemented on all platforms nor for all controls so it is mostly just a hint to wxWidgets and not a mandatory directive. @@ -670,7 +686,7 @@ Gets the accelerator table for this window. See \helpref{wxAcceleratorTable}{wxa \membersection{wxWindow::GetAccessible}\label{wxwindowgetaccessible} -\func{wxAccessibile*}{GetAccessible}{\void} +\func{wxAccessible*}{GetAccessible}{\void} Returns the accessible object for this window, if any. @@ -700,6 +716,36 @@ Returns the background colour of the window. \helpref{wxWindow::SetForegroundColour}{wxwindowsetforegroundcolour},\rtfsp \helpref{wxWindow::GetForegroundColour}{wxwindowgetforegroundcolour} +\membersection{wxWindow::GetBackgroundStyle}\label{wxwindowgetbackgroundstyle} + +\constfunc{virtual wxBackgroundStyle}{GetBackgroundStyle}{\void} + +Returns the background style of the window. The background style indicates +whether background colour should be determined by the system (wxBG\_STYLE\_SYSTEM), +be set to a specific colour (wxBG\_STYLE\_COLOUR), or should be left to the +application to implement (wxBG\_STYLE\_CUSTOM). + +On GTK+, use of wxBG\_STYLE\_CUSTOM allows the flicker-free drawing of a custom +background, such as a tiled bitmap. Currently the style has no effect on other platforms. + +\wxheading{See also} + +\helpref{wxWindow::SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp +\helpref{wxWindow::GetForegroundColour}{wxwindowgetforegroundcolour},\rtfsp +\helpref{wxWindow::SetBackgroundStyle}{wxwindowsetbackgroundstyle} + +\membersection{wxWindow::GetBestFittingSize}\label{wxwindowgetbestfittingsize} + +\constfunc{wxSize}{GetBestFittingSize}{\void} + +Merges the window's best size into the min size and returns the result. + +\wxheading{See also} + +\helpref{wxWindow::GetBestSize}{wxwindowgetbestsize},\rtfsp +\helpref{wxWindow::SetBestFittingSize}{wxwindowsetbestfittingsize},\rtfsp +\helpref{wxWindow::SetSizeHints}{wxwindowsetsizehints} + \membersection{wxWindow::GetBestSize}\label{wxwindowgetbestsize} @@ -734,28 +780,28 @@ Returns the currently captured window. \helpref{wxMouseCaptureChangedEvent}{wxmousecapturechangedevent} -\membersection{wxWindow::GetCharHeight} +\membersection{wxWindow::GetCharHeight}\label{wxwindowgetcharheight} \constfunc{virtual int}{GetCharHeight}{\void} Returns the character height for this window. -\membersection{wxWindow::GetCharWidth} +\membersection{wxWindow::GetCharWidth}\label{wxwindowgetcharwidth} \constfunc{virtual int}{GetCharWidth}{\void} Returns the average character width for this window. -\membersection{wxWindow::GetChildren} +\membersection{wxWindow::GetChildren}\label{wxwindowgetchildren} \func{wxList\&}{GetChildren}{\void} Returns a reference to the list of the window's children. -\membersection{wxControl::GetClassDefaultAttributes}\label{wxwindowgetclassdefaultattributes} +\membersection{wxWindow::GetClassDefaultAttributes}\label{wxwindowgetclassdefaultattributes} \func{static wxVisualAttributes}{GetClassDefaultAttributes}{\param{wxWindowVariant}{ variant = \texttt{wxWINDOW\_VARIANT\_NORMAL}}} @@ -846,7 +892,7 @@ Return the cursor associated with this window. \helpref{wxWindow::SetCursor}{wxwindowsetcursor} -\membersection{wxControl::GetDefaultAttributes}\label{wxwindowgetdefaultattributes} +\membersection{wxWindow::GetDefaultAttributes}\label{wxwindowgetdefaultattributes} \constfunc{virtual wxVisualAttributes}{GetDefaultAttributes}{\void} @@ -902,9 +948,9 @@ Returns the extra style bits for the window. \membersection{wxWindow::GetFont}\label{wxwindowgetfont} -\constfunc{wxFont\&}{GetFont}{\void} +\constfunc{wxFont}{GetFont}{\void} -Returns a reference to the font for this window. +Returns the font for this window. \wxheading{See also} @@ -930,7 +976,7 @@ be used at all. \helpref{wxWindow::GetBackgroundColour}{wxwindowgetbackgroundcolour} -\membersection{wxWindow::GetGrandParent} +\membersection{wxWindow::GetGrandParent}\label{wxwindowgetgrandparent} \constfunc{wxWindow*}{GetGrandParent}{\void} @@ -980,7 +1026,7 @@ Each window has an integer identifier. If the application has not provided one \helpref{Window identifiers}{windowids} -\membersection{wxWindow::GetLabel} +\membersection{wxWindow::GetLabel}\label{wxwindowgetlabel} \constfunc{virtual wxString }{GetLabel}{\void} @@ -995,6 +1041,19 @@ the button text. This function can be useful for meta-programs (such as testing tools or special-needs access programs) which need to identify windows by name. +\membersection{wxWindow::GetMaxSize}\label{wxwindowgetmaxsize} + +\constfunc{wxSize}{GetMaxSize}{\void} + +Returns the maximum size of the window, an indication to the sizer layout mechanism +that this is the maximum possible size. + +\membersection{wxWindow::GetMinSize}\label{wxwindowgetminsize} + +\constfunc{wxSize}{GetMinSize}{\void} + +Returns the minimum size of the window, an indication to the sizer layout mechanism +that this is the minimum required size. \membersection{wxWindow::GetName}\label{wxwindowgetname} @@ -1012,7 +1071,7 @@ name in the window constructor or via \helpref{wxWindow::SetName}{wxwindowsetnam \helpref{wxWindow::SetName}{wxwindowsetname} -\membersection{wxWindow::GetParent} +\membersection{wxWindow::GetParent}\label{wxwindowgetparent} \constfunc{virtual wxWindow*}{GetParent}{\void} @@ -1282,15 +1341,15 @@ By ``intelligently'' the following is meant: by default, all windows use their own \helpref{default}{wxwindowgetclassdefaultattributes} attributes. However if some of the parents attributes are explicitly (that is, using \helpref{SetFont}{wxwindowsetfont} and not -\helpref{SetDefaultFont}{wxwindowsetdefaultfont}) changed \emph{and} if the +\helpref{SetOwnFont}{wxwindowsetownfont}) changed \emph{and} if the corresponding attribute hadn't been explicitly set for this window itself, then this window takes the same value as used by the parent. In addition, if the window overrides \helpref{ShouldInheritColours}{wxwindowshouldinheritcolours} to return \false, the colours will not be changed no matter what and only the font might. -This rather complicated logic is necessary in order to accomodate the -different usage scenarius. The most common one is when all default attributes +This rather complicated logic is necessary in order to accommodate the +different usage scenarios. The most common one is when all default attributes are used and in this case, nothing should be inherited as in modern GUIs different controls use different fonts (and colours) than their siblings so they can't inherit the same value from the parent. However it was also deemed @@ -1307,6 +1366,13 @@ Sends an {\tt wxEVT\_INIT\_DIALOG} event, whose handler usually transfers data to the dialog via validators. +\membersection{wxWindow::InvalidateBestSize}\label{wxwindowinvalidatebestsize} + +\func{void}{InvalidateBestSize}{\void} + +Resets the cached best size value so it will be recalculated the next time it is needed. + + \membersection{wxWindow::IsEnabled}\label{wxwindowisenabled} \constfunc{virtual bool}{IsEnabled}{\void} @@ -1448,6 +1514,34 @@ implements the following methods:\par \end{twocollist}} } + +\membersection{wxWindow::MoveAfterInTabOrder}\label{wxwindowmoveafterintaborder} + +\func{void}{MoveAfterInTabOrder}{\param{wxWindow *}{win}} + +Moves this window in the tab navigation order after the specified \arg{win}. +This means that when the user presses \texttt{TAB} key on that other window, +the focus switches to this window. + +Default tab order is the same as creation order, this function and +\helpref{MoveBeforeInTabOrder()}{wxwindowmovebeforeintaborder} allow to change +it after creating all the windows. + +\wxheading{Parameters} + +\docparam{win}{A sibling of this window which should precede it in tab order, +must not be NULL} + + +\membersection{wxWindow::MoveBeforeInTabOrder}\label{wxwindowmovebeforeintaborder} + +\func{void}{MoveBeforeInTabOrder}{\param{wxWindow *}{win}} + +Same as \helpref{MoveAfterInTabOrder}{wxwindowmoveafterintaborder} except that +it inserts this window just before \arg{win} instead of putting it right after +it. + + \membersection{wxWindow::Navigate}\label{wxwindownavigate} \func{bool}{Navigate}{\param{int}{ flags = wxNavigationKeyEvent::IsForward}} @@ -1551,7 +1645,7 @@ and not navigate to the next control. %% %% This function is only relevant to top-level windows (frames and dialogs), and under %% Windows only. Under GTK the normal EVT\_CHAR\_ event has the functionality, i.e. -%% you can intercepts it and if you don't call \helpref{wxEvent::Skip}{wxeventskip} +%% you can intercept it, and if you don't call \helpref{wxEvent::Skip}{wxeventskip} %% the window won't get the event. %% %% \wxheading{See also} @@ -2321,7 +2415,7 @@ Sets the accelerator table for this window. See \helpref{wxAcceleratorTable}{wxa \membersection{wxWindow::SetAccessible}\label{wxwindowsetaccessible} -\func{void}{SetAccessible}{\param{wxAccessibile*}{ accessible}} +\func{void}{SetAccessible}{\param{wxAccessible*}{ accessible}} Sets the accessible for this window. Any existing accessible for this window will be deleted first, if not identical to {\it accessible}. @@ -2358,7 +2452,7 @@ Sets the background colour of the window. Please see \helpref{InheritAttributes}{wxwindowinheritattributes} for explanation of the difference between this method and -\helpref{SetDefaultBackgroundColour}{wxwindowsetdefaultbackgroundcolour}. +\helpref{SetOwnBackgroundColour}{wxwindowsetownbackgroundcolour}. \wxheading{Parameters} @@ -2390,18 +2484,41 @@ applications on the system. \helpref{wxWindow::Refresh}{wxwindowrefresh},\rtfsp \helpref{wxEraseEvent}{wxeraseevent} +\membersection{wxWindow::SetBackgroundStyle}\label{wxwindowsetbackgroundstyle} + +\func{virtual void}{SetBackgroundStyle}{\param{wxBackgroundStyle}{ style}} + +Sets the background style of the window. The background style indicates +whether background colour should be determined by the system (wxBG\_STYLE\_SYSTEM), +be set to a specific colour (wxBG\_STYLE\_COLOUR), or should be left to the +application to implement (wxBG\_STYLE\_CUSTOM). + +On GTK+, use of wxBG\_STYLE\_CUSTOM allows the flicker-free drawing of a custom +background, such as a tiled bitmap. Currently the style has no effect on other platforms. + +\wxheading{See also} + +\helpref{wxWindow::SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp +\helpref{wxWindow::GetForegroundColour}{wxwindowgetforegroundcolour},\rtfsp +\helpref{wxWindow::GetBackgroundStyle}{wxwindowgetbackgroundstyle} + + \membersection{wxWindow::SetBestFittingSize}\label{wxwindowsetbestfittingsize} -\func{void}{SetBestFittingSize}{\param{const wxSize& }{size = wxDefaultSize}} +\func{void}{SetBestFittingSize}{\param{const wxSize\& }{size = wxDefaultSize}} A {\it smart} SetSize that will fill in default size components with the -window's {\it best} size values. Also set's the minsize for use with -sizers. +window's {\it best} size values. Also sets the window's minsize to +the value passed in for use with sizers. This means that if a full or +partial size is passed to this function then the sizers will use that +size instead of the results of GetBestSize to determine the minimum +needs of the window for layout. \wxheading{See also} -\helpref{wxWindow::SetSize}{wxwindowsetsize} -\helpref{wxWindow::GetBestSize}{wxwindowgetbestsize} +\helpref{wxWindow::SetSize}{wxwindowsetsize},\rtfsp +\helpref{wxWindow::GetBestSize}{wxwindowgetbestsize},\rtfsp +\helpref{wxWindow::GetBestFittingSize}{wxwindowgetbestfittingsize},\rtfsp \helpref{wxWindow::SetSizeHints}{wxwindowsetsizehints} @@ -2491,10 +2608,32 @@ 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::SetDefaultBackgroundColour}\label{wxwindowsetdefaultbackgroundcolour} +\membersection{wxWindow::SetOwnBackgroundColour}\label{wxwindowsetownbackgroundcolour} -\func{void}{SetDefaultBackgroundColour}{\param{const wxColour\& }{colour}} +\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. @@ -2505,9 +2644,9 @@ by the children of this window. \helpref{InheritAttributes}{wxwindowinheritattributes} -\membersection{wxWindow::SetDefaultFont}\label{wxwindowsetdefaultfont} +\membersection{wxWindow::SetOwnFont}\label{wxwindowsetownfont} -\func{void}{SetDefaultBackgroundColour}{\param{const wxColour\& }{colour}} +\func{void}{SetOwnBackgroundColour}{\param{const wxColour\& }{colour}} Sets the font of the window but prevents it from being inherited by the children of this window. @@ -2518,9 +2657,9 @@ children of this window. \helpref{InheritAttributes}{wxwindowinheritattributes} -\membersection{wxWindow::SetDefaultForegroundColour}\label{wxwindowsetdefaultforegroundcolour} +\membersection{wxWindow::SetOwnForegroundColour}\label{wxwindowsetownforegroundcolour} -\func{void}{SetDefaultForegroundColour}{\param{const wxColour\& }{colour}} +\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. @@ -2641,7 +2780,7 @@ can be overridden to do something in addition to this in the derived classes. Sets the font for this window. This function should not be called for the parent window if you don't want its font to be inherited by its children, -use \helpref{SetDefaultFont}{wxwindowsetdefaultfont} instead in this case and +use \helpref{SetOwnFont}{wxwindowsetownfont} instead in this case and see \helpref{InheritAttributes}{wxwindowinheritattributes} for more explanations. @@ -2664,7 +2803,7 @@ Sets the foreground colour of the window. Please see \helpref{InheritAttributes}{wxwindowinheritattributes} for explanation of the difference between this method and -\helpref{SetDefaultForegroundColour}{wxwindowsetdefaultforegroundcolour}. +\helpref{SetOwnForegroundColour}{wxwindowsetownforegroundcolour}. \wxheading{Parameters} @@ -3167,7 +3306,7 @@ See \helpref{Window styles}{windowstyles} for more information about flags. This function can be called under all platforms but only does anything under Mac OS X 10.3+ currently. Under this system, each of the standard control can -exist in several sizes which correpond to the elements of wxWindowVariant +exist in several sizes which correspond to the elements of wxWindowVariant enum: \begin{verbatim} enum wxWindowVariant