]>
Commit | Line | Data |
---|---|---|
1 | \section{\class{wxSize}}\label{wxsize} | |
2 | ||
3 | A {\bf wxSize} is a useful data structure for graphics operations. | |
4 | It simply contains integer {\it width} and {\it height} members. | |
5 | ||
6 | wxSize is used throughout wxWidgets as well as wxPoint which, although almost | |
7 | equivalent to wxSize, has a different meaning: wxPoint represents a position | |
8 | while wxSize - the size. | |
9 | ||
10 | \pythonnote{wxPython defines aliases for the {\tt x} and {\tt y} members | |
11 | named {\tt width} and {\tt height} since it makes much more sense for | |
12 | sizes. | |
13 | } | |
14 | ||
15 | \wxheading{Derived from} | |
16 | ||
17 | None | |
18 | ||
19 | \wxheading{Include files} | |
20 | ||
21 | <wx/gdicmn.h> | |
22 | ||
23 | \wxheading{See also} | |
24 | ||
25 | \helpref{wxPoint}{wxpoint}, \helpref{wxRealPoint}{wxrealpoint} | |
26 | ||
27 | \latexignore{\rtfignore{\wxheading{Members}}} | |
28 | ||
29 | ||
30 | \membersection{wxSize::wxSize} | |
31 | ||
32 | \func{}{wxSize}{\void} | |
33 | ||
34 | \func{}{wxSize}{\param{int}{ width}, \param{int}{ height}} | |
35 | ||
36 | Creates a size object. | |
37 | ||
38 | ||
39 | ||
40 | \membersection{wxSize::DecTo}\label{wxsizedecto} | |
41 | ||
42 | \func{wxSize\&}{DecTo}{\param{const wxSize\& }{size}} | |
43 | ||
44 | Decrements this object so that both of its dimensions are not greater than the | |
45 | corresponding dimensions of the \arg{size}. | |
46 | ||
47 | \wxheading{See also} | |
48 | ||
49 | \helpref{IncTo}{wxsizeincto} | |
50 | ||
51 | ||
52 | \membersection{wxSize::IsFullySpecified}\label{wxsizeisfullyspecified} | |
53 | ||
54 | \constfunc{bool}{IsFullySpecified}{\void} | |
55 | ||
56 | Returns \true if neither of the size object components is equal to $-1$, which | |
57 | is used as default for the size values in wxWidgets (hence the predefined | |
58 | \texttt{wxDefaultSize} has both of its components equal to $-1$). | |
59 | ||
60 | This method is typically used before calling | |
61 | \helpref{SetDefaults}{wxsizesetdefaults}. | |
62 | ||
63 | ||
64 | \membersection{wxSize::GetWidth}\label{wxsizegetwidth} | |
65 | ||
66 | \constfunc{int}{GetWidth}{\void} | |
67 | ||
68 | Gets the width member. | |
69 | ||
70 | ||
71 | \membersection{wxSize::GetHeight}\label{wxsizegetheight} | |
72 | ||
73 | \constfunc{int}{GetHeight}{\void} | |
74 | ||
75 | Gets the height member. | |
76 | ||
77 | ||
78 | ||
79 | \membersection{wxSize::IncTo}\label{wxsizeincto} | |
80 | ||
81 | \func{wxSize\&}{IncTo}{\param{const wxSize\& }{size}} | |
82 | ||
83 | Increments this object so that both of its dimensions are not less than the | |
84 | corresponding dimensions of the \arg{size}. | |
85 | ||
86 | \wxheading{See also} | |
87 | ||
88 | \helpref{DecTo}{wxsizedecto} | |
89 | ||
90 | ||
91 | ||
92 | \membersection{wxSize::Set}\label{wxsizeset} | |
93 | ||
94 | \func{void}{Set}{\param{int}{ width}, \param{int}{ height}} | |
95 | ||
96 | Sets the width and height members. | |
97 | ||
98 | ||
99 | \membersection{wxSize::SetDefaults}\label{wxsizesetdefaults} | |
100 | ||
101 | \func{void}{SetDefaults}{\param{const wxSize\& }{sizeDefault}} | |
102 | ||
103 | Combine this size object with another one replacing the default (i.e. equal | |
104 | to $-1$) components of this object with those of the other. It is typically | |
105 | used like this: | |
106 | \begin{verbatim} | |
107 | if ( !size.IsFullySpecified() ) | |
108 | { | |
109 | size.SetDefaults(GetDefaultSize()); | |
110 | } | |
111 | \end{verbatim} | |
112 | ||
113 | \wxheading{See also} | |
114 | ||
115 | \helpref{IsFullySpecified}{wxsizeisfullyspecified} | |
116 | ||
117 | ||
118 | \membersection{wxSize::SetHeight}\label{wxsizesetheight} | |
119 | ||
120 | \func{void}{SetHeight}{\param{int}{ height}} | |
121 | ||
122 | Sets the height. | |
123 | ||
124 | ||
125 | \membersection{wxSize::SetWidth}\label{wxsizesetwidth} | |
126 | ||
127 | \func{void}{SetWidth}{\param{int}{ width}} | |
128 | ||
129 | Sets the width. | |
130 | ||
131 | ||
132 | \membersection{wxSize::operator $=$} | |
133 | ||
134 | \func{void}{operator $=$}{\param{const wxSize\& }{sz}} | |
135 | ||
136 | Assignment operator. | |
137 | ||
138 |