]> git.saurik.com Git - wxWidgets.git/blob - docs/latex/wx/propliva.tex
typo fix
[wxWidgets.git] / docs / latex / wx / propliva.tex
1 \section{\class{wxPropertyListValidator}}\label{wxpropertylistvalidator}
2
3 The {\bf wxPropertyListValidator} abstract class is the base class for
4 deriving validators for property lists.
5
6 \wxheading{See also}
7
8 \helpref{wxPropertyListValidator overview}{wxpropertylistvalidatoroverview}
9
10 \latexignore{\rtfignore{\wxheading{Members}}}
11
12 \membersection{wxPropertyListValidator::wxPropertyListValidator}
13
14 \func{void}{wxPropertyListValidator}{\param{long}{ flags = wxPROP\_ALLOW\_TEXT\_EDITING}}
15
16 Constructor.
17
18 \membersection{wxPropertyListValidator::\destruct{wxPropertyListValidator}}
19
20 \func{void}{\destruct{wxPropertyListValidator}}{\void}
21
22 Destructor.
23
24 \membersection{wxPropertyListValidator::OnCheckValue}
25
26 \func{bool}{OnCheckValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
27 \param{wxWindow *}{parentWindow}}
28
29 Called when the Tick (Confirm) button is pressed or focus is list. Return FALSE if the value
30 was invalid, which is a signal restores the old value. Return TRUE if the value was valid.
31
32 \membersection{wxPropertyListValidator::OnClearControls}
33
34 \func{bool}{OnClearControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
35 \param{wxWindow *}{parentWindow}}
36
37 Allows the clearing (enabling, disabling) of property list controls, when the focus leaves the current property.
38
39 \membersection{wxPropertyListValidator::OnClearDetailControls}
40
41 \func{bool}{OnClearDetailControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
42 \param{wxWindow *}{parentWindow}}
43
44 Called when the focus is lost, if the validator is in detailed editing mode.
45
46 \membersection{wxPropertyListValidator::OnDisplayValue}
47
48 \func{bool}{OnDisplayValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
49 \param{wxWindow *}{parentWindow}}
50
51 Should display the value in the appropriate controls. The default implementation gets the
52 textual value from the property and inserts it into the text edit control.
53
54 \membersection{wxPropertyListValidator::OnDoubleClick}
55
56 \func{bool}{OnDoubleClick}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
57 \param{wxWindow *}{parentWindow}}
58
59 Called when the property is double clicked. Extra functionality can be provided,
60 such as cycling through possible values.
61
62 \membersection{wxPropertyListValidator::OnEdit}
63
64 \func{bool}{OnEdit}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
65 \param{wxWindow *}{parentWindow}}
66
67 Called when the Edit (detailed editing) button is pressed. The default implementation
68 calls wxPropertyListView::BeginDetailedEditing; a filename validator (for example) overrides
69 this function to show the file selector.
70
71 \membersection{wxPropertyListValidator::OnPrepareControls}
72
73 \func{bool}{OnPrepareControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
74 \param{wxWindow *}{parentWindow}}
75
76 Called to allow the validator to setup the display, such enabling or disabling buttons, and
77 setting the values and selection in the standard listbox control (the one optionally used for displaying
78 value options).
79
80 \membersection{wxPropertyListValidator::OnPrepareDetailControls}
81
82 \func{bool}{OnPrepareDetailControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
83 \param{wxWindow *}{parentWindow}}
84
85 Called when the property is edited `in detail', i.e. when the Edit button is pressed.
86
87 \membersection{wxPropertyListValidator::OnRetrieveValue}
88
89 \func{bool}{OnRetrieveValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
90 \param{wxWindow *}{parentWindow}}
91
92 Called when Tick (Confirm) is pressed or focus is lost or view wants to update
93 the property list. Should do the transfer from the property editing area to the property itself
94
95 \membersection{wxPropertyListValidator::OnSelect}
96
97 \func{bool}{OnSelect}{\param{bool}{ select}, \param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
98 \param{wxWindow *}{parentWindow}}
99
100 Called when the property is selected or deselected: typically displays the value
101 in the edit control (having chosen a suitable control to display: (non)editable text or listbox).
102
103 \membersection{wxPropertyListValidator::OnValueListSelect}
104
105 \func{bool}{OnValueListSelect}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
106 \param{wxWindow *}{parentWindow}}
107
108 Called when the value listbox is selected. The default behaviour is to copy
109 string to text control, and retrieve the value into the property.
110