]>
Commit | Line | Data |
---|---|---|
1 | \section{\class{wxStdDialogButtonSizer}}\label{wxstddialogbuttonsizer} | |
2 | ||
3 | This class creates button layouts which conform to the standard button spacing and ordering defined by the platform | |
4 | or toolkit's user interface guidelines (if such things exist). By using this class, you can ensure that all your | |
5 | standard dialogs look correct on all major platforms. Currently it conforms to the Windows, GTK+ and Mac OS X | |
6 | human interface guidelines. | |
7 | ||
8 | When there aren't interface guidelines defined for a particular platform or toolkit, wxStdDialogButtonSizer reverts | |
9 | to the Windows implementation. | |
10 | ||
11 | To use this class, first add buttons to the sizer by calling AddButton (or SetAffirmativeButton, SetNegativeButton, | |
12 | or SetCancelButton) and then call Realize in order to create the actual button layout used. Other than these special | |
13 | operations, this sizer works like any other sizer. | |
14 | ||
15 | If you add a button with wxID\_SAVE, on Mac OS X the button will be renamed to "Save" and | |
16 | the wxID\_NO button will be renamed to "Don't Save" in accordance with the Mac OS X Human Interface Guidelines. | |
17 | ||
18 | \wxheading{Derived from} | |
19 | ||
20 | \helpref{wxBoxSizer}{wxboxsizer}\\ | |
21 | \helpref{wxSizer}{wxsizer}\\ | |
22 | \helpref{wxObject}{wxobject} | |
23 | ||
24 | \wxheading{Include files} | |
25 | ||
26 | <wx/sizer.h> | |
27 | ||
28 | \wxheading{See also} | |
29 | ||
30 | \helpref{wxSizer}{wxsizer}, \helpref{Sizer overview}{sizeroverview}, \helpref{wxDialog::CreateButtonSizer}{wxdialogcreatebuttonsizer} | |
31 | ||
32 | \membersection{wxStdDialogButtonSizer::wxStdDialogButtonSizer}\label{wxstddialogbuttonsizerctor} | |
33 | ||
34 | \func{}{wxStdDialogButtonSizer}{\void} | |
35 | ||
36 | Constructor for a wxStdDialogButtonSizer. | |
37 | ||
38 | \membersection{wxStdDialogButtonSizer::AddButton}\label{wxstddialogbuttonsizeraddbutton} | |
39 | ||
40 | \func{void}{AddButton}{\param{wxButton* }{button}} | |
41 | ||
42 | Adds a button to the wxStdDialogButtonSizer. The button must have one of the following identifiers: | |
43 | ||
44 | \begin{itemize}\itemsep=0pt | |
45 | \item wxID\_OK | |
46 | \item wxID\_YES | |
47 | \item wxID\_SAVE | |
48 | \item wxID\_APPLY | |
49 | \item wxID\_CLOSE | |
50 | \item wxID\_NO | |
51 | \item wxID\_CANCEL | |
52 | \item wxID\_HELP | |
53 | \item wxID\_CONTEXT\_HELP | |
54 | \end{itemize} | |
55 | ||
56 | \membersection{wxStdDialogButtonSizer::Realize}\label{wxstddialogbuttonsizerrealize} | |
57 | ||
58 | \func{void}{Realize}{\void} | |
59 | ||
60 | Rearranges the buttons and applies proper spacing between buttons to make them match the platform or toolkit's interface guidelines. | |
61 | ||
62 | \membersection{wxStdDialogButtonSizer::SetAffirmativeButton}\label{wxstddialogbuttonsizersetaffirmativebutton} | |
63 | ||
64 | \func{void}{SetAffirmativeButton}{\param{wxButton* }{button}} | |
65 | ||
66 | Sets the affirmative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
67 | ||
68 | \membersection{wxStdDialogButtonSizer::SetCancelButton}\label{wxstddialogbuttonsizersetcancelbutton} | |
69 | ||
70 | \func{void}{SetCancelButton}{\param{wxButton* }{button}} | |
71 | ||
72 | Sets the cancel button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
73 | ||
74 | \membersection{wxStdDialogButtonSizer::SetNegativeButton}\label{wxstddialogbuttonsizersetnegativebutton} | |
75 | ||
76 | \func{void}{SetNegativeButton}{\param{wxButton* }{button}} | |
77 | ||
78 | Sets the negative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
79 |