source: MML/trunk/machine/SOLEIL/common/toolbox/GUILayout/layoutHelp/Function reference2_6.html @ 4

Last change on this file since 4 was 4, checked in by zhangj, 11 years ago

Initial import--MML version from SOLEIL@2013

File size: 10.6 KB
Line 
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.VButtonBox</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 reference2_5.html"><IMG SRC="Images/leftarrow.png" BORDER="0" ALT="previous page"/></A><A HREF="Function reference3_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>2.6: uiextras.VButtonBox&nbsp;<a href="Function reference.html#2"><img src="Images/uparrow.png" border="0" align="top" alt="Go back up one level"/></a></h2>
23     
24                 
25                 
26                 
27
28             <img src="Images/bigicon_HButtonBox.png" align="left"/>
29             <br clear="all"/>
30             <p>Arrange buttons vertically in a single column</p>
31             <dl>
32                 <dt><code class="OUTARG">obj</code><code class="FUNCTION"> = uiextras.VButtonBox(</code><code class="FUNCTION">&nbsp;)</code></dt>
33                 <dd>is a type of VBox specialised for
34       arranging a column of buttons, check-boxes or similar graphical
35       elements. All buttons are given equal size and by default are
36       centered in the drawing area. The justification can be changed as
37       required.</dd>
38                 
39                 <dt><code class="OUTARG">obj</code><code class="FUNCTION"> = uiextras.VButtonBox(</code><code class="INARG">&nbsp;prop</code><code class="FUNCTION">,</code><code class="INARG">&nbsp;value</code><code class="FUNCTION">,</code><code class="INARG">&nbsp;...</code><code class="FUNCTION">&nbsp;)</code></dt>
40                 <dd>also sets one or more property values.</dd>
41                 
42             </dl>
43             
44                   
45             <h3>uiextras.HBox properties</h3>
46                 <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&nbsp;</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&nbsp;</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>ButtonSize&nbsp;</code></td><td valign="top" class="PROPERTYTABLE"><value>[w h]</value></td><td valign="top" class="PROPERTYTABLE"><description>The size for the buttons (all are given equal size).</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Children&nbsp;</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&nbsp;</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&nbsp;</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>HorizontalAlignment&nbsp;</code></td><td valign="top" class="PROPERTYTABLE"><value>[ left | center | right ]</value></td><td valign="top" class="PROPERTYTABLE"><description>The horizontal position of the buttons.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Padding&nbsp;</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&nbsp;</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&nbsp;</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>Spacing&nbsp;</code></td><td valign="top" class="PROPERTYTABLE"><value>positive integer</value></td><td valign="top" class="PROPERTYTABLE"><description>Number of pixels of extra space to leave between elements in the layout.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Tag&nbsp;</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&nbsp;</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&nbsp;</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>VerticalAlignment&nbsp;</code></td><td valign="top" class="PROPERTYTABLE"><value>[ top | middle | bottom ]</value></td><td valign="top" class="PROPERTYTABLE"><description>The vertical position of the buttons.</description></td></tr><tr><td valign="top" class="PROPERTYTABLE"><code>Visible&nbsp;</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>                 
47             
48             <h3>For example:</h3>
49                     <pre style="background-color: #eeeeff; margin-left: 20px; margin-right: 20px"><font color="#000011"><!--&gt;&gt; -->f = <a href="matlab:doc figure"><code class="FUNCTION">figure</code></a>();
50<!--&gt;&gt; -->b = <a href="uiextras.VButtonBox.html"><code class="FUNCTION">uiextras.VButtonBox</code></a>( <code class="STRING">'Parent'</code>, f );
51<!--&gt;&gt; --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, b, <code class="STRING">'String'</code>, 'One' );
52<!--&gt;&gt; --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, b, <code class="STRING">'String'</code>, 'Two' );
53<!--&gt;&gt; --><a href="matlab:doc uicontrol"><code class="FUNCTION">uicontrol</code></a>( <code class="STRING">'Parent'</code>, b, <code class="STRING">'String'</code>, 'Three' );
54<!--&gt;&gt; --><a href="matlab:doc set"><code class="FUNCTION">set</code></a>( b, <code class="STRING">'ButtonSize'</code>, [130 35], <code class="STRING">'Spacing'</code>, 5 );</font></pre>
55                     <p style="background-color: #ddddee; margin-left: 20px; margin-right: 20px"><font color="#000022">
56                         <center><img src="Images/VButtonBox.png"/></center>
57                     </font></p>
58                 
59             
60             <br/><b>See also:</b><ul><li><code class="FUNCTION"><a href="uiextras.HButtonBox.html">uiextras.HButtonBox</a></code> - for creating a horizontal arrangement of buttons</li><li><code class="FUNCTION"><a href="uiextras.VBox.html">uiextras.VBox</a></code> - for creating a general vertical arrangement</li></ul>
61         
62     
63      <br clear="ALL"/>
64      <table class="footer" width="100%" border="0" cellspacing="0" cellpadding="0">
65         <tr>
66            <td width="18" height="15" bgcolor="#e4f0f8" align="left"><a href="Function reference2_5.html"><img src="images/leftarrow.png" border="0" alt="previous page"/></a></td>
67            <td width="40%" height="15" bgcolor="#e4f0f8" align="left"><a href="Function reference2_5.html"><font face="arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">uiextras.HButtonBox</font></a></td>
68            <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>
69            <td width="40%" height="15" bgcolor="#e4f0f8" align="right"><a href="Function reference3_1.html"><font face="arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">uiextras.Grid</font></a></td>
70            <td width="18" height="15" bgcolor="#e4f0f8" align="right"><a href="Function reference3_1.html"><img src="images/rightarrow.png" border="0" alt="next page"/></a></td>
71         </tr>
72      </table>
73      <font face="Arial" bgcolor="#e4f0f8" size="normal" underline="0" color="#000000">&copy; 2011 The MathWorks Ltd</font>
74      <TT>&#149; </TT><a href="matlab: helpview([matlabroot,'/license.txt'])">Terms of Use</a>
75      <TT>&#149; </TT><a href="matlab: helpview([matlabroot,'/patents.txt'])">Patents</a>
76      <TT>&#149; </TT><a href="matlab: helpview([matlabroot,'/trademarks.txt'])">Trademarks</a>
77   
78   </body>
79</html>
80
81       
Note: See TracBrowser for help on using the repository browser.