1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/propgrid/propgridiface.cpp
3 // Purpose: wxPropertyGridInterface class
4 // Author: Jaakko Salli
8 // Copyright: (c) Jaakko Salli
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
12 // For compilers that support precompilation, includes "wx/wx.h".
13 #include "wx/wxprec.h"
23 #include "wx/object.h"
25 #include "wx/string.h"
28 #include "wx/window.h"
31 #include "wx/dcmemory.h"
32 #include "wx/button.h"
35 #include "wx/settings.h"
40 #include <wx/propgrid/property.h>
41 #include <wx/propgrid/propgrid.h>
44 const wxChar
*wxPGTypeName_long
= wxT("long");
45 const wxChar
*wxPGTypeName_bool
= wxT("bool");
46 const wxChar
*wxPGTypeName_double
= wxT("double");
47 const wxChar
*wxPGTypeName_wxString
= wxT("string");
48 const wxChar
*wxPGTypeName_void
= wxT("void*");
49 const wxChar
*wxPGTypeName_wxArrayString
= wxT("arrstring");
52 // ----------------------------------------------------------------------------
54 // ----------------------------------------------------------------------------
56 WX_PG_IMPLEMENT_VARIANT_DATA_EXPORTED(wxPoint
, WXDLLIMPEXP_PROPGRID
)
57 WX_PG_IMPLEMENT_VARIANT_DATA_EXPORTED(wxSize
, WXDLLIMPEXP_PROPGRID
)
58 WX_PG_IMPLEMENT_VARIANT_DATA_EXPORTED_DUMMY_EQ(wxArrayInt
, WXDLLIMPEXP_PROPGRID
)
60 // For wxLongLong and wxULongLong have custom classname << variant
61 // implementation for improved flexibility.
62 WX_PG_IMPLEMENT_VARIANT_DATA_EXPORTED_NO_EQ_NO_GETTER(wxLongLong
, WXDLLIMPEXP_PROPGRID
)
63 WX_PG_IMPLEMENT_VARIANT_DATA_EQ(wxLongLong
, WXDLLIMPEXP_PROPGRID
)
64 WXDLLIMPEXP_PROPGRID wxLongLong
& operator << ( wxLongLong
&value
, const wxVariant
&variant
)
67 if ( !wxPGVariantToLongLong(variant
, &ll
) )
69 wxFAIL_MSG("Cannot convert to wxLongLong");
74 WXDLLIMPEXP_PROPGRID wxLongLong_t
& operator << ( wxLongLong_t
&value
, const wxVariant
&variant
)
76 if ( !wxPGVariantToLongLong(variant
, &value
) )
78 wxFAIL_MSG("Cannot convert to wxLongLong");
83 WX_PG_IMPLEMENT_VARIANT_DATA_EXPORTED_NO_EQ_NO_GETTER(wxULongLong
, WXDLLIMPEXP_PROPGRID
)
84 WX_PG_IMPLEMENT_VARIANT_DATA_EQ(wxULongLong
, WXDLLIMPEXP_PROPGRID
)
85 WXDLLIMPEXP_PROPGRID wxULongLong
& operator << ( wxULongLong
&value
, const wxVariant
&variant
)
88 if ( !wxPGVariantToULongLong(variant
, &ull
) )
90 wxFAIL_MSG("Cannot convert to wxULongLong");
95 WXDLLIMPEXP_PROPGRID wxULongLong_t
& operator << ( wxULongLong_t
&value
, const wxVariant
&variant
)
97 if ( !wxPGVariantToULongLong(variant
, &value
) )
99 wxFAIL_MSG("Cannot convert to wxULongLong");
104 IMPLEMENT_VARIANT_OBJECT_EXPORTED(wxFont
, WXDLLIMPEXP_PROPGRID
)
106 // -----------------------------------------------------------------------
108 // -----------------------------------------------------------------------
110 long wxPGVariantToInt( const wxVariant
& variant
, long defVal
)
112 if ( variant
.IsNull() )
115 if ( variant
.GetType() == wxS("long") )
116 return variant
.GetLong();
118 if ( variant
.GetType() == wxS("bool") )
119 return variant
.GetBool() ? 1 : 0;
121 if ( variant
.GetType() == wxS("wxLongLong") )
125 if ( ll
>= LONG_MAX
)
127 else if ( ll
<= LONG_MIN
)
134 if ( variant
.GetType() == wxPG_VARIANT_TYPE_STRING
)
135 variant
.GetString().ToLong(&l
, 0);
140 // -----------------------------------------------------------------------
142 bool wxPGVariantToLongLong( const wxVariant
& variant
, wxLongLong_t
* pResult
)
144 if ( variant
.IsNull() )
147 wxString variantType
= variant
.GetType();
149 if ( variantType
== wxPG_VARIANT_TYPE_LONG
)
151 *pResult
= variant
.GetLong();
155 if ( variantType
== wxLongLong_VariantType
)
157 // NOTE: << operator uses this functions, so we can't use it here
158 *pResult
= wxLongLongRefFromVariant(variant
).GetValue();
165 // -----------------------------------------------------------------------
167 bool wxPGVariantToULongLong( const wxVariant
& variant
, wxULongLong_t
* pResult
)
169 if ( variant
.IsNull() )
172 wxString variantType
= variant
.GetType();
174 if ( variantType
== wxPG_VARIANT_TYPE_LONG
)
176 *pResult
= (unsigned long)variant
.GetLong();
180 if ( variantType
== wxULongLong_VariantType
)
182 // NOTE: << operator uses this functions, so we can't use it here
183 *pResult
= wxULongLongRefFromVariant(variant
).GetValue();
190 // -----------------------------------------------------------------------
192 bool wxPGVariantToDouble( const wxVariant
& variant
, double* pResult
)
194 if ( variant
.IsNull() )
197 wxString variantType
= variant
.GetType();
199 if ( variantType
== wxPG_VARIANT_TYPE_DOUBLE
)
201 *pResult
= variant
.GetDouble();
205 if ( variantType
== wxPG_VARIANT_TYPE_LONG
)
207 *pResult
= (double)variant
.GetLong();
211 if ( variantType
== wxLongLong_VariantType
)
215 *pResult
= ll
.ToDouble();
219 if ( variantType
== wxPG_VARIANT_TYPE_STRING
)
220 if ( variant
.GetString().ToDouble(pResult
) )
226 // -----------------------------------------------------------------------
228 // -----------------------------------------------------------------------
230 wxPGProperty
* wxPGPropArgCls::GetPtr( wxPropertyGridInterface
* iface
) const
232 if ( m_flags
== IsProperty
)
234 wxASSERT_MSG( m_ptr
.property
, wxT("invalid property ptr") );
235 return m_ptr
.property
;
237 else if ( m_flags
& IsWxString
)
238 return iface
->GetPropertyByNameA(*m_ptr
.stringName
);
239 else if ( m_flags
& IsCharPtr
)
240 return iface
->GetPropertyByNameA(m_ptr
.charName
);
242 else if ( m_flags
& IsWCharPtr
)
243 return iface
->GetPropertyByNameA(m_ptr
.wcharName
);
249 // -----------------------------------------------------------------------
250 // wxPropertyGridInterface
251 // -----------------------------------------------------------------------
253 void wxPropertyGridInterface::RefreshGrid( wxPropertyGridPageState
* state
)
258 wxPropertyGrid
* grid
= state
->GetGrid();
259 if ( grid
->GetState() == state
&& !grid
->IsFrozen() )
265 // -----------------------------------------------------------------------
267 wxPGProperty
* wxPropertyGridInterface::Append( wxPGProperty
* property
)
269 wxPGProperty
* retp
= m_pState
->DoAppend(property
);
271 wxPropertyGrid
* grid
= m_pState
->GetGrid();
278 // -----------------------------------------------------------------------
280 wxPGProperty
* wxPropertyGridInterface::AppendIn( wxPGPropArg id
, wxPGProperty
* newproperty
)
282 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxNullProperty
)
283 wxPGProperty
* pwc
= (wxPGProperty
*) p
;
284 wxPGProperty
* retp
= m_pState
->DoInsert(pwc
, pwc
->GetChildCount(), newproperty
);
288 // -----------------------------------------------------------------------
290 wxPGProperty
* wxPropertyGridInterface::Insert( wxPGPropArg id
, wxPGProperty
* property
)
292 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxNullProperty
)
293 wxPGProperty
* retp
= m_pState
->DoInsert(p
->GetParent(), p
->GetArrIndex(), property
);
298 // -----------------------------------------------------------------------
300 wxPGProperty
* wxPropertyGridInterface::Insert( wxPGPropArg id
, int index
, wxPGProperty
* newproperty
)
302 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxNullProperty
)
303 wxPGProperty
* retp
= m_pState
->DoInsert((wxPGProperty
*)p
,index
,newproperty
);
308 // -----------------------------------------------------------------------
310 void wxPropertyGridInterface::DeleteProperty( wxPGPropArg id
)
312 wxPG_PROP_ARG_CALL_PROLOG()
314 wxPropertyGridPageState
* state
= p
->GetParentState();
315 wxPropertyGrid
* grid
= state
->GetGrid();
317 if ( grid
->GetState() == state
)
319 bool selRes
= grid
->DoSelectProperty(NULL
, wxPG_SEL_DELETING
);
320 wxPG_CHECK_RET_DBG( selRes
,
321 wxT("failed to deselect a property (editor probably had invalid value)") );
324 state
->DoDelete( p
);
329 // -----------------------------------------------------------------------
331 wxPGProperty
* wxPropertyGridInterface::ReplaceProperty( wxPGPropArg id
, wxPGProperty
* property
)
333 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxNullProperty
)
335 wxPGProperty
* replaced
= p
;
336 wxCHECK_MSG( replaced
&& property
,
338 wxT("NULL property") );
339 wxCHECK_MSG( !replaced
->IsCategory(),
341 wxT("cannot replace this type of property") );
342 wxCHECK_MSG( !m_pState
->IsInNonCatMode(),
344 wxT("cannot replace properties in alphabetic mode") );
346 // Get address to the slot
347 wxPGProperty
* parent
= replaced
->GetParent();
348 int ind
= replaced
->GetIndexInParent();
350 wxPropertyGridPageState
* state
= replaced
->GetParentState();
351 DeleteProperty(replaced
); // Must use generic Delete
352 state
->DoInsert(parent
,ind
,property
);
357 // -----------------------------------------------------------------------
358 // wxPropertyGridInterface property operations
359 // -----------------------------------------------------------------------
361 bool wxPropertyGridInterface::ClearSelection()
363 wxPropertyGridPageState
* state
= m_pState
;
364 wxPropertyGrid
* pg
= state
->GetGrid();
365 if ( pg
->GetState() == state
)
366 return pg
->DoClearSelection();
368 state
->SetSelection(NULL
);
372 // -----------------------------------------------------------------------
374 void wxPropertyGridInterface::LimitPropertyEditing( wxPGPropArg id
, bool limit
)
376 wxPG_PROP_ARG_CALL_PROLOG()
378 m_pState
->DoLimitPropertyEditing(p
, limit
);
382 // -----------------------------------------------------------------------
384 bool wxPropertyGridInterface::EnableProperty( wxPGPropArg id
, bool enable
)
386 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
388 wxPropertyGridPageState
* state
= p
->GetParentState();
389 wxPropertyGrid
* grid
= state
->GetGrid();
393 if ( !(p
->m_flags
& wxPG_PROP_DISABLED
) )
396 // If active, Set active Editor.
397 if ( grid
->GetState() == state
&& p
== grid
->GetSelection() )
398 grid
->DoSelectProperty( p
, wxPG_SEL_FORCE
);
402 if ( p
->m_flags
& wxPG_PROP_DISABLED
)
405 // If active, Disable as active Editor.
406 if ( grid
->GetState() == state
&& p
== grid
->GetSelection() )
407 grid
->DoSelectProperty( p
, wxPG_SEL_FORCE
);
410 state
->DoEnableProperty(p
, enable
);
412 RefreshProperty( p
);
417 // -----------------------------------------------------------------------
419 bool wxPropertyGridInterface::ExpandAll( bool doExpand
)
421 wxPropertyGridPageState
* state
= m_pState
;
423 if ( !state
->DoGetRoot()->GetChildCount() )
426 wxPropertyGrid
* pg
= state
->GetGrid();
428 if ( GetSelection() && GetSelection() != state
->DoGetRoot() &&
431 if ( !pg
->ClearSelection() )
437 for ( it
= GetVIterator( wxPG_ITERATE_ALL
); !it
.AtEnd(); it
.Next() )
439 wxPGProperty
* p
= (wxPGProperty
*) it
.GetProperty();
440 if ( p
->GetChildCount() )
444 if ( !p
->IsExpanded() )
451 if ( p
->IsExpanded() )
453 state
->DoCollapse(p
);
459 pg
->RecalculateVirtualSize();
466 // -----------------------------------------------------------------------
468 void wxPropertyGridInterface::SetPropertyValueUnspecified( wxPGPropArg id
)
470 wxPG_PROP_ARG_CALL_PROLOG()
471 wxPropertyGrid
* propGrid
= p
->GetGridIfDisplayed();
473 propGrid
->DoSetPropertyValueUnspecified(p
);
475 p
->GetParentState()->DoSetPropertyValueUnspecified(p
);
478 // -----------------------------------------------------------------------
479 // wxPropertyGridInterface property value setting and getting
480 // -----------------------------------------------------------------------
482 void wxPGGetFailed( const wxPGProperty
* p
, const wxString
& typestr
)
484 wxPGTypeOperationFailed(p
, typestr
, wxS("Get"));
487 // -----------------------------------------------------------------------
489 void wxPGTypeOperationFailed( const wxPGProperty
* p
,
490 const wxString
& typestr
,
493 wxASSERT( p
!= NULL
);
494 wxLogError( _("Type operation \"%s\" failed: Property labeled \"%s\" is of type \"%s\", NOT \"%s\"."),
495 op
.c_str(), p
->GetLabel().c_str(), p
->GetValue().GetType().c_str(), typestr
.c_str() );
498 // -----------------------------------------------------------------------
500 void wxPropertyGridInterface::SetPropVal( wxPGPropArg id
, wxVariant
& value
)
502 wxPG_PROP_ARG_CALL_PROLOG()
507 wxPropertyGrid
* propGrid
= p
->GetGridIfDisplayed();
509 propGrid
->DrawItemAndValueRelated( p
);
514 // -----------------------------------------------------------------------
516 void wxPropertyGridInterface::SetPropertyValueString( wxPGPropArg id
, const wxString
& value
)
518 wxPG_PROP_ARG_CALL_PROLOG()
520 if ( m_pState
->DoSetPropertyValueString(p
,value
) )
522 wxPropertyGrid
* propGrid
= p
->GetGridIfDisplayed();
524 propGrid
->DrawItemAndValueRelated( p
);
528 // -----------------------------------------------------------------------
530 void wxPropertyGridInterface::SetValidationFailureBehavior( int vfbFlags
)
532 GetPropertyGrid()->m_permanentValidationFailureBehavior
= vfbFlags
;
535 // -----------------------------------------------------------------------
537 wxPGProperty
* wxPropertyGridInterface::GetPropertyByNameA( const wxString
& name
) const
539 wxPGProperty
* p
= GetPropertyByName(name
);
540 wxASSERT_MSG(p
,wxString::Format(wxT("no property with name '%s'"),name
.c_str()));
544 // ----------------------------------------------------------------------------
546 wxPGProperty
* wxPropertyGridInterface::GetPropertyByLabel( const wxString
& label
) const
550 for ( it
= GetVIterator( wxPG_ITERATE_PROPERTIES
); !it
.AtEnd(); it
.Next() )
552 if ( it
.GetProperty()->GetLabel() == label
)
553 return it
.GetProperty();
556 return wxNullProperty
;
559 // ----------------------------------------------------------------------------
561 void wxPropertyGridInterface::DoSetPropertyAttribute( wxPGPropArg id
, const wxString
& name
,
562 wxVariant
& value
, long argFlags
)
564 wxPG_PROP_ARG_CALL_PROLOG()
566 p
->SetAttribute( name
, value
);
568 if ( argFlags
& wxPG_RECURSE
)
571 for ( i
= 0; i
< p
->GetChildCount(); i
++ )
572 DoSetPropertyAttribute(p
->Item(i
), name
, value
, argFlags
);
576 // -----------------------------------------------------------------------
578 void wxPropertyGridInterface::SetPropertyAttributeAll( const wxString
& attrName
,
581 unsigned int pageIndex
= 0;
585 wxPropertyGridPageState
* page
= GetPageState(pageIndex
);
588 DoSetPropertyAttribute(page
->DoGetRoot(), attrName
, value
, wxPG_RECURSE
);
594 // -----------------------------------------------------------------------
596 void wxPropertyGridInterface::GetPropertiesWithFlag( wxArrayPGProperty
* targetArr
,
597 wxPGProperty::FlagType flags
,
599 int iterFlags
) const
601 wxASSERT( targetArr
);
602 wxPGVIterator it
= GetVIterator( iterFlags
);
608 const wxPGProperty
* property
= it
.GetProperty();
612 if ( (property
->GetFlags() & flags
) == flags
)
613 targetArr
->push_back((wxPGProperty
*)property
);
617 if ( (property
->GetFlags() & flags
) != flags
)
618 targetArr
->push_back((wxPGProperty
*)property
);
623 // -----------------------------------------------------------------------
625 void wxPropertyGridInterface::SetPropertiesFlag( const wxArrayPGProperty
& srcArr
,
626 wxPGProperty::FlagType flags
,
631 for ( i
=0; i
<srcArr
.size(); i
++ )
633 wxPGProperty
* property
= srcArr
[i
];
636 property
->SetFlag(flags
);
638 property
->ClearFlag(flags
);
641 // If collapsed flag or hidden was manipulated, we need to update virtual
643 wxPropertyGrid
* pg
= GetPropertyGrid();
644 if ( flags
& (wxPG_PROP_COLLAPSED
|wxPG_PROP_HIDDEN
) )
646 GetState()->VirtualHeightChanged();
647 pg
->RecalculateVirtualSize();
651 // -----------------------------------------------------------------------
653 void wxPropertyGridInterface::SetBoolChoices( const wxString
& trueChoice
,
654 const wxString
& falseChoice
)
656 wxPGGlobalVars
->m_boolChoices
[0] = falseChoice
;
657 wxPGGlobalVars
->m_boolChoices
[1] = trueChoice
;
660 // -----------------------------------------------------------------------
662 wxPGProperty
* wxPropertyGridInterface::DoGetPropertyByName( const wxString
& name
) const
664 return m_pState
->BaseGetPropertyByName(name
);
667 // -----------------------------------------------------------------------
669 wxPGProperty
* wxPropertyGridInterface::GetPropertyByName( const wxString
& name
,
670 const wxString
& subname
) const
672 wxPGProperty
* p
= DoGetPropertyByName(name
);
673 if ( !p
|| !p
->GetChildCount() )
674 return wxNullProperty
;
676 return p
->GetPropertyByName(subname
);
679 // -----------------------------------------------------------------------
681 // Since GetPropertyByName is used *a lot*, this makes sense
682 // since non-virtual method can be called with less code.
683 wxPGProperty
* wxPropertyGridInterface::GetPropertyByName( const wxString
& name
) const
685 wxPGProperty
* p
= DoGetPropertyByName(name
);
689 // Check if its "Property.SubProperty" format
690 int pos
= name
.Find(wxT('.'));
694 return GetPropertyByName(name
.substr(0,pos
),
695 name
.substr(pos
+1,name
.length()-pos
-1));
698 // -----------------------------------------------------------------------
700 bool wxPropertyGridInterface::HideProperty( wxPGPropArg id
, bool hide
, int flags
)
702 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
704 wxPropertyGrid
* pg
= m_pState
->GetGrid();
706 if ( pg
== p
->GetGrid() )
707 return pg
->DoHideProperty(p
, hide
, flags
);
709 m_pState
->DoHideProperty(p
, hide
, flags
);
714 // -----------------------------------------------------------------------
716 bool wxPropertyGridInterface::Collapse( wxPGPropArg id
)
718 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
719 wxPropertyGrid
* pg
= p
->GetGridIfDisplayed();
721 return pg
->DoCollapse(p
);
723 return p
->GetParentState()->DoCollapse(p
);
726 // -----------------------------------------------------------------------
728 bool wxPropertyGridInterface::Expand( wxPGPropArg id
)
730 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
731 wxPropertyGrid
* pg
= p
->GetGridIfDisplayed();
733 return pg
->DoExpand(p
);
735 return p
->GetParentState()->DoExpand(p
);
738 // -----------------------------------------------------------------------
740 void wxPropertyGridInterface::SetPropertyLabel( wxPGPropArg id
, const wxString
& newproplabel
)
742 wxPG_PROP_ARG_CALL_PROLOG()
744 p
->SetLabel( newproplabel
);
746 wxPropertyGridPageState
* state
= p
->GetParentState();
747 wxPropertyGrid
* pg
= state
->GetGrid();
749 if ( pg
->HasFlag(wxPG_AUTO_SORT
) )
750 pg
->SortChildren(p
->GetParent());
752 if ( pg
->GetState() == state
)
754 if ( pg
->HasFlag(wxPG_AUTO_SORT
) )
761 // -----------------------------------------------------------------------
763 bool wxPropertyGridInterface::SetPropertyMaxLength( wxPGPropArg id
, int maxLen
)
765 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
767 wxPropertyGrid
* pg
= m_pState
->GetGrid();
769 p
->m_maxLen
= (short) maxLen
;
771 // Adjust control if selected currently
772 if ( pg
== p
->GetGrid() && p
== m_pState
->GetSelection() )
774 wxWindow
* wnd
= pg
->GetEditorControl();
775 wxTextCtrl
* tc
= wxDynamicCast(wnd
,wxTextCtrl
);
777 tc
->SetMaxLength( maxLen
);
786 // -----------------------------------------------------------------------
787 // GetPropertyValueAsXXX methods
789 #define IMPLEMENT_GET_VALUE(T,TRET,BIGNAME,DEFRETVAL) \
790 TRET wxPropertyGridInterface::GetPropertyValueAs##BIGNAME( wxPGPropArg id ) const \
792 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(DEFRETVAL) \
793 wxVariant value = p->GetValue(); \
794 if ( wxStrcmp(value.GetType(), wxPGTypeName_##T) != 0 ) \
796 wxPGGetFailed(p,wxPGTypeName_##T); \
797 return (TRET)DEFRETVAL; \
799 return (TRET)value.Get##BIGNAME(); \
802 // String is different than others.
803 wxString
wxPropertyGridInterface::GetPropertyValueAsString( wxPGPropArg id
) const
805 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxEmptyString
)
806 return p
->GetValueAsString(wxPG_FULL_VALUE
);
809 bool wxPropertyGridInterface::GetPropertyValueAsBool( wxPGPropArg id
) const
811 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
812 wxVariant value
= p
->GetValue();
813 if ( wxStrcmp(value
.GetType(), wxPGTypeName_bool
) == 0 )
815 return value
.GetBool();
817 if ( wxStrcmp(value
.GetType(), wxPGTypeName_long
) == 0 )
819 return value
.GetLong()?true:false;
821 wxPGGetFailed(p
,wxPGTypeName_bool
);
825 IMPLEMENT_GET_VALUE(long,long,Long
,0)
826 IMPLEMENT_GET_VALUE(double,double,Double
,0.0)
827 IMPLEMENT_GET_VALUE(void,void*,VoidPtr
,NULL
)
829 bool wxPropertyGridInterface::IsPropertyExpanded( wxPGPropArg id
) const
831 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
832 return p
->IsExpanded();
835 // -----------------------------------------------------------------------
836 // wxPropertyGridInterface wrappers
837 // -----------------------------------------------------------------------
839 bool wxPropertyGridInterface::ChangePropertyValue( wxPGPropArg id
, wxVariant newValue
)
841 return GetPropertyGrid()->ChangePropertyValue(id
, newValue
);
844 // -----------------------------------------------------------------------
846 void wxPropertyGridInterface::BeginAddChildren( wxPGPropArg id
)
848 wxPG_PROP_ARG_CALL_PROLOG()
849 wxCHECK_RET( p
->HasFlag(wxPG_PROP_AGGREGATE
), wxT("only call on properties with fixed children") );
850 p
->ClearFlag(wxPG_PROP_AGGREGATE
);
851 p
->SetFlag(wxPG_PROP_MISC_PARENT
);
854 // -----------------------------------------------------------------------
856 bool wxPropertyGridInterface::EditorValidate()
858 return GetPropertyGrid()->DoEditorValidate();
861 // -----------------------------------------------------------------------
863 void wxPropertyGridInterface::EndAddChildren( wxPGPropArg id
)
865 wxPG_PROP_ARG_CALL_PROLOG()
866 wxCHECK_RET( p
->HasFlag(wxPG_PROP_MISC_PARENT
), wxT("only call on properties for which BeginAddChildren was called prior") );
867 p
->ClearFlag(wxPG_PROP_MISC_PARENT
);
868 p
->SetFlag(wxPG_PROP_AGGREGATE
);
871 // -----------------------------------------------------------------------
872 // wxPGVIterator_State
873 // -----------------------------------------------------------------------
875 // Default returned by wxPropertyGridInterface::GetVIterator().
876 class wxPGVIteratorBase_State
: public wxPGVIteratorBase
879 wxPGVIteratorBase_State( wxPropertyGridPageState
* state
, int flags
)
881 m_it
.Init( state
, flags
);
883 virtual ~wxPGVIteratorBase_State() { }
884 virtual void Next() { m_it
.Next(); }
887 wxPGVIterator
wxPropertyGridInterface::GetVIterator( int flags
) const
889 return wxPGVIterator( new wxPGVIteratorBase_State( m_pState
, flags
) );
892 // -----------------------------------------------------------------------
893 // wxPGEditableState related functions
894 // -----------------------------------------------------------------------
896 // EscapeDelimiters() changes ";" into "\;" and "|" into "\|"
897 // in the input string. This is an internal functions which is
898 // used for saving states
899 // NB: Similar function exists in aui/framemanager.cpp
900 static wxString
EscapeDelimiters(const wxString
& s
)
903 result
.Alloc(s
.length());
904 const wxChar
* ch
= s
.c_str();
907 if (*ch
== wxT(';') || *ch
== wxT('|') || *ch
== wxT(','))
915 wxString
wxPropertyGridInterface::SaveEditableState( int includedStates
) const
920 // Save state on page basis
921 unsigned int pageIndex
= 0;
922 wxArrayPtrVoid pageStates
;
926 wxPropertyGridPageState
* page
= GetPageState(pageIndex
);
929 pageStates
.Add(page
);
934 for ( pageIndex
=0; pageIndex
< pageStates
.size(); pageIndex
++ )
936 wxPropertyGridPageState
* pageState
= (wxPropertyGridPageState
*) pageStates
[pageIndex
];
938 if ( includedStates
& SelectionState
)
941 if ( pageState
->GetSelection() )
942 sel
= pageState
->GetSelection()->GetName();
943 result
+= wxS("selection=");
944 result
+= EscapeDelimiters(sel
);
947 if ( includedStates
& ExpandedState
)
949 wxArrayPGProperty ptrs
;
950 wxPropertyGridConstIterator it
=
951 wxPropertyGridConstIterator( pageState
,
952 wxPG_ITERATE_ALL_PARENTS_RECURSIVELY
|wxPG_ITERATE_HIDDEN
,
955 result
+= wxS("expanded=");
961 const wxPGProperty
* p
= it
.GetProperty();
963 if ( !p
->HasFlag(wxPG_PROP_COLLAPSED
) )
964 result
+= EscapeDelimiters(p
->GetName());
969 if ( result
.Last() == wxS(',') )
974 if ( includedStates
& ScrollPosState
)
977 GetPropertyGrid()->GetViewStart(&x
,&y
);
978 result
+= wxString::Format(wxS("scrollpos=%i,%i;"), x
, y
);
980 if ( includedStates
& SplitterPosState
)
982 result
+= wxS("splitterpos=");
984 for ( size_t i
=0; i
<pageState
->GetColumnCount(); i
++ )
985 result
+= wxString::Format(wxS("%i,"), pageState
->DoGetSplitterPosition(i
));
987 result
.RemoveLast(); // Remove last comma
990 if ( includedStates
& PageState
)
992 result
+= wxS("ispageselected=");
994 if ( GetPageState(-1) == pageState
)
999 result
.RemoveLast(); // Remove last semicolon
1004 if ( result
.length() )
1005 result
.RemoveLast();
1010 bool wxPropertyGridInterface::RestoreEditableState( const wxString
& src
, int restoreStates
)
1012 wxPropertyGrid
* pg
= GetPropertyGrid();
1013 wxPGProperty
* newSelection
= NULL
;
1017 long selectedPage
= -1;
1018 bool pgSelectionSet
= false;
1022 wxArrayString pageStrings
= ::wxSplit(src
, wxS('|'), wxS('\\'));
1024 for ( pageIndex
=0; pageIndex
<pageStrings
.size(); pageIndex
++ )
1026 wxPropertyGridPageState
* pageState
= GetPageState(pageIndex
);
1030 wxArrayString kvpairStrings
= ::wxSplit(pageStrings
[pageIndex
], wxS(';'), wxS('\\'));
1032 for ( size_t i
=0; i
<kvpairStrings
.size(); i
++ )
1034 const wxString
& kvs
= kvpairStrings
[i
];
1035 int eq_pos
= kvs
.Find(wxS('='));
1036 if ( eq_pos
!= wxNOT_FOUND
)
1038 wxString key
= kvs
.substr(0, eq_pos
);
1039 wxString value
= kvs
.substr(eq_pos
+1);
1041 // Further split value by commas
1042 wxArrayString values
= ::wxSplit(value
, wxS(','), wxS('\\'));
1044 if ( key
== wxS("expanded") )
1046 if ( restoreStates
& ExpandedState
)
1048 wxPropertyGridIterator it
=
1049 wxPropertyGridIterator( pageState
,
1053 // First collapse all
1054 for ( ; !it
.AtEnd(); it
.Next() )
1056 wxPGProperty
* p
= it
.GetProperty();
1057 pageState
->DoCollapse(p
);
1060 // Then expand those which names are in values
1061 for ( size_t n
=0; n
<values
.size(); n
++ )
1063 const wxString
& name
= values
[n
];
1064 wxPGProperty
* prop
= GetPropertyByName(name
);
1066 pageState
->DoExpand(prop
);
1070 else if ( key
== wxS("scrollpos") )
1072 if ( restoreStates
& ScrollPosState
)
1074 if ( values
.size() == 2 )
1076 values
[0].ToLong(&vx
);
1077 values
[1].ToLong(&vy
);
1085 else if ( key
== wxS("splitterpos") )
1087 if ( restoreStates
& SplitterPosState
)
1089 for ( size_t n
=1; n
<values
.size(); n
++ )
1092 values
[n
].ToLong(&pos
);
1094 pageState
->DoSetSplitterPosition(pos
, n
);
1098 else if ( key
== wxS("selection") )
1100 if ( restoreStates
& SelectionState
)
1102 if ( values
.size() > 0 )
1104 if ( pageState
->IsDisplayed() )
1106 if ( values
[0].length() )
1107 newSelection
= GetPropertyByName(value
);
1108 pgSelectionSet
= true;
1112 if ( values
[0].length() )
1113 pageState
->SetSelection(GetPropertyByName(value
));
1115 pageState
->DoClearSelection();
1120 else if ( key
== wxS("ispageselected") )
1122 if ( restoreStates
& PageState
)
1125 if ( values
.size() == 1 && values
[0].ToLong(&pageSelStatus
) )
1127 if ( pageSelStatus
)
1128 selectedPage
= pageIndex
;
1145 // Force recalculation of virtual heights of all pages
1146 // (may be needed on unclean source string).
1148 wxPropertyGridPageState
* pageState
= GetPageState(pageIndex
);
1151 pageState
->VirtualHeightChanged();
1153 pageState
= GetPageState(pageIndex
);
1159 // Selection of visible grid page must be set after Thaw() call
1160 if ( pgSelectionSet
)
1163 pg
->SelectProperty(newSelection
);
1165 pg
->ClearSelection();
1168 if ( selectedPage
!= -1 )
1170 DoSelectPage(selectedPage
);
1181 #endif // wxUSE_PROPGRID