Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

updates for wxDialog affirmative/escape id buttons handling changes

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40701 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2006-08-20 10:38:55 +00:00
parent 551f281b79
commit 684e5b95a6
2 changed files with 26 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/changes.txt
View File

@@ -30,6 +30,7 @@ INCOMPATIBLE CHANGES SINCE 2.6.x
- Windows calling CaptureMouse() are now required to handle
the wxEVT_MOUSE_CAPTURE_LOST event.
- SetDefaultItem() method was moved from wxPanel to wxTopLevelWindow
- wxDialog::OnOK/OnCancel() don't exist any more, use SetAffirmative/EscapeId()
Deprecated methods since 2.6.x and their replacements

35
docs/latex/wx/dialog.tex
View File

@@ -234,7 +234,8 @@ invocation.
\constfunc{int}{GetAffirmativeId}{\void}
Gets the identifier to be used when the user presses an OK button in a PocketPC titlebar.
Gets the identifier of the button which works like standard OK button in this
dialog.
\wxheading{See also}
@@ -394,24 +395,38 @@ propagate the notification to child windows and controls.
\func{void}{SetAffirmativeId}{\param{int }{id}}
Sets the identifier to be used when the user presses an OK button in a PocketPC titlebar.
By default, this is wxID\_OK.
Sets the identifier to be used as OK button. When the button with this
identifier is pressed, the dialog calls \helpref{Validate}{wxwindowvalidate}
and \helpref{wxWindow::TransferDataFromWindow}{wxwindowtransferdatafromwindow}
and, if they both return \true, closes the dialog with \texttt{wxID\_OK} return
code.
Also, when the user presses a hardware OK button on the devices having one or
the special OK button in the PocketPC title bar, an event with this id is
generated.
By default, the affirmative id is wxID\_OK.
\wxheading{See also}
\helpref{wxDialog::GetAffirmativeId}{wxdialoggetaffirmativeid}
\helpref{wxDialog::GetAffirmativeId}{wxdialoggetaffirmativeid}, \helpref{wxDialog::SetEscapeId}{wxdialogsetescapeid}
\membersection{wxDialog::SetEscapeId}\label{wxdialogsetescapeid}
\func{void}{SetEscapeId}{\param{int }{id}}
Sets the identifier to be used when the user presses \texttt{\textsc{ESC}}
button in the dialog. By default, this is \texttt{wxID\_ANY} meaning that
the first suitable button is used: if there a \texttt{wxID\_CANCEL} button, it
is activated, otherwise \texttt{wxID\_OK} button is activated if present.
Another possible special value for \arg{id} is \texttt{wxID\_NONE} meaning that
\texttt{\textsc{ESC}} presses should be ignored. If another value is given, it
Sets the identifier of the button which should work like the standard
\texttt{\textsc{Cancel}} button in this dialog. When the button with this id is
clicked, the dialog is closed. Also, when the user presses \texttt{\textsc{ESC}}
key in the dialog or closes the dialog using the close button in the title bar,
this is mapped to the click of the button with the specified id.
By default, the escape id is the special value \texttt{wxID\_ANY} meaning that
\texttt{wxID\_CANCEL} button is used if it's present in the dialog and
otherwise the button with \helpref{GetAffirmativeId()}{wxdialoggetaffirmativeid}
is used. Another special value for \arg{id} is \texttt{wxID\_NONE} meaning that
\texttt{\textsc{ESC}} presses should be ignored. If any other value is given, it
is interpreted as the id of the button to map the escape key to.