]>
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 JS |
11 | To use this class, first add buttons to the sizer by calling AddButton (or SetAffirmativeButton, SetNegativeButton, |
12 | or SetCancelButton) and then call Finalise in order to create the actual button layout used. Other than these special | |
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 | |
49 | \item wxID\_NO | |
50 | \item wxID\_CANCEL | |
51 | \item wxID\_HELP | |
52 | \item wxID\_CONTEXT\_HELP | |
76bdc1d2 KO |
53 | \end{itemize} |
54 | ||
55 | \membersection{wxStdDialogButtonSizer::Finalise}\label{wxstddialogbuttonsizerfinalise} | |
56 | ||
57 | \func{void}{Finalise}{\void} | |
58 | ||
59 | Rearranges the buttons and applies proper spacing between buttons to make them match the platform or toolkit's interface guidelines. | |
60 | ||
61 | \membersection{wxStdDialogButtonSizer::SetAffirmativeButton}\label{wxstddialogbuttonsizersetaffirmativebutton} | |
62 | ||
63 | \func{void}{SetAffirmativeButton}{\param{wxButton* }{button}} | |
64 | ||
dceb1c09 | 65 | Sets the affirmative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
76bdc1d2 KO |
66 | |
67 | \membersection{wxStdDialogButtonSizer::SetCancelButton}\label{wxstddialogbuttonsizersetcancelbutton} | |
68 | ||
69 | \func{void}{SetCancelButton}{\param{wxButton* }{button}} | |
70 | ||
dceb1c09 | 71 | Sets the cancel button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
76bdc1d2 KO |
72 | |
73 | \membersection{wxStdDialogButtonSizer::SetNegativeButton}\label{wxstddialogbuttonsizersetnegativebutton} | |
74 | ||
75 | \func{void}{SetNegativeButton}{\param{wxButton* }{button}} | |
76 | ||
dceb1c09 JS |
77 | Sets the negative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. |
78 |