526954c596
Use "wxWindows licence" and not "wxWidgets licence" (the latter doesn't exist) and consistently spell "licence" using British spelling. See #12165. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@64940 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
555 lines
19 KiB
C++
555 lines
19 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/propgrid/editors.h
|
|
// Purpose: wxPropertyGrid editors
|
|
// Author: Jaakko Salli
|
|
// Modified by:
|
|
// Created: 2007-04-14
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) Jaakko Salli
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_PROPGRID_EDITORS_H_
|
|
#define _WX_PROPGRID_EDITORS_H_
|
|
|
|
#if wxUSE_PROPGRID
|
|
|
|
// -----------------------------------------------------------------------
|
|
// wxPGWindowList contains list of editor windows returned by CreateControls.
|
|
|
|
class wxPGWindowList
|
|
{
|
|
public:
|
|
wxPGWindowList()
|
|
{
|
|
m_primary = m_secondary = NULL;
|
|
}
|
|
|
|
void SetSecondary( wxWindow* secondary ) { m_secondary = secondary; }
|
|
|
|
wxWindow* m_primary;
|
|
wxWindow* m_secondary;
|
|
|
|
wxPGWindowList( wxWindow* a )
|
|
{
|
|
m_primary = a;
|
|
m_secondary = NULL;
|
|
};
|
|
wxPGWindowList( wxWindow* a, wxWindow* b )
|
|
{
|
|
m_primary = a;
|
|
m_secondary = b;
|
|
};
|
|
};
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
/** @class wxPGEditor
|
|
|
|
Base class for custom wxPropertyGrid editors.
|
|
|
|
@remarks
|
|
- Names of builtin property editors are: TextCtrl, Choice,
|
|
ComboBox, CheckBox, TextCtrlAndButton, and ChoiceAndButton. Additional
|
|
editors include SpinCtrl and DatePickerCtrl, but using them requires
|
|
calling wxPropertyGrid::RegisterAdditionalEditors() prior use.
|
|
|
|
- Pointer to builtin editor is available as wxPGEditor_EditorName
|
|
(eg. wxPGEditor_TextCtrl).
|
|
|
|
- To add new editor you need to register it first using static function
|
|
wxPropertyGrid::RegisterEditorClass(), with code like this:
|
|
@code
|
|
wxPGEditor *editorPointer = wxPropertyGrid::RegisterEditorClass(
|
|
new MyEditorClass(), "MyEditor");
|
|
@endcode
|
|
After that, wxPropertyGrid will take ownership of the given object, but
|
|
you should still store editorPointer somewhere, so you can pass it to
|
|
wxPGProperty::SetEditor(), or return it from
|
|
wxPGEditor::DoGetEditorClass().
|
|
|
|
@library{wxpropgrid}
|
|
@category{propgrid}
|
|
*/
|
|
class WXDLLIMPEXP_PROPGRID wxPGEditor : public wxObject
|
|
{
|
|
DECLARE_ABSTRACT_CLASS(wxPGEditor)
|
|
public:
|
|
|
|
/** Constructor. */
|
|
wxPGEditor()
|
|
: wxObject()
|
|
{
|
|
m_clientData = NULL;
|
|
}
|
|
|
|
/** Destructor. */
|
|
virtual ~wxPGEditor();
|
|
|
|
/**
|
|
Returns pointer to the name of the editor. For example,
|
|
wxPGEditor_TextCtrl has name "TextCtrl". If you dont' need to access
|
|
your custom editor by string name, then you do not need to implement
|
|
this function.
|
|
*/
|
|
virtual wxString GetName() const;
|
|
|
|
/**
|
|
Instantiates editor controls.
|
|
|
|
@param propgrid
|
|
wxPropertyGrid to which the property belongs (use as parent for
|
|
control).
|
|
@param property
|
|
Property for which this method is called.
|
|
@param pos
|
|
Position, inside wxPropertyGrid, to create control(s) to.
|
|
@param size
|
|
Initial size for control(s).
|
|
|
|
@remarks
|
|
- Primary control shall use id wxPG_SUBID1, and secondary (button)
|
|
control shall use wxPG_SUBID2.
|
|
- Unlike in previous version of wxPropertyGrid, it is no longer
|
|
necessary to call wxEvtHandler::Connect() for interesting editor
|
|
events. Instead, all events from control are now automatically
|
|
forwarded to wxPGEditor::OnEvent() and wxPGProperty::OnEvent().
|
|
*/
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const = 0;
|
|
|
|
/** Loads value from property to the control. */
|
|
virtual void UpdateControl( wxPGProperty* property,
|
|
wxWindow* ctrl ) const = 0;
|
|
|
|
/**
|
|
Used to get the renderer to draw the value with when the control is
|
|
hidden.
|
|
|
|
Default implementation returns g_wxPGDefaultRenderer.
|
|
*/
|
|
//virtual wxPGCellRenderer* GetCellRenderer() const;
|
|
|
|
/** Draws value for given property.
|
|
*/
|
|
virtual void DrawValue( wxDC& dc,
|
|
const wxRect& rect,
|
|
wxPGProperty* property,
|
|
const wxString& text ) const;
|
|
|
|
/** Handles events. Returns true if value in control was modified
|
|
(see wxPGProperty::OnEvent for more information).
|
|
|
|
@remarks wxPropertyGrid will automatically unfocus the editor when
|
|
wxEVT_COMMAND_TEXT_ENTER is received and when it results in
|
|
property value being modified. This happens regardless of
|
|
editor type (ie. behavior is same for any wxTextCtrl and
|
|
wxComboBox based editor).
|
|
*/
|
|
virtual bool OnEvent( wxPropertyGrid* propgrid, wxPGProperty* property,
|
|
wxWindow* wnd_primary, wxEvent& event ) const = 0;
|
|
|
|
/** Returns value from control, via parameter 'variant'.
|
|
Usually ends up calling property's StringToValue or IntToValue.
|
|
Returns true if value was different.
|
|
*/
|
|
virtual bool GetValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
|
|
/**
|
|
Sets new appearance for the control. Default implementation
|
|
sets foreground colour, background colour, font, plus text
|
|
for wxTextCtrl and wxComboCtrl.
|
|
|
|
@param appearance
|
|
New appearance to be applied.
|
|
|
|
@param oldAppearance
|
|
Previously applied appearance. Used to detect which
|
|
control attributes need to be changed (e.g. so we only
|
|
change background colour if really needed).
|
|
|
|
@param unspecified
|
|
@true if the new appearance represents an unspecified
|
|
property value.
|
|
*/
|
|
virtual void SetControlAppearance( wxPropertyGrid* pg,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
const wxPGCell& appearance,
|
|
const wxPGCell& oldAppearance,
|
|
bool unspecified ) const;
|
|
|
|
/**
|
|
Sets value in control to unspecified.
|
|
*/
|
|
virtual void SetValueToUnspecified( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
|
|
/** Sets control's value specifically from string. */
|
|
virtual void SetControlStringValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
const wxString& txt ) const;
|
|
|
|
/** Sets control's value specifically from int (applies to choice etc.). */
|
|
virtual void SetControlIntValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
int value ) const;
|
|
|
|
/** Inserts item to existing control. Index -1 means appending.
|
|
Default implementation does nothing. Returns index of item added.
|
|
*/
|
|
virtual int InsertItem( wxWindow* ctrl,
|
|
const wxString& label,
|
|
int index ) const;
|
|
|
|
/** Deletes item from existing control.
|
|
Default implementation does nothing.
|
|
*/
|
|
virtual void DeleteItem( wxWindow* ctrl, int index ) const;
|
|
|
|
/** Extra processing when control gains focus. For example, wxTextCtrl
|
|
based controls should select all text.
|
|
*/
|
|
virtual void OnFocus( wxPGProperty* property, wxWindow* wnd ) const;
|
|
|
|
/** Returns true if control itself can contain the custom image. Default is
|
|
to return false.
|
|
*/
|
|
virtual bool CanContainCustomImage() const;
|
|
|
|
//
|
|
// This member is public so scripting language bindings
|
|
// wrapper code can access it freely.
|
|
void* m_clientData;
|
|
};
|
|
|
|
|
|
#define WX_PG_IMPLEMENT_INTERNAL_EDITOR_CLASS(EDITOR,CLASSNAME,BASECLASS) \
|
|
IMPLEMENT_DYNAMIC_CLASS(CLASSNAME, BASECLASS) \
|
|
wxString CLASSNAME::GetName() const \
|
|
{ \
|
|
return wxS(#EDITOR); \
|
|
} \
|
|
wxPGEditor* wxPGEditor_##EDITOR = NULL;
|
|
|
|
|
|
//
|
|
// Following are the built-in editor classes.
|
|
//
|
|
|
|
class WXDLLIMPEXP_PROPGRID wxPGTextCtrlEditor : public wxPGEditor
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxPGTextCtrlEditor)
|
|
public:
|
|
wxPGTextCtrlEditor() {}
|
|
virtual ~wxPGTextCtrlEditor();
|
|
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
virtual void UpdateControl( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual bool OnEvent( wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
wxWindow* primaryCtrl,
|
|
wxEvent& event ) const;
|
|
virtual bool GetValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
|
|
virtual wxString GetName() const;
|
|
|
|
//virtual wxPGCellRenderer* GetCellRenderer() const;
|
|
virtual void SetControlStringValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
const wxString& txt ) const;
|
|
virtual void OnFocus( wxPGProperty* property, wxWindow* wnd ) const;
|
|
|
|
// Provided so that, for example, ComboBox editor can use the same code
|
|
// (multiple inheritance would get way too messy).
|
|
static bool OnTextCtrlEvent( wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
wxEvent& event );
|
|
|
|
static bool GetTextCtrlValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl );
|
|
|
|
};
|
|
|
|
|
|
class WXDLLIMPEXP_PROPGRID wxPGChoiceEditor : public wxPGEditor
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxPGChoiceEditor)
|
|
public:
|
|
wxPGChoiceEditor() {}
|
|
virtual ~wxPGChoiceEditor();
|
|
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
virtual void UpdateControl( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual bool OnEvent( wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
wxWindow* primaryCtrl,
|
|
wxEvent& event ) const;
|
|
virtual bool GetValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual void SetValueToUnspecified( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual wxString GetName() const;
|
|
|
|
virtual void SetControlIntValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
int value ) const;
|
|
virtual void SetControlStringValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
const wxString& txt ) const;
|
|
|
|
virtual int InsertItem( wxWindow* ctrl,
|
|
const wxString& label,
|
|
int index ) const;
|
|
virtual void DeleteItem( wxWindow* ctrl, int index ) const;
|
|
virtual bool CanContainCustomImage() const;
|
|
|
|
// CreateControls calls this with CB_READONLY in extraStyle
|
|
wxWindow* CreateControlsBase( wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& sz,
|
|
long extraStyle ) const;
|
|
|
|
};
|
|
|
|
|
|
class WXDLLIMPEXP_PROPGRID wxPGComboBoxEditor : public wxPGChoiceEditor
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxPGComboBoxEditor)
|
|
public:
|
|
wxPGComboBoxEditor() {}
|
|
virtual ~wxPGComboBoxEditor();
|
|
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
|
|
virtual wxString GetName() const;
|
|
|
|
virtual void UpdateControl( wxPGProperty* property, wxWindow* ctrl ) const;
|
|
|
|
virtual bool OnEvent( wxPropertyGrid* propgrid, wxPGProperty* property,
|
|
wxWindow* ctrl, wxEvent& event ) const;
|
|
|
|
virtual bool GetValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
|
|
virtual void OnFocus( wxPGProperty* property, wxWindow* wnd ) const;
|
|
|
|
};
|
|
|
|
|
|
class WXDLLIMPEXP_PROPGRID wxPGChoiceAndButtonEditor : public wxPGChoiceEditor
|
|
{
|
|
public:
|
|
wxPGChoiceAndButtonEditor() {}
|
|
virtual ~wxPGChoiceAndButtonEditor();
|
|
virtual wxString GetName() const;
|
|
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxPGChoiceAndButtonEditor)
|
|
};
|
|
|
|
class WXDLLIMPEXP_PROPGRID
|
|
wxPGTextCtrlAndButtonEditor : public wxPGTextCtrlEditor
|
|
{
|
|
public:
|
|
wxPGTextCtrlAndButtonEditor() {}
|
|
virtual ~wxPGTextCtrlAndButtonEditor();
|
|
virtual wxString GetName() const;
|
|
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxPGTextCtrlAndButtonEditor)
|
|
};
|
|
|
|
|
|
#if wxPG_INCLUDE_CHECKBOX
|
|
|
|
//
|
|
// Use custom check box code instead of native control
|
|
// for cleaner (ie. more integrated) look.
|
|
//
|
|
class WXDLLIMPEXP_PROPGRID wxPGCheckBoxEditor : public wxPGEditor
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxPGCheckBoxEditor)
|
|
public:
|
|
wxPGCheckBoxEditor() {}
|
|
virtual ~wxPGCheckBoxEditor();
|
|
|
|
virtual wxString GetName() const;
|
|
virtual wxPGWindowList CreateControls(wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
const wxPoint& pos,
|
|
const wxSize& size) const;
|
|
virtual void UpdateControl( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual bool OnEvent( wxPropertyGrid* propgrid,
|
|
wxPGProperty* property,
|
|
wxWindow* primaryCtrl,
|
|
wxEvent& event ) const;
|
|
virtual bool GetValueFromControl( wxVariant& variant,
|
|
wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
virtual void SetValueToUnspecified( wxPGProperty* property,
|
|
wxWindow* ctrl ) const;
|
|
|
|
virtual void DrawValue( wxDC& dc,
|
|
const wxRect& rect,
|
|
wxPGProperty* property,
|
|
const wxString& text ) const;
|
|
//virtual wxPGCellRenderer* GetCellRenderer() const;
|
|
|
|
virtual void SetControlIntValue( wxPGProperty* property,
|
|
wxWindow* ctrl,
|
|
int value ) const;
|
|
};
|
|
|
|
#endif
|
|
|
|
|
|
// -----------------------------------------------------------------------
|
|
// Editor class registeration macro (mostly for internal use)
|
|
|
|
#define wxPGRegisterEditorClass(EDITOR) \
|
|
if ( wxPGEditor_##EDITOR == NULL ) \
|
|
{ \
|
|
wxPGEditor_##EDITOR = wxPropertyGrid::RegisterEditorClass( \
|
|
new wxPG##EDITOR##Editor ); \
|
|
}
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
/** @class wxPGEditorDialogAdapter
|
|
|
|
Derive a class from this to adapt an existing editor dialog or function to
|
|
be used when editor button of a property is pushed.
|
|
|
|
You only need to derive class and implement DoShowDialog() to create and
|
|
show the dialog, and finally submit the value returned by the dialog
|
|
via SetValue().
|
|
|
|
@library{wxpropgrid}
|
|
@category{propgrid}
|
|
*/
|
|
class WXDLLIMPEXP_PROPGRID wxPGEditorDialogAdapter : public wxObject
|
|
{
|
|
DECLARE_ABSTRACT_CLASS(wxPGEditorDialogAdapter)
|
|
public:
|
|
wxPGEditorDialogAdapter()
|
|
: wxObject()
|
|
{
|
|
m_clientData = NULL;
|
|
}
|
|
|
|
virtual ~wxPGEditorDialogAdapter() { }
|
|
|
|
bool ShowDialog( wxPropertyGrid* propGrid, wxPGProperty* property );
|
|
|
|
virtual bool DoShowDialog( wxPropertyGrid* propGrid,
|
|
wxPGProperty* property ) = 0;
|
|
|
|
void SetValue( wxVariant value )
|
|
{
|
|
m_value = value;
|
|
}
|
|
|
|
/**
|
|
This method is typically only used if deriving class from existing
|
|
adapter with value conversion purposes.
|
|
*/
|
|
wxVariant& GetValue() { return m_value; }
|
|
|
|
//
|
|
// This member is public so scripting language bindings
|
|
// wrapper code can access it freely.
|
|
void* m_clientData;
|
|
|
|
private:
|
|
wxVariant m_value;
|
|
};
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
|
|
/** @class wxPGMultiButton
|
|
|
|
This class can be used to have multiple buttons in a property editor.
|
|
You will need to create a new property editor class, override
|
|
CreateControls, and have it return wxPGMultiButton instance in
|
|
wxPGWindowList::SetSecondary().
|
|
*/
|
|
class WXDLLIMPEXP_PROPGRID wxPGMultiButton : public wxWindow
|
|
{
|
|
public:
|
|
wxPGMultiButton( wxPropertyGrid* pg, const wxSize& sz );
|
|
virtual ~wxPGMultiButton() {}
|
|
|
|
wxWindow* GetButton( unsigned int i ) { return (wxWindow*) m_buttons[i]; }
|
|
const wxWindow* GetButton( unsigned int i ) const
|
|
{ return (const wxWindow*) m_buttons[i]; }
|
|
|
|
/** Utility function to be used in event handlers.
|
|
*/
|
|
int GetButtonId( unsigned int i ) const { return GetButton(i)->GetId(); }
|
|
|
|
/** Returns number of buttons.
|
|
*/
|
|
unsigned int GetCount() const { return (unsigned int) m_buttons.size(); }
|
|
|
|
void Add( const wxString& label, int id = -2 );
|
|
#if wxUSE_BMPBUTTON
|
|
void Add( const wxBitmap& bitmap, int id = -2 );
|
|
#endif
|
|
|
|
wxSize GetPrimarySize() const
|
|
{
|
|
return wxSize(m_fullEditorSize.x - m_buttonsWidth, m_fullEditorSize.y);
|
|
}
|
|
|
|
void Finalize( wxPropertyGrid* propGrid, const wxPoint& pos );
|
|
|
|
protected:
|
|
|
|
void DoAddButton( wxWindow* button, const wxSize& sz );
|
|
|
|
int GenId( int id ) const;
|
|
|
|
wxArrayPtrVoid m_buttons;
|
|
wxSize m_fullEditorSize;
|
|
int m_buttonsWidth;
|
|
};
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
#endif // wxUSE_PROPGRID
|
|
|
|
#endif // _WX_PROPGRID_EDITORS_H_
|