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
->GetIndexInParent(), 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 // -----------------------------------------------------------------------
480 void wxPropertyGridInterface::ClearModifiedStatus()
482 unsigned int pageIndex
= 0;
486 wxPropertyGridPageState
* page
= GetPageState(pageIndex
);
489 page
->DoGetRoot()->SetFlagRecursively(wxPG_PROP_MODIFIED
, false);
495 // -----------------------------------------------------------------------
496 // wxPropertyGridInterface property value setting and getting
497 // -----------------------------------------------------------------------
499 void wxPGGetFailed( const wxPGProperty
* p
, const wxString
& typestr
)
501 wxPGTypeOperationFailed(p
, typestr
, wxS("Get"));
504 // -----------------------------------------------------------------------
506 void wxPGTypeOperationFailed( const wxPGProperty
* p
,
507 const wxString
& typestr
,
510 wxASSERT( p
!= NULL
);
511 wxLogError( _("Type operation \"%s\" failed: Property labeled \"%s\" is of type \"%s\", NOT \"%s\"."),
512 op
.c_str(), p
->GetLabel().c_str(), p
->GetValue().GetType().c_str(), typestr
.c_str() );
515 // -----------------------------------------------------------------------
517 void wxPropertyGridInterface::SetPropVal( wxPGPropArg id
, wxVariant
& value
)
519 wxPG_PROP_ARG_CALL_PROLOG()
524 wxPropertyGrid
* propGrid
= p
->GetGridIfDisplayed();
526 propGrid
->DrawItemAndValueRelated( p
);
531 // -----------------------------------------------------------------------
533 void wxPropertyGridInterface::SetPropertyValueString( wxPGPropArg id
, const wxString
& value
)
535 wxPG_PROP_ARG_CALL_PROLOG()
537 if ( m_pState
->DoSetPropertyValueString(p
,value
) )
539 wxPropertyGrid
* propGrid
= p
->GetGridIfDisplayed();
541 propGrid
->DrawItemAndValueRelated( p
);
545 // -----------------------------------------------------------------------
547 void wxPropertyGridInterface::SetValidationFailureBehavior( int vfbFlags
)
549 GetPropertyGrid()->m_permanentValidationFailureBehavior
= vfbFlags
;
552 // -----------------------------------------------------------------------
554 wxPGProperty
* wxPropertyGridInterface::GetPropertyByNameA( const wxString
& name
) const
556 wxPGProperty
* p
= GetPropertyByName(name
);
557 wxASSERT_MSG(p
,wxString::Format(wxT("no property with name '%s'"),name
.c_str()));
561 // ----------------------------------------------------------------------------
563 wxPGProperty
* wxPropertyGridInterface::GetPropertyByLabel( const wxString
& label
) const
567 for ( it
= GetVIterator( wxPG_ITERATE_PROPERTIES
); !it
.AtEnd(); it
.Next() )
569 if ( it
.GetProperty()->GetLabel() == label
)
570 return it
.GetProperty();
573 return wxNullProperty
;
576 // ----------------------------------------------------------------------------
578 void wxPropertyGridInterface::DoSetPropertyAttribute( wxPGPropArg id
, const wxString
& name
,
579 wxVariant
& value
, long argFlags
)
581 wxPG_PROP_ARG_CALL_PROLOG()
583 p
->SetAttribute( name
, value
);
585 if ( argFlags
& wxPG_RECURSE
)
588 for ( i
= 0; i
< p
->GetChildCount(); i
++ )
589 DoSetPropertyAttribute(p
->Item(i
), name
, value
, argFlags
);
593 // -----------------------------------------------------------------------
595 void wxPropertyGridInterface::SetPropertyAttributeAll( const wxString
& attrName
,
598 unsigned int pageIndex
= 0;
602 wxPropertyGridPageState
* page
= GetPageState(pageIndex
);
605 DoSetPropertyAttribute(page
->DoGetRoot(), attrName
, value
, wxPG_RECURSE
);
611 // -----------------------------------------------------------------------
613 void wxPropertyGridInterface::GetPropertiesWithFlag( wxArrayPGProperty
* targetArr
,
614 wxPGProperty::FlagType flags
,
616 int iterFlags
) const
618 wxASSERT( targetArr
);
619 wxPGVIterator it
= GetVIterator( iterFlags
);
625 const wxPGProperty
* property
= it
.GetProperty();
629 if ( (property
->GetFlags() & flags
) == flags
)
630 targetArr
->push_back((wxPGProperty
*)property
);
634 if ( (property
->GetFlags() & flags
) != flags
)
635 targetArr
->push_back((wxPGProperty
*)property
);
640 // -----------------------------------------------------------------------
642 void wxPropertyGridInterface::SetBoolChoices( const wxString
& trueChoice
,
643 const wxString
& falseChoice
)
645 wxPGGlobalVars
->m_boolChoices
[0] = falseChoice
;
646 wxPGGlobalVars
->m_boolChoices
[1] = trueChoice
;
649 // -----------------------------------------------------------------------
651 wxPGProperty
* wxPropertyGridInterface::DoGetPropertyByName( const wxString
& name
) const
653 return m_pState
->BaseGetPropertyByName(name
);
656 // -----------------------------------------------------------------------
658 wxPGProperty
* wxPropertyGridInterface::GetPropertyByName( const wxString
& name
,
659 const wxString
& subname
) const
661 wxPGProperty
* p
= DoGetPropertyByName(name
);
662 if ( !p
|| !p
->GetChildCount() )
663 return wxNullProperty
;
665 return p
->GetPropertyByName(subname
);
668 // -----------------------------------------------------------------------
670 // Since GetPropertyByName is used *a lot*, this makes sense
671 // since non-virtual method can be called with less code.
672 wxPGProperty
* wxPropertyGridInterface::GetPropertyByName( const wxString
& name
) const
674 wxPGProperty
* p
= DoGetPropertyByName(name
);
678 // Check if its "Property.SubProperty" format
679 int pos
= name
.Find(wxT('.'));
683 return GetPropertyByName(name
.substr(0,pos
),
684 name
.substr(pos
+1,name
.length()-pos
-1));
687 // -----------------------------------------------------------------------
689 bool wxPropertyGridInterface::HideProperty( wxPGPropArg id
, bool hide
, int flags
)
691 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
693 wxPropertyGrid
* pg
= m_pState
->GetGrid();
695 if ( pg
== p
->GetGrid() )
696 return pg
->DoHideProperty(p
, hide
, flags
);
698 m_pState
->DoHideProperty(p
, hide
, flags
);
703 // -----------------------------------------------------------------------
705 bool wxPropertyGridInterface::Collapse( wxPGPropArg id
)
707 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
708 wxPropertyGrid
* pg
= p
->GetGridIfDisplayed();
710 return pg
->DoCollapse(p
);
712 return p
->GetParentState()->DoCollapse(p
);
715 // -----------------------------------------------------------------------
717 bool wxPropertyGridInterface::Expand( wxPGPropArg id
)
719 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
720 wxPropertyGrid
* pg
= p
->GetGridIfDisplayed();
722 return pg
->DoExpand(p
);
724 return p
->GetParentState()->DoExpand(p
);
727 // -----------------------------------------------------------------------
729 void wxPropertyGridInterface::SetPropertyLabel( wxPGPropArg id
, const wxString
& newproplabel
)
731 wxPG_PROP_ARG_CALL_PROLOG()
733 p
->SetLabel( newproplabel
);
735 wxPropertyGridPageState
* state
= p
->GetParentState();
736 wxPropertyGrid
* pg
= state
->GetGrid();
738 if ( pg
->HasFlag(wxPG_AUTO_SORT
) )
739 pg
->SortChildren(p
->GetParent());
741 if ( pg
->GetState() == state
)
743 if ( pg
->HasFlag(wxPG_AUTO_SORT
) )
750 // -----------------------------------------------------------------------
752 bool wxPropertyGridInterface::SetPropertyMaxLength( wxPGPropArg id
, int maxLen
)
754 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
756 wxPropertyGrid
* pg
= m_pState
->GetGrid();
758 p
->m_maxLen
= (short) maxLen
;
760 // Adjust control if selected currently
761 if ( pg
== p
->GetGrid() && p
== m_pState
->GetSelection() )
763 wxWindow
* wnd
= pg
->GetEditorControl();
764 wxTextCtrl
* tc
= wxDynamicCast(wnd
,wxTextCtrl
);
766 tc
->SetMaxLength( maxLen
);
775 // -----------------------------------------------------------------------
776 // GetPropertyValueAsXXX methods
778 #define IMPLEMENT_GET_VALUE(T,TRET,BIGNAME,DEFRETVAL) \
779 TRET wxPropertyGridInterface::GetPropertyValueAs##BIGNAME( wxPGPropArg id ) const \
781 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(DEFRETVAL) \
782 wxVariant value = p->GetValue(); \
783 if ( wxStrcmp(value.GetType(), wxPGTypeName_##T) != 0 ) \
785 wxPGGetFailed(p,wxPGTypeName_##T); \
786 return (TRET)DEFRETVAL; \
788 return (TRET)value.Get##BIGNAME(); \
791 // String is different than others.
792 wxString
wxPropertyGridInterface::GetPropertyValueAsString( wxPGPropArg id
) const
794 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(wxEmptyString
)
795 return p
->GetValueAsString(wxPG_FULL_VALUE
);
798 bool wxPropertyGridInterface::GetPropertyValueAsBool( wxPGPropArg id
) const
800 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
801 wxVariant value
= p
->GetValue();
802 if ( wxStrcmp(value
.GetType(), wxPGTypeName_bool
) == 0 )
804 return value
.GetBool();
806 if ( wxStrcmp(value
.GetType(), wxPGTypeName_long
) == 0 )
808 return value
.GetLong()?true:false;
810 wxPGGetFailed(p
,wxPGTypeName_bool
);
814 IMPLEMENT_GET_VALUE(long,long,Long
,0)
815 IMPLEMENT_GET_VALUE(double,double,Double
,0.0)
817 bool wxPropertyGridInterface::IsPropertyExpanded( wxPGPropArg id
) const
819 wxPG_PROP_ARG_CALL_PROLOG_RETVAL(false)
820 return p
->IsExpanded();
823 // -----------------------------------------------------------------------
824 // wxPropertyGridInterface wrappers
825 // -----------------------------------------------------------------------
827 bool wxPropertyGridInterface::ChangePropertyValue( wxPGPropArg id
, wxVariant newValue
)
829 return GetPropertyGrid()->ChangePropertyValue(id
, newValue
);
832 // -----------------------------------------------------------------------
834 void wxPropertyGridInterface::BeginAddChildren( wxPGPropArg id
)
836 wxPG_PROP_ARG_CALL_PROLOG()
837 wxCHECK_RET( p
->HasFlag(wxPG_PROP_AGGREGATE
), wxT("only call on properties with fixed children") );
838 p
->ClearFlag(wxPG_PROP_AGGREGATE
);
839 p
->SetFlag(wxPG_PROP_MISC_PARENT
);
842 // -----------------------------------------------------------------------
844 bool wxPropertyGridInterface::EditorValidate()
846 return GetPropertyGrid()->DoEditorValidate();
849 // -----------------------------------------------------------------------
851 void wxPropertyGridInterface::EndAddChildren( wxPGPropArg id
)
853 wxPG_PROP_ARG_CALL_PROLOG()
854 wxCHECK_RET( p
->HasFlag(wxPG_PROP_MISC_PARENT
), wxT("only call on properties for which BeginAddChildren was called prior") );
855 p
->ClearFlag(wxPG_PROP_MISC_PARENT
);
856 p
->SetFlag(wxPG_PROP_AGGREGATE
);
859 // -----------------------------------------------------------------------
860 // wxPGVIterator_State
861 // -----------------------------------------------------------------------
863 // Default returned by wxPropertyGridInterface::GetVIterator().
864 class wxPGVIteratorBase_State
: public wxPGVIteratorBase
867 wxPGVIteratorBase_State( wxPropertyGridPageState
* state
, int flags
)
869 m_it
.Init( state
, flags
);
871 virtual ~wxPGVIteratorBase_State() { }
872 virtual void Next() { m_it
.Next(); }
875 wxPGVIterator
wxPropertyGridInterface::GetVIterator( int flags
) const
877 return wxPGVIterator( new wxPGVIteratorBase_State( m_pState
, flags
) );
880 // -----------------------------------------------------------------------
881 // wxPGEditableState related functions
882 // -----------------------------------------------------------------------
884 // EscapeDelimiters() changes ";" into "\;" and "|" into "\|"
885 // in the input string. This is an internal functions which is
886 // used for saving states
887 // NB: Similar function exists in aui/framemanager.cpp
888 static wxString
EscapeDelimiters(const wxString
& s
)
891 result
.Alloc(s
.length());
892 const wxChar
* ch
= s
.c_str();
895 if (*ch
== wxT(';') || *ch
== wxT('|') || *ch
== wxT(','))
903 wxString
wxPropertyGridInterface::SaveEditableState( int includedStates
) const
908 // Save state on page basis
909 unsigned int pageIndex
= 0;
910 wxArrayPtrVoid pageStates
;
914 wxPropertyGridPageState
* page
= GetPageState(pageIndex
);
917 pageStates
.Add(page
);
922 for ( pageIndex
=0; pageIndex
< pageStates
.size(); pageIndex
++ )
924 wxPropertyGridPageState
* pageState
= (wxPropertyGridPageState
*) pageStates
[pageIndex
];
926 if ( includedStates
& SelectionState
)
929 if ( pageState
->GetSelection() )
930 sel
= pageState
->GetSelection()->GetName();
931 result
+= wxS("selection=");
932 result
+= EscapeDelimiters(sel
);
935 if ( includedStates
& ExpandedState
)
937 wxArrayPGProperty ptrs
;
938 wxPropertyGridConstIterator it
=
939 wxPropertyGridConstIterator( pageState
,
940 wxPG_ITERATE_ALL_PARENTS_RECURSIVELY
|wxPG_ITERATE_HIDDEN
,
943 result
+= wxS("expanded=");
949 const wxPGProperty
* p
= it
.GetProperty();
951 if ( !p
->HasFlag(wxPG_PROP_COLLAPSED
) )
952 result
+= EscapeDelimiters(p
->GetName());
957 if ( result
.Last() == wxS(',') )
962 if ( includedStates
& ScrollPosState
)
965 GetPropertyGrid()->GetViewStart(&x
,&y
);
966 result
+= wxString::Format(wxS("scrollpos=%i,%i;"), x
, y
);
968 if ( includedStates
& SplitterPosState
)
970 result
+= wxS("splitterpos=");
972 for ( size_t i
=0; i
<pageState
->GetColumnCount(); i
++ )
973 result
+= wxString::Format(wxS("%i,"), pageState
->DoGetSplitterPosition(i
));
975 result
.RemoveLast(); // Remove last comma
978 if ( includedStates
& PageState
)
980 result
+= wxS("ispageselected=");
982 if ( GetPageState(-1) == pageState
)
987 if ( includedStates
& DescBoxState
)
989 wxVariant v
= GetEditableStateItem(wxS("descboxheight"));
991 result
+= wxString::Format(wxS("descboxheight=%i;"), (int)v
.GetLong());
993 result
.RemoveLast(); // Remove last semicolon
998 if ( result
.length() )
1004 bool wxPropertyGridInterface::RestoreEditableState( const wxString
& src
, int restoreStates
)
1006 wxPropertyGrid
* pg
= GetPropertyGrid();
1007 wxPGProperty
* newSelection
= NULL
;
1011 long selectedPage
= -1;
1012 bool pgSelectionSet
= false;
1016 wxArrayString pageStrings
= ::wxSplit(src
, wxS('|'), wxS('\\'));
1018 for ( pageIndex
=0; pageIndex
<pageStrings
.size(); pageIndex
++ )
1020 wxPropertyGridPageState
* pageState
= GetPageState(pageIndex
);
1024 wxArrayString kvpairStrings
= ::wxSplit(pageStrings
[pageIndex
], wxS(';'), wxS('\\'));
1026 for ( size_t i
=0; i
<kvpairStrings
.size(); i
++ )
1028 const wxString
& kvs
= kvpairStrings
[i
];
1029 int eq_pos
= kvs
.Find(wxS('='));
1030 if ( eq_pos
!= wxNOT_FOUND
)
1032 wxString key
= kvs
.substr(0, eq_pos
);
1033 wxString value
= kvs
.substr(eq_pos
+1);
1035 // Further split value by commas
1036 wxArrayString values
= ::wxSplit(value
, wxS(','), wxS('\\'));
1038 if ( key
== wxS("expanded") )
1040 if ( restoreStates
& ExpandedState
)
1042 wxPropertyGridIterator it
=
1043 wxPropertyGridIterator( pageState
,
1047 // First collapse all
1048 for ( ; !it
.AtEnd(); it
.Next() )
1050 wxPGProperty
* p
= it
.GetProperty();
1051 pageState
->DoCollapse(p
);
1054 // Then expand those which names are in values
1055 for ( size_t n
=0; n
<values
.size(); n
++ )
1057 const wxString
& name
= values
[n
];
1058 wxPGProperty
* prop
= GetPropertyByName(name
);
1060 pageState
->DoExpand(prop
);
1064 else if ( key
== wxS("scrollpos") )
1066 if ( restoreStates
& ScrollPosState
)
1068 if ( values
.size() == 2 )
1070 values
[0].ToLong(&vx
);
1071 values
[1].ToLong(&vy
);
1079 else if ( key
== wxS("splitterpos") )
1081 if ( restoreStates
& SplitterPosState
)
1083 for ( size_t n
=1; n
<values
.size(); n
++ )
1086 values
[n
].ToLong(&pos
);
1088 pageState
->DoSetSplitterPosition(pos
, n
);
1092 else if ( key
== wxS("selection") )
1094 if ( restoreStates
& SelectionState
)
1096 if ( values
.size() > 0 )
1098 if ( pageState
->IsDisplayed() )
1100 if ( values
[0].length() )
1101 newSelection
= GetPropertyByName(value
);
1102 pgSelectionSet
= true;
1106 if ( values
[0].length() )
1107 pageState
->SetSelection(GetPropertyByName(value
));
1109 pageState
->DoClearSelection();
1114 else if ( key
== wxS("ispageselected") )
1116 if ( restoreStates
& PageState
)
1119 if ( values
.size() == 1 && values
[0].ToLong(&pageSelStatus
) )
1121 if ( pageSelStatus
)
1122 selectedPage
= pageIndex
;
1130 else if ( key
== wxS("descboxheight") )
1132 if ( restoreStates
& DescBoxState
)
1135 if ( values
.size() == 1 && values
[0].ToLong(&descBoxHeight
) )
1137 SetEditableStateItem(wxS("descboxheight"), descBoxHeight
);
1154 // Force recalculation of virtual heights of all pages
1155 // (may be needed on unclean source string).
1157 wxPropertyGridPageState
* pageState
= GetPageState(pageIndex
);
1160 pageState
->VirtualHeightChanged();
1162 pageState
= GetPageState(pageIndex
);
1168 // Selection of visible grid page must be set after Thaw() call
1169 if ( pgSelectionSet
)
1172 pg
->SelectProperty(newSelection
);
1174 pg
->ClearSelection();
1177 if ( selectedPage
!= -1 )
1179 DoSelectPage(selectedPage
);
1190 #endif // wxUSE_PROPGRID