X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/00a77b7c5d9e1714198cd5d7e3a905bca2df2534..c52b96359b639cda516615f9433d3b20b35443b5:/docs/latex/wx/window.tex?ds=inline diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex index d19f545197..e100561a9d 100644 --- a/docs/latex/wx/window.tex +++ b/docs/latex/wx/window.tex @@ -219,6 +219,26 @@ called by the user code. \docparam{child}{Child window to add.} +\membersection{wxWindow::AlwaysShowScrollbars}\label{wxwindowalwaysshowscrollbars} + +\func{void}{AlwaysShowScrollbars}{\param{bool}{ hflag}, \param{bool}{ vflag}} + +Call this function to force one or both scrollbars to be always shown, even if +the window is big enough to show its entire contents without scrolling. + +\newsince{2.9.0} + +\wxheading{Parameters} + +\docparam{hflag}{Whether the horizontal scroll bar should always be visible.} + +\docparam{vflag}{Whether the vertical scroll bar should always be visible.} + +\wxheading{Remarks} + +This function is currently only implemented under Mac/Carbon. + + \membersection{wxWindow::CacheBestSize}\label{wxwindowcachebestsize} \constfunc{void}{CacheBestSize}{\param{const wxSize\& }{size}} @@ -226,6 +246,16 @@ called by the user code. Sets the cached best size value. +\membersection{wxWindow::CanSetTransparent}\label{wxwindowcansettransparent} + +\func{bool}{CanSetTransparent}{\void} + +Returns \true if the system supports transparent windows and calling +\helpref{SetTransparent}{wxwindowsettransparent} may succeed. If this function +returns \false, transparent windows are definitely not supported by the current +system. + + \membersection{wxWindow::CaptureMouse}\label{wxwindowcapturemouse} \func{virtual void}{CaptureMouse}{\void} @@ -775,19 +805,32 @@ Returns the background colour of the window. \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. +Returns the background style of the window. The background style can be one of: +\begin{twocollist}\itemsep=0pt +\twocolitem{wxBG\_STYLE\_SYSTEM}{Use the default background, as determined by +the system or the current theme.} +\twocolitem{wxBG\_STYLE\_COLOUR}{Use a solid colour for the background, this +style is set automatically if you call +\helpref{SetBackgroundColour}{wxwindowsetbackgroundcolour} so you only need to +set it explicitly if you had changed the background style to something else +before.} +\twocolitem{wxBG\_STYLE\_CUSTOM}{Don't draw the background at all, it's +supposed that it is drawn by the user-defined erase background event handler. +This style should be used to avoid flicker when the background is entirely +custom-drawn.} +\twocolitem{wxBG\_STYLE\_TRANSPARET}{The background is (partially) transparent, +this style is automatically set if you call +\helpref{SetTransparent}{wxwindowsettransparent} which is used to set the +transparency level.} +\end{twocollist} \wxheading{See also} \helpref{wxWindow::SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp \helpref{wxWindow::GetForegroundColour}{wxwindowgetforegroundcolour},\rtfsp -\helpref{wxWindow::SetBackgroundStyle}{wxwindowsetbackgroundstyle} +\helpref{wxWindow::SetBackgroundStyle}{wxwindowsetbackgroundstyle},\rtfsp +\helpref{wxWindow::SetTransparent}{wxwindowsettransparent} + \membersection{wxWindow::GetEffectiveMinSize}\label{wxwindowgeteffectiveminsize} @@ -1154,6 +1197,20 @@ name in the window constructor or via \helpref{wxWindow::SetName}{wxwindowsetnam \helpref{wxWindow::SetName}{wxwindowsetname} +\membersection{wxWindow::GetNextSibling}\label{wxwindowgetnextsibling} + +\constfunc{wxWindow *}{GetNextSibling}{\void} + +Returns the next window after this one among the parent children or \NULL if +this window is the last child. + +\newsince{2.8.8} + +\wxheading{See also} + +\helpref{GetPrevSibling}{wxwindowgetprevsibling} + + \membersection{wxWindow::GetParent}\label{wxwindowgetparent} \constfunc{virtual wxWindow*}{GetParent}{\void} @@ -1227,6 +1284,20 @@ method:\par \helpref{GetScreenPosition}{wxwindowgetscreenposition} +\membersection{wxWindow::GetPrevSibling}\label{wxwindowgetprevsibling} + +\constfunc{wxWindow *}{GetPrevSibling}{\void} + +Returns the previous window before this one among the parent children or \NULL if +this window is the first child. + +\newsince{2.8.8} + +\wxheading{See also} + +\helpref{GetNextSibling}{wxwindowgetnextsibling} + + \membersection{wxWindow::GetRect}\label{wxwindowgetrect} \constfunc{virtual wxRect}{GetRect}{\void} @@ -1663,6 +1734,21 @@ Returns {\tt true} if the window is retained, {\tt false} otherwise. Retained windows are only available on X platforms. +\membersection{wxWindow::IsScrollbarAlwaysShown}\label{wxwindowisscrollbaralwaysshown} + +\func{bool}{IsScrollbarAlwaysShown}{\param{int}{ orient}} + +Return whether a scrollbar is always shown. + +\wxheading{Parameters} + +\docparam{orient}{Orientation to check, either {\tt wxHORIZONTAL} or {\tt wxVERTICAL}.} + +\wxheading{See also} + +\helpref{wxWindow::AlwaysShowScrollbars}{wxwindowalwaysshowscrollbars} + + \membersection{wxWindow::IsShown}\label{wxwindowisshown} \constfunc{virtual bool}{IsShown}{\void} @@ -2793,19 +2879,15 @@ applications on the system. \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. +Sets the background style of the window. see +\helpref{GetBackgroundStyle()}{wxwindowgetbackgroundstyle} for the description +of the possible style values. \wxheading{See also} \helpref{wxWindow::SetBackgroundColour}{wxwindowsetbackgroundcolour},\rtfsp \helpref{wxWindow::GetForegroundColour}{wxwindowgetforegroundcolour},\rtfsp -\helpref{wxWindow::GetBackgroundStyle}{wxwindowgetbackgroundstyle} +\helpref{wxWindow::SetTransparent}{wxwindowsettransparent} @@ -3545,6 +3627,20 @@ See also: \helpref{GetToolTip}{wxwindowgettooltip}, \helpref{wxToolTip}{wxtooltip} +\membersection{wxWindow::SetTransparent}\label{wxwindowsettransparent} + +\func{bool}{SetTransparent}{\param{wxByte }{alpha}} + +Set the transparency of the window. If the system supports transparent windows, +returns \true, otherwise returns \false and the window remains fully opaque. +See also \helpref{CanSetTransparent}{wxwindowcansettransparent}. + +The parameter \arg{alpha} is in the range $0..255$ where $0$ corresponds to a +fully transparent window and $255$ to the fully opaque one. The constants +\texttt{wxIMAGE\_ALPHA\_TRANSPARENT} and \texttt{wxIMAGE\_ALPHA\_OPAQUE} can be +used. + + \membersection{wxWindow::SetValidator}\label{wxwindowsetvalidator} \func{virtual void}{SetValidator}{\param{const wxValidator\&}{ validator}}