diff options
Diffstat (limited to 'libXt/man/XtCreatePopupShell.man')
| -rw-r--r-- | libXt/man/XtCreatePopupShell.man | 354 | 
1 files changed, 177 insertions, 177 deletions
| diff --git a/libXt/man/XtCreatePopupShell.man b/libXt/man/XtCreatePopupShell.man index a32a11924..72d242fbf 100644 --- a/libXt/man/XtCreatePopupShell.man +++ b/libXt/man/XtCreatePopupShell.man @@ -1,177 +1,177 @@ -.\" Copyright 1993 X Consortium -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining -.\" a copy of this software and associated documentation files (the -.\" "Software"), to deal in the Software without restriction, including -.\" without limitation the rights to use, copy, modify, merge, publish, -.\" distribute, sublicense, and/or sell copies of the Software, and to -.\" permit persons to whom the Software is furnished to do so, subject to -.\" the following conditions: -.\" -.\" The above copyright notice and this permission notice shall be -.\" included in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of the X Consortium shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from the X Consortium. -.\" -.ds tk X Toolkit -.ds xT X Toolkit Intrinsics \- C Language Interface -.ds xI Intrinsics -.ds xW X Toolkit Athena Widgets \- C Language Interface -.ds xL Xlib \- C Language X Interface -.ds xC Inter-Client Communication Conventions Manual -.ds Rn 3 -.ds Vn 2.2 -.hw XtCreate-Popup-Shell XtVaCreate-Popup-Shell wid-get -.na -.de Ds -.nf -.\\$1D \\$2 \\$1 -.ft 1 -.ps \\n(PS -.\".if \\n(VS>=40 .vs \\n(VSu -.\".if \\n(VS<=39 .vs \\n(VSp -.. -.de De -.ce 0 -.if \\n(BD .DF -.nr BD 0 -.in \\n(OIu -.if \\n(TM .ls 2 -.sp \\n(DDu -.fi -.. -.de FD -.LP -.KS -.TA .5i 3i -.ta .5i 3i -.nf -.. -.de FN -.fi -.KE -.LP -.. -.de IN		\" send an index entry to the stderr -.. -.de C{ -.KS -.nf -.D -.\" -.\"	choose appropriate monospace font -.\"	the imagen conditional, 480, -.\"	may be changed to L if LB is too -.\"	heavy for your eyes... -.\" -.ie "\\*(.T"480" .ft L -.el .ie "\\*(.T"300" .ft L -.el .ie "\\*(.T"202" .ft PO -.el .ie "\\*(.T"aps" .ft CW -.el .ft R -.ps \\n(PS -.ie \\n(VS>40 .vs \\n(VSu -.el .vs \\n(VSp -.. -.de C} -.DE -.R -.. -.de Pn -.ie t \\$1\fB\^\\$2\^\fR\\$3 -.el \\$1\fI\^\\$2\^\fP\\$3 -.. -.de ZN -.ie t \fB\^\\$1\^\fR\\$2 -.el \fI\^\\$1\^\fP\\$2 -.. -.de NT -.ne 7 -.ds NO Note -.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2 -.if \\n(.$ .if !'\\$1'C' .ds NO \\$1 -.ie n .sp -.el .sp 10p -.TB -.ce -\\*(NO -.ie n .sp -.el .sp 5p -.if '\\$1'C' .ce 99 -.if '\\$2'C' .ce 99 -.in +5n -.ll -5n -.R -.. -.		\" Note End -- doug kraft 3/85 -.de NE -.ce 0 -.in -5n -.ll +5n -.ie n .sp -.el .sp 10p -.. -.ny0 -.TH XtCreatePopupShell __libmansuffix__ __xorgversion__ "XT FUNCTIONS" -.SH NAME -XtCreatePopupShell, XtVaCreatePopupShell \- create a popup shell -.SH SYNTAX -.HP -Widget XtCreatePopupShell(String \fIname\fP, WidgetClass \fIwidget_class\fP, -Widget \fIparent\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP); -.HP -Widget XtVaCreatePopupShell(String \fIname\fP, WidgetClass \fIwidget_class\fP, -Widget \fIparent\fP, ...\^);  -.SH ARGUMENTS -.ds Al to override the resource defaults -.IP \fIargs\fP 1i -Specifies the argument list \*(Al. -.ds Sh \ shell -.IP \fIname\fP 1i -Specifies the text name for the created\*(Sh widget. -.IP \fInum_args\fP 1i -Specifies the number of arguments in the argument list. -.IP \fIparent\fP 1i -Specifies the parent widget. -.ds Wc \ pointer for the created shell widget -.IP \fIwidget_class\fP 1i -Specifies the widget class\*(Wc. -.IP \fI...\fP 1i -Specifies the variable argument list \*(Al. -.SH DESCRIPTION -The -.ZN XtCreatePopupShell -function ensures that the specified class is a subclass of -.ZN Shell -and, rather than using insert_child to attach the widget to the parent's -.IN "insert_child procedure" -children list, attaches the shell to the parent's pop-ups list directly. -.LP -A spring-loaded pop-up invoked from a translation table already must exist -at the time that the translation is invoked,  -so the translation manager can find the shell by name. -Pop-ups invoked in other ways can be created ``on-the-fly'' when -the pop-up actually is needed. -This delayed creation of the shell is particularly useful when you pop up -an unspecified number of pop-ups. -You can look to see if an appropriate unused shell (that is, not -currently popped up) exists and create a new shell if needed. -.SH "SEE ALSO" -XtCreateWidget(__libmansuffix__), -XtPopdown(__libmansuffix__), -XtPopup(__libmansuffix__) -.br -\fI\*(xT\fP -.br -\fI\*(xL\fP +.\" Copyright 1993 X Consortium
 +.\"
 +.\" Permission is hereby granted, free of charge, to any person obtaining
 +.\" a copy of this software and associated documentation files (the
 +.\" "Software"), to deal in the Software without restriction, including
 +.\" without limitation the rights to use, copy, modify, merge, publish,
 +.\" distribute, sublicense, and/or sell copies of the Software, and to
 +.\" permit persons to whom the Software is furnished to do so, subject to
 +.\" the following conditions:
 +.\"
 +.\" The above copyright notice and this permission notice shall be
 +.\" included in all copies or substantial portions of the Software.
 +.\"
 +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 +.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 +.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
 +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 +.\" OTHER DEALINGS IN THE SOFTWARE.
 +.\"
 +.\" Except as contained in this notice, the name of the X Consortium shall
 +.\" not be used in advertising or otherwise to promote the sale, use or
 +.\" other dealings in this Software without prior written authorization
 +.\" from the X Consortium.
 +.\"
 +.ds tk X Toolkit
 +.ds xT X Toolkit Intrinsics \- C Language Interface
 +.ds xI Intrinsics
 +.ds xW X Toolkit Athena Widgets \- C Language Interface
 +.ds xL Xlib \- C Language X Interface
 +.ds xC Inter-Client Communication Conventions Manual
 +.ds Rn 3
 +.ds Vn 2.2
 +.hw XtCreate-Popup-Shell XtVaCreate-Popup-Shell wid-get
 +.na
 +.de Ds
 +.nf
 +.\\$1D \\$2 \\$1
 +.ft 1
 +.ps \\n(PS
 +.\".if \\n(VS>=40 .vs \\n(VSu
 +.\".if \\n(VS<=39 .vs \\n(VSp
 +..
 +.de De
 +.ce 0
 +.if \\n(BD .DF
 +.nr BD 0
 +.in \\n(OIu
 +.if \\n(TM .ls 2
 +.sp \\n(DDu
 +.fi
 +..
 +.de FD
 +.LP
 +.KS
 +.TA .5i 3i
 +.ta .5i 3i
 +.nf
 +..
 +.de FN
 +.fi
 +.KE
 +.LP
 +..
 +.de IN		\" send an index entry to the stderr
 +..
 +.de C{
 +.KS
 +.nf
 +.D
 +.\"
 +.\"	choose appropriate monospace font
 +.\"	the imagen conditional, 480,
 +.\"	may be changed to L if LB is too
 +.\"	heavy for your eyes...
 +.\"
 +.ie "\\*(.T"480" .ft L
 +.el .ie "\\*(.T"300" .ft L
 +.el .ie "\\*(.T"202" .ft PO
 +.el .ie "\\*(.T"aps" .ft CW
 +.el .ft R
 +.ps \\n(PS
 +.ie \\n(VS>40 .vs \\n(VSu
 +.el .vs \\n(VSp
 +..
 +.de C}
 +.DE
 +.R
 +..
 +.de Pn
 +.ie t \\$1\fB\^\\$2\^\fR\\$3
 +.el \\$1\fI\^\\$2\^\fP\\$3
 +..
 +.de ZN
 +.ie t \fB\^\\$1\^\fR\\$2
 +.el \fI\^\\$1\^\fP\\$2
 +..
 +.de NT
 +.ne 7
 +.ds NO Note
 +.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
 +.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
 +.ie n .sp
 +.el .sp 10p
 +.TB
 +.ce
 +\\*(NO
 +.ie n .sp
 +.el .sp 5p
 +.if '\\$1'C' .ce 99
 +.if '\\$2'C' .ce 99
 +.in +5n
 +.ll -5n
 +.R
 +..
 +.		\" Note End -- doug kraft 3/85
 +.de NE
 +.ce 0
 +.in -5n
 +.ll +5n
 +.ie n .sp
 +.el .sp 10p
 +..
 +.ny0
 +.TH XtCreatePopupShell __libmansuffix__ __xorgversion__ "XT FUNCTIONS"
 +.SH NAME
 +XtCreatePopupShell, XtVaCreatePopupShell \- create a popup shell
 +.SH SYNTAX
 +.HP
 +Widget XtCreatePopupShell(String \fIname\fP, WidgetClass \fIwidget_class\fP,
 +Widget \fIparent\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP);
 +.HP
 +Widget XtVaCreatePopupShell(String \fIname\fP, WidgetClass \fIwidget_class\fP,
 +Widget \fIparent\fP, ...\^); 
 +.SH ARGUMENTS
 +.ds Al to override the resource defaults
 +.IP \fIargs\fP 1i
 +Specifies the argument list \*(Al.
 +.ds Sh \ shell
 +.IP \fIname\fP 1i
 +Specifies the text name for the created\*(Sh widget.
 +.IP \fInum_args\fP 1i
 +Specifies the number of arguments in the argument list.
 +.IP \fIparent\fP 1i
 +Specifies the parent widget.
 +.ds Wc \ pointer for the created shell widget
 +.IP \fIwidget_class\fP 1i
 +Specifies the widget class\*(Wc.
 +.IP \fI...\fP 1i
 +Specifies the variable argument list \*(Al.
 +.SH DESCRIPTION
 +The
 +.ZN XtCreatePopupShell
 +function ensures that the specified class is a subclass of
 +.ZN Shell
 +and, rather than using insert_child to attach the widget to the parent's
 +.IN "insert_child procedure"
 +children list, attaches the shell to the parent's pop-ups list directly.
 +.LP
 +A spring-loaded pop-up invoked from a translation table already must exist
 +at the time that the translation is invoked, 
 +so the translation manager can find the shell by name.
 +Pop-ups invoked in other ways can be created ``on-the-fly'' when
 +the pop-up actually is needed.
 +This delayed creation of the shell is particularly useful when you pop up
 +an unspecified number of pop-ups.
 +You can look to see if an appropriate unused shell (that is, not
 +currently popped up) exists and create a new shell if needed.
 +.SH "SEE ALSO"
 +XtCreateWidget(__libmansuffix__),
 +XtPopdown(__libmansuffix__),
 +XtPopup(__libmansuffix__)
 +.br
 +\fI\*(xT\fP
 +.br
 +\fI\*(xL\fP
 | 
