.

[bbtk.git] / doc / bouml / bbtkk / 140674.bodies

class wxTreeMultiCtrl
!!!172546.cpp!!!        DoFold(inout item : TreeMultiItemBase, in expand : bool, in recursive : bool) : void




        // go through all node objects on this level, and expand or

        // collapse them



        if(item == 0)

                return;



        // if this is a node, use it to go through all the subnodes (if needed)

        // if not, then just exit.



        TreeMultiItemNode *node = item->IsTreeMultiItemNode();

        if(node)

        {

                node->Fold(expand);



                // go recursive

                if(recursive)

                {

                        TreeMultiItemNode *p;

                        for(int i = 0; i < node->GetNodeCount(); i++)

                        {

                                // get node, and if a real node, then call fold

                                p = node->GetNode(i)->IsTreeMultiItemNode();

                                if(p)

                                        p->Fold(expand);



                                // go recursive for every node

                                DoFold(p, expand, recursive);

                        }

                }

        }

!!!172674.cpp!!!        RedrawFromNode(inout n : TreeMultiItemNode) : void


        static int recalcMutex = 0;

        bool visible = true;



        if(recalcMutex > 0)

                return;



        recalcMutex ++;



        // when node is not visible or excluded

        // then don't redraw.



        if(n)

                visible = n->IsVisible();



        if(visible)

        {

                int h, h1,w, w1;

                GetVirtualSize(&w, &h);



                UpdateAllWindowVisibility();

                RecalculateNodePositions();

                RecalculateVirtualSize();



                // why is this needed? Because folding or collapsing can change

                // the state. When the virtual area gets smaller, we need to keep

                // the largest one and the other way atound. And since we do not

                // know here we are folding or collapsing, we remember the biggest

                GetVirtualSize(&w1, &h1);



                if(h1 > h)

                        h = h1;



                // only refresh the part from x,y down

                if(n)

                {

                        int x, y;

                        CalcScrolledPosition(n->GetX(), n->GetY(), &x, &y);

                        if(h - y > 0)

                        {

                                wxRect rect(0, y, w, h - y);

                                RefreshRect(rect);

                        }

                        else

                                Refresh();

                }

                else

                        Refresh();      // do a full refresh

        }



        recalcMutex --;

!!!172802.cpp!!!        RedrawFromParentNode(inout n : TreeMultiItemBase) : void


        TreeMultiItemNode *p = 0;

        if(n)

                p = n->GetParent();



        RedrawFromNode(p);

!!!172930.cpp!!!        DrawCheckbox(inout b : TreeMultiItemBase, inout dc : wxDC, in convertScrolled : bool = false) : void


        wxCHECK2(b, return);



        wxBitmap *bmp;

        int bmpOffsetX = b->GetX() - (_gutterWidth + _iconWidth);



        switch(b->GetCheckboxState())

        {

        case 0:

                bmp = _uncheckBmp;

                break;

        case 1:

                bmp = _checkBmp;

                break;

        default:

                bmp = _tristateBmp;

                break;

        }



        int x, xx, y, yy;



        if(b->IsTreeMultiItemWindow())

        {

                xx = x = bmpOffsetX - ((TreeMultiItemWindow *)b)->GetFrontSpacing() + _checkWidth;

                yy = y = b->GetY() + _checkDeltaY;

        }

        else

        {

                xx = x = bmpOffsetX;

                yy = y = b->GetY() + _checkDeltaY;

        }



        if(convertScrolled)

                CalcScrolledPosition(x, y, &xx, &yy);



        dc.DrawBitmap(*bmp, xx, yy, true);

!!!173058.cpp!!!        RecalculateNodePositions() : void


        int currentY = _spacingY;

        // go recursive on every node, and store the information in the node



        for(int i = 0; i < _root.GetNodeCount(); i++)

        currentY += CalculateNodeDimensions(_root.GetNode(i), currentY, 0);

!!!173186.cpp!!!        CalculateNodeDimensions(inout b : TreeMultiItemBase, in currentY : int, in level : int) : int


        int gutter = (_gutterWidth * 2) + _iconWidth;

        int y = 0, topSpacing = 0;



        // return same if no proper object

        wxCHECK(b, 0);



#if(CHECKBOXVIEW)

        if(b->GetCheckbox())

                gutter += _checkWidth;

#endif



        // if we are not visible, skip recalculation and descending

        if(b->IsVisible())

        {

                b->SetY(currentY);



                // if level is 0, calculate with front gutter, else without

                y = currentY + b->GetHeight();

                if(b->IsTreeMultiItemNode())

                {

                        TreeMultiItemNode *n = (TreeMultiItemNode *)b;



                        if(level == 0)

                                b->SetX(gutter);

                        else

                                b->SetX(gutter + (level * (_gutterWidth + _iconWidth)));



                        // now do children of this node



                        for(int i = 0; i < n->GetNodeCount(); i++)

                                y += CalculateNodeDimensions(n->GetNode(i), y + _spacingY, level+1);

                }

                else if(b->IsTreeMultiItemWindow())

                {

                        TreeMultiItemWindow *w = (TreeMultiItemWindow *)b;



                        if(level == 0)

                                b->SetX(gutter + w->GetFrontSpacing());

                        else

                                b->SetX(_gutterWidth + (level * (_gutterWidth + _iconWidth)) + w->GetFrontSpacing());



                        topSpacing = w->GetTopSpacing();



                        // reposition the window



                        wxWindow *wnd = w->GetWindow();

                        if(wnd)

                        {

                                int x = 0, y = 0;

                                CalcScrolledPosition(w->GetX(), w->GetY(), &x, &y);

                                wnd->SetSize(x, y, w->GetWidth(), w->GetHeight());

                        }

                }



                if(y > 0)

                        return (y - currentY) + _spacingY + topSpacing; // return delta

                else

                        return 0;

        }



        return 0;       // not visible, thus we skip calculations

!!!173314.cpp!!!        DrawNode(inout b : TreeMultiItemBase, inout dc : wxDC) : void


        // go through this item .. if it is a node, draw

        // the caption, else reposition the window.



        if(!b)

                return;



        // forget it if this node is not visible

        if(b->IsVisible())

        {

                int bmpOffsetX = b->GetX() - (_gutterWidth + _iconWidth);



#if(CHECKBOXVIEW)

                // now draw the checkbox if there is any, in the proper state

                if(b->GetCheckbox())

                {

                        DrawCheckbox(b, dc);



                        // adjust the bmpOffset because we also have a checkbox

                        bmpOffsetX -= _checkWidth;

                }

#endif



                if(b->IsTreeMultiItemNode())

                {

                        // draw the node icon and the caption

                        TreeMultiItemNode *n = (TreeMultiItemNode *)b;



                 // set background of caption item

                  if (n->IsSelected())

                  {

                    dc.SetBrush(*(this->m_HilightBrush));

        dc.SetPen(wxPen(this->m_HilightBrush->GetColour(),1,wxSOLID));

                  } /* if */

                  else

                  {

                    dc.SetBrush(wxBrush(*wxWHITE,wxSOLID));

        dc.SetPen(wxPen(*wxWHITE,1,wxSOLID));

                  } /* if */

                  dc.DrawRectangle(n->GetX(),n->GetY(),n->GetWidth(),n->GetHeight());

                 // draw caption

                        dc.DrawText(n->GetCaption(), n->GetX(), n->GetY());



                        // draw the bitmap for the state

                        if(n->IsExpanded())

                                dc.DrawBitmap(*_expandBmp, bmpOffsetX, n->GetY() + _iconDeltaY, true);

                        else

                                dc.DrawBitmap(*_collBmp, bmpOffsetX, n->GetY() + _iconDeltaY, true);



                        // now go through all the subnodes

                        for(int i = 0; i < n->GetNodeCount(); i++)

                                DrawNode(n->GetNode(i), dc);



                }

        }

!!!173442.cpp!!!        SetWindowBackgroundColour(inout wnd : wxWindow, in col : wxColour, in flags : int) : void


        if(wnd)

        {

                // if we cannot change a button, make sure all button

                // classes are not changed



                wxButton *btn = wxDynamicCast(wnd, wxButton);

                if(!btn || ((flags & wxTMC_BG_ADJUST_BTN) != 0))

                        wnd->SetBackgroundColour(col);



                // get every window, and make the background equal to the given one

                wxWindowListNode *node = wnd->GetChildren().GetFirst();

                while (node)

                {

                        SetWindowBackgroundColour(node->GetData(), col, flags);

                        node = node->GetNext();

                }

        }

!!!173570.cpp!!!        ShowTreeMultiWindow(inout window : TreeMultiItemWindow, in show : bool = true) : void


        // show or hide window

        if(window && window->GetWindow())

                window->GetWindow()->Show(show);

!!!173698.cpp!!!        UpdateAllWindowVisibility() : void


        // all roots are visible, but what lies beneath ... who knows

        for(int i = 0; i < _root.GetNodeCount(); i++)

                UpdateTreeMultiWindowVisibility(_root.GetNode(i), true);

!!!173826.cpp!!!        UpdateTreeMultiWindowVisibility(inout b : TreeMultiItemBase, in show : bool) : void


        if(b)

        {

                // this is done for performance issues. IsVisible can go all

                // the way up the tree to check. However if show is already

                // false, there is no need to check (some higher one is collapsed)

                bool showMe = show;



                if(showMe)

                        showMe = b->IsVisible();



                if(b->IsTreeMultiItemWindow())

                {

                        // if this level must be hidden, hide

                        ShowTreeMultiWindow((TreeMultiItemWindow*)b, showMe);

                }

                else if(b->IsTreeMultiItemNode())

                {

                        TreeMultiItemNode *node = (TreeMultiItemNode *)b;



                        // if hidden, descend and hide all windows

                        for(int i = 0; i < node->GetNodeCount(); i++)

                                UpdateTreeMultiWindowVisibility(node->GetNode(i), showMe);

                }

        }

!!!173954.cpp!!!        RecalculateVirtualSize() : void


        // go through all the nodes, and store the largest x and largest y



        int x = 0, y = 0;

        RecalculateVirtualSizeFromNode(&_root, x, y);



        // now adjust virtual size

        SetVirtualSize(x, y);

        AdjustScrollbars(x, y);

!!!174082.cpp!!!        AdjustScrollbars(in x : int, in y : int) : void


        // adjust scrollbars

        // courtesy of treectrlg.cpp



        y += WXTMC_PIXELS_PER_UNIT+2; // one more scrollbar unit + 2 pixels

    x += WXTMC_PIXELS_PER_UNIT+2; // one more scrollbar unit + 2 pixels

    int x_pos = GetScrollPos( wxHORIZONTAL );

    int y_pos = GetScrollPos( wxVERTICAL );

    SetScrollbars( WXTMC_PIXELS_PER_UNIT, WXTMC_PIXELS_PER_UNIT, x/WXTMC_PIXELS_PER_UNIT,

                           y/WXTMC_PIXELS_PER_UNIT, x_pos, y_pos, true );

!!!174210.cpp!!!        RecalculateVirtualSizeFromNode(in node : TreeMultiItemNode, inout x : int, inout y : int) : void


        if(node->IsExcluded())

                return;



        // if calulate this node's dimensions

        if(x < (node->GetWidth() + node->GetX()))

                x = node->GetWidth() + node->GetX();



        y = node->GetY() + node->GetHeight();



        // if this node is collapsed, no subnodes are visible, else

        // go through all subnodes as well, node needs to be included as well

        if(node->IsExpanded())

        {

                TreeMultiItemBase *b;

                for(int i = 0; i < node->GetNodeCount(); i++)

                {

                        b = node->GetNode(i);



                        // calculate x and y

                        if(x < (b->GetWidth() + b->GetX()))

                                x = b->GetWidth() + b->GetX();



                        y = b->GetY() + b->GetHeight();



                        if(b->IsTreeMultiItemNode())

                                RecalculateVirtualSizeFromNode((TreeMultiItemNode *)b, x, y);

                }

        }

!!!174338.cpp!!!        FindNodeByPoint(inout b : TreeMultiItemBase, in pt : wxPoint, inout area : int) : TreeMultiItemBase


        wxCHECK(b, 0);



        // if this layer is not visible, return with nothing.

        if(!b->IsVisible())

                return 0;



        area = 0;



        // now see if our y is matching the mouse

        if(pt.y >= b->GetY() && pt.y < (b->GetY() + b->GetHeight()))

        {

#if(CHECKBOXVIEW)

                // if we are checkboxed, calculate the checkbox position

                if(b->GetCheckbox())

                {

                        int extraSpacing = 0, extraWidth = 0;



                        // now for a windows item, this is minus the gutter. For a normal node it is X minus checkbox

                        if(b->IsTreeMultiItemWindow())

                        {

                            extraWidth = _checkWidth;

                                extraSpacing = ((TreeMultiItemWindow *)b)->GetFrontSpacing();

                        }

                        else

                                extraSpacing = 4;



                        if(pt.x > (b->GetX() - extraSpacing - _checkWidth) && pt.x < (b->GetX() - extraSpacing + extraWidth))

                        {

                                area = wxTMC_HITTEST_CHECKBOX;

                                return b;

                        }

                }

#endif



                // allrighty we have something, now where and what is it (look with x)

                if(pt.x < b->GetX())

                        area = wxTMC_HITTEST_GUTTER;



                /** \todo Match only the real part of the caption, window (we assume x > GetX() which is the rest)

                        HOWEVER the window probably doesn't propagate the click event back to the parent, so we might

                        leave it like this so the use can click behind a window so it will be selected.

                */

                else

                {

                        // inside area, return proper flag

                        if(b->IsTreeMultiItemNode())

                                area = wxTMC_HITTEST_CAPTION;

                        else

                                area = wxTMC_HITTEST_WINDOW;

                }



                return b;

        }

        else

        {

                // not found, let's try our children if we have some

                TreeMultiItemNode *n = b->IsTreeMultiItemNode();

                if(n)

                {

                        TreeMultiItemBase *bb = 0;

                        for(int i = 0; i < n->GetNodeCount() && !bb; i++)

                                bb = FindNodeByPoint(n->GetNode(i), pt, area);



                        // keep returning result to caller

                        return bb;

                }

        }



        return 0;

!!!174466.cpp!!!        FindWindowNode(inout wnd : wxWindow, inout n : TreeMultiItemNode = 0) : wxTreeMultiItem


        wxCHECK(wnd, wxTreeMultiItem(0));



        // take root node if not assigned one



        if(!n)

                n = (TreeMultiItemNode *)&_root;



        // check on this level for the wxWindow pointer



        TreeMultiItemWindow *w;

        wxTreeMultiItem result(0);

        for(int i = 0; i < n->GetNodeCount() && !result.IsOk(); i++)

        {

                // if window node

                w = n->GetNode(i)->IsTreeMultiItemWindow();

                if(w && w->GetWindow() == wnd)

                        return wxTreeMultiItem(n);



                // if node, go deeper

                if(n->GetNode(i)->IsTreeMultiItemNode())

                        result = FindWindowNode(wnd, (TreeMultiItemNode*)n->GetNode(i));

        }



        return result;

!!!174594.cpp!!!        FindNextVisibleWindowItem(inout b : TreeMultiItemBase, in index : int = -1) : TreeMultiItemWindow


        wxCHECK(b, 0);



        // check on this level, go deeper with every node we got. When a node is not

        // visible anymore, skip the node.



        TreeMultiItemWindow *value = 0;

        if(b->IsVisible())

        {

                // if we are already searching on a node with an index



                TreeMultiItemBase *bn = 0;

                TreeMultiItemNode *n = b->IsTreeMultiItemNode();

                if(n)

                {

                        for(int i = index + 1; i < n->GetNodeCount() && !value; i++)

                        {

                                bn = n->GetNode(i);

                                value = bn->IsTreeMultiItemWindow();



                                // assume a node, root when not a a window

                                if(!value)

                                        value = FindNextVisibleWindowItem(bn, -1);

                        }



                }

                else

                {

                        if(b->IsTreeMultiItemWindow())

                        {

                                // get parent first, and locate child as ptr

                                TreeMultiItemNode *p = b->GetParent();

                                wxCHECK(p, 0);



                                // go scan the parent from the given index, if

                                // the index is valid else there is no child with that index



                                int idx = p->Index(b);

                                wxCHECK(idx >= 0, 0);



                                value = FindNextVisibleWindowItem(p, idx);

                        }

                }

        }



        return value;



!!!174722.cpp!!!        AdjustIconsDeltaY() : void


        int x = 0, y = 0;



        if(_captionFont.Ok())

      GetTextExtent(wxT("jG"), &x, &y, 0, 0, &_captionFont);

        _captionHeight = y;



        if(_maxHeight < _captionHeight)

                _maxHeight = _captionHeight;



        // determine the center pos for the [+]

        _iconDeltaY = abs(_maxHeight - _iconHeight) / 2 + 1;

        if(_iconDeltaY < 1)

                _iconDeltaY = 1;



#if(CHECKBOXVIEW)

        // determine the center pos for the checkbox

        _checkDeltaY = abs(_maxHeight - _checkHeight) / 2 + 1;

        if(_checkDeltaY < 1)

                _checkDeltaY = 1;

#endif

!!!174850.cpp!!!        CalculateNodeSpanning(inout b : TreeMultiItemBase) : void


        // return same if no proper object

        wxCHECK2(b, return);



        if(b->IsTreeMultiItemNode())

        {

                TreeMultiItemNode *n = (TreeMultiItemNode *)b;



                // now do children of this node



                for(int i = 0; i < n->GetNodeCount(); i++)

                        CalculateNodeSpanning(n->GetNode(i));

        }

        else if(b->IsTreeMultiItemWindow())

        {

                TreeMultiItemWindow *w = (TreeMultiItemWindow *)b;

                wxWindow *wnd = w->GetWindow();

                if(wnd)

                {

                        // if the window is spanning, we adjust the width to the max width of the control

                        if(w->GetHorizontalSpan())

                        {

                                wxSize tmcsize = GetClientSize();

                                int maxwidth = tmcsize.GetWidth() - w->GetX() - 8; // extract 3 for border



                                wxSizer *sz = wnd->GetSizer();

                                if(sz)

                                {

                                        if(maxwidth < sz->GetMinSize().GetWidth())

                                                maxwidth = sz->GetMinSize().GetWidth();

                                }



                                // prevent a size of 0

                                if(maxwidth < 1)

                                        maxwidth = 1;



                                // set the size

                                w->SetWidth(maxwidth);

                                wnd->SetSize(w->GetWidth(), w->GetHeight());



                                // layout by sizer (not sure if this is needed)

                                if(wnd->GetSizer())

                                        wnd->GetSizer()->Layout();

                        }

                }

        }

!!!174978.cpp!!!        SetRecursiveCheckState(inout n : TreeMultiItemNode, in check : bool) : void


        int state = 0;

        if(check)

                state++;



        // go check all kids on this level

        for(int i = 0; i < n->GetNodeCount(); i++)

        {

                // check all the nodes, and go deeper

                n->GetNode(i)->SetCheckboxState(state);

                if(n->GetNode(i)->IsTreeMultiItemNode())

                        SetRecursiveCheckState((TreeMultiItemNode *)n->GetNode(i), check);

        }

!!!175106.cpp!!!        ScanTristateCheckstates(inout b : TreeMultiItemBase) : void


        // check from the parent on, all node entries and see if they are

        // checked or cleared or scattered

        TreeMultiItemNode *p = b->GetParent();



        if(p && p->GetCheckbox())

        {

                bool foundcheck = false, foundclear = false;

                for(size_t i = 0; i < (size_t)p->GetNodeCount(); ++i)

                {

                        // only evaluate when checkboxed

                        if(p->GetNode(i)->IsTreeMultiItemWindow() && p->GetNode(i)->GetCheckbox())

                        {

                                // record instance of a cleared checkbox

                                if(!p->GetNode(i)->GetCheckboxState())

                                        foundclear = true;

                                // record instance of checked checkbox

                                if(p->GetNode(i)->GetCheckboxState() == 1)

                                        foundcheck = true;

                        }

                }



                // if we have both check and clear, go tristate

                // if all clear, clear parent and if all set, then set parent

                if(foundclear && !foundcheck)

                        p->SetCheckboxState(0);

                else if(!foundclear && foundcheck)

                        p->SetCheckboxState(1);

                else if(foundclear && foundcheck)

                        p->SetCheckboxState(2);



                //wxClientDC dc;

                //DrawCheckbox(p, dc, false);

                RedrawFromNode(p);

        }

!!!175234.cpp!!!        InsertNode(inout ParentPtr : TreeMultiItemNode, in Position : size_t, in Caption : wxString, in Name : wxString) : wxTreeMultiItem


        int extX, extY;



  TreeMultiItemNode* NodePtr(new TreeMultiItemNode(ParentPtr,Caption,Name)); // generate new node pointer





 // continue with initializing the new node:

#if(CHECKBOXVIEW)

 // if checkbox view is desired, tag this item as a checkbox

 // and set the state as 'false'

        NodePtr->SetCheckbox(_checkboxView);

        NodePtr->SetCheckboxState(0);

#endif

 // calculate the height and width

        this->GetTextExtent(Caption,&extX,&extY,0,0,&(this->_captionFont));

        NodePtr->SetHeight(extY);

        NodePtr->SetWidth(extX);

 // finally, insert node:

  if (Position < (size_t)ParentPtr->GetNodeCount())

    ParentPtr->InsertNode(NodePtr,Position);

  else

    ParentPtr->AddNode(NodePtr);

 // return the newly created node:

  return wxTreeMultiItem(NodePtr);

!!!175362.cpp!!!        InsertWindow(inout ParentPtr : TreeMultiItemNode, in Position : size_t, inout WindowPtr : wxWindow, in Name : wxString, in Info : wxTreeMultiWindowInfo, in Flags : int) : wxTreeMultiItem


  int WindowFlags;



        TreeMultiItemWindow* NewWindowPtr = new TreeMultiItemWindow(ParentPtr,Name); // generate new window pointer





 // get flags from passed variable "Flags"; in case this variable does not contain any flags use the window's information flags:

  if (Flags != 0)

    WindowFlags = Flags;

  else

    WindowFlags = Info.GetFlags();



 // continue with initializing the new window:

#if(CHECKBOXVIEW)

        // if checkbox view is desired, tag this item as a checkbox

        // and set the state as 'false'

        NewWindowPtr->SetCheckbox(_checkboxView);

#endif

 // if style wants us to change background, set it to our background

        if (WindowFlags & wxTMC_BG_ADJUST_ALL)

        {

                // go through all children of this window, and set the

                // background of it (recursively)

                this->SetWindowBackgroundColour(WindowPtr,this->GetBackgroundColour(),WindowFlags);

        } /* if */



 // set the spacing:

        NewWindowPtr->SetTopSpacing(Info.GetTopSpacing());

#if(CHECKBOXVIEW)

        // make sure that the checkboxes are at least indented enough

        if (this->_checkboxView)

                NewWindowPtr->SetFrontSpacing(Info.GetFrontSpacing() + this->_checkWidth);

        else

#endif

                NewWindowPtr->SetFrontSpacing(Info.GetFrontSpacing());

 // assign finally the window:

        NewWindowPtr->AssignWindow(WindowPtr);



#if(CHECKBOXVIEW)

 // set the checkbox state after the window is assigned

        NewWindowPtr->SetCheckboxState(Info.GetDefaultCheckState());

#endif



 // if the window is not visible, set hide flag

        this->ShowTreeMultiWindow(NewWindowPtr,NewWindowPtr->IsVisible());



 // finally, insert the newly constructed window:

  if (Position < (size_t)ParentPtr->GetNodeCount())

    ParentPtr->InsertNode(NewWindowPtr,Position);

  else

    ParentPtr->AddNode(NewWindowPtr);

 // return the newly created window:

        return wxTreeMultiItem(NewWindowPtr);

!!!175490.cpp!!!        Init() : void


        _root.Clear();



        _expandBmp = 0;

        _collBmp = 0;



#if(CHECKBOXVIEW)

        _checkBmp = 0;

        _uncheckBmp = 0;

        _tristateBmp = 0;



        _checkHeight = 11;

        _checkWidth = 11;



        _checkboxView = false;

#endif



        _gutterWidth = WXTMC_GUTTER_DEFAULT;

        _iconWidth = 11;

        _iconHeight = 11;

        _maxHeight = 1;;

        _iconDeltaY = 2;

        _spacingY = WXTMC_YSPACING_DEFAULT;

        _captionHeight = 13;



        // create two bitmap nodes for drawing



        _expandBmp = new wxBitmap(expand_xpm);

        _collBmp = new wxBitmap(collapse_xpm);



        // calculate average font height for bitmap centering



        _iconWidth = _expandBmp->GetWidth();

        _iconHeight = _expandBmp->GetHeight();



#if(CHECKBOXVIEW)

        // create bitmaps for checkboxes

        _checkBmp = new wxBitmap(checked_icon);

        _uncheckBmp = new wxBitmap(unchecked_icon);

        _tristateBmp = new wxBitmap(tristate_icon);



        // adjust the height if the checkboxes are higher

        // so that everything is alligned properly

        _checkHeight = _checkBmp->GetHeight();

        _checkWidth = _checkBmp->GetWidth();

#endif



        // remember the highest of the two bitmaps so there is

        // always enough room

        _maxHeight = _iconHeight;



#if(CHECKBOXVIEW)

        if(_maxHeight < _checkHeight)

                _maxHeight = _checkHeight;

#endif



 // set standard highlighting brush

  this->m_HilightBrush = new wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT),wxSOLID);



        // set standard DC font

    _captionFont = wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT);



        // adjust bitmap icon y position so they are centered

        AdjustIconsDeltaY();



        // set virtual size to this window size

        if (_create_called) {

                wxSize wndsize = GetSize();

                SetVirtualSize(wndsize.GetWidth(), wndsize.GetWidth());

        }

!!!175746.cpp!!!        OnMouseClick(inout event : wxMouseEvent) : void


        // react on double click and left mouse down

        if(event.LeftDown() || event.LeftDClick())

        {

                // get translation point

                wxPoint pt( event.GetPosition() );



                int x = 0, y = 0;

                CalcUnscrolledPosition( pt.x, pt.y, &x, &y );



                // go check if we clicked a treenode

                int flags;

                wxPoint p(x,y);

                wxTreeMultiItem id = HitTest(p, flags);



#if(CHECKBOXVIEW)

                if(flags == wxTMC_HITTEST_CHECKBOX)

                {

                        // toggle the checkbox, and redraw

                        if(id.IsOk())

                        {

                                TreeMultiItemBase *b = id.GetItem();

                                b->SetCheckboxState((b->GetCheckboxState()+1) & 0x1);



                                TreeMultiItemWindow *w = b->IsTreeMultiItemWindow();

                                if(w)

                                {

                                        // try to force a focus on the window. This could

                                        // be extended by searching for the first edit control

                                        // class but for now, just a focus is tried.

                                        w->GetWindow()->Enable(b->GetCheckboxState() == 1);

                                        w->GetWindow()->SetFocus();



                                        // draw the checkbox in the state needed

                                        wxClientDC dc(this);

                                        DrawCheckbox(b, dc, true);



                                        // TODO: determine if the upper parents should be

                                        // tristated or not



                                        ScanTristateCheckstates(b);



                                }

                                else if(b->IsTreeMultiItemNode())

                                {

                                        // descend to all the children and set the state of the parent

                                        SetRecursiveCheckState((TreeMultiItemNode *)b, b->GetCheckboxState() == 1);

                                        RedrawFromNode((TreeMultiItemNode *)b);

                                }

                        }

                }

                else

#endif // #if(CHECKBOXVIEW)

                {

                        // react on left mouse button, to fold and on

                        // right for caption doubleclick

                        int area = -1;



// adjust behaviour for Linux (single click = always fold)

#ifndef LINUX

                        if(event.LeftDClick())

                                area = wxTMC_HITTEST_CAPTION;

                        else

                                area = wxTMC_HITTEST_GUTTER;

#else

                        area = flags;

#endif



// Linux (single or double click -> always fold

      if (id.IsOk())

      {

#ifdef LINUX

                                // we have a valid item, if it is a node, then fold

                                TreeMultiItemNode *n = id.GetItem()->IsTreeMultiItemNode();

                                if(n)

                                {

                                  this->SelectItem(id);

                                        Fold(n, !n->IsExpanded());

                                } /* if */

#else

        if (event.LeftDown())

          if (flags == wxTMC_HITTEST_GUTTER)

          {

                                TreeMultiItemNode *n = id.GetItem()->IsTreeMultiItemNode(); // for some reasons also windows may have set the flag



            if (n != NULL)

                                        Fold(n, !n->IsExpanded());

          } /* if */

          else if (flags == wxTMC_HITTEST_CAPTION)

          {

                                TreeMultiItemNode *n = id.GetItem()->IsTreeMultiItemNode(); // for some reasons also windows may have set the flag



                                if (n != NULL)

                                {

                                  this->SelectItem(id);

                                this->RedrawFromNode(n);

                                } /* if */

          } /* if */

#endif

      } /* if */

      else

        this->UnselectAll();

                }

        }

!!!175874.cpp!!!        OnRightMouseClick(inout Event : wxMouseEvent) : void


  if (Event.RightDown())

    if (Event.Dragging())

      this->UnselectAll();

    else

    {

     // variable definitions:

        int Flags;

        wxPoint Point;



     // translate mouse coordinates:

        CalcUnscrolledPosition(Event.GetPosition().x,Event.GetPosition().y,&(Point.x),&(Point.y));

     // check if the mouse is above the caption of an item:

      wxTreeMultiItem Item(this->HitTest(Point,Flags)); // variable definition and initialization



      if (Item.IsOk() && (Flags == wxTMC_HITTEST_CAPTION))

      {

        this->SelectItem(Item);

                                this->RedrawFromNode(Item.GetItem()->IsTreeMultiItemNode());

          Event.Skip(); // window will convert right mouse click to a context menu event or proceed with

                        // a right mouse click event if the context menu event cannot be processed

      } /* if */

      else

        this->UnselectAll();

    } /* if */

  else

    this->UnselectAll();

!!!176002.cpp!!!        OnKey(inout event : wxKeyEvent) : void


        // check if we need to traverse to upper or lower

        // control in the list

        if(event.GetKeyCode() == WXK_TAB)

        {

                wxTreeMultiItem item = GetFocus();

                if(item.IsOk())

                {

                        // traverse down direction

                        if(!event.ShiftDown())

                                item = FindNextVisibleWindowItem(item.GetItem());

                        //else // traverse in up direction

                        //      item = FindPreviousVisibleWindowItem(item);



                        if(item.IsOk())

                        {

                                TreeMultiItemWindow *w = item.GetItem()->IsTreeMultiItemWindow();

                                if(w)

                                {

                                        wxWindow *wnd = w->GetWindow();

                                        wnd->SetFocus();

                                }

                        }

                }

        }

        else

                event.Skip();

!!!176258.cpp!!!        RecalculateSpanSizes() : void


        for(int i = 0; i < _root.GetNodeCount(); i++)

        CalculateNodeSpanning(_root.GetNode(i));

!!!176642.cpp!!!        ~wxTreeMultiCtrl()


        // delete the bitmap resources

        delete _expandBmp;

        delete _collBmp;



#if(CHECKBOXVIEW)

        delete _checkBmp;

        delete _uncheckBmp;

        delete _tristateBmp;

#endif

!!!176898.cpp!!!        AddRoot(in caption : wxString, in name : wxString = wxEmptyString) : wxTreeMultiItem


        wxTreeMultiItem result((TreeMultiItemBase *)&_root);

        result = AppendNode(result, caption, name);



        return result;

!!!177026.cpp!!!        AppendWindow(in ParentItem : wxTreeMultiItem, inout window : wxWindow = NULL, in name : wxString = wxEmptyString, in info : wxTreeMultiWindowInfo = wxTreeMultiWindowInfoDefault, in flags : int = 0) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewWindowItem(this->InsertWindow(parent,wx_static_cast(size_t,parent->GetNodeCount()),window,name,info,flags));

 // redraw the stucture:

        this->RedrawFromNode(parent);

 // return the new window

        return NewWindowItem;

!!!177154.cpp!!!        InsertWindow(in ParentItem : wxTreeMultiItem, in Position : size_t, inout window : wxWindow = NULL, in name : wxString = wxEmptyString, in info : wxTreeMultiWindowInfo = wxTreeMultiWindowInfoDefault, in flags : int = 0) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewWindowItem(this->InsertWindow(parent,Position,window,name,info,flags));

 // redraw the stucture:

        this->RedrawFromNode(parent);

 // return the new window

        return NewWindowItem;

!!!177282.cpp!!!        PrependWindow(in ParentItem : wxTreeMultiItem, inout window : wxWindow = NULL, in name : wxString = wxEmptyString, in info : wxTreeMultiWindowInfo = wxTreeMultiWindowInfoDefault, in flags : int = 0) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewWindowItem(this->InsertWindow(parent,0,window,name,info,flags));

 // redraw the stucture:

        this->RedrawFromNode(parent);

 // return the new window

        return NewWindowItem;

!!!177410.cpp!!!        AppendNode(in ParentItem : wxTreeMultiItem, in caption : wxString = wxEmptyString, in name : wxString = wxEmptyString) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewNodeItem(this->InsertNode(parent,wx_static_cast(size_t,parent->GetNodeCount()),caption,name));

 // redraw the structure:

        this->RedrawFromNode(parent);

 // return the new node:

        return NewNodeItem;

!!!177538.cpp!!!        InsertNode(in ParentItem : wxTreeMultiItem, in Position : size_t, in caption : wxString, in name : wxString) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewNodeItem(this->InsertNode(parent,Position,caption,name));

 // redraw the structure:

        this->RedrawFromNode(parent);

 // return the new node:

        return NewNodeItem;

!!!177666.cpp!!!        PrependNode(in ParentItem : wxTreeMultiItem, in caption : wxString = wxEmptyString, in name : wxString = wxEmptyString) : wxTreeMultiItem


 // add window only if the parent item is valid and...

        wxCHECK(ParentItem.IsOk(), wxTreeMultiItem(0));



        TreeMultiItemNode* parent = ParentItem.GetItem()->IsTreeMultiItemNode(); // also roots are nodes



 // ... is a node

  wxCHECK(parent != NULL, wxTreeMultiItem(0));



 // now, append node to the tree control:

  wxTreeMultiItem NewNodeItem(this->InsertNode(parent,0,caption,name));

 // redraw the structure:

        this->RedrawFromNode(parent);

 // return the new node:

        return NewNodeItem;

!!!177794.cpp!!!        Delete(inout item : wxTreeMultiItem) : bool


        bool redraw = true;

        wxCHECK(item.IsOk(), false);



        wxTreeMultiItem nullItem(0);





 // if item has been selected, remove it from the selected list:

  size_t ItemIndex(this->GetSelectedItemIndex(item));



  if (ItemIndex != this->GetSelectedItemCount())

    this->m_SelectedItems.RemoveAt(ItemIndex);



        // get parent, to delete item from

        TreeMultiItemNode *p = item.GetItem()->GetParent();



        // first check if it was visible, if so from the parent off

        // it needs redrawing

        redraw = item.GetItem()->IsVisible();

        if(p)

                p->DeleteNode(item.GetItem());

        else

                _root.DeleteNode(item.GetItem());



        item = nullItem;



        // do redraw when node was visible

        if(redraw)

                RedrawFromNode(p);



        return true;

!!!178050.cpp!!!        DeleteChildren(in item : wxTreeMultiItem) : void


        if(item.IsNodeItem())

        {

                TreeMultiItemNode *n = (TreeMultiItemNode *)item.GetItem();



   // remove all children from the selected item list:

          if (n->GetNodeCount() > 0)

          {

           // variable definitions and initializations:

            int Cookie;

            wxTreeMultiItem FirstItemIterator(this->GetFirstChild(item,Cookie)), LastItemIterator(this->GetLastChild(item));



            for (;;)

            {

              size_t ItemIndex(this->GetSelectedItemIndex(item)); // variable definition and initialization



              if (ItemIndex != this->GetSelectedItemCount())

                this->m_SelectedItems.RemoveAt(ItemIndex);

              if (FirstItemIterator == LastItemIterator)

                break; // all children checked

              else

                FirstItemIterator = this->GetNext(FirstItemIterator);

            } /* for */

          } /* if */

         // delete children:

                n->Clear();

        // redraw:

                RedrawFromNode(n);

        }

!!!178178.cpp!!!        ExpandNodes(in recursive : bool = false) : void


        // go through all children and call DoFold recursively

        for(int i = 0; i < _root.GetNodeCount(); i++)

                DoFold(_root.GetNode(i), true, recursive);

        RedrawFromNode(0);

!!!178306.cpp!!!        CollapseNodes(in recursive : bool = false) : void


        // go through all children and call DoFold recursively

        for(int i = 0; i < _root.GetNodeCount(); i++)

                DoFold(_root.GetNode(i), false, recursive);

        RedrawFromNode(0);

!!!178434.cpp!!!        Expand(in item : wxTreeMultiItem, in recursive : bool) : void


        if(item.IsOk())

        {

        TreeMultiItemNode *n = item.GetItem()->IsTreeMultiItemNode();

                if(!n)

                        n = item.GetItem()->GetParent();

        DoFold(n, true, recursive);

                RedrawFromNode(item.GetItem()->IsTreeMultiItemNode());

        }

!!!178562.cpp!!!        Collapse(in item : wxTreeMultiItem, in recursive : bool) : void


        if(item.IsOk())

        {

        TreeMultiItemNode *n = item.GetItem()->IsTreeMultiItemNode();

                if(!n)

                        n = item.GetItem()->GetParent();

                DoFold(n, false, recursive);

                RedrawFromNode(item.GetItem()->IsTreeMultiItemNode());

        }

!!!178690.cpp!!!        CollapseAndReset(in item : wxTreeMultiItem) : void


        if(item.IsNodeItem())

        {

                 TreeMultiItemNode *n = (TreeMultiItemNode *)item.GetItem();



                 // delete all kids

                 n->Clear();

                 Collapse(item, false);

        }

!!!179074.cpp!!!        GetFirstSelectedItem(in  : void) : wxTreeMultiItem


  if (this->GetSelectedItemCount() > 0)

    return this->m_SelectedItems[0];

  else

    return wxTreeMultiItem();

!!!179202.cpp!!!        GetLastSelectedItem(in  : void) : wxTreeMultiItem


  if (this->GetSelectedItemCount() > 0)

    return this->m_SelectedItems[this->GetSelectedItemCount()-1];

  else

    return wxTreeMultiItem();

!!!179330.cpp!!!        GetSelectedItem(in Index : size_t) : wxTreeMultiItem


  if (Index < this->GetSelectedItemCount())

    return this->m_SelectedItems[Index];

  else

    return wxTreeMultiItem();

!!!179458.cpp!!!        GetSelectedItemIndex(in Item : wxTreeMultiItem) : size_t


 // attention: the function wxArray::Index() can NOT be used in a save manner as it only checks the address of an item

 //            element but it is not guaranteed that Item may not be a copy of the originally inserted item

  const size_t NoOfSelectedItems = this->GetSelectedItemCount();



  size_t Index(0);





  while ((Index < NoOfSelectedItems) && (this->m_SelectedItems[Index] != Item))

    ++Index;

  return Index;

!!!179586.cpp!!!        SelectItem(in Item : wxTreeMultiItem, in UnselectOthers : bool = true, in ExpandSelection : bool = false) : void


  TreeMultiItemNode* NodePtr(Item.GetItem()->IsTreeMultiItemNode());





 // only nodes can be selected and they can only be selected if they are not already selected:

  if ((NodePtr == NULL) || NodePtr->IsSelected())

   return;



 // inform that we are about to change:

  wxTreeMultiEvent Event(wxEVT_COMMAND_TREE_MULTI_SEL_CHANGING,Item); // variable definition and initialization



  if (this->m_SelectedItems.GetCount() > 0) // the last item in the array is always the latest inserted item

    Event.SetOldItem(this->m_SelectedItems.Last());

  Event.SetEventObject(this);

  if (this->GetEventHandler()->ProcessEvent(Event) && !(Event.IsAllowed()))

      return; // vetoed



 // make sure that the to be selected item can be seen:

  this->Include(Item);



 // variable definition and initialization:

  wxTreeMultiItem ExcludedParent(this->GetExcludedParent(Item));



  while (ExcludedParent.IsOk())

  {

    this->Include(ExcludedParent);

    ExcludedParent = this->GetExcludedParent(Item);

  } /* while */



 // unselect items if necessary:

  if (UnselectOthers)

    this->UnselectAll();

 // expand selection if necessary:

  if (ExpandSelection)

  {

   // variable definition:

    wxTreeMultiItem FirstItemIterator, LastItemIterator;

    wxTreeMultiItem LastSelectedItem;



   // determine the last selected item or the first item in case nothing has been selected before:

    if (this->m_SelectedItems.GetCount() > 0)

      LastSelectedItem = this->m_SelectedItems.Last();

    else

      LastSelectedItem = this->GetFirstRoot();

   // determine the item from which to start and the one with which to end the selection:

    if (Item.GetItem()->GetY() > LastSelectedItem.GetItem()->GetY())

    {

      FirstItemIterator = LastSelectedItem;

      LastItemIterator  = Item;

    } /* if */

    else

    {

      FirstItemIterator = Item;

      LastItemIterator  = LastSelectedItem;

    } /* if */

   // select all items that are a node and are placed between the two limiting iterators (included the limits):

    for (;;)

    {

      if (!(FirstItemIterator.IsSelected()) && FirstItemIterator.IsNodeItem())

      {

        FirstItemIterator.GetItem()->Select();

        this->m_SelectedItems.Add(FirstItemIterator);

        this->RefreshRect(wxRect(FirstItemIterator.GetItem()->GetX(),    FirstItemIterator.GetItem()->GetY(),

                                 FirstItemIterator.GetItem()->GetWidth(),FirstItemIterator.GetItem()->GetHeight()));

      } /* if */

      if (FirstItemIterator == LastItemIterator)

        break; // done

     // continue iterating:

      FirstItemIterator = this->GetNext(FirstItemIterator);

    } /* for */

  } /* if */

  else // select passed item only

  {

    NodePtr->Select();

    this->m_SelectedItems.Add(NodePtr);

    this->RefreshRect(wxRect(NodePtr->GetX(),NodePtr->GetY(),NodePtr->GetWidth(),NodePtr->GetHeight()));

  } /* if */



 // inform that we have selected the item:

  Event.SetEventType(wxEVT_COMMAND_TREE_MULTI_SEL_CHANGED);

  this->GetEventHandler()->ProcessEvent(Event);

!!!179714.cpp!!!        UnselectAll(in  : void) : void


  const size_t NoOfSelectedItems = this->m_SelectedItems.GetCount();





  for (size_t i=0; i<NoOfSelectedItems; ++i)

  {

    this->RefreshRect(wxRect(this->m_SelectedItems[i].GetItem()->GetX(),    this->m_SelectedItems[i].GetItem()->GetY(),

                             this->m_SelectedItems[i].GetItem()->GetWidth(),this->m_SelectedItems[i].GetItem()->GetHeight()));

    this->m_SelectedItems[i].GetItem()->Unselect();

  } /* for */

  this->m_SelectedItems.Clear();

!!!179842.cpp!!!        Unselect(in Item : wxTreeMultiItem) : void


  size_t ItemIndex(this->GetSelectedItemIndex(Item));





  if (ItemIndex != this->GetSelectedItemCount())

  {

    Item.GetItem()->Unselect();

    this->m_SelectedItems.RemoveAt(ItemIndex);

    this->RefreshRect(wxRect(Item.GetItem()->GetX(),Item.GetItem()->GetY(),Item.GetItem()->GetWidth(),Item.GetItem()->GetHeight()));

  } /* if */

!!!179970.cpp!!!        Exclude(in item : wxTreeMultiItem) : void


        wxCHECK2(item.IsOk(), return);



        // exclude the item, and refresh

        // if already excluded, skip



        if(!item.GetItem()->IsExcluded())

        {

                item.GetItem()->SetExcluded(true);

                RedrawFromParentNode(item.GetItem());

        }

!!!180098.cpp!!!        Include(in item : wxTreeMultiItem) : void


        wxCHECK2(item.IsOk(), return);



        // include the item, and refresh. If not

        // excluded, do nothing



        if(item.GetItem()->IsExcluded())

        {

                item.GetItem()->SetExcluded(false);

                RedrawFromParentNode(item.GetItem());

        }

!!!180226.cpp!!!        GetExcludedParent(in item : wxTreeMultiItem) : wxTreeMultiItem


        wxCHECK(item.IsOk(), wxTreeMultiItem(0));



        // go find the parent (including this one) that

        // can be the excluded one



        TreeMultiItemNode *n = item.GetItem()->IsTreeMultiItemNode();

        if(n && n->IsExcluded())

                return wxTreeMultiItem(n);



        n = item.GetItem()->GetParent();

        while(n)

        {

                if(n->IsExcluded())

                        return wxTreeMultiItem(n);

                else

                        n = n->GetParent();

        }



        return wxTreeMultiItem(0);

!!!180354.cpp!!!        HitTest(in pt : wxPoint, inout flags : int) : wxTreeMultiItem


        // scan all nodes to see which one matches

        TreeMultiItemBase *b = 0;

        for(int i = 0; i < _root.GetNodeCount() && !b; i++)

                b = FindNodeByPoint(_root.GetNode(i), pt, flags);



        if(!b)

        {

                // none found, reset

                flags = 0;

                return wxTreeMultiItem(0);

        }



        // return an item

        return wxTreeMultiItem(b);

!!!180482.cpp!!!        FindItem(in item : wxTreeMultiItem, in name : wxString, in ignoreCase : bool = false, in skipFirst : bool = false) : wxTreeMultiItem


        if(item.IsOk())

        {

                TreeMultiItemBase *b = item.GetItem();



                // check this item first (or not)



                if(!skipFirst)

                {

                        if(b->GetName().IsSameAs(name, !ignoreCase))

                                return wxTreeMultiItem(b);

                }



                if(b->IsTreeMultiItemNode())

                {

                        // now check whether we are a node, then go check children



                        TreeMultiItemNode *n = (TreeMultiItemNode *)b;

                        wxTreeMultiItem result(0);

                        for(int i = 0; i < n->GetNodeCount() && !result.IsOk(); i++)

                                result = FindItem(wxTreeMultiItem(n->GetNode(i)), name, ignoreCase, false);



                        return result;

                }

        }



        return wxTreeMultiItem(0);

!!!180866.cpp!!!        GetFocus() : wxTreeMultiItem


        wxWindow *wnd = wxWindow::FindFocus();



        // now find window that holds this item. if not

        // visible it cannot have focus (should not have)



        wxTreeMultiItem item = FindWindowNode(wnd);

        if(item.IsOk() && item.GetItem()->IsVisible())

                return item;



        return wxTreeMultiItem(0);

!!!180994.cpp!!!        GetBooleanValue(in wndId : int) : bool


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK(wnd, false);



        // try a radio button

        wxRadioButton *b = wxDynamicCast(wnd, wxRadioButton);

        if(b)

                return b->GetValue();



        // try a check box

        wxCheckBox *c = wxDynamicCast(wnd, wxCheckBox);

        if(c)

                return c->GetValue();



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

            which can be overridden to retrieve the boolean value. It will also be passed

            the pointer to the window, so the derived class can figure out how to get a boolean

            value.

        */



        // generate assert or just return with false

        wxCHECK(0, false);

!!!181122.cpp!!!        GetTextValue(in wndId : int) : wxString


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK(wnd, wxEmptyString);



        // try a radio button

        wxTextCtrl *t = wxDynamicCast(wnd, wxTextCtrl);

        if(t)

                return t->GetValue();



        // try a choice box

        wxChoice *c1 = wxDynamicCast(wnd, wxChoice);

        if(c1)

                return c1->GetStringSelection();



        // try a combo box

        wxComboBox *c2 = wxDynamicCast(wnd, wxComboBox);

        if(c2)

                return c2->GetStringSelection();



        // try a listbox

        wxListBox *l = wxDynamicCast(wnd, wxListBox);

        if(l)

                return l->GetStringSelection();



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

            which can be overridden to retrieve the boolean value. It will also be passed

            the pointer to the window, so the derived class can figure out how to get a boolean

            value.

        */



        // generate assert or just return with string

        wxCHECK(0, wxEmptyString);

!!!181250.cpp!!!        SetBooleanValue(in wndId : int, in value : bool = true) : void


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK2(wnd, return);



        // try a radio button

        wxRadioButton *b = wxDynamicCast(wnd, wxRadioButton);

        if(b)

        {

                b->SetValue(value);

                return;

        }



        // try a check box

        wxCheckBox *c = wxDynamicCast(wnd, wxCheckBox);

        if(c)

        {

                c->SetValue(value);

                return;

        }



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

                    which can be overridden to retrieve the boolean value. It will also be passed

                    the pointer to the window, so the derived class can figure out how to get a boolean

                    value.

        */



        // generate assert

        wxCHECK2(0, return);

!!!181378.cpp!!!        SetTextValue(in wndId : int, in value : wxString = wxEmptyString) : void


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK2(wnd, return);



        // try a radio button

        wxTextCtrl *t = wxDynamicCast(wnd, wxTextCtrl);

        if(t)

        {

                t->SetValue(value);

                return;

        }



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

                    which can be overridden to retrieve the boolean value. It will also be passed

                    the pointer to the window, so the derived class can figure out how to get a boolean

                    value.

        */



        // generate assert

        wxCHECK2(0, return);

!!!181634.cpp!!!        SetSelectionValue(in wndId : int, in sel : int) : void


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK2(wnd, return);



        // try a choice box

        wxChoice *c1 = wxDynamicCast(wnd, wxChoice);

        if(c1)

        {

                c1->SetSelection(sel);

                return;

        }



        // try a combo box

        wxComboBox *c2 = wxDynamicCast(wnd, wxComboBox);

        if(c2)

        {

                c2->SetSelection(sel);

                return;

        }



        // try a listbox

        wxListBox *l = wxDynamicCast(wnd, wxListBox);

        if(l)

        {

                l->SetSelection(sel);

                return;

        }



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

            which can be overridden to retrieve the boolean value. It will also be passed

            the pointer to the window, so the derived class can figure out how to get a boolean

            value.

        */



        // generate assert or just return with string

        wxCHECK2(0, return);

!!!181762.cpp!!!        GetSelectionValue(in wndId : int) : int


        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK(wnd, -1);



        // try a choice box

        wxChoice *c1 = wxDynamicCast(wnd, wxChoice);

        if(c1)

                return c1->GetSelection();



        // try a combo box

        wxComboBox *c2 = wxDynamicCast(wnd, wxComboBox);

        if(c2)

                return c2->GetSelection();



        // try a listbox

        wxListBox *l = wxDynamicCast(wnd, wxListBox);

        if(l)

                return l->GetSelection();



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

            which can be overridden to retrieve the boolean value. It will also be passed

            the pointer to the window, so the derived class can figure out how to get a boolean

            value.

        */



        // generate assert or just return with string

        wxCHECK(0, -1);

!!!181890.cpp!!!        GetSelectionValues(in wndId : int, inout sels : wxArrayInt) : void


        sels.Clear();



        wxWindow *wnd = wxWindow::FindWindow(wndId);

        wxCHECK2(wnd, return);



        // try a listbox

        wxListBox *l = wxDynamicCast(wnd, wxListBox);

        if(l)

        {

                l->GetSelections(sels);

                return;

        }



        /** \todo For custom controls we should put something in wxMultiTreeItemData class

            which can be overridden to retrieve the boolean value. It will also be passed

            the pointer to the window, so the derived class can figure out how to get a boolean

            value.

        */



        // generate assert or just return with string

        wxCHECK2(0, return);

!!!183042.cpp!!!        GetParent(in item : wxTreeMultiItem) : wxTreeMultiItem


 // check if valid or root item has been passed, both do not have parents:

  if (!(item.IsOk()) || item.GetItem()->IsTreeMultiItemRoot())

    return wxTreeMultiItem();

  else

    return wxTreeMultiItem(item.GetItem()->GetParent()); // GetParent() returns a valid pointer in case of a root item!!

                                                         // therefore, the check if the passed item is a root item is necessary

!!!183170.cpp!!!        GetFirstChild(in item : wxTreeMultiItem, inout cookie : int) : wxTreeMultiItem


        if(item.IsNodeItem())

        {

                TreeMultiItemNode *n = (TreeMultiItemNode *)item.GetItem();



                if(n->GetNodeCount() > 0)

                {

                        cookie = 0;

                        return wxTreeMultiItem(n->GetNode(0));

                }

        }



        // no children or no valid node

        cookie = -1;

        return wxTreeMultiItem(0);

!!!183298.cpp!!!        GetNextChild(in item : wxTreeMultiItem, inout cookie : int) : wxTreeMultiItem


        if(item.IsNodeItem())

        {

                TreeMultiItemNode *n = (TreeMultiItemNode *)item.GetItem();



                if(cookie >= 0 && cookie < (n->GetNodeCount()-1))

                {

                        // increment cookie, return node

                        cookie ++;

                        return wxTreeMultiItem(n->GetNode(cookie));

                }

        }



        // end of query, or no valid node

        cookie = -1;

        return wxTreeMultiItem(0);

!!!183426.cpp!!!        GetLastChild(in item : wxTreeMultiItem) : wxTreeMultiItem


        if(item.IsNodeItem())

        {

                TreeMultiItemNode *n = (TreeMultiItemNode *)item.GetItem();



                if(n->GetNodeCount() > 0)

                        return wxTreeMultiItem(n->GetNode(n->GetNodeCount()-1));

        }



        return wxTreeMultiItem(0);

!!!183554.cpp!!!        GetNextSibling(in item : wxTreeMultiItem) : wxTreeMultiItem


 // check if a valid item has been passed:

  if (!(item.IsOk()))

    return wxTreeMultiItem();



  TreeMultiItemNode* ParentPtr(item.GetItem()->GetParent());





  if (ParentPtr != NULL) // the parent pointer is only null if the passed item is the root

  {

   // find the current item in the parent's list; the next sibling has an index that is one higher than the one of the current item:

    int NextItemIndex(ParentPtr->Index(item.GetItem())+1); // variable definition and initialization



    if (NextItemIndex < ParentPtr->GetNodeCount())

      return ParentPtr->GetNode(NextItemIndex);

    else

      return wxTreeMultiItem();

  } /* if */

  else

    return wxTreeMultiItem();

!!!183682.cpp!!!        GetPrevSibling(in item : wxTreeMultiItem) : wxTreeMultiItem


 // check if a valid item has been passed:

  if (!(item.IsOk()))

    return wxTreeMultiItem();



  TreeMultiItemNode* ParentPtr(item.GetItem()->GetParent());





  if (ParentPtr != NULL)

  {

   // find the current item in the parent's list; the next sibling has an index that is one higher than the one of the current item:

    int PrevItemIndex(ParentPtr->Index(item.GetItem())-1); // variable definition and initialization



    if (PrevItemIndex >= 0)

      return ParentPtr->GetNode(PrevItemIndex);

    else

      return wxTreeMultiItem();

  } /* if */

  else

    return wxTreeMultiItem();

!!!183810.cpp!!!        GetNext(in item : wxTreeMultiItem) : wxTreeMultiItem


 // check if a valid item has been passed:

  if (!(item.IsOk()))

    return wxTreeMultiItem();



  TreeMultiItemNode* NodePtr(item.GetItem()->IsTreeMultiItemNode()); // variable definition and initialization



  if ((NodePtr != NULL) && (NodePtr->GetNodeCount() > 0))

    return wxTreeMultiItem(NodePtr->First());

  else

  {

   // variable definitions and initializations:

    wxTreeMultiItem Parent(item);

    wxTreeMultiItem Sibling;



    do

    {

      Sibling = this->GetNextSibling(Parent); // try to find next sibling

      Parent = this->GetParent(Parent);       // get next ancestor

    } while (!(Sibling.IsOk()) && Parent.IsOk());

   // in case the loop ended with Sibling.IsOk() "Sibling" contains a valid sibling otherwise an invalid

    return Sibling;

  } /* if */

!!!183938.cpp!!!        GetPrevious(in item : wxTreeMultiItem) : wxTreeMultiItem


 // check if a valid item has been passed:

  if (!(item.IsOk()))

    return wxTreeMultiItem();



  TreeMultiItemNode* NodePtr(item.GetItem()->IsTreeMultiItemNode()); // variable definition and initialization



  if ((NodePtr != NULL) && (NodePtr->GetNodeCount() > 0))

    return wxTreeMultiItem(NodePtr->Last());

  else

  {

   // variable definitions and initializations:

    wxTreeMultiItem Parent(item);

    wxTreeMultiItem Sibling;



    do

    {

      Sibling = this->GetPrevSibling(Parent); // try to find next sibling

      Parent = this->GetParent(Parent);       // get next ancestor

    } while (!(Sibling.IsOk()) && Parent.IsOk());

   // in case the loop ended with Sibling.IsOk() "Sibling" contains a valid sibling otherwise an invalid

    return Sibling;

  } /* if */

!!!184194.cpp!!!        SetCaptionFont(in font : wxFont) : void


        _captionFont = font;



        // adjust the icons so that they are in the middle

        AdjustIconsDeltaY();



        RedrawFromNode(0);

!!!184322.cpp!!!        OnDraw(inout dc : wxDC) : void


        // go recursive and draw the whole visible tree.

        dc.SetFont(_captionFont);

        for(int i = 0; i < _root.GetNodeCount(); i++)

                DrawNode(_root.GetNode(i), dc);