1 | <html xmlns:saxon="http://icl.com/saxon"> |
---|
2 | <head> |
---|
3 | <link rel="stylesheet" type="text/css" href="doc.css"/> |
---|
4 | <link rel="stylesheet" type="text/css" href=""/> |
---|
5 | <meta author="The MathWorks Ltd."/> |
---|
6 | <meta copyright="2011 The MathWorks Ltd."/> |
---|
7 | <title>uiextras.TabPanel</title> |
---|
8 | </head> |
---|
9 | |
---|
10 | |
---|
11 | <body> |
---|
12 | <table class="header" width="100%" border="0" cellspacing="0" cellpadding="0"> |
---|
13 | <tr> |
---|
14 | <td bgcolor="#e4f0f8"><A href="Function reference.html"><font face="Arial" bgcolor="#e4f0f8" size="+0" underline="0" color="#000000"><b>Function reference</b></font></A></td> |
---|
15 | <td width="36" bgcolor="#e4f0f8"><A HREF="Function reference1_3.html"><IMG SRC="Images/leftarrow.png" BORDER="0" ALT="previous page"/></A><A HREF="Function reference2_1.html"><IMG SRC="Images/rightarrow.png" BORDER="0" ALT="next page"/></A></td> |
---|
16 | </tr> |
---|
17 | </table> |
---|
18 | |
---|
19 | |
---|
20 | <br clear="all"/> |
---|
21 | |
---|
22 | <h2>1.4: uiextras.TabPanel <a href="Function reference.html#1"><img src="Images/uparrow.png" border="0" align="top" alt="Go back up one level"/></a></h2> |
---|
23 | |
---|
24 | |
---|
25 | <img src="Images/bigicon_TabPanel.png" align="left"/> |
---|
26 | <br clear="all"/> |
---|
27 | <p>Arrange elements in a panel with tabs for selecting which is visible</p> |
---|
28 | <dl> |
---|
29 | <dt><code class="OUTARG">obj</code><code class="FUNCTION"> = uiextras.TabPanel(</code><code class="FUNCTION"> )</code></dt> |
---|
30 | <dd>creates a panel with tabs along one edge |
---|
31 | to allow selection between the different child objects contained.</dd> |
---|
32 | |
---|
33 | <dt><code class="OUTARG">obj</code><code class="FUNCTION"> = uiextras.TabPanel(</code><code class="INARG"> prop</code><code class="FUNCTION">,</code><code class="INARG"> value</code><code class="FUNCTION">,</code><code class="INARG"> ...</code><code class="FUNCTION"> )</code></dt> |
---|
34 | <dd>also sets one or more property values.</dd> |
---|
35 | |
---|
36 | </dl> |
---|
37 | |
---|
38 | |
---|
39 | <h3>uiextras.TabPanel properties</h3> |
---|
40 | <center><table frame="box" rules="all" class="PROPERTYTABLE"><tr><th class="PROPERTYTABLE">Property</th><th class="PROPERTYTABLE">Value</th><th class="PROPERTYTABLE">Description</th></tr><tr><td valign="top" class="PROPERTYTABLE"><code>BackgroundColor </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc colorspec"><code class="FUNCTION">colorspec</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>The color to use for exposed areas of the layout background. This can be an RGB triple (e.g. [0 0 1]) or a colour name (e.g. 'b').</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>BeingDeleted </code></td><td valign="top" class="PROPERTYTABLE"><value>[ on | off ]</value></td><td valign="top" class="PROPERTYTABLE"><description>is the object in the process of being deleted.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Callback </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc function_handle"><code class="FUNCTION">function_handle</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>Function to call when the selected tab is changed. The event-data supplied has fields <code>PreviousChild</code> and <code>SelectedChild</code> giving the previously selected and newly selected tab indices.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Children </code></td><td valign="top" class="PROPERTYTABLE"><value>handle array</value></td><td valign="top" class="PROPERTYTABLE"><description>List of child objects within this layout (note that this can only be set to permutations of itself).</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>DeleteFcn </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc function_handle"><code class="FUNCTION">function_handle</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>Function to call when the layout is being deleted</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Enable </code></td><td valign="top" class="PROPERTYTABLE"><value>[ on | off ]</value></td><td valign="top" class="PROPERTYTABLE"><description>Is interaction with this layout enabled? Note that changing the enable property will cause all children contained to also be enabled/disabled, however since they can be individually re-enabled the state of this property does not reflect the state of the children. See the <a href="EnableExample.html">enable example</a> for more details.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>FontAngle </code></td><td valign="top" class="PROPERTYTABLE"><value>[ normal | italic | oblique ]</value></td><td valign="top" class="PROPERTYTABLE"><description>Title font angle.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>FontName </code></td><td valign="top" class="PROPERTYTABLE"><value>string</value></td><td valign="top" class="PROPERTYTABLE"><description>Title font name (e.g. Arial, Helvetica etc).</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>FontSize </code></td><td valign="top" class="PROPERTYTABLE"><value>positive integer</value></td><td valign="top" class="PROPERTYTABLE"><description>Title font size.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>FontUnits </code></td><td valign="top" class="PROPERTYTABLE"><value>[ inches | centimeters | normalized | points | pixels ]</value></td><td valign="top" class="PROPERTYTABLE"><description>Title font units for measuring size.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>FontWeight </code></td><td valign="top" class="PROPERTYTABLE"><value>[ light | normal | demi | bold ]</value></td><td valign="top" class="PROPERTYTABLE"><description>Title font weight.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>ForegroundColor </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc colorspec"><code class="FUNCTION">colorspec</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>Title font color and/or color of 2-D border line.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>HighlightColor </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc colorspec"><code class="FUNCTION">colorspec</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>3-D frame highlight color.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>ShadowColor </code></td><td valign="top" class="PROPERTYTABLE"><value><a href="matlab:doc colorspec"><code class="FUNCTION">colorspec</code></a></value></td><td valign="top" class="PROPERTYTABLE"><description>3-D frame shadow color.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>IsMinimized </code></td><td valign="top" class="PROPERTYTABLE"><value>logical</value></td><td valign="top" class="PROPERTYTABLE"><description>Is this panel in a minimized state.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>MinimizeFcn </code></td><td valign="top" class="PROPERTYTABLE"><value>function handle</value></td><td valign="top" class="PROPERTYTABLE"><description>Function to call when panel is minimized or maximized.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Padding </code></td><td valign="top" class="PROPERTYTABLE"><value>positive integer</value></td><td valign="top" class="PROPERTYTABLE"><description>Number of pixels of extra space around the outside of the layout.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Parent </code></td><td valign="top" class="PROPERTYTABLE"><value>handle</value></td><td valign="top" class="PROPERTYTABLE"><description>The handle of the parent figure or container.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Position </code></td><td valign="top" class="PROPERTYTABLE"><value>[x y w h]</value></td><td valign="top" class="PROPERTYTABLE"><description>The position (x,y) and size (w,h) of the layout.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>SelectedChild </code></td><td valign="top" class="PROPERTYTABLE"><value>positive integer or empty</value></td><td valign="top" class="PROPERTYTABLE"><description>Which child is visible.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>TabSize </code></td><td valign="top" class="PROPERTYTABLE"><value>positive integer</value></td><td valign="top" class="PROPERTYTABLE"><description>Size (width) of the tabs in pixels (default 50).</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>TabEnable </code></td><td valign="top" class="PROPERTYTABLE"><value>cell array of [ on | off ]</value></td><td valign="top" class="PROPERTYTABLE"><description>A list of the enabled state of each tab (default is all 'on').</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>TabNames </code></td><td valign="top" class="PROPERTYTABLE"><value>cell array of strings</value></td><td valign="top" class="PROPERTYTABLE"><description>A list of the names of the tabs with one entry per tab.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Tag </code></td><td valign="top" class="PROPERTYTABLE"><value>string</value></td><td valign="top" class="PROPERTYTABLE"><description>A string that can be used to identify this object later.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Type </code></td><td valign="top" class="PROPERTYTABLE"><value>string</value></td><td valign="top" class="PROPERTYTABLE"><description>the object type (class).</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Units </code></td><td valign="top" class="PROPERTYTABLE"><value>[ inches | centimeters | normalized | points | pixels | characters ]</value></td><td valign="top" class="PROPERTYTABLE"><description>The units of measurement for position the layout within its parent.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Visible </code></td><td valign="top" class="PROPERTYTABLE"><value>[ on | off ]</value></td><td valign="top" class="PROPERTYTABLE"><description>Is the object visible on screen.</description></td></tr></table></center> |
---|
41 | |
---|
42 | <h3>For example:</h3> |
---|
43 | <pre style="background-color: #eeeeff; margin-left: 20px; margin-right: 20px"><font color="#000011"><!-->> -->f = <a href="matlab:doc figure"><code class="FUNCTION">figure</code></a>(); |
---|
44 | <!-->> -->p = <a href="uiextras.TabPanel.html"><code class="FUNCTION">uiextras.TabPanel</code></a>( <code class="STRING">'Parent'</code>, f, <code class="STRING">'Padding'</code>, 5 ); |
---|
45 | <!-->> --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, p, <code class="STRING">'Background'</code>, <code class="STRING">'r'</code> ); |
---|
46 | <!-->> --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, p, <code class="STRING">'Background'</code>, <code class="STRING">'b'</code> ); |
---|
47 | <!-->> --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, p, <code class="STRING">'Background'</code>, <code class="STRING">'g'</code> ); |
---|
48 | <!-->> -->p.TabNames = {<code class="STRING">'Red'</code>, <code class="STRING">'Blue'</code>, <code class="STRING">'Green'</code>}; |
---|
49 | <!-->> -->p.SelectedChild = 2;</font></pre> |
---|
50 | <p style="background-color: #ddddee; margin-left: 20px; margin-right: 20px"><font color="#000022"> |
---|
51 | <center><img src="Images/TabPanel.png"/></center> |
---|
52 | </font></p> |
---|
53 | |
---|
54 | |
---|
55 | <br/><b>See also:</b><ul><li><code class="FUNCTION"><a href="uiextras.Panel.html">uiextras.Panel</a></code> - for creating a more standard panel</li><li><code class="FUNCTION"><a href="uiextras.BoxPanel.html">uiextras.BoxPanel</a></code> - for creating a panel with boxed title</li></ul> |
---|
56 | |
---|
57 | |
---|
58 | <br clear="ALL"/> |
---|
59 | <table class="footer" width="100%" border="0" cellspacing="0" cellpadding="0"> |
---|
60 | <tr> |
---|
61 | <td width="18" height="15" bgcolor="#e4f0f8" align="left"><a href="Function reference1_3.html"><img src="images/leftarrow.png" border="0" alt="previous page"/></a></td> |
---|
62 | <td width="40%" height="15" bgcolor="#e4f0f8" align="left"><a href="Function reference1_3.html"><font face="arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">uiextras.BoxPanel</font></a></td> |
---|
63 | <td width="20%" height="15" bgcolor="#e4f0f8" align="center"><a href="index.html"><font face="arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">[Top]</font></a></td> |
---|
64 | <td width="40%" height="15" bgcolor="#e4f0f8" align="right"><a href="Function reference2_1.html"><font face="arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">uiextras.HBox</font></a></td> |
---|
65 | <td width="18" height="15" bgcolor="#e4f0f8" align="right"><a href="Function reference2_1.html"><img src="images/rightarrow.png" border="0" alt="next page"/></a></td> |
---|
66 | </tr> |
---|
67 | </table> |
---|
68 | <font face="Arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">© 2011 The MathWorks Ltd</font> |
---|
69 | <TT>• </TT><a href="matlab: helpview([matlabroot,'/license.txt'])">Terms of Use</a> |
---|
70 | <TT>• </TT><a href="matlab: helpview([matlabroot,'/patents.txt'])">Patents</a> |
---|
71 | <TT>• </TT><a href="matlab: helpview([matlabroot,'/trademarks.txt'])">Trademarks</a> |
---|
72 | |
---|
73 | </body> |
---|
74 | </html> |
---|
75 | |
---|
76 | |
---|