XMCREATESIMPLEPULLDOWNMENU(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 πŸ’…

XmCreateSimplePulldownMenu β€” ok so it's literally a RowColumn widget convenience creation function, and bestie, "convenience" is doing a LOT of heavy lifting here because it builds you a whole menu in one call πŸŽ€


✨ SYNOPSIS ✨

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

πŸ¦‹ DESCRIPTION πŸ¦‹

So XmCreateSimplePulldownMenu makes you an instance of a RowColumn widget, type XmMENU_PULLDOWN, and hands you back the widget ID like the little gift it is 🎁

This routine creates a Pulldown menu pane and its button children. Not me doing the whole nursery thing but okay:

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

And the order?? Buttons, separators, and titles are named <em>and</em> created <strong>in the order they are specified</strong> in the RowColumn simple menu creation resources you supplied in the argument list. So it's giving ✨sequential main character energy✨, no reordering, no cap.

  • parent β€” the widget ID of the parent of the MenuShell 🌸
  • name β€” the name of the created widget, iconic
  • arglist β€” the argument list πŸ’–
  • argcount β€” how many attribute/value pairs are chillin' in the argument list (<code>arglist</code>) πŸ”’

A whole bunch of resources exist specifically for use with this and other simple menu creation routines, iykyk. So like, heads up: the <strong>only</strong> button types allowed in the XmNbuttonType resource are:

  • XmCASCADEBUTTON
  • XmPUSHBUTTON
  • XmRADIOBUTTON
  • XmCHECKBUTTON
  • XmTITLE
  • XmSEPARATOR
  • XmDOUBLE_SEPARATOR

For a complete definition of RowColumn and its associated resources, go see XmRowColumn(3) bestie, she has the full lore πŸ“–


πŸ”₯ RETURN πŸ”₯

Returns the RowColumn widget ID. Periodt. πŸ’…



and that's the whole page babes πŸ’– it's a library call page, footer said so, and the header said it too β€” XmCreateSimplePulldownMenu in the library call section, mwah 🫢 go build a menu, you got this ✨