OpenCores
URL https://opencores.org/ocsvn/or1k_old/or1k_old/trunk

Subversion Repositories or1k_old

[/] [or1k_old/] [trunk/] [insight/] [itcl/] [iwidgets3.0.0/] [demos/] [html/] [dialogshell.n.html] - Rev 1782

Compare with Previous | Blame | View Log

<HTML>
<HEAD>
<TITLE>iwidgets2.2.0 User Commands - dialogshell</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<H1>iwidgets2.2.0 User Commands - dialogshell</H1>
<HR>
<PRE>
 
</PRE>
<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>
 
 
</PRE>
<H2>NAME</H2><PRE>
     dialogshell - Create and manipulate a dialog shell widget
 
 
</PRE>
<H2>SYNOPSIS</H2><PRE>
     <STRONG>dialogshell</STRONG> <EM>pathName</EM> ?<EM>options</EM>?
 
 
</PRE>
<H2>INHERITANCE</H2><PRE>
     itk::Toplevel &lt;- Shell &lt;- Dialogshell
 
 
</PRE>
<H2>STANDARD OPTIONS</H2><PRE>
     <STRONG>background</STRONG>      <STRONG>cursor</STRONG>         <STRONG>foreground</STRONG>
 
     See the "options" manual entry for details on  the  standard
     options.
 
 
</PRE>
<H2>INHERITED OPTIONS</H2><PRE>
     <STRONG>master</STRONG>          <STRONG>modality</STRONG>       <STRONG>title</STRONG>
 
     See the "shell" manual entry for details on the above inher-
     ited options.
 
 
 
</PRE>
<H2>WIDGET-SPECIFIC OPTIONS</H2><PRE>
     Name:           <STRONG>buttonBoxPadX</STRONG>
     Class:          <STRONG>Pad</STRONG>
     Command-Line Switch:           <STRONG>-buttonboxpadx</STRONG>
 
          Specifies a  non-negative  padding  distance  to  leave
          between the button group and the outer edge of the but-
          ton box in the x direction.  The value may be given  in
          any  of  the  forms  accpetable  to  <STRONG>Tk_GetPixels</STRONG>.  The
          default is 5 pixels.
 
     Name:           <STRONG>buttonBoxPadY</STRONG>
     Class:          <STRONG>Pad</STRONG>
     Command-Line Switch:           <STRONG>-buttonboxpady</STRONG>
 
          Specifies a  non-negative  padding  distance  to  leave
          between the button group and the outer edge of the but-
          ton box in the y direction.  The value may be given  in
          any  of  the  forms  accpetable  to  <STRONG>Tk_GetPixels</STRONG>.  The
          default is 5 pixels.
 
     Name:           <STRONG>buttonBoxPos</STRONG>
     Class:          <STRONG>Position</STRONG>
     Command-Line Switch:           <STRONG>-buttonboxpos</STRONG>
 
          Attaches buttons to the given side of the dialog: <STRONG>n</STRONG>, <STRONG>s</STRONG>,
          <STRONG>e</STRONG> or <STRONG>w</STRONG>.  The default is s.
 
     Name:           <STRONG>padX</STRONG>
     Class:          <STRONG>Pad</STRONG>
     Command-Line Switch:           <STRONG>-padx</STRONG>
 
          Specifies a padding distance for the childsite  in  the
          X-direction   in   any   of  the  forms  acceptable  to
          <STRONG>Tk_GetPixels</STRONG>.  The default is 10.
 
     Name:           <STRONG>padY</STRONG>
     Class:          <STRONG>Pad</STRONG>
     Command-Line Switch:           <STRONG>-pady</STRONG>
 
          Specifies a padding distance for the childsite  in  the
          Y-direction   in   any   of  the  forms  acceptable  to
          <STRONG>Tk_GetPixels</STRONG>.  The default is 10.
 
     Name:           <STRONG>separator</STRONG>
     Class:          <STRONG>Separator</STRONG>
     Command-Line Switch:           <STRONG>-separator</STRONG>
 
          Specifies whether a line is drawn to separate the  but-
          tons  from  the dialog box contents in any of the forms
          acceptable to <STRONG>Tcl_GetBoolean</STRONG>.  The default is true.
 
     Name:           <STRONG>thickness</STRONG>
     Class:          <STRONG>Thickness</STRONG>
     Command-Line Switch:           <STRONG>-thickness</STRONG>
 
          Specifies the thickness of the separator in any of  the
          forms  acceptable  to  <STRONG>Tk_GetPixels</STRONG>.   The default is 3
          pixels.
 
</PRE>
<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>
 
 
 
</PRE>
<H2>DESCRIPTION</H2><PRE>
     The <STRONG>dialogshell</STRONG> command creates a dialog shell  which  is  a
     top  level  widget  composed of a button box, separator, and
     child site area.  The class also has methods to control but-
     ton construction.
 
 
 
</PRE>
<H2>METHODS</H2><PRE>
     The <STRONG>dialogshell</STRONG> command create a new Tcl command whose  name
     is  <EM>pathName</EM>.   This  command  may be used to invoke various
     operations on the widget.   It  has  the  following  general
     form:
 
          <EM>pathName</EM> <EM>option</EM> ?<EM>arg</EM> <EM>arg</EM> ...?
 
     <EM>Option</EM> and the <EM>arg</EM>s determine the exact behavior of the com-
     mand.   The  following commands are possible for dialogshell
     widgets:
 
 
</PRE>
<H2>INHERITED METHODS</H2><PRE>
     <STRONG>activate</STRONG>        <STRONG>center</STRONG>         <STRONG>deactivate</STRONG>
 
     See the "shell" manual entry for details on the above inher-
     ited methods.
 
 
</PRE>
<H2>ASSOCIATED METHODS</H2><PRE>
     <STRONG>add</STRONG>             <STRONG>buttonconfigure</STRONG>                <STRONG>defaultdelete</STRONG>
     <STRONG>hide</STRONG>            <STRONG>index</STRONG>          <STRONG>insert</STRONG>          <STRONG>invoke</STRONG>
     <STRONG>show</STRONG>
 
     See the "buttonbox" manual entry for details on the  associ-
     ated methods.
 
 
</PRE>
<H2>WIDGET-SPECIFIC METHODS</H2><PRE>
     <EM>pathName</EM> <STRONG>cget</STRONG> <EM>option</EM>
          Returns the current value of the  configuration  option
          given  by  <EM>option</EM>.   <EM>Option</EM>  may have any of the values
          accepted by the <STRONG>dialogshell</STRONG> command.
 
     <EM>pathName</EM> <STRONG>childsite</STRONG>
          Returns the pathname of the child site widget.
 
     <EM>pathName</EM> <STRONG>configure</STRONG> ?<EM>option</EM>? ?<EM>value</EM> <EM>option</EM> <EM>value</EM> ...?
          Query  or  modify  the  configuration  options  of  the
          widget.   If  no  <EM>option</EM>  is  specified, returns a list
          describing all of the available  options  for  <EM>pathName</EM>
          (see  <STRONG>Tk_ConfigureInfo</STRONG> for information on the format of
          this list).  If <EM>option</EM> is specified with no <EM>value</EM>, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  sublist  of  the  value  returned  if no <EM>option</EM> is
          specified).  If one or more  <EM>option</EM> - <EM>value</EM>  pairs  are
          specified,  then  the command modifies the given widget
          option(s) to have the given value(s);  in this case the
          command  returns  an empty string.  <EM>Option</EM> may have any
          of the values accepted by the <STRONG>dialogshell</STRONG> command.
 
 
 
</PRE>
<H2>COMPONENTS</H2><PRE>
     Name:           <STRONG>dschildsite</STRONG>
     Class:          <STRONG>frame</STRONG>
 
          The dschildsite component is the user  child  site  for
          the  dialog shell.  See the "frame" widget manual entry
          for details on the dschildsite component item.
 
     Name:           <STRONG>separator</STRONG>
     Class:          <STRONG>frame</STRONG>
 
          The separator component devides the  area  between  the
          user  child  site  and the button box.  See the "frame"
          widget manual entry for details on the  separator  com-
          ponent item.
 
     Name:           <STRONG>bbox</STRONG>
     Class:          <STRONG>ButtonBox</STRONG>
 
          The bbox component is the  button  box  containing  the
          buttons  for  the  dialog  shell.   See the "ButtonBox"
          widget manual entry for details on the  bbox  component
          item.
 
 
 
</PRE>
<H2>EXAMPLE</H2><PRE>
           dialogshell .ds -modality none
 
           .ds add OK -text "OK"
           .ds add Cancel -text "Cancel"
           .ds default OK
 
           .ds activate
 
 
 
</PRE>
<H2>AUTHOR</H2><PRE>
     Mark L. Ulferts
 
 
</PRE>
<H2>KEYWORDS</H2><PRE>
     dialogshell, dialog, shell, widget
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
</PRE>
</BODY>
</HTML>
 

Compare with Previous | Blame | View Log

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.