aboutsummaryrefslogtreecommitdiff
path: root/libXaw/spec/SimpleMenu
diff options
context:
space:
mode:
authormarha <marha@users.sourceforge.net>2011-03-25 10:41:05 +0000
committermarha <marha@users.sourceforge.net>2011-03-25 10:41:05 +0000
commit272e57235cd60a2e65ac8258d96a02eb3939b687 (patch)
tree789d74bd6ec1cc468f1f81aab97d4e4dfdb2d5c5 /libXaw/spec/SimpleMenu
parentb39f063f74bf0163eaf34db03134f226d18142ec (diff)
downloadvcxsrv-272e57235cd60a2e65ac8258d96a02eb3939b687.tar.gz
vcxsrv-272e57235cd60a2e65ac8258d96a02eb3939b687.tar.bz2
vcxsrv-272e57235cd60a2e65ac8258d96a02eb3939b687.zip
git update until 25 Mar 2011
xserver fontconfig glproto libXau libXft libXmu libfontenc libxcb mesa mkfontscale pixman randrproto xkeyboard-config xtrans xwininfo updated following packages: xproto-7.0.21 xineramaproto-1.2.1 libXt-1.1.1 libxkbfile-1.0.7 libXpm-3.5.9 libXfont-1.4.3 libXaw-1.0.9 bdftopcf-1.0.3 encodings-1.0.4 fixesproto-5.0 font-adobe-100dpi-1.0.3 font-adobe-75dpi-1.0.3 font-adobe-utopia-100dpi-1.0.4 font-adobe-utopia-75dpi-1.0.4 font-adobe-utopia-type1-1.0.4 font-alias-1.0.3 font-arabic-misc-1.0.3 font-bh-100dpi-1.0.3 font-bh-75dpi-1.0.3 font-bh-lucidatypewriter-100dpi-1.0.3 font-bh-lucidatypewriter-75dpi-1.0.3 font-bh-ttf-1.0.3 font-bh-type1-1.0.3 font-bitstream-100dpi-1.0.3 font-bitstream-75dpi-1.0.3 font-bitstream-speedo-1.0.2 font-bitstream-type1-1.0.3 font-cronyx-cyrillic-1.0.3 font-cursor-misc-1.0.3 font-daewoo-misc-1.0.3 font-dec-misc-1.0.3 font-ibm-type1-1.0.3 font-isas-misc-1.0.3 font-jis-misc-1.0.3 font-micro-misc-1.0.3 font-misc-cyrillic-1.0.3 font-misc-ethiopic-1.0.3 font-misc-meltho-1.0.3 font-misc-misc-1.1.2 font-mutt-misc-1.0.3 font-schumacher-misc-1.1.2 font-screen-cyrillic-1.0.4 font-sony-misc-1.0.3 font-sun-misc-1.0.3 font-util-1.2.0 font-winitzki-cyrillic-1.0.3 font-xfree86-type1-1.0.4
Diffstat (limited to 'libXaw/spec/SimpleMenu')
-rw-r--r--libXaw/spec/SimpleMenu315
1 files changed, 0 insertions, 315 deletions
diff --git a/libXaw/spec/SimpleMenu b/libXaw/spec/SimpleMenu
deleted file mode 100644
index b59e511c8..000000000
--- a/libXaw/spec/SimpleMenu
+++ /dev/null
@@ -1,315 +0,0 @@
-.\" $Xorg: SimpleMenu,v 1.3 2000/08/17 19:42:27 cpqbld Exp $
-.NH 2
-SimpleMenu Widget
-.XS
- SimpleMenu Widget
-.XE
-.IN "SimpleMenu widget" "" "@DEF@"
-.Ds 0
-.TA 2.0i
-.ta 2.0i
-.sp
-Application Header file <X11/Xaw/SimpleMenu.h>
-.IN "SimpleMenu.h" ""
-Class Header file <X11/Xaw/SimpleMenP.h>
-.IN "SimpleMenP.h" ""
-Class simpleMenuWidgetClass
-.IN "simpleMenuWidgetClass" ""
-Class Name SimpleMenu
-.IN "SimpleMenu widget" "class name"
-Superclass OverrideShell
-.sp
-.De
-.LP
-The SimpleMenu widget is a container for the menu entries. It is a
-direct subclass of shell, and is should be created with
-\fBXtCreatePopupShell\fP, not \fBXtCreateManagedWidget\fP. This is the
-only part of the menu that
-actually is associated with a window. The SimpleMenu serves as the glue to bind
-the individual menu entries together into a menu.
-.NH 3
-Resources
-.LP
-.IN "SimpleMenu widget" "resources"
-.LP
-The resources associated with the SimpleMenu widget control aspects
-that will affect the entire menu.
-.TS H
-lw(1i) lw(1i) lw(1i) lw(.5i) lw(2i).
-_
-.sp 3p
-.TB
-Name Class Type Notes Default Value
-.sp 3p
-_
-.TH
-.R
-.sp 3p
-accelerators Accelerators AcceleratorTable NULL
-ancestorSensitive AncestorSensitive Boolean D True
-allowShellResize AllowShellResize Boolean True
-background Background Pixel XtDefaultBackground
-backgroundPixmap Pixmap Pixmap XtUnspecifiedPixmap
-backingStore BackingStore BackingStore see below
-borderColor BorderColor Pixel XtDefaultForeground
-borderPixmap Pixmap Pixmap XtUnspecifiedPixmap
-borderWidth BorderWidth Dimension 1
-bottomMargin VerticalMargins Dimension 0
-children ReadOnly WidgetList R NULL
-createPopupChildProc CreatePopupChildProc Function NULL
-colormap Colormap Colormap Parent's Colormap
-cursor Cursor Cursor None
-depth Depth int C Parent's Depth
-destroyCallback Callback XtCallbackList NULL
-geometry Geometry String NULL
-height Height Dimension Enough space to contain all entries
-label Label String NULL
-labelClass LabelClass Pointer SmeBSBObjectClass
-mappedWhenManaged MappedWhenManaged Boolean True
-menuOnScreen MenuOnScreen Boolean True
-numChildren ReadOnly Cardinal R 0
-overrideRedirect OverrideRedirect Boolean True
-popdownCallback Callback XtCallbackList NULL
-popupCallback Callback XtCallbackList NULL
-popupOnEntry PopupOnEntry Widget A Label or first entry
-rowHeight RowHeight Dimension 0
-saveUnder SaveUnder Boolean False
-screen Screen Screen R Parent's Screen
-sensitive Sensitive Boolean True
-topMargin VerticalMargins Dimension 0
-translations Translations TranslationTable See below
-visual Visual Visual CopyFromParent
-width Width Dimension Width of widest entry
-x Position Position 0
-y Position Position 0
-.sp 3p
-_
-.TE
-.Ac
-.As
-.IP \fBbackingStore\fP 1.5i
-.IN "conversions" "BackingStore"
-Determines what type of backing store will be used for the menu. Legal
-values for this resource are \fBNotUseful\fP, \fBWhenMapped\fP, and
-\fBAlways\fP. These values are the backing-store integers defined in
-<X11/X.h>.
-.Rs "notUseful, whenMapped, always, \fPand\fP default"
-If \fBdefault\fP is specified (the default behavior) the server will use
-whatever it thinks is appropriate.
-.Bg
-.Gp
-.Bc
-.Bp
-.Bw
-.IP \fBbottomMargin\fP 1.5i
-.br
-.ns
-.IP \fBtopMargin\fP 1.5i
-The amount of space between the top or bottom of the menu and the menu entry
-closest to that edge.
-.Ch
-.Cm
-.IP \fBcursor\fP 1.5i
-The shape of the mouse pointer whenever it is in this widget.
-.Dp
-.Dc
-.IP geometry 1.5i
-If this resource is specified it will override the x, y, width and
-height of this widget. The format of this string is
-[<\fIwidth\fP>x<\fIheight\fP>][{+ -} <\fIxoffset\fP> {+ -}<\fIyoffset\fP>].
-.Hw
-.IP \fBlabel\fP 1.5i
-This label will be placed at the top of the SimpleMenu, and may not be
-highlighted. The name of the
-label object is \fBmenuLabel\fP. Using this name it is possible to
-modify the label's attributes through the resource database. When the label
-is created, the \fBlabel\fP is hard coded to the value of \fBlabel\fP, and
-\fBjustify\fP is hard coded as \fBXtJustifyCenter\fP.
-.IP \fBlabelClass\fP 1.5i
-Specifies the type of Sme object created as the menu label.
-.Mm
-.IP \fBmenuOnScreen\fP 1.5i
-If the menu is automatically positioned under the cursor with the
-\fBXawPositionSimpleMenu\fP action, and this resource is \fBTrue\fP,
-then the menu will always be fully visible on the screen.
-.Nc
-.IP overrideRedirect 1.5i
-Determines the value of the override_redirect attribute of the
-SimpleMenu's window. The override_redirect attribute of a window
-determines whether or not a window manager may interpose itself between
-this window and the root window of the display. For more information
-see the \fIInterclient Communications Conventions Manual\fP.
-.IP popdownCallback 1.5i
-.br
-.ns
-.IP popupCallback 1.5i
-These callback functions are called by the Xt Intrinsics whenever the
-shell is popped up or down (See \fI\*(xT\fP for details).
-.IP \fBpopupOnEntry\fP 1.5i
-The \fBXawPositionSimpleMenu\fP action will, by default, popup the
-SimpleMenu with its label (or first entry) directly under the
-pointer. To popup the menu under
-another entry, set this resource to the menu entry that should be
-under the pointer, when the menu is popped up. This allows the
-application to offer the user a default menu entry that can be selected
-with out moving the pointer.
-.IP \fBrowHeight\fP 1.5i
-If this resources is zero (the default) then each menu entry will be
-given its desired height. If this resource has any other value then
-all menu entries will be forced to be \fBrowHeight\fP pixels high.
-.IP saveUnder 1.5i
-If this is \fBTrue\fP then save unders will be active on the menu's window.
-.Sc
-.Se
-.Tr
-.Xy
-.NH 3
-SimpleMenu Actions
-.IN "SimpleMenu widget" "actions"
-.LP
-The SimpleMenu widget supports the following actions:
-.IP \(bu 5
-Switching the entry under the mouse pointer between
-the foreground and background colors with \fBhighlight\fP
-and \fBunhighlight\fP
-.IP \(bu 5
-Processing menu entry callbacks with \fBnotify\fP
-.sp
-.LP
-.IN "SimpleMenu widget" "default translations"
-The following are the default translation bindings used
-by the SimpleMenu widget:
-.LP
-.sp
-.Ds 0
-.TA .5i 2.25i
-.ta .5i 2.25i
- <EnterWindow>: highlight(\|)
- <LeaveWindow>: unhighlight(\|)
- <BtnMotion>: highlight(\|)
- <BtnUp>: MenuPopdown(\|) notify(\|) unhighlight(\|)
-.De
-.sp
-.LP
-.IN "SimpleMenu widget" "MenuPopdown routine"
-The user can pop down the menu without activating any of the callback
-functions by releasing the pointer button when no menu item is
-highlighted.
-.sp
-.LP
-The full list of actions supported by SimpleMenu is:
-.IP \fBhighlight\fP() 1.5i
-Highlight the menu entry that is currently under the pointer.
-Only a item that is highlighted will be notified when the \fBnotify\fP
-action is invoked. The look of a highlighted entry is determined by
-the menu entry.
-.IP \fBunhighlight\fP(\|) 1.5i
-Unhighlights the currently highlighted menu item, and returns it to
-its normal look.
-.IP \fBnotify\fP(\|) 1.5i
-Notifies the menu entry that is currently highlighted that is has been
-selected. It is the responsibility of the menu entry to take the
-appropriate action.
-.IP \fBMenuPopdown\fP(\fImenu\fP)
-This action is defined in \fI\*(xT\fP.
-.IN "SimpleMenu widget" "MenuPopdown routine"
-.NH 3
-Positioning the SimpleMenu
-.IN "XawPositionSimpleMenu" "" "@DEF@"
-.IN "SimpleMenu widget" "positioning" "@DEF@"
-.LP
-If the SimpleMenu widget is to be used as a pulldown menu then the
-MenuButton widget, or some other outside means should be used to place
-the menu when it is popped up.
-.LP
-If popup menus are desired it will be necessary to add the
-\fBXawPositionSimpleMenu\fP and \fBMenuPopup\fP actions to the
-translation table of the widget that will be popping up the menu. The
-\fBMenuPopup\fP action is described in \fI\*(xT\fP.
-\fBXawPositionSimpleMenu\fP is a global action procedure registered by
-the SimpleMenu widget when the first one is created or the convenience
-routine \fBXawSimpleMenuAddGlobalActions\fP is called.
-.LP
-Translation writers should be aware that Xt does not register grabs on
-``don't care'' modifiers, and therefore the left hand side of the
-production should be written to exclude unspecified modifiers.
-For example these are the translations needed to popup some of
-\fBxterm's\fP menus:
-.sp
-.LP
-.Ds 0
-.TA .5i 2.25i
-.ta .5i 2.25i
- !Ctrl<Btn1Down>: XawPositionSimpleMenu(xterm) MenuPopup(xterm)
- !Ctrl<Btn2Down>: XawPositionSimpleMenu(modes) MenuPopup(modes)
-.De
-.sp 1
-.LP
-.IP \fBXawPositionSimpleMenu\fP(\fImenu\fP) 2.25i
-The \fBXawPositionSimpleMenu\fP routine will search for the menu name
-passed to it using \fBXtNameToWidget\fP starting with the widget
-invoking the action as the reference widget. If it is unsuccessful it
-will continue up the widget tree using each of the invoking widget's
-ancestors as the reference widget. If it is still unsuccessful it will
-print a warning message and give up. \fBXawPositionSimpleMenu\fP will
-position the menu directly under the pointer cursor. The menu will be
-placed so that the pointer cursor is centered on the entry named by the
-\fBpopupOnEntry\fP resource. If the \fBmenuOnScreen\fP resource is
-\fBTrue\fP then the menu will always be fully visible on the screen.
-.NH 3
-Convenience Routines
-.NH 4
-Registering the Global Action Routines
-.LP
-.IN "XawPositionSimpleMenu" ""
-The \fBXawPositionSimpleMenu\fP action routine may often be invoked
-before any menus have been created. This can occur when an
-application uses dynamic menu creation. In these cases an application will
-need to register this global action routine by calling
-\fBXawSimpleMenuAddGlobalActions\fP:
-.IN "XawSimpleMenuAddGlobalActions" "" "@DEF@"
-.FD 0
-void XawSimpleMenuAddGlobalActions(\fIapp_con\fP)
-.br
- XtAppContext \fIapp_con\fP;
-.FN
-.IP \fIapp_con\fP 1i
-Specifies the application context in which this action should be registered.
-.LP
-This function need only be called once per application and must be
-called before any widget that uses \fBXawPositionSimpleMenu\fP action
-is realized.
-.NH 4
-Getting and Clearing the Current Menu Entry
-.LP
-To get the currently highlighted menu entry use
-\fBXawSimpleMenuGetActiveEntry\fP:
-.IN "XawSimpleMenuGetActiveEntry" "" "@DEF@"
-.FD 0
-Widget XawSimpleMenuGetActiveEntry(\fIw\fP)
-.br
- Widget \fIw\fP;
-.FN
-.IP \fIw\fP 1i
-Specifies the SimpleMenu widget.
-.LP
-This function returns the menu entry that is
-currently highlighted, or NULL if no entry is highlighted.
-.LP
-.sp
-To clear the SimpleMenu widget's internal information about the
-currently highlighted menu entry use
-\fBXawSimpleMenuClearActiveEntry\fP:
-.IN "XawSimpleMenuClearActiveEntry" "" "@DEF@"
-.FD 0
-Widget XawSimpleMenuClearActiveEntry(\fIw\fP)
-.br
- Widget \fIw\fP;
-.FN
-.IP \fIw\fP 1i
-Specifies the SimpleMenu widget.
-.LP
-This function unsets all internal references to the currently
-highlighted menu entry. It does not \fIunhighlight\fP or otherwise
-alter the appearance of the active entry. This function is primarily
-for use by implementors of menu entries.