window.tex

来自「Wxpython Implemented on Windows CE, Sou」· TEX 代码 · 共 1,841 行 · 第 1/5 页

\membersection{wxWindow::IsEnabled}\label{wxwindowisenabled}

\constfunc{virtual bool}{IsEnabled}{\void}

Returns {\tt true} if the window is enabled for input, {\tt false} otherwise.

\wxheading{See also}

\helpref{wxWindow::Enable}{wxwindowenable}


\membersection{wxWindow::IsExposed}\label{wxwindowisexposed}

\constfunc{bool}{IsExposed}{\param{int }{x}, \param{int }{y}}

\constfunc{bool}{IsExposed}{\param{wxPoint }{\&pt}}

\constfunc{bool}{IsExposed}{\param{int }{x}, \param{int }{y}, \param{int }{w}, \param{int }{h}}

\constfunc{bool}{IsExposed}{\param{wxRect }{\&rect}}

Returns {\tt true} if the given point or rectangle area has been exposed since the
last repaint. Call this in an paint event handler to optimize redrawing by
only redrawing those areas, which have been exposed.

\pythonnote{In place of a single overloaded method name, wxPython
implements the following methods:\par
\indented{2cm}{\begin{twocollist}
\twocolitem{{\bf IsExposed(x,y, w=0,h=0)}}{}
\twocolitem{{\bf IsExposedPoint(pt)}}{}
\twocolitem{{\bf IsExposedRect(rect)}}{}
\end{twocollist}}}


\membersection{wxWindow::IsRetained}\label{wxwindowisretained}

\constfunc{virtual bool}{IsRetained}{\void}

Returns {\tt true} if the window is retained, {\tt false} otherwise.

\wxheading{Remarks}

Retained windows are only available on X platforms.


\membersection{wxWindow::IsShown}\label{wxwindowisshown}

\constfunc{virtual bool}{IsShown}{\void}

Returns {\tt true} if the window is shown, {\tt false} if it has been hidden.


\membersection{wxWindow::IsTopLevel}\label{wxwindowistoplevel}

\constfunc{bool}{IsTopLevel}{\void}

Returns {\tt true} if the given window is a top-level one. Currently all frames and
dialogs are considered to be top-level windows (even if they have a parent
window).


\membersection{wxWindow::Layout}\label{wxwindowlayout}

\func{void}{Layout}{\void}

Invokes the constraint-based layout algorithm or the sizer-based algorithm
for this window.

See \helpref{wxWindow::SetAutoLayout}{wxwindowsetautolayout}: when auto
layout is on, this function gets called automatically when the window is resized.


\membersection{wxWindow::LineDown}\label{wxwindowlinedown}

This is just a wrapper for \helpref{ScrollLines}{wxwindowscrolllines}$(1)$.


\membersection{wxWindow::LineUp}\label{wxwindowlineup}

This is just a wrapper for \helpref{ScrollLines}{wxwindowscrolllines}$(-1)$.


\membersection{wxWindow::Lower}\label{wxwindowlower}

\func{void}{Lower}{\void}

Lowers the window to the bottom of the window hierarchy (z-order).

\wxheading{See also}

\helpref{Raise}{wxwindowraise}


\membersection{wxWindow::MakeModal}\label{wxwindowmakemodal}

\func{virtual void}{MakeModal}{\param{bool }{flag}}

Disables all other windows in the application so that
the user can only interact with this window.

\wxheading{Parameters}

\docparam{flag}{If {\tt true}, this call disables all other windows in the application so that
the user can only interact with this window. If {\tt false}, the effect is reversed.}


\membersection{wxWindow::Move}\label{wxwindowmove}

\func{void}{Move}{\param{int}{ x}, \param{int}{ y}}

\func{void}{Move}{\param{const wxPoint\&}{ pt}}

Moves the window to the given position.

\wxheading{Parameters}

\docparam{x}{Required x position.}

\docparam{y}{Required y position.}

\docparam{pt}{\helpref{wxPoint}{wxpoint} object representing the position.}

\wxheading{Remarks}

Implementations of SetSize can also implicitly implement the
wxWindow::Move function, which is defined in the base wxWindow class
as the call:

\begin{verbatim}
  SetSize(x, y, wxDefaultCoord, wxDefaultCoord, wxSIZE_USE_EXISTING);
\end{verbatim}

\wxheading{See also}

\helpref{wxWindow::SetSize}{wxwindowsetsize}

\pythonnote{In place of a single overloaded method name, wxPython
implements the following methods:\par
\indented{2cm}{\begin{twocollist}
\twocolitem{{\bf Move(point)}}{Accepts a wxPoint}
\twocolitem{{\bf MoveXY(x, y)}}{Accepts a pair of integers}
\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}}

Does keyboard navigation from this window to another, by sending
a wxNavigationKeyEvent.

\wxheading{Parameters}

\docparam{flags}{A combination of wxNavigationKeyEvent::IsForward and wxNavigationKeyEvent::WinChange.}

\wxheading{Remarks}

You may wish to call this from a text control custom keypress handler to do the default
navigation behaviour for the tab key, since the standard default behaviour for
a multiline text control with the wxTE\_PROCESS\_TAB style is to insert a tab
and not navigate to the next control.

%% VZ: wxWindow::OnXXX() functions should not be documented but I'm leaving
%%     the old docs here in case we want to move any still needed bits to
%%     the right location (i.e. probably the corresponding events docs)
%%
%% \membersection{wxWindow::OnActivate}\label{wxwindowonactivate}
%%
%% \func{void}{OnActivate}{\param{wxActivateEvent\&}{ event}}
%%
%% Called when a window is activated or deactivated.
%%
%% \wxheading{Parameters}
%%
%% \docparam{event}{Object containing activation information.}
%%
%% \wxheading{Remarks}
%%
%% If the window is being activated, \helpref{wxActivateEvent::GetActive}{wxactivateeventgetactive} returns {\tt true},
%% otherwise it returns {\tt false} (it is being deactivated).
%%
%% \wxheading{See also}
%%
%% \helpref{wxActivateEvent}{wxactivateevent},\rtfsp
%% \helpref{Event handling overview}{eventhandlingoverview}
%%
%% \membersection{wxWindow::OnChar}\label{wxwindowonchar}
%%
%% \func{void}{OnChar}{\param{wxKeyEvent\&}{ event}}
%%
%% Called when the user has pressed a key that is not a modifier (SHIFT, CONTROL or ALT).
%%
%% \wxheading{Parameters}
%%
%% \docparam{event}{Object containing keypress information. See \helpref{wxKeyEvent}{wxkeyevent} for
%% details about this class.}
%%
%% \wxheading{Remarks}
%%
%% This member function is called in response to a keypress. To intercept this event,
%% use the EVT\_CHAR macro in an event table definition. Your {\bf OnChar} handler may call this
%% default function to achieve default keypress functionality.
%%
%% Note that the ASCII values do not have explicit key codes: they are passed as ASCII
%% values.
%%
%% Note that not all keypresses can be intercepted this way. If you wish to intercept modifier
%% keypresses, then you will need to use \helpref{wxWindow::OnKeyDown}{wxwindowonkeydown} or
%% \helpref{wxWindow::OnKeyUp}{wxwindowonkeyup}.
%%
%% Most, but not all, windows allow keypresses to be intercepted.
%%
%% {\bf Tip:} be sure to call {\tt event.Skip()} for events that you don't process in this function,
%% otherwise menu shortcuts may cease to work under Windows.
%%
%% \wxheading{See also}
%%
%% \helpref{wxWindow::OnKeyDown}{wxwindowonkeydown}, \helpref{wxWindow::OnKeyUp}{wxwindowonkeyup},\rtfsp
%% \helpref{wxKeyEvent}{wxkeyevent}, \helpref{wxWindow::OnCharHook}{wxwindowoncharhook},\rtfsp
%% \helpref{Event handling overview}{eventhandlingoverview}
%%
%% \membersection{wxWindow::OnCharHook}\label{wxwindowoncharhook}
%%
%% \func{void}{OnCharHook}{\param{wxKeyEvent\&}{ event}}
%%
%% This member is called to allow the window to intercept keyboard events
%% before they are processed by child windows.
%%
%% \wxheading{Parameters}
%%
%% \docparam{event}{Object containing keypress information. See \helpref{wxKeyEvent}{wxkeyevent} for
%% details about this class.}
%%
%% \wxheading{Remarks}
%%
%% This member function is called in response to a keypress, if the window is active. To intercept this event,
%% use the EVT\_CHAR\_HOOK macro in an event table definition. If you do not process a particular
%% keypress, call \helpref{wxEvent::Skip}{wxeventskip} to allow default processing.
%%
%% An example of using this function is in the implementation of escape-character processing for wxDialog,
%% where pressing ESC dismisses the dialog by {\bf OnCharHook} 'forging' a cancel button press event.
%%
%% Note that the ASCII values do not have explicit key codes: they are passed as ASCII
%% values.
%%
%% 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 intercept it, and if you don't call \helpref{wxEvent::Skip}{wxeventskip}
%% the window won't get the event.
%%
%% \wxheading{See also}
%%
%% \helpref{wxKeyEvent}{wxkeyevent},\rtfsp
%% \helpref{wxWindow::OnCharHook}{wxwindowoncharhook},\rtfsp
%% %% GD: OnXXX functions are not documented
%% %%\helpref{wxApp::OnCharHook}{wxapponcharhook},\rtfsp
%% \helpref{Event handling overview}{eventhandlingoverview}
%%
%% \membersection{wxWindow::OnCommand}\label{wxwindowoncommand}
%%
%% \func{virtual void}{OnCommand}{\param{wxEvtHandler\& }{object}, \param{wxCommandEvent\& }{event}}
%%
%% This virtual member function is called if the control does not handle the command event.
%%
%% \wxheading{Parameters}
%%
%% \docparam{object}{Object receiving the command event.}
%%
%% \docparam{event}{Command event}
%%
%% \wxheading{Remarks}
%%
%% This virtual function is provided mainly for backward compatibility. You can also intercept commands
%% from child controls by using an event table, with identifiers or identifier ranges to identify
%% the control(s) in question.
%%
%% \wxheading{See also}
%%
%% \helpref{wxCommandEvent}{wxcommandevent},\rtfsp
%% \helpref{Event handling overview}{eventhandlingoverview}
%%
%% \membersection{wxWindow::OnClose}\label{wxwindowonclose}
%%
%% \func{virtual bool}{OnClose}{\void}
%%
%% Called when the user has tried to close a a frame
%% or dialog box using the window manager (X) or system menu (Windows).
%%
%% {\bf Note:} This is an obsolete function.
%% It is superseded by the \helpref{wxWindow::OnCloseWindow}{wxwindowonclosewindow} event
%% handler.
%%
%% \wxheading{Return value}
%%
%% If {\tt true} is returned by OnClose, the window will be deleted by the system, otherwise the
%% attempt will be ignored. Do not delete the window from within this handler, although
%% you may delete other windows.
%%
%% \wxheading{See also}
%%
%% \helpref{Window deletion overview}{windowdeletionoverview},\rtfsp
%% \helpref{wxWindow::Close}{wxwindowclose},\rtfsp
%% \helpref{wxWindow::OnCloseWindow}{wxwindowonclosewindow},\rtfsp
%% \helpref{wxCloseEvent}{wxcloseevent}
%%
%% \membersection{wxWindow::OnKeyDown}\label{wxwindowonkeydown}
%%
%% \func{void}{OnKeyDown}{\param{wxKeyEvent\&}{ event}}
%%
%% Called when the user has pressed a key, before it is translated into an ASCII value using other
%% modifier keys that might be pressed at the same time.
%%
%% \wxheading{Parameters}
%%
%% \docparam{event}{Object containing keypress information. See \helpref{wxKeyEvent}{wxkeyevent} for
%% details about this class.}
%%
%% \wxheading{Remarks}
%%
%% This member function is called in response to a key down event. To intercept this event,
%% use the EVT\_KEY\_DOWN macro in an event table definition. Your {\bf OnKeyDown} handler may call this
%% default function to achieve default keypress functionality.
%%
%% Note that not all keypresses can be intercepted this way. If you wish to intercept special
%% keys, such as shift, control, and function keys, then you will need to use \helpref{wxWindow::OnKeyDown}{wxwindowonkeydown} or
%% \helpref{wxWindow::OnKeyUp}{wxwindowonkeyup}.
%%
%% Most, but not all, windows allow keypresses to be intercepted.
%%
%% {\bf Tip:} be sure to call {\tt event.Skip()} for events that you don't process in this function,
%% otherwise menu shortcuts may cease to work under Windows.
%%
%% \wxheading{See also}
%%
%% \helpref{wxWindow::OnChar}{wxwindowonchar}, \helpref{wxWindow::OnKeyUp}{wxwindowonkeyup},\rtfsp
%% \helpref{wxKeyEvent}{wxkeyevent}, \helpref{wxWindow::OnCharHook}{wxwindowoncharhook},\rtfsp
%% \helpref{Event handling o