File: combopopup.tex

package info (click to toggle)
wxwidgets2.8 2.8.10.1-3
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 239,052 kB
  • ctags: 289,550
  • sloc: cpp: 1,838,857; xml: 396,717; python: 282,506; ansic: 126,171; makefile: 51,406; sh: 14,581; asm: 299; sql: 258; lex: 194; perl: 139; yacc: 128; pascal: 95; php: 39; lisp: 38; tcl: 24; haskell: 20; java: 18; cs: 18; erlang: 17; ruby: 16; ada: 9; ml: 9; csh: 9
file content (184 lines) | stat: -rw-r--r-- 5,335 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Name:        combopopup.tex
%% Purpose:     wxComboPopup docs
%% Author:      Jaakko Salli
%% Modified by:
%% Created:
%% RCS-ID:      $Id: combopopup.tex 59083 2009-02-22 08:52:07Z JMS $
%% Copyright:   (c) Jaakko Salli
%% License:     wxWindows license
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{\class{wxComboPopup}}\label{wxcombopopup}

In order to use a custom popup with \helpref{wxComboCtrl}{wxcomboctrl},
an interface class must be derived from wxComboPopup. For more information
how to use it, see \helpref{Setting Custom Popup for wxComboCtrl}{wxcomboctrl}.

\wxheading{Include files}

<combo.h>

\wxheading{See also}

\helpref{wxComboCtrl}{wxcomboctrl}

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxComboPopup::wxComboPopup}\label{wxcombopopupwxcombopopup}

\func{}{wxComboPopup}{\void}

Default constructor. It is recommended that internal variables
are prepared in \helpref{Init}{wxcombopopupinit} instead
(because \helpref{m\_combo}{wxcombopopupmcombo} is not valid in constructor).


\membersection{wxComboPopup::m\_combo}\label{wxcombopopupmcombo}

\member{wxComboCtrl*}{m\_combo}

Parent \helpref{wxComboCtrl}{wxcomboctrl}. This protected member variable is
prepared automatically before \helpref{Init}{wxcombopopupinit} is called.


\membersection{wxComboPopup::Create}\label{wxcombopopupcreate}

\func{bool}{Create}{\param{wxWindow* }{parent}}

The derived class must implement this to create the popup control.

\wxheading{Return value}

\true if the call succeeded, \false otherwise.


\membersection{wxComboPopup::Dismiss}\label{wxcombopopupdismiss}

\func{void}{Dismiss}{\void}

Utility function that hides the popup.


\membersection{wxComboPopup::GetAdjustedSize}\label{wxcombopopupgetadjustedsize}

\func{wxSize}{GetAdjustedSize}{\param{int }{minWidth}, \param{int }{prefHeight}, \param{int }{maxHeight}}

The derived class may implement this to return adjusted size
for the popup control, according to the variables given.

\wxheading{Parameters}

\docparam{minWidth}{Preferred minimum width.}
\docparam{prefHeight}{Preferred height. May be -1 to indicate
no preference.}
\docparam{maxWidth}{Max height for window, as limited by
screen size.}

\wxheading{Remarks}

Called each time popup is about to be shown.


\membersection{wxComboPopup::GetControl}\label{wxcombopopupgetcontrol}

\func{wxWindow*}{GetControl}{\void}

The derived class must implement this to return pointer
to the associated control created in \helpref{Create}{wxcombopopupcreate}.


\membersection{wxComboPopup::GetStringValue}\label{wxcombopopupgetstringvalue}

\constfunc{wxString}{GetStringValue}{\void}

The derived class must implement this to return
string representation of the value.


\membersection{wxComboPopup::Init}\label{wxcombopopupinit}

\func{void}{Init}{\void}

The derived class must implement this to initialize
its internal variables. This method is called immediately
after construction finishes. \helpref{m\_combo}{wxcombopopupmcombo}
member variable has been initialized before the call.


\membersection{wxComboPopup::IsCreated}\label{wxcombopopupiscreated}

\constfunc{bool}{IsCreated}{\void}

Utility method that returns \true if Create has been called.

Useful in conjunction with \helpref{LazyCreate}{wxcombopopuplazycreate}.


\membersection{wxComboPopup::LazyCreate}\label{wxcombopopuplazycreate}

\func{bool}{LazyCreate}{\void}

The derived class may implement this to return
\true if it wants to delay call to \helpref{Create}{wxcombopopupcreate}
until the popup is shown for the first time. It is more
efficient, but on the other hand it is often more convenient
to have the control created immediately.

\wxheading{Remarks}

Base implementation returns \false.


\membersection{wxComboPopup::OnComboDoubleClick}\label{wxcombopopuponcombodoubleclick}

\func{void}{OnComboDoubleClick}{\void}

The derived class may implement this to do something
when the parent \helpref{wxComboCtrl}{wxcomboctrl} gets double-clicked.


\membersection{wxComboPopup::OnComboKeyEvent}\label{wxcombopopuponcombokeyevent}

\func{void}{OnComboKeyEvent}{\param{wxKeyEvent\& }{event}}

The derived class may implement this to receive
key events from the parent \helpref{wxComboCtrl}{wxcomboctrl}.

Events not handled should be skipped, as usual.


\membersection{wxComboPopup::OnDismiss}\label{wxcombopopupondismiss}

\func{void}{OnDismiss}{\void}

The derived class may implement this to do
special processing when popup is hidden.


\membersection{wxComboPopup::OnPopup}\label{wxcombopopuponpopup}

\func{void}{OnPopup}{\void}

The derived class may implement this to do
special processing when popup is shown.


\membersection{wxComboPopup::PaintComboControl}\label{wxcombopopuppaintcombocontrol}

\func{void}{PaintComboControl}{\param{wxDC\& }{dc}, \param{const wxRect\& }{rect}}

The derived class may implement this to paint
the parent \helpref{wxComboCtrl}{wxcomboctrl}.

Default implementation draws value as string.


\membersection{wxComboPopup::SetStringValue}\label{wxcombopopupsetstringvalue}

\func{void}{SetStringValue}{\param{const wxString\& }{value}}

The derived class must implement this to receive
string value changes from \helpref{wxComboCtrl}{wxcomboctrl}.