XMCREATESIMPLEPOPUPMENU(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ NAME ✨

XmCreateSimplePopupMenu β€” a RowColumn widget convenience creation function, and bestie, it's giving effortless popup menu πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <Xm/RowColumn.h>
Widget XmCreateSimplePopupMenu(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount);

πŸ’– DESCRIPTION πŸ’–

okay so. XmCreateSimplePopupMenu creates an instance of a RowColumn widget of type XmMENU_POPUP and hands you back the associated widget ID. that's it, that's the whole vibe. 🫢

This routine creates a Popup menu pane and its button children. and the naming scheme?? so organized of it:

  • every button is named button_n, where n is an integer from 0 (zero) to the number of buttons in the menu minus 1
  • every separator is named separator_n, where n is an integer from 0 (zero) to the number of separators in the menu minus 1
  • every title is named label_n, where n is an integer from 0 (zero) to the number of titles in the menu minus 1

and here's the part you gotta internalize, no cap: buttons, separators, and titles are named and created in the order in which they are specified in the RowColumn simple menu creation resources supplied in the argument list. order matters. periodt. πŸ”₯

🌸 the arguments 🌸

  • parent β€” specifies the widget ID of the parent of the MenuShell
  • name β€” specifies the name of the created widget
  • arglist β€” specifies the argument list
  • argcount β€” specifies the number of attribute/value pairs in the argument list (arglist)

πŸŽ€ the resources πŸŽ€

A number of resources exist specifically for use with this and other simple menu creation routines. ✨

and listen β€” the ONLY button types allowed in the XmNbuttonType resource are:

  • XmCASCADEBUTTON
  • XmPUSHBUTTON
  • XmRADIOBUTTON
  • XmCHECKBUTTON
  • XmTITLE
  • XmSEPARATOR
  • XmDOUBLE_SEPARATOR
not me being dramatic but if you try to sneak in anything else, that's not on the list. don't do it. πŸ™ˆ

For a complete definition of RowColumn and its associated resources, see XmRowColumn(3).


πŸ‘‘ RETURN πŸ‘‘

Returns the RowColumn widget ID. that's your prize bestie, go build something iconic πŸ’…



and that's the whole page, mwah πŸ’– this one came from the XmCreateSimplePopupMenu(library call) manual, so if you're citing it, that's the source/version label it rolls with β€” love that for it, fr fr. πŸ¦‹βœ¨πŸŽ€