]>
Commit | Line | Data |
---|---|---|
76bdc1d2 KO |
1 | \section{\class{wxStdDialogButtonSizer}}\label{wxstddialogbuttonsizer} |
2 | ||
dceb1c09 JS |
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. | |
76bdc1d2 | 7 | |
dceb1c09 JS |
8 | When there aren't interface guidelines defined for a particular platform or toolkit, wxStdDialogButtonSizer reverts |
9 | to the Windows implementation. | |
76bdc1d2 | 10 | |
dceb1c09 | 11 | To use this class, first add buttons to the sizer by calling AddButton (or SetAffirmativeButton, SetNegativeButton, |
718903fe | 12 | or SetCancelButton) and then call Realize in order to create the actual button layout used. Other than these special |
dceb1c09 | 13 | operations, this sizer works like any other sizer. |
76bdc1d2 | 14 | |
dceb1c09 JS |
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. | |
76bdc1d2 KO |
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 | ||
67edd0c7 JS |
30 | \helpref{wxSizer}{wxsizer}, \helpref{Sizer overview}{sizeroverview}, \helpref{wxDialog::CreateButtonSizer}{wxdialogcreatebuttonsizer} |
31 | ||
32 | \membersection{wxStdDialogButtonSizer::wxStdDialogButtonSizer}\label{wxstddialogbuttonsizerctor} | |
76bdc1d2 KO |
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 | ||
dceb1c09 | 42 | Adds a button to the wxStdDialogButtonSizer. The button must have one of the following identifiers: |
76bdc1d2 | 43 | |
67edd0c7 | 44 | \begin{itemize}\itemsep=0pt |
dceb1c09 JS |
45 | \item wxID\_OK |
46 | \item wxID\_YES | |
47 | \item wxID\_SAVE | |
48 | \item wxID\_APPLY | |
57d7f988 | 49 | \item wxID\_CLOSE |
dceb1c09 JS |
50 | \item wxID\_NO |
51 | \item wxID\_CANCEL | |
52 | \item wxID\_HELP | |
53 | \item wxID\_CONTEXT\_HELP | |
76bdc1d2 KO |
54 | \end{itemize} |
55 | ||
718903fe | 56 | \membersection{wxStdDialogButtonSizer::Realize}\label{wxstddialogbuttonsizerrealize} |
76bdc1d2 | 57 | |
718903fe | 58 | \func{void}{Realize}{\void} |
76bdc1d2 KO |
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 | ||
dceb1c09 | 66 | Sets the affirmative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
76bdc1d2 KO |
67 | |
68 | \membersection{wxStdDialogButtonSizer::SetCancelButton}\label{wxstddialogbuttonsizersetcancelbutton} | |
69 | ||
70 | \func{void}{SetCancelButton}{\param{wxButton* }{button}} | |
71 | ||
dceb1c09 | 72 | Sets the cancel button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
76bdc1d2 KO |
73 | |
74 | \membersection{wxStdDialogButtonSizer::SetNegativeButton}\label{wxstddialogbuttonsizersetnegativebutton} | |
75 | ||
76 | \func{void}{SetNegativeButton}{\param{wxButton* }{button}} | |
77 | ||
dceb1c09 JS |
78 | Sets the negative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
79 |