]>
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{Library} | |
29 | ||
30 | \helpref{wxCore}{librarieslist} | |
31 | ||
32 | \wxheading{See also} | |
33 | ||
34 | \helpref{wxSizer}{wxsizer}, \helpref{Sizer overview}{sizeroverview}, \helpref{wxDialog::CreateButtonSizer}{wxdialogcreatebuttonsizer} | |
35 | ||
36 | \membersection{wxStdDialogButtonSizer::wxStdDialogButtonSizer}\label{wxstddialogbuttonsizerctor} | |
37 | ||
38 | \func{}{wxStdDialogButtonSizer}{\void} | |
39 | ||
40 | Constructor for a wxStdDialogButtonSizer. | |
41 | ||
42 | \membersection{wxStdDialogButtonSizer::AddButton}\label{wxstddialogbuttonsizeraddbutton} | |
43 | ||
44 | \func{void}{AddButton}{\param{wxButton* }{button}} | |
45 | ||
46 | Adds a button to the wxStdDialogButtonSizer. The button must have one of the following identifiers: | |
47 | ||
48 | \begin{itemize}\itemsep=0pt | |
49 | \item wxID\_OK | |
50 | \item wxID\_YES | |
51 | \item wxID\_SAVE | |
52 | \item wxID\_APPLY | |
53 | \item wxID\_CLOSE | |
54 | \item wxID\_NO | |
55 | \item wxID\_CANCEL | |
56 | \item wxID\_HELP | |
57 | \item wxID\_CONTEXT\_HELP | |
58 | \end{itemize} | |
59 | ||
60 | \membersection{wxStdDialogButtonSizer::Realize}\label{wxstddialogbuttonsizerrealize} | |
61 | ||
62 | \func{void}{Realize}{\void} | |
63 | ||
64 | Rearranges the buttons and applies proper spacing between buttons to make them match the platform or toolkit's interface guidelines. | |
65 | ||
66 | \membersection{wxStdDialogButtonSizer::SetAffirmativeButton}\label{wxstddialogbuttonsizersetaffirmativebutton} | |
67 | ||
68 | \func{void}{SetAffirmativeButton}{\param{wxButton* }{button}} | |
69 | ||
70 | Sets the affirmative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
71 | ||
72 | \membersection{wxStdDialogButtonSizer::SetCancelButton}\label{wxstddialogbuttonsizersetcancelbutton} | |
73 | ||
74 | \func{void}{SetCancelButton}{\param{wxButton* }{button}} | |
75 | ||
76 | Sets the cancel button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
77 | ||
78 | \membersection{wxStdDialogButtonSizer::SetNegativeButton}\label{wxstddialogbuttonsizersetnegativebutton} | |
79 | ||
80 | \func{void}{SetNegativeButton}{\param{wxButton* }{button}} | |
81 | ||
82 | Sets the negative button for the sizer. This allows you to use identifiers other than the standard identifiers outlined above. | |
83 |