1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/propgrid/propgridpagestate.cpp
3 // Purpose: wxPropertyGridPageState 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"
35 #include "wx/stopwatch.h"
38 // This define is necessary to prevent macro clearing
39 #define __wxPG_SOURCE_FILE__
41 #include "wx/propgrid/propgridpagestate.h"
42 #include "wx/propgrid/propgrid.h"
43 #include "wx/propgrid/editors.h"
45 #define wxPG_DEFAULT_SPLITTERX 110
48 // -----------------------------------------------------------------------
49 // wxPropertyGridIterator
50 // -----------------------------------------------------------------------
52 void wxPropertyGridIteratorBase::Init( wxPropertyGridPageState
* state
, int flags
, wxPGProperty
* property
, int dir
)
54 wxASSERT( dir
== 1 || dir
== -1 );
57 m_baseParent
= state
->DoGetRoot();
58 if ( !property
&& m_baseParent
->GetChildCount() )
59 property
= m_baseParent
->Item(0);
61 m_property
= property
;
63 wxPG_ITERATOR_CREATE_MASKS(flags
, m_itemExMask
, m_parentExMask
)
65 // Need to skip first?
66 if ( property
&& (property
->GetFlags() & m_itemExMask
) )
75 void wxPropertyGridIteratorBase::Init( wxPropertyGridPageState
* state
, int flags
, int startPos
, int dir
)
77 wxPGProperty
* property
= NULL
;
79 if ( startPos
== wxTOP
)
84 else if ( startPos
== wxBOTTOM
)
86 property
= state
->GetLastItem(flags
);
92 wxFAIL_MSG("Only supported starting positions are wxTOP and wxBOTTOM");
95 Init( state
, flags
, property
, dir
);
98 void wxPropertyGridIteratorBase::Assign( const wxPropertyGridIteratorBase
& it
)
100 m_property
= it
.m_property
;
101 m_state
= it
.m_state
;
102 m_baseParent
= it
.m_baseParent
;
103 m_itemExMask
= it
.m_itemExMask
;
104 m_parentExMask
= it
.m_parentExMask
;
107 void wxPropertyGridIteratorBase::Prev()
109 wxPGProperty
* property
= m_property
;
110 wxASSERT( property
);
112 wxPGProperty
* parent
= property
->GetParent();
114 unsigned int index
= property
->GetIndexInParent();
121 property
= parent
->Item(index
);
123 // Go to last children?
124 if ( property
->GetChildCount() &&
125 wxPG_ITERATOR_PARENTEXMASK_TEST(property
, m_parentExMask
) )
128 property
= property
->Last();
134 if ( parent
== m_baseParent
)
145 m_property
= property
;
147 // If property does not match our criteria, skip it
148 if ( property
->GetFlags() & m_itemExMask
)
152 void wxPropertyGridIteratorBase::Next( bool iterateChildren
)
154 wxPGProperty
* property
= m_property
;
155 wxASSERT( property
);
157 if ( property
->GetChildCount() &&
158 wxPG_ITERATOR_PARENTEXMASK_TEST(property
, m_parentExMask
) &&
162 property
= property
->Item(0);
166 wxPGProperty
* parent
= property
->GetParent();
168 unsigned int index
= property
->GetIndexInParent() + 1;
170 if ( index
< parent
->GetChildCount() )
173 property
= parent
->Item(index
);
177 // Next sibling of parent
178 if ( parent
== m_baseParent
)
191 m_property
= property
;
193 // If property does not match our criteria, skip it
194 if ( property
->GetFlags() & m_itemExMask
)
198 // -----------------------------------------------------------------------
199 // wxPropertyGridPageState
200 // -----------------------------------------------------------------------
202 wxPropertyGridPageState::wxPropertyGridPageState()
205 m_regularArray
.SetParentState(this);
206 m_properties
= &m_regularArray
;
208 m_currentCategory
= NULL
;
212 m_lastCaptionBottomnest
= 1;
216 m_colWidths
.push_back( wxPG_DEFAULT_SPLITTERX
);
217 m_colWidths
.push_back( wxPG_DEFAULT_SPLITTERX
);
218 m_fSplitterX
= wxPG_DEFAULT_SPLITTERX
;
221 // -----------------------------------------------------------------------
223 wxPropertyGridPageState::~wxPropertyGridPageState()
228 // -----------------------------------------------------------------------
230 void wxPropertyGridPageState::InitNonCatMode()
234 m_abcArray
= new wxPGRootProperty();
235 m_abcArray
->SetParentState(this);
236 m_abcArray
->SetFlag(wxPG_PROP_CHILDREN_ARE_COPIES
);
239 // Must be called when state::m_properties still points to regularArray.
240 wxPGProperty
* oldProperties
= m_properties
;
242 // Must use temp value in state::m_properties for item iteration loop
243 // to run as expected.
244 m_properties
= &m_regularArray
;
246 if ( m_properties
->GetChildCount() )
249 // Prepare m_abcArray
250 wxPropertyGridIterator
it( this, wxPG_ITERATE_PROPERTIES
);
252 for ( ; !it
.AtEnd(); it
.Next() )
254 wxPGProperty
* p
= it
.GetProperty();
255 wxPGProperty
* parent
= p
->GetParent();
256 if ( parent
->IsCategory() || parent
->IsRoot() )
258 m_abcArray
->AddChild2(p
);
259 p
->m_parent
= &m_regularArray
;
264 m_properties
= oldProperties
;
267 // -----------------------------------------------------------------------
269 void wxPropertyGridPageState::DoClear()
271 m_regularArray
.Empty();
277 m_currentCategory
= NULL
;
278 m_lastCaptionBottomnest
= 1;
287 // -----------------------------------------------------------------------
289 void wxPropertyGridPageState::CalculateFontAndBitmapStuff( int WXUNUSED(vspacing
) )
291 wxPropertyGrid
* propGrid
= GetGrid();
293 VirtualHeightChanged();
295 // Recalculate caption text extents.
298 for ( i
=0;i
<m_regularArray
.GetChildCount();i
++ )
300 wxPGProperty
* p
=m_regularArray
.Item(i
);
302 if ( p
->IsCategory() )
303 ((wxPropertyCategory
*)p
)->CalculateTextExtent(propGrid
, propGrid
->GetCaptionFont());
307 // -----------------------------------------------------------------------
309 void wxPropertyGridPageState::SetVirtualWidth( int width
)
311 wxASSERT( width
>= 0 );
312 wxPropertyGrid
* pg
= GetGrid();
313 int gw
= pg
->GetClientSize().x
;
320 // -----------------------------------------------------------------------
322 void wxPropertyGridPageState::OnClientWidthChange( int newWidth
, int widthChange
, bool fromOnResize
)
324 wxPropertyGrid
* pg
= GetGrid();
326 if ( pg
->HasVirtualWidth() )
328 if ( m_width
< newWidth
)
329 SetVirtualWidth( newWidth
);
331 CheckColumnWidths(widthChange
);
335 SetVirtualWidth( newWidth
);
337 // This should be done before splitter auto centering
338 // NOTE: Splitter auto-centering is done in this function.
341 CheckColumnWidths(widthChange
);
343 if ( !(GetGrid()->GetInternalFlags() & wxPG_FL_SPLITTER_PRE_SET
) &&
344 (GetGrid()->GetInternalFlags() & wxPG_FL_DONT_CENTER_SPLITTER
) )
346 long timeSinceCreation
= (::wxGetLocalTimeMillis() - GetGrid()->m_timeCreated
).ToLong();
348 // If too long, don't set splitter
349 if ( timeSinceCreation
< 3000 )
351 if ( m_properties
->GetChildCount() || timeSinceCreation
> 750 )
353 SetSplitterLeft( false );
357 DoSetSplitterPosition( newWidth
/ 2 );
358 GetGrid()->ClearInternalFlag(wxPG_FL_SPLITTER_PRE_SET
);
365 // -----------------------------------------------------------------------
366 // wxPropertyGridPageState item iteration methods
367 // -----------------------------------------------------------------------
369 wxPGProperty
* wxPropertyGridPageState::GetLastItem( int flags
)
371 if ( !m_properties
->GetChildCount() )
374 wxPG_ITERATOR_CREATE_MASKS(flags
, int itemExMask
, int parentExMask
)
376 // First, get last child of last parent
377 wxPGProperty
* pwc
= (wxPGProperty
*)m_properties
->Last();
378 while ( pwc
->GetChildCount() &&
379 wxPG_ITERATOR_PARENTEXMASK_TEST(pwc
, parentExMask
) )
380 pwc
= (wxPGProperty
*) pwc
->Last();
382 // Then, if it doesn't fit our criteria, back up until we find something that does
383 if ( pwc
->GetFlags() & itemExMask
)
385 wxPropertyGridIterator
it( this, flags
, pwc
);
386 for ( ; !it
.AtEnd(); it
.Prev() )
388 pwc
= (wxPGProperty
*) it
.GetProperty();
394 wxPropertyCategory
* wxPropertyGridPageState::GetPropertyCategory( const wxPGProperty
* p
) const
396 const wxPGProperty
* parent
= (const wxPGProperty
*)p
;
397 const wxPGProperty
* grandparent
= (const wxPGProperty
*)parent
->GetParent();
400 parent
= grandparent
;
401 grandparent
= (wxPGProperty
*)parent
->GetParent();
402 if ( parent
->IsCategory() && grandparent
)
403 return (wxPropertyCategory
*)parent
;
404 } while ( grandparent
);
409 // -----------------------------------------------------------------------
410 // wxPropertyGridPageState GetPropertyXXX methods
411 // -----------------------------------------------------------------------
413 wxPGProperty
* wxPropertyGridPageState::GetPropertyByLabel( const wxString
& label
,
414 wxPGProperty
* parent
) const
419 if ( !parent
) parent
= (wxPGProperty
*) &m_regularArray
;
421 for ( i
=0; i
<parent
->GetChildCount(); i
++ )
423 wxPGProperty
* p
= parent
->Item(i
);
424 if ( p
->m_label
== label
)
426 // Check children recursively.
427 if ( p
->GetChildCount() )
429 p
= GetPropertyByLabel(label
,(wxPGProperty
*)p
);
438 // -----------------------------------------------------------------------
440 wxPGProperty
* wxPropertyGridPageState::BaseGetPropertyByName( const wxString
& name
) const
442 wxPGHashMapS2P::const_iterator it
;
443 it
= m_dictName
.find(name
);
444 if ( it
!= m_dictName
.end() )
445 return (wxPGProperty
*) it
->second
;
449 // -----------------------------------------------------------------------
451 void wxPropertyGridPageState::DoSetPropertyName( wxPGProperty
* p
,
452 const wxString
& newName
)
454 wxCHECK_RET( p
, wxT("invalid property id") );
456 wxPGProperty
* parent
= p
->GetParent();
458 if ( parent
->IsCategory() || parent
->IsRoot() )
460 if ( p
->GetBaseName().length() )
461 m_dictName
.erase( p
->GetBaseName() );
462 if ( newName
.length() )
463 m_dictName
[newName
] = (void*) p
;
466 p
->DoSetName(newName
);
469 // -----------------------------------------------------------------------
470 // wxPropertyGridPageState global operations
471 // -----------------------------------------------------------------------
473 // -----------------------------------------------------------------------
474 // Item iteration macros
475 // NB: Nowadays only needed for alphabetic/categoric mode switching.
476 // -----------------------------------------------------------------------
478 //#define II_INVALID_I 0x00FFFFFF
480 #define ITEM_ITERATION_VARIABLES \
481 wxPGProperty* parent; \
485 #define ITEM_ITERATION_INIT_FROM_THE_TOP \
486 parent = m_properties; \
490 #define ITEM_ITERATION_INIT(startparent, startindex, state) \
491 parent = startparent; \
492 i = (unsigned int)startindex; \
493 if ( parent == NULL ) \
495 parent = state->m_properties; \
500 #define ITEM_ITERATION_LOOP_BEGIN \
503 iMax = parent->GetChildCount(); \
506 wxPGProperty* p = parent->Item(i);
508 #define ITEM_ITERATION_LOOP_END \
509 if ( p->GetChildCount() ) \
512 parent = (wxPGProperty*)p; \
513 iMax = parent->GetChildCount(); \
518 i = parent->m_arrIndex + 1; \
519 parent = parent->m_parent; \
521 while ( parent != NULL );
523 bool wxPropertyGridPageState::EnableCategories( bool enable
)
526 // NB: We can't use wxPropertyGridIterator in this
527 // function, since it depends on m_arrIndexes,
528 // which, among other things, is being fixed here.
530 ITEM_ITERATION_VARIABLES
538 if ( !IsInNonCatMode() )
541 m_properties
= &m_regularArray
;
543 // fix parents, indexes, and depths
544 ITEM_ITERATION_INIT_FROM_THE_TOP
546 ITEM_ITERATION_LOOP_BEGIN
550 p
->m_parent
= parent
;
552 // If parent was category, and this is not,
553 // then the depth stays the same.
554 if ( parent
->IsCategory() &&
556 p
->m_depth
= parent
->m_depth
;
558 p
->m_depth
= parent
->m_depth
+ 1;
560 ITEM_ITERATION_LOOP_END
566 // Disable categories
569 if ( IsInNonCatMode() )
572 // Create array, if necessary.
576 m_properties
= m_abcArray
;
578 // fix parents, indexes, and depths
579 ITEM_ITERATION_INIT_FROM_THE_TOP
581 ITEM_ITERATION_LOOP_BEGIN
585 p
->m_parent
= parent
;
587 p
->m_depth
= parent
->m_depth
+ 1;
589 ITEM_ITERATION_LOOP_END
592 VirtualHeightChanged();
594 if ( m_pPropGrid
->GetState() == this )
595 m_pPropGrid
->RecalculateVirtualSize();
600 // -----------------------------------------------------------------------
605 static bool wxPG_SortFunc_ByFunction(wxPGProperty
*p1
, wxPGProperty
*p2
)
607 wxPropertyGrid
* pg
= p1
->GetGrid();
608 wxPGSortCallback sortFunction
= pg
->GetSortFunction();
609 return sortFunction(pg
, p1
, p2
) < 0;
612 static bool wxPG_SortFunc_ByLabel(wxPGProperty
*p1
, wxPGProperty
*p2
)
614 return p1
->GetLabel().CmpNoCase( p2
->GetLabel() ) < 0;
619 static int wxPG_SortFunc_ByFunction(wxPGProperty
**pp1
, wxPGProperty
**pp2
)
621 wxPGProperty
*p1
= *pp1
;
622 wxPGProperty
*p2
= *pp2
;
623 wxPropertyGrid
* pg
= p1
->GetGrid();
624 wxPGSortCallback sortFunction
= pg
->GetSortFunction();
625 return sortFunction(pg
, p1
, p2
);
628 static int wxPG_SortFunc_ByLabel(wxPGProperty
**pp1
, wxPGProperty
**pp2
)
630 wxPGProperty
*p1
= *pp1
;
631 wxPGProperty
*p2
= *pp2
;
632 return p1
->GetLabel().CmpNoCase( p2
->GetLabel() );
637 void wxPropertyGridPageState::DoSortChildren( wxPGProperty
* p
,
643 // Can only sort items with children
644 if ( !p
->GetChildCount() )
647 // Never sort children of aggregate properties
648 if ( p
->HasFlag(wxPG_PROP_AGGREGATE
) )
651 if ( (flags
& wxPG_SORT_TOP_LEVEL_ONLY
)
652 && !p
->IsCategory() && !p
->IsRoot() )
656 if ( GetGrid()->GetSortFunction() )
657 std::sort(p
->m_children
.begin(), p
->m_children
.end(),
658 wxPG_SortFunc_ByFunction
);
660 std::sort(p
->m_children
.begin(), p
->m_children
.end(),
661 wxPG_SortFunc_ByLabel
);
663 if ( GetGrid()->GetSortFunction() )
664 p
->m_children
.Sort( wxPG_SortFunc_ByFunction
);
666 p
->m_children
.Sort( wxPG_SortFunc_ByLabel
);
670 p
->FixIndicesOfChildren();
672 if ( flags
& wxPG_RECURSE
)
674 // Apply sort recursively
675 for ( unsigned int i
=0; i
<p
->GetChildCount(); i
++ )
676 DoSortChildren(p
->Item(i
), flags
);
680 // -----------------------------------------------------------------------
682 void wxPropertyGridPageState::DoSort( int flags
)
684 DoSortChildren( m_properties
, flags
| wxPG_RECURSE
);
686 // Sort categories as well (but we need not do it recursively)
687 if ( IsInNonCatMode() )
690 for ( i
=0;i
<m_regularArray
.GetChildCount();i
++)
692 wxPGProperty
* p
= m_regularArray
.Item(i
);
693 if ( p
->IsCategory() )
694 DoSortChildren( p
, 0 );
699 // -----------------------------------------------------------------------
701 bool wxPropertyGridPageState::PrepareAfterItemsAdded()
703 if ( !m_itemsAdded
) return false;
705 wxPropertyGrid
* pg
= GetGrid();
709 if ( pg
->HasFlag(wxPG_AUTO_SORT
) )
710 DoSort(wxPG_SORT_TOP_LEVEL_ONLY
);
715 // -----------------------------------------------------------------------
716 // wxPropertyGridPageState splitter, column and hittest functions
717 // -----------------------------------------------------------------------
719 wxPGProperty
* wxPropertyGridPageState::DoGetItemAtY( int y
) const
726 return m_properties
->GetItemAtY(y
, GetGrid()->m_lineHeight
, &a
);
729 // -----------------------------------------------------------------------
731 wxPropertyGridHitTestResult
wxPropertyGridPageState::HitTest( const wxPoint
&pt
) const
733 wxPropertyGridHitTestResult result
;
734 result
.column
= HitTestH( pt
.x
, &result
.splitter
, &result
.splitterHitOffset
);
735 result
.property
= DoGetItemAtY( pt
.y
);
739 // -----------------------------------------------------------------------
741 // Used by SetSplitterLeft() and DotFitColumns()
742 int wxPropertyGridPageState::GetColumnFitWidth(wxClientDC
& dc
,
747 wxPropertyGrid
* pg
= m_pPropGrid
;
752 for ( i
=0; i
<pwc
->GetChildCount(); i
++ )
754 wxPGProperty
* p
= pwc
->Item(i
);
755 if ( !p
->IsCategory() )
757 const wxPGCell
* cell
= NULL
;
759 p
->GetDisplayInfo(col
, -1, 0, &text
, &cell
);
760 dc
.GetTextExtent(text
, &w
, &h
);
762 w
+= ( ((int)p
->m_depth
-1) * pg
->m_subgroup_extramargin
);
765 // TODO: Add bitmap support.
767 w
+= (wxPG_XBEFORETEXT
*2);
773 if ( p
->GetChildCount() &&
774 ( subProps
|| p
->IsCategory() ) )
776 w
= GetColumnFitWidth( dc
, p
, col
, subProps
);
786 int wxPropertyGridPageState::DoGetSplitterPosition( int splitterColumn
) const
788 int n
= GetGrid()->m_marginWidth
;
790 for ( i
=0; i
<=splitterColumn
; i
++ )
795 int wxPropertyGridPageState::GetColumnMinWidth( int WXUNUSED(column
) ) const
797 return wxPG_DRAG_MARGIN
;
800 void wxPropertyGridPageState::PropagateColSizeDec( int column
, int decrease
, int dir
)
802 int origWidth
= m_colWidths
[column
];
803 m_colWidths
[column
] -= decrease
;
804 int min
= GetColumnMinWidth(column
);
806 if ( m_colWidths
[column
] < min
)
808 more
= decrease
- (origWidth
- min
);
809 m_colWidths
[column
] = min
;
813 // FIXME: Causes erratic splitter changing, so as a workaround
814 // disabled if two or less columns.
816 if ( m_colWidths
.size() <= 2 )
820 if ( more
&& column
< (int)m_colWidths
.size() && column
>= 0 )
821 PropagateColSizeDec( column
, more
, dir
);
824 void wxPropertyGridPageState::DoSetSplitterPosition( int newXPos
, int splitterColumn
, bool WXUNUSED(allPages
), bool fromAutoCenter
)
826 wxPropertyGrid
* pg
= GetGrid();
828 int adjust
= newXPos
- DoGetSplitterPosition(splitterColumn
);
830 if ( !pg
->HasVirtualWidth() )
836 otherColumn
= splitterColumn
+ 1;
837 if ( otherColumn
== (int)m_colWidths
.size() )
839 m_colWidths
[splitterColumn
] += adjust
;
840 PropagateColSizeDec( otherColumn
, adjust
, 1 );
844 otherColumn
= splitterColumn
+ 1;
845 if ( otherColumn
== (int)m_colWidths
.size() )
847 m_colWidths
[otherColumn
] -= adjust
;
848 PropagateColSizeDec( splitterColumn
, -adjust
, -1 );
853 m_colWidths
[splitterColumn
] += adjust
;
856 if ( splitterColumn
== 0 )
857 m_fSplitterX
= (double) newXPos
;
859 if ( !fromAutoCenter
)
861 // Don't allow initial splitter auto-positioning after this.
862 if ( pg
->GetState() == this )
863 pg
->SetInternalFlag(wxPG_FL_SPLITTER_PRE_SET
);
869 // Moves splitter so that all labels are visible, but just.
870 void wxPropertyGridPageState::SetSplitterLeft( bool subProps
)
872 wxPropertyGrid
* pg
= GetGrid();
874 dc
.SetFont(pg
->m_font
);
876 int maxW
= GetColumnFitWidth(dc
, m_properties
, 0, subProps
);
880 maxW
+= pg
->m_marginWidth
;
881 DoSetSplitterPosition( maxW
);
884 pg
->SetInternalFlag(wxPG_FL_DONT_CENTER_SPLITTER
);
887 wxSize
wxPropertyGridPageState::DoFitColumns( bool WXUNUSED(allowGridResize
) )
889 wxPropertyGrid
* pg
= GetGrid();
891 dc
.SetFont(pg
->m_font
);
893 int marginWidth
= pg
->m_marginWidth
;
894 int accWid
= marginWidth
;
895 int maxColWidth
= 500;
897 for ( unsigned int col
=0; col
< GetColumnCount(); col
++ )
899 int fitWid
= GetColumnFitWidth(dc
, m_properties
, col
, true);
900 int colMinWidth
= GetColumnMinWidth(col
);
901 if ( fitWid
< colMinWidth
)
902 fitWid
= colMinWidth
;
903 else if ( fitWid
> maxColWidth
)
904 fitWid
= maxColWidth
;
906 m_colWidths
[col
] = fitWid
;
911 // Expand last one to fill the width
912 int remaining
= m_width
- accWid
;
913 m_colWidths
[GetColumnCount()-1] += remaining
;
915 pg
->SetInternalFlag(wxPG_FL_DONT_CENTER_SPLITTER
);
917 int firstSplitterX
= marginWidth
+ m_colWidths
[0];
918 m_fSplitterX
= (double) firstSplitterX
;
920 // Don't allow initial splitter auto-positioning after this.
921 if ( pg
->GetState() == this )
923 pg
->SetSplitterPosition(firstSplitterX
, false);
928 pg
->GetVirtualSize(&x
, &y
);
930 return wxSize(accWid
, y
);
933 void wxPropertyGridPageState::CheckColumnWidths( int widthChange
)
938 wxPropertyGrid
* pg
= GetGrid();
941 const bool debug
= false;
945 unsigned int lastColumn
= m_colWidths
.size() - 1;
947 int clientWidth
= pg
->GetClientSize().x
;
950 // Column to reduce, if needed. Take last one that exceeds minimum width.
951 // Except if auto splitter centering is used, in which case use widest.
953 int highestColWidth
= 0;
957 wxLogDebug(wxT("ColumnWidthCheck (virtualWidth: %i, clientWidth: %i)"), width
, clientWidth
);
962 for ( i
=0; i
<m_colWidths
.size(); i
++ )
964 int min
= GetColumnMinWidth(i
);
965 if ( m_colWidths
[i
] <= min
)
967 m_colWidths
[i
] = min
;
971 if ( pg
->HasFlag(wxPG_SPLITTER_AUTO_CENTER
) )
973 if ( m_colWidths
[i
] >= highestColWidth
)
975 highestColWidth
= m_colWidths
[i
];
986 int colsWidth
= pg
->m_marginWidth
;
987 for ( i
=0; i
<m_colWidths
.size(); i
++ )
988 colsWidth
+= m_colWidths
[i
];
992 wxLogDebug(wxT(" HasVirtualWidth: %i colsWidth: %i"),(int)pg
->HasVirtualWidth(),colsWidth
);
995 // Then mode-based requirement
996 if ( !pg
->HasVirtualWidth() )
998 int widthHigher
= width
- colsWidth
;
1000 // Adapt colsWidth to width
1001 if ( colsWidth
< width
)
1006 wxLogDebug(wxT(" Adjust last column to %i"), m_colWidths
[lastColumn
] + widthHigher
);
1008 m_colWidths
[lastColumn
] = m_colWidths
[lastColumn
] + widthHigher
;
1010 else if ( colsWidth
> width
)
1013 if ( reduceCol
!= -1 )
1017 wxLogDebug(wxT(" Reduce column %i (by %i)"), reduceCol
, -widthHigher
);
1019 // Reduce widest column, and recheck
1020 m_colWidths
[reduceCol
] = m_colWidths
[reduceCol
] + widthHigher
;
1021 CheckColumnWidths();
1027 // Only check colsWidth against clientWidth
1028 if ( colsWidth
< clientWidth
)
1030 m_colWidths
[lastColumn
] = m_colWidths
[lastColumn
] + (clientWidth
-colsWidth
);
1033 m_width
= colsWidth
;
1035 // If width changed, recalculate virtual size
1036 if ( pg
->GetState() == this )
1037 pg
->RecalculateVirtualSize();
1042 for ( i
=0; i
<m_colWidths
.size(); i
++ )
1043 wxLogDebug(wxT("col%i: %i"),i
,m_colWidths
[i
]);
1046 // Auto center splitter
1047 if ( !(pg
->GetInternalFlags() & wxPG_FL_DONT_CENTER_SPLITTER
) &&
1048 m_colWidths
.size() == 2 )
1050 float centerX
= (float)(pg
->m_width
/2);
1053 if ( m_fSplitterX
< 0.0 )
1055 splitterX
= centerX
;
1057 else if ( widthChange
)
1059 //float centerX = float(pg->GetSize().x) * 0.5;
1062 splitterX
= m_fSplitterX
+ (float(widthChange
) * 0.5);
1063 float deviation
= fabs(centerX
- splitterX
);
1065 // If deviating from center, adjust towards it
1066 if ( deviation
> 20.0 )
1068 if ( splitterX
> centerX
)
1076 // No width change, just keep sure we keep splitter position intact
1077 splitterX
= m_fSplitterX
;
1078 float deviation
= fabs(centerX
- splitterX
);
1079 if ( deviation
> 50.0 )
1081 splitterX
= centerX
;
1085 DoSetSplitterPosition((int)splitterX
, 0, false, true);
1087 m_fSplitterX
= splitterX
; // needed to retain accuracy
1091 void wxPropertyGridPageState::SetColumnCount( int colCount
)
1093 wxASSERT( colCount
>= 2 );
1094 m_colWidths
.SetCount( colCount
, wxPG_DRAG_MARGIN
);
1095 if ( m_colWidths
.size() > (unsigned int)colCount
)
1096 m_colWidths
.RemoveAt( m_colWidths
.size(), m_colWidths
.size() - colCount
);
1098 if ( m_pPropGrid
->GetState() == this )
1099 m_pPropGrid
->RecalculateVirtualSize();
1101 CheckColumnWidths();
1104 // Returns column index, -1 for margin
1105 int wxPropertyGridPageState::HitTestH( int x
, int* pSplitterHit
, int* pSplitterHitOffset
) const
1107 int cx
= GetGrid()->m_marginWidth
;
1109 int prevSplitter
= -1;
1114 if ( col
>= (int)m_colWidths
.size() )
1120 cx
+= m_colWidths
[col
];
1123 // Near prev. splitter
1126 int diff
= x
- prevSplitter
;
1127 if ( abs(diff
) < wxPG_SPLITTERX_DETECTMARGIN1
)
1129 *pSplitterHit
= col
- 1;
1130 *pSplitterHitOffset
= diff
;
1135 // Near next splitter
1136 int nextSplitter
= cx
;
1137 if ( col
< (int)(m_colWidths
.size()-1) )
1139 int diff
= x
- nextSplitter
;
1140 if ( abs(diff
) < wxPG_SPLITTERX_DETECTMARGIN1
)
1142 *pSplitterHit
= col
;
1143 *pSplitterHitOffset
= diff
;
1152 // -----------------------------------------------------------------------
1153 // wxPropertyGridPageState property value setting and getting
1154 // -----------------------------------------------------------------------
1156 bool wxPropertyGridPageState::DoSetPropertyValueString( wxPGProperty
* p
, const wxString
& value
)
1160 int flags
= wxPG_REPORT_ERROR
|wxPG_FULL_VALUE
|wxPG_PROGRAMMATIC_VALUE
;
1162 wxVariant variant
= p
->GetValueRef();
1165 if ( p
->GetMaxLength() <= 0 )
1166 res
= p
->StringToValue( variant
, value
, flags
);
1168 res
= p
->StringToValue( variant
, value
.Mid(0,p
->GetMaxLength()), flags
);
1172 p
->SetValue(variant
);
1173 if ( m_selected
==p
&& this==m_pPropGrid
->GetState() )
1174 m_pPropGrid
->RefreshEditor();
1182 // -----------------------------------------------------------------------
1184 bool wxPropertyGridPageState::DoSetPropertyValue( wxPGProperty
* p
, wxVariant
& value
)
1189 if ( m_selected
==p
&& this==m_pPropGrid
->GetState() )
1190 m_pPropGrid
->RefreshEditor();
1197 // -----------------------------------------------------------------------
1199 bool wxPropertyGridPageState::DoSetPropertyValueWxObjectPtr( wxPGProperty
* p
, wxObject
* value
)
1203 // wnd_primary has to be given so the control can be updated as well.
1205 DoSetPropertyValue(p
, v
);
1211 // -----------------------------------------------------------------------
1212 // wxPropertyGridPageState property operations
1213 // -----------------------------------------------------------------------
1215 bool wxPropertyGridPageState::DoCollapse( wxPGProperty
* p
)
1217 wxCHECK_MSG( p
, false, wxT("invalid property id") );
1219 if ( !p
->GetChildCount() ) return false;
1221 if ( !p
->IsExpanded() ) return false;
1223 p
->SetExpanded(false);
1225 VirtualHeightChanged();
1230 // -----------------------------------------------------------------------
1232 bool wxPropertyGridPageState::DoExpand( wxPGProperty
* p
)
1234 wxCHECK_MSG( p
, false, wxT("invalid property id") );
1236 if ( !p
->GetChildCount() ) return false;
1238 if ( p
->IsExpanded() ) return false;
1240 p
->SetExpanded(true);
1242 VirtualHeightChanged();
1247 // -----------------------------------------------------------------------
1249 bool wxPropertyGridPageState::DoSelectProperty( wxPGProperty
* p
, unsigned int flags
)
1251 if ( this == m_pPropGrid
->GetState() )
1252 return m_pPropGrid
->DoSelectProperty( p
, flags
);
1258 // -----------------------------------------------------------------------
1260 bool wxPropertyGridPageState::DoHideProperty( wxPGProperty
* p
, bool hide
, int flags
)
1263 p
->ClearFlag( wxPG_PROP_HIDDEN
);
1265 p
->SetFlag( wxPG_PROP_HIDDEN
);
1267 if ( flags
& wxPG_RECURSE
)
1270 for ( i
= 0; i
< p
->GetChildCount(); i
++ )
1271 DoHideProperty(p
->Item(i
), hide
, flags
| wxPG_RECURSE_STARTS
);
1274 VirtualHeightChanged();
1279 // -----------------------------------------------------------------------
1281 bool wxPropertyGridPageState::DoEnableProperty( wxPGProperty
* p
, bool enable
)
1287 if ( !(p
->m_flags
& wxPG_PROP_DISABLED
) )
1292 p
->m_flags
&= ~(wxPG_PROP_DISABLED
);
1296 if ( p
->m_flags
& wxPG_PROP_DISABLED
)
1301 p
->m_flags
|= wxPG_PROP_DISABLED
;
1305 // Apply same to sub-properties as well
1307 for ( i
= 0; i
< p
->GetChildCount(); i
++ )
1308 DoEnableProperty( p
->Item(i
), enable
);
1315 // -----------------------------------------------------------------------
1316 // wxPropertyGridPageState wxVariant related routines
1317 // -----------------------------------------------------------------------
1319 // Returns list of wxVariant objects (non-categories and non-sub-properties only).
1320 // Never includes sub-properties (unless they are parented by wxParentProperty).
1321 wxVariant
wxPropertyGridPageState::DoGetPropertyValues( const wxString
& listname
,
1322 wxPGProperty
* baseparent
,
1325 wxPGProperty
* pwc
= (wxPGProperty
*) baseparent
;
1327 // Root is the default base-parent.
1331 wxVariantList tempList
;
1332 wxVariant
v( tempList
, listname
);
1334 if ( pwc
->GetChildCount() )
1336 if ( flags
& wxPG_KEEP_STRUCTURE
)
1338 wxASSERT( !pwc
->HasFlag(wxPG_PROP_AGGREGATE
) );
1341 for ( i
=0; i
<pwc
->GetChildCount(); i
++ )
1343 wxPGProperty
* p
= pwc
->Item(i
);
1344 if ( !p
->GetChildCount() || p
->HasFlag(wxPG_PROP_AGGREGATE
) )
1346 wxVariant variant
= p
->GetValue();
1347 variant
.SetName( p
->GetBaseName() );
1348 v
.Append( variant
);
1352 v
.Append( DoGetPropertyValues(p
->m_name
,p
,flags
|wxPG_KEEP_STRUCTURE
) );
1354 if ( (flags
& wxPG_INC_ATTRIBUTES
) && p
->m_attributes
.GetCount() )
1355 v
.Append( p
->GetAttributesAsList() );
1360 wxPropertyGridConstIterator
it( this, wxPG_ITERATE_DEFAULT
, pwc
->Item(0) );
1361 it
.SetBaseParent( pwc
);
1363 for ( ; !it
.AtEnd(); it
.Next() )
1365 const wxPGProperty
* p
= it
.GetProperty();
1367 // Use a trick to ignore wxParentProperty itself, but not its sub-properties.
1368 if ( !p
->GetChildCount() || p
->HasFlag(wxPG_PROP_AGGREGATE
) )
1370 wxVariant variant
= p
->GetValue();
1371 variant
.SetName( p
->GetName() );
1372 v
.Append( variant
);
1373 if ( (flags
& wxPG_INC_ATTRIBUTES
) && p
->m_attributes
.GetCount() )
1374 v
.Append( p
->GetAttributesAsList() );
1383 // -----------------------------------------------------------------------
1385 void wxPropertyGridPageState::DoSetPropertyValues( const wxVariantList
& list
, wxPGProperty
* defaultCategory
)
1387 unsigned char origFrozen
= 1;
1389 if ( m_pPropGrid
->GetState() == this )
1391 origFrozen
= m_pPropGrid
->m_frozen
;
1392 if ( !origFrozen
) m_pPropGrid
->Freeze();
1395 wxPropertyCategory
* use_category
= (wxPropertyCategory
*)defaultCategory
;
1397 if ( !use_category
)
1398 use_category
= (wxPropertyCategory
*)m_properties
;
1400 // Let's iterate over the list of variants.
1401 wxVariantList::const_iterator node
;
1402 int numSpecialEntries
= 0;
1405 // Second pass for special entries
1406 for ( node
= list
.begin(); node
!= list
.end(); ++node
)
1408 wxVariant
*current
= (wxVariant
*)*node
;
1410 // Make sure it is wxVariant.
1411 wxASSERT( current
);
1412 wxASSERT( wxStrcmp(current
->GetClassInfo()->GetClassName(),wxT("wxVariant")) == 0 );
1414 const wxString
& name
= current
->GetName();
1415 if ( name
.length() > 0 )
1418 // '@' signified a special entry
1419 if ( name
[0] == wxS('@') )
1421 numSpecialEntries
++;
1425 wxPGProperty
* foundProp
= BaseGetPropertyByName(name
);
1428 wxPGProperty
* p
= foundProp
;
1430 // If it was a list, we still have to go through it.
1431 if ( wxStrcmp(current
->GetType(), wxS("list")) == 0 )
1433 DoSetPropertyValues( current
->GetList(),
1434 p
->IsCategory()?p
:(NULL
)
1440 if ( wxStrcmp(current
->GetType(), p
->GetValue().GetType()) != 0)
1442 wxLogDebug(wxT("wxPropertyGridPageState::DoSetPropertyValues Warning: Setting value of property \"%s\" from variant"),
1443 p
->GetName().c_str());
1447 p
->SetValue(*current
);
1453 if ( current
->GetType() != wxS("list") )
1459 // Yes, it is; create a sub category and append contents there.
1460 wxPGProperty
* newCat
= DoInsert(use_category
,-1,new wxPropertyCategory(current
->GetName(),wxPG_LABEL
));
1461 DoSetPropertyValues( current
->GetList(), newCat
);
1468 if ( numSpecialEntries
)
1470 for ( node
= list
.begin(); node
!= list
.end(); ++node
)
1472 wxVariant
*current
= (wxVariant
*)*node
;
1474 const wxString
& name
= current
->GetName();
1475 if ( name
.length() > 0 )
1478 // '@' signified a special entry
1479 if ( name
[0] == wxS('@') )
1481 numSpecialEntries
--;
1483 size_t pos2
= name
.rfind(wxS('@'));
1484 if ( pos2
> 0 && pos2
< (name
.size()-1) )
1486 wxString propName
= name
.substr(1, pos2
-1);
1487 wxString entryType
= name
.substr(pos2
+1, wxString::npos
);
1489 if ( entryType
== wxS("attr") )
1492 // List of attributes
1493 wxPGProperty
* foundProp
= BaseGetPropertyByName(propName
);
1496 wxASSERT( current
->GetType() == wxPG_VARIANT_TYPE_LIST
);
1498 wxVariantList
& list2
= current
->GetList();
1499 wxVariantList::const_iterator node2
;
1501 for ( node2
= list2
.begin(); node2
!= list2
.end(); ++node2
)
1503 wxVariant
*attr
= (wxVariant
*)*node2
;
1504 foundProp
->SetAttribute( attr
->GetName(), *attr
);
1509 // ERROR: No such property: 'propName'
1515 // ERROR: Special entry requires name of format @<propname>@<entrytype>
1520 if ( !numSpecialEntries
)
1527 m_pPropGrid
->Thaw();
1529 if ( this == m_pPropGrid
->GetState() )
1530 m_pPropGrid
->RefreshEditor();
1535 // -----------------------------------------------------------------------
1536 // wxPropertyGridPageState property adding and removal
1537 // -----------------------------------------------------------------------
1539 bool wxPropertyGridPageState::PrepareToAddItem( wxPGProperty
* property
,
1540 wxPGProperty
* scheduledParent
)
1542 wxPropertyGrid
* propGrid
= m_pPropGrid
;
1544 // This will allow better behavior.
1545 if ( scheduledParent
== m_properties
)
1546 scheduledParent
= NULL
;
1548 if ( scheduledParent
&& !scheduledParent
->IsCategory() )
1550 wxASSERT_MSG( property
->GetBaseName().length(),
1551 "Property's children must have unique, non-empty names within their scope" );
1554 property
->m_parentState
= this;
1556 if ( property
->IsCategory() )
1559 // Parent of a category must be either root or another category
1560 // (otherwise Bad Things might happen).
1561 wxASSERT_MSG( scheduledParent
== NULL
||
1562 scheduledParent
== m_properties
||
1563 scheduledParent
->IsCategory(),
1564 wxT("Parent of a category must be either root or another category."));
1566 // If we already have category with same name, delete given property
1567 // and use it instead as most recent caption item.
1568 wxPGProperty
* found_id
= BaseGetPropertyByName( property
->GetBaseName() );
1571 wxPropertyCategory
* pwc
= (wxPropertyCategory
*) found_id
;
1572 if ( pwc
->IsCategory() ) // Must be a category.
1575 m_currentCategory
= pwc
;
1582 // Warn for identical names in debug mode.
1583 if ( BaseGetPropertyByName(property
->GetName()) &&
1584 (!scheduledParent
|| scheduledParent
->IsCategory()) )
1586 wxLogError(wxT("wxPropertyGrid: Warning - item with name \"%s\" already exists."),
1587 property
->GetName().c_str());
1588 wxPGGlobalVars
->m_warnings
++;
1592 // Make sure nothing is selected.
1594 propGrid
->ClearSelection(false);
1596 // NULL parent == root parent
1597 if ( !scheduledParent
)
1598 scheduledParent
= DoGetRoot();
1600 property
->m_parent
= scheduledParent
;
1602 property
->InitAfterAdded(this, propGrid
);
1604 if ( property
->IsCategory() )
1606 wxPropertyCategory
* pc
= wxStaticCast(property
, wxPropertyCategory
);
1608 m_currentCategory
= pc
;
1610 // Calculate text extent for category caption
1612 pc
->CalculateTextExtent(propGrid
, propGrid
->GetCaptionFont());
1618 // -----------------------------------------------------------------------
1620 wxPGProperty
* wxPropertyGridPageState::DoAppend( wxPGProperty
* property
)
1622 wxPropertyCategory
* cur_cat
= m_currentCategory
;
1623 if ( property
->IsCategory() )
1626 return DoInsert( cur_cat
, -1, property
);
1629 // -----------------------------------------------------------------------
1631 wxPGProperty
* wxPropertyGridPageState::DoInsert( wxPGProperty
* parent
, int index
, wxPGProperty
* property
)
1634 parent
= m_properties
;
1636 wxCHECK_MSG( !parent
->HasFlag(wxPG_PROP_AGGREGATE
),
1638 wxT("when adding properties to fixed parents, use BeginAddChildren and EndAddChildren.") );
1640 bool res
= PrepareToAddItem( property
, (wxPropertyCategory
*)parent
);
1642 // PrepareToAddItem() may just decide to use use current category
1643 // instead of adding new one.
1645 return m_currentCategory
;
1647 // Note that item must be added into current mode later.
1649 // If parent is wxParentProperty, just stick it in...
1650 // If parent is root (m_properties), then...
1651 // In categoric mode: Add as last item in m_abcArray (if not category).
1652 // Add to given index in m_regularArray.
1653 // In non-cat mode: Add as last item in m_regularArray.
1654 // Add to given index in m_abcArray.
1655 // If parent is category, then...
1656 // 1) Add to given category in given index.
1657 // 2) Add as last item in m_abcArray.
1659 if ( !parent
->IsCategory() && !parent
->IsRoot() )
1661 // Parent is wxParentingProperty: Just stick it in...
1662 parent
->AddChild2( property
, index
);
1666 // Parent is Category or Root.
1668 if ( m_properties
== &m_regularArray
)
1672 // Only add non-categories to m_abcArray.
1673 if ( m_abcArray
&& !property
->IsCategory() )
1674 m_abcArray
->AddChild2( property
, -1, false );
1676 // Add to current mode.
1677 parent
->AddChild2( property
, index
);
1682 // Non-categorized mode.
1684 if ( parent
!= m_properties
)
1685 // Parent is category.
1686 parent
->AddChild2( property
, index
, false );
1689 m_regularArray
.AddChild2( property
, -1, false );
1691 // Add to current mode (no categories).
1692 if ( !property
->IsCategory() )
1693 m_abcArray
->AddChild2( property
, index
);
1698 if ( property
->IsCategory() )
1700 // This is a category caption item.
1702 // Last caption is not the bottom one (this info required by append)
1703 m_lastCaptionBottomnest
= 0;
1706 // Only add name to hashmap if parent is root or category
1707 if ( property
->m_name
.length() &&
1708 (parent
->IsCategory() || parent
->IsRoot()) )
1709 m_dictName
[property
->m_name
] = (void*) property
;
1711 VirtualHeightChanged();
1713 property
->UpdateParentValues();
1720 // -----------------------------------------------------------------------
1722 void wxPropertyGridPageState::DoDelete( wxPGProperty
* item
, bool doDelete
)
1724 wxCHECK_RET( item
->GetParent(),
1725 wxT("this property was already deleted") );
1727 wxCHECK_RET( item
!= &m_regularArray
&& item
!= m_abcArray
,
1728 wxT("wxPropertyGrid: Do not attempt to remove the root item.") );
1730 unsigned int indinparent
= item
->GetIndexInParent();
1732 wxPGProperty
* pwc
= (wxPGProperty
*)item
;
1733 wxPGProperty
* parent
= item
->GetParent();
1735 wxCHECK_RET( !parent
->HasFlag(wxPG_PROP_AGGREGATE
),
1736 wxT("wxPropertyGrid: Do not attempt to remove sub-properties.") );
1739 if ( item
->GetChildCount() && !item
->HasFlag(wxPG_PROP_AGGREGATE
) )
1741 // deleting a category
1742 if ( item
->IsCategory() )
1744 if ( pwc
== m_currentCategory
)
1745 m_currentCategory
= NULL
;
1748 item
->DeleteChildren();
1751 if ( !IsInNonCatMode() )
1753 // categorized mode - non-categorized array
1755 // Remove from non-cat array
1756 if ( !item
->IsCategory() &&
1757 (parent
->IsCategory() || parent
->IsRoot()) )
1760 m_abcArray
->RemoveChild(item
);
1763 // categorized mode - categorized array
1764 wxArrayPGProperty
& parentsChildren
= parent
->m_children
;
1765 parentsChildren
.erase( parentsChildren
.begin() + indinparent
);
1766 item
->m_parent
->FixIndicesOfChildren();
1770 // non-categorized mode - categorized array
1772 // We need to find location of item.
1773 wxPGProperty
* cat_parent
= &m_regularArray
;
1774 int cat_index
= m_regularArray
.GetChildCount();
1776 for ( i
= 0; i
< m_regularArray
.GetChildCount(); i
++ )
1778 wxPGProperty
* p
= m_regularArray
.Item(i
);
1779 if ( p
== item
) { cat_index
= i
; break; }
1780 if ( p
->IsCategory() )
1782 int subind
= ((wxPGProperty
*)p
)->Index(item
);
1783 if ( subind
!= wxNOT_FOUND
)
1785 cat_parent
= ((wxPGProperty
*)p
);
1791 cat_parent
->m_children
.erase(cat_parent
->m_children
.begin()+cat_index
);
1793 // non-categorized mode - non-categorized array
1794 if ( !item
->IsCategory() )
1796 wxASSERT( item
->m_parent
== m_abcArray
);
1797 wxArrayPGProperty
& parentsChildren
= item
->m_parent
->m_children
;
1798 parentsChildren
.erase(parentsChildren
.begin() + indinparent
);
1799 item
->m_parent
->FixIndicesOfChildren(indinparent
);
1803 if ( item
->GetBaseName().length() &&
1804 (parent
->IsCategory() || parent
->IsRoot()) )
1805 m_dictName
.erase(item
->GetBaseName());
1807 // We can actually delete it now
1811 m_itemsAdded
= 1; // Not a logical assignment (but required nonetheless).
1813 VirtualHeightChanged();
1816 // -----------------------------------------------------------------------
1818 #endif // wxUSE_PROPGRID