<html> <head><title>ClanLib Reference: CL_MenuNode</title></head> <body text=black link=blue vlink=#800080 bgcolor=white topmargin=0 leftmargin=0> <table border=0 cellspacing=0 cellpadding=0 width=100%><tr><td><img border=0 src="../images/eyeheader-main-purple-a.gif" alt="ClanSoft logo" width=525 height=96></td></tr> <tr bgcolor=#dadada><td align=left valign=top><img border=0 src="../images/eyeheader-main-purple-b.gif" alt="ClanSoft logo" width=190 height=14></td><td align=right valign=top><img border=0 src="../images/clanlib_light.gif" width=42 height=14></td></tr></table> <table align=center border=0 cellspacing=10> <tr> <td><a href="entire_class_index.html">Entire Class Index</a></td> <td><a href="class_index.html">Main Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="global_index.html">Global Index</a></td> </table><h1 align=center>Class CL_MenuNode</h1><p> <b> MenuNode </b><br> Contained in: <a href="global_index.html">global</a><br> Derived from: <i>none</i> <br> Derived by: <a href="CL_PopupMenu.html">CL_PopupMenu</a> <br>Group: GUI (Controls) <p> #include <ClanLib/gui.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=left><h3>Construction:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_MenuNode.html#2977"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a></td><td><tt>(<a href="CL_PopupMenu.html"><tt><font color=navy><b>CL_PopupMenu</b></font></tt></a>* <tt><font color=blue>popupmenu</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="CL_MenuNode.html#2978"><tt><font color=blue><b>~CL_MenuNode</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=left><h3>Attributes:</h3></td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2979"><tt><font color=blue><b>is_selected</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2980"><tt><font color=blue><b>is_collapsed</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2981"><tt><font color=blue><b>has_children</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt>*</tt> </td><td align=right><a href="CL_MenuNode.html#2982"><tt><font color=blue><b>get_userdata</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>*</tt> </td><td align=right><a href="CL_MenuNode.html#2983"><tt><font color=blue><b>get_component</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=left><h3>Operations:</h3></td> <tr valign=top><td align=right><tt><a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>*</tt> </td><td align=right><a href="CL_MenuNode.html#2984"><tt><font color=blue><b>insert_item</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>text</font></tt>, <tt><font color=purple>int</font></tt> <tt><font color=blue>index</font></tt> = -1)</tt>;</td> <tr valign=top><td align=right><tt><a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>*</tt> </td><td align=right><a href="CL_MenuNode.html#2985"><tt><font color=blue><b>insert_item</b></font></tt></a></td><td><tt>(<a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>* <tt><font color=blue>component</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>delete_component</font></tt> = false, <tt><font color=purple>int</font></tt> <tt><font color=blue>index</font></tt> = -1)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2986"><tt><font color=blue><b>set_component</b></font></tt></a></td><td><tt>(<a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>* <tt><font color=blue>component</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>delete_component</font></tt> = false)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2987"><tt><font color=blue><b>set_collapsed</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>collapse</font></tt> = true)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2988"><tt><font color=blue><b>set_selected</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>select</font></tt> = true)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2989"><tt><font color=blue><b>set_selected</b></font></tt></a></td><td><tt>(<a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>* <tt><font color=blue>node</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>select</font></tt> = true)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2990"><tt><font color=blue><b>clear_selection</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2991"><tt><font color=blue><b>invert_selection</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2992"><tt><font color=blue><b>clear</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2993"><tt><font color=blue><b>set_userdata</b></font></tt></a></td><td><tt>(<tt><font color=purple>void</font></tt>* <tt><font color=blue>data</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="CL_MenuNode.html#2994"><tt><font color=blue><b>draw_nodes</b></font></tt></a></td><td><tt>(<a href="CL_Point.html"><tt><font color=navy><b>CL_Point</b></font></tt></a>& <tt><font color=blue>point</font></tt>)</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>private function member index:</h3></td> <tr valign=top><td align=left><h3>Implementation:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>& <tt><font color=blue>copy</font></tt>)</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2977"><font size=+1><b>CL_MenuNode::CL_MenuNode</b></font></a> - The menunode constructor.<br> Not to be constructed by user - use insert_item() instead, which<br> creates a <a href="CL_MenuNode.html">CL_MenuNode</a>.<br><tt></tt> <a href="CL_MenuNode.html#2977"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a><tt>(<a href="CL_PopupMenu.html"><tt><font color=navy><b>CL_PopupMenu</b></font></tt></a>* <tt><font color=blue>popupmenu</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2992"><font size=+1><b>CL_MenuNode::clear</b></font></a> - Deletes all items.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2992"><tt><font color=blue><b>clear</b></font></tt></a><tt>()</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2990"><font size=+1><b>CL_MenuNode::clear_selection</b></font></a> - Deselects current selected item.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2990"><tt><font color=blue><b>clear_selection</b></font></tt></a><tt>()</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2983"><font size=+1><b>CL_MenuNode::get_component</b></font></a> - Returns the <a href="CL_Component.html">CL_Component</a> this node uses.<br><tt><a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>*</tt> <a href="CL_MenuNode.html#2983"><tt><font color=blue><b>get_component</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2982"><font size=+1><b>CL_MenuNode::get_userdata</b></font></a> - Returns the attaches userdata, if any.<br><tt><tt><font color=purple>void</font></tt>*</tt> <a href="CL_MenuNode.html#2982"><tt><font color=blue><b>get_userdata</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2981"><font size=+1><b>CL_MenuNode::has_children</b></font></a> - Return true if node has sub-items<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_MenuNode.html#2981"><tt><font color=blue><b>has_children</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2984"><font size=+1><b>CL_MenuNode::insert_item</b></font></a> - Inserts an item at index. <br><tt><a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>*</tt> <a href="CL_MenuNode.html#2984"><tt><font color=blue><b>insert_item</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>std::string</font></tt>& <tt><font color=blue>text</font></tt>, <tt><font color=purple>int</font></tt> <tt><font color=blue>index</font></tt> = -1)</tt>;<br><blockquote> If index is negative, text is inserted at the end of the list.<br> Returns the node of the item.</blockquote> <hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2985"><font size=+1><b>CL_MenuNode::insert_item</b></font></a> - Inserts an item (uses any type of component) at index. <br><tt><a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>*</tt> <a href="CL_MenuNode.html#2985"><tt><font color=blue><b>insert_item</b></font></tt></a><tt>(<a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>* <tt><font color=blue>component</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>delete_component</font></tt> = false, <tt><font color=purple>int</font></tt> <tt><font color=blue>index</font></tt> = -1)</tt>;<br><blockquote> If index is negative, text is inserted at the end of the list.<br> Set delete_component to true if you want the component to be deleted when<br> this node gets deleted.<br> Returns the node of the item.</blockquote> <hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2991"><font size=+1><b>CL_MenuNode::invert_selection</b></font></a> - Inverts the selection.<br> Works only in Multi selection mode.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2991"><tt><font color=blue><b>invert_selection</b></font></tt></a><tt>()</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2980"><font size=+1><b>CL_MenuNode::is_collapsed</b></font></a> - Return true if node is collapsed<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_MenuNode.html#2980"><tt><font color=blue><b>is_collapsed</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2979"><font size=+1><b>CL_MenuNode::is_selected</b></font></a> - Returns true if node is selected<br><tt><tt><font color=purple>bool</font></tt></tt> <a href="CL_MenuNode.html#2979"><tt><font color=blue><b>is_selected</b></font></tt></a><tt>() <tt>const</tt></tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2987"><font size=+1><b>CL_MenuNode::set_collapsed</b></font></a> - Collapse this node.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2987"><tt><font color=blue><b>set_collapsed</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>collapse</font></tt> = true)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2986"><font size=+1><b>CL_MenuNode::set_component</b></font></a> - Sets/changes a new component for the node.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2986"><tt><font color=blue><b>set_component</b></font></tt></a><tt>(<a href="CL_Component.html"><tt><font color=navy><b>CL_Component</b></font></tt></a>* <tt><font color=blue>component</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>delete_component</font></tt> = false)</tt>;<br><blockquote> Mostly used when add(CL_Component *) is used with a NULL parameter.<br> Set delete_component to true if you want the component to be deleted when<br> this node gets deleted.</blockquote> <hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2988"><font size=+1><b>CL_MenuNode::set_selected</b></font></a> - Select this node.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2988"><tt><font color=blue><b>set_selected</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>select</font></tt> = true)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2989"><font size=+1><b>CL_MenuNode::set_selected</b></font></a> - Select any of the children nodes.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2989"><tt><font color=blue><b>set_selected</b></font></tt></a><tt>(<a href="CL_MenuNode.html#2995"><tt><font color=blue><b>CL_MenuNode</b></font></tt></a>* <tt><font color=blue>node</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>select</font></tt> = true)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <a name="2993"><font size=+1><b>CL_MenuNode::set_userdata</b></font></a> - Attaches userdata to node.<br><tt><tt><font color=purple>void</font></tt></tt> <a href="CL_MenuNode.html#2993"><tt><font color=blue><b>set_userdata</b></font></tt></a><tt>(<tt><font color=purple>void</font></tt>* <tt><font color=blue>data</font></tt>)</tt>;<hr size="1" width="70%" align="left" noshade="noshade"><br><br> <hr noshade> <h2>Variable Member Descriptions:</h2> <hr noshade> </body> </html>
