wxPGEditor Class Reference

Base for property editor classes. More...

#include <editors.h>

Inheritance diagram for wxPGEditor:

Public Member Functions
bool	ActualGetValueFromControl (wxVariant &variant, wxPGProperty property, wxWindow ctrl) const
virtual bool	CanContainCustomImage () const
virtual wxPGWindowList	CreateControls (wxPropertyGrid propgrid, wxPGProperty property, const wxPoint &pos, const wxSize &size) const =0
virtual void	DeleteItem (wxWindow *ctrl, int index) const
virtual void	DrawValue (wxDC &dc, const wxRect &rect, wxPGProperty *property, const wxString &text) const
virtual wxPG_CONST_WXCHAR_PTR	GetName () const =0
virtual int	InsertItem (wxWindow *ctrl, const wxString &label, int index) const
virtual bool	OnEvent (wxPropertyGrid propgrid, wxPGProperty property, wxWindow *wnd_primary, wxEvent &event) const =0
virtual void	OnFocus (wxPGProperty property, wxWindow wnd) const
virtual void	SetControlIntValue (wxPGProperty property, wxWindow ctrl, int value) const
virtual void	SetControlStringValue (wxPGProperty property, wxWindow ctrl, const wxString &txt) const
virtual void	SetValueToUnspecified (wxPGProperty property, wxWindow ctrl) const =0
virtual void	UpdateControl (wxPGProperty property, wxWindow ctrl) const =0
	wxPGEditor ()
virtual	~wxPGEditor ()
Private Member Functions
virtual bool	GetValueFromControl (wxVariant &variant, wxPGProperty property, wxWindow ctrl) const WX_PG_NOT_PURE_IN_WXPYTHON

Detailed Description

Base for property editor classes.

Remarks:

Event handling: wxPGEditor::CreateControls should Connect all necessary events to the wxPropertyGrid::OnCustomEditorEvent. For Example:

            // Relays wxEVT_COMMAND_TEXT_UPDATED events of primary editor
            // control to the OnEvent.
            // NOTE: This event in particular is actually automatically conveyed, but
            //   it is just used as an example.
            propgrid->Connect( wxPG_SUBID1, wxEVT_COMMAND_TEXT_UPDATED,
                              (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction)
                              &wxPropertyGrid::OnCustomEditorEvent );

OnCustomEditorEvent will then forward events, first to wxPGEditor::OnEvent and then to wxPGProperty::OnEvent.

You need to call macro wxPGRegisterEditorClass(EditorName) before using a custom editor class.
See propgrid.cpp for how builtin editors works (starting from wxPGTextCtrlEditor).

Definition at line 68 of file editors.h.

Constructor & Destructor Documentation

wxPGEditor::wxPGEditor ( ) [inline]

Constructor.

Definition at line 76 of file editors.h.

virtual wxPGEditor::~wxPGEditor ( ) [virtual]

Destructor.

Member Function Documentation

bool wxPGEditor::ActualGetValueFromControl	(	wxVariant &	variant,
		wxPGProperty *	property,
		wxWindow *	ctrl
	)			const `[inline]`

Definition at line 146 of file editors.h.

virtual bool wxPGEditor::CanContainCustomImage ( ) const [virtual]

Returns true if control itself can contain the custom image. Default is to return false.

Reimplemented in wxPGChoiceEditor.

virtual wxPGWindowList wxPGEditor::CreateControls	(	wxPropertyGrid *	propgrid,
		wxPGProperty *	property,
		const wxPoint &	pos,
		const wxSize &	size
	)			const `[pure virtual]`

Instantiates editor controls.

Remarks:

Primary control shall use id wxPG_SUBID1, and secondary (button) control shall use wxPG_SUBID2.

Parameters:

	propgrid	wxPropertyGrid to which the property belongs (use as parent for control).
	property	Property for which this method is called.
	pos	Position, inside wxPropertyGrid, to create control(s) to.
	size	Initial size for control(s).

virtual void wxPGEditor::DeleteItem	(	wxWindow *	ctrl,
		int	index
	)			const `[virtual]`

Deletes item from existing control. Default implementation does nothing.

Reimplemented in wxPGChoiceEditor.

virtual void wxPGEditor::DrawValue	(	wxDC &	dc,
		const wxRect &	rect,
		wxPGProperty *	property,
		const wxString &	text
	)			const `[virtual]`

Used to get the renderer to draw the value with when the control is hidden.

Default implementation returns g_wxPGDefaultRenderer. Draws value for given property.

virtual wxPG_CONST_WXCHAR_PTR wxPGEditor::GetName ( ) const [pure virtual]

Returns pointer to the name of the editor. For example, wxPG_EDITOR(TextCtrl) has name "TextCtrl". This method is autogenerated for custom editors.

Implemented in wxPGTextCtrlEditor, wxPGChoiceEditor, wxPGComboBoxEditor, wxPGChoiceAndButtonEditor, and wxPGTextCtrlAndButtonEditor.

virtual bool wxPGEditor::GetValueFromControl	(	wxVariant &	variant,
		wxPGProperty *	property,
		wxWindow *	ctrl
	)			const `[private, virtual]`

Returns value from control, via parameter 'variant'. Usually ends up calling property's StringToValue or IntToValue. Returns true if value was different.

Reimplemented in wxPGComboBoxEditor.

virtual int wxPGEditor::InsertItem	(	wxWindow *	ctrl,
		const wxString &	label,
		int	index
	)			const `[virtual]`

Inserts item to existing control. Index -1 means appending. Default implementation does nothing. Returns index of item added.

Reimplemented in wxPGChoiceEditor.

virtual bool wxPGEditor::OnEvent	(	wxPropertyGrid *	propgrid,
		wxPGProperty *	property,
		wxWindow *	wnd_primary,
		wxEvent &	event
	)			const `[pure virtual]`

Handles events. Returns true if value in control was modified (see wxPGProperty::OnEvent for more information).

Implemented in wxPGComboBoxEditor.

virtual void wxPGEditor::OnFocus	(	wxPGProperty *	property,
		wxWindow *	wnd
	)			const `[virtual]`

Extra processing when control gains focus. For example, wxTextCtrl based controls should select all text.

Reimplemented in wxPGTextCtrlEditor, and wxPGComboBoxEditor.

virtual void wxPGEditor::SetControlIntValue	(	wxPGProperty *	property,
		wxWindow *	ctrl,
		int	value
	)			const `[virtual]`

Sets control's value specifically from int (applies to choice etc.).

Reimplemented in wxPGChoiceEditor.

virtual void wxPGEditor::SetControlStringValue	(	wxPGProperty *	property,
		wxWindow *	ctrl,
		const wxString &	txt
	)			const `[virtual]`

Sets control's value specifically from string.

Reimplemented in wxPGTextCtrlEditor, and wxPGChoiceEditor.

virtual void wxPGEditor::SetValueToUnspecified	(	wxPGProperty *	property,
		wxWindow *	ctrl
	)			const `[pure virtual]`

Sets value in control to unspecified.

virtual void wxPGEditor::UpdateControl	(	wxPGProperty *	property,
		wxWindow *	ctrl
	)			const `[pure virtual]`

Loads value from property to the control.

Implemented in wxPGComboBoxEditor.

The documentation for this class was generated from the following file:

editors.h

wxPGEditor Class Reference

Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation