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 - Windows calling CaptureMouse() are now required to handle
the wxEVT_MOUSE_CAPTURE_LOST event. the wxEVT_MOUSE_CAPTURE_LOST event.
- SetDefaultItem() method was moved from wxPanel to wxTopLevelWindow - 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 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} \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} \wxheading{See also}
@@ -394,24 +395,38 @@ propagate the notification to child windows and controls.
\func{void}{SetAffirmativeId}{\param{int }{id}} \func{void}{SetAffirmativeId}{\param{int }{id}}
Sets the identifier to be used when the user presses an OK button in a PocketPC titlebar. Sets the identifier to be used as OK button. When the button with this
By default, this is wxID\_OK. 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} \wxheading{See also}
\helpref{wxDialog::GetAffirmativeId}{wxdialoggetaffirmativeid} \helpref{wxDialog::GetAffirmativeId}{wxdialoggetaffirmativeid}, \helpref{wxDialog::SetEscapeId}{wxdialogsetescapeid}
\membersection{wxDialog::SetEscapeId}\label{wxdialogsetescapeid} \membersection{wxDialog::SetEscapeId}\label{wxdialogsetescapeid}
\func{void}{SetEscapeId}{\param{int }{id}} \func{void}{SetEscapeId}{\param{int }{id}}
Sets the identifier to be used when the user presses \texttt{\textsc{ESC}} Sets the identifier of the button which should work like the standard
button in the dialog. By default, this is \texttt{wxID\_ANY} meaning that \texttt{\textsc{Cancel}} button in this dialog. When the button with this id is
the first suitable button is used: if there a \texttt{wxID\_CANCEL} button, it clicked, the dialog is closed. Also, when the user presses \texttt{\textsc{ESC}}
is activated, otherwise \texttt{wxID\_OK} button is activated if present. key in the dialog or closes the dialog using the close button in the title bar,
Another possible special value for \arg{id} is \texttt{wxID\_NONE} meaning that this is mapped to the click of the button with the specified id.
\texttt{\textsc{ESC}} presses should be ignored. If another value is given, it
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. is interpreted as the id of the button to map the escape key to.