XMCREATEFRAME(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

✨ XmCreateFrame πŸ’…

okay bestie, so this one lives in the library call section of the manual, and it's all about the Frame widget creation function. yes, that Frame. the one that goes around your other widgets and gives them that little border moment. iconic behavior honestly πŸŽ€


🌸 NAME 🌸

XmCreateFrame β€” The Frame widget creation function

like. that's it. that's the whole name. short, sweet, slays πŸ’–


✨ SYNOPSIS ✨

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

no cap, that's the whole signature. four args, one Widget coming back at you πŸ¦‹


πŸ’œ DESCRIPTION πŸ’œ

So XmCreateFrame creates an instance of a Frame widget and returns the associated widget ID. that's the whole vibe. you ask for a Frame, the toolkit goes "say less", and hands you back the ID. periodt πŸ‘‘

Now the args, one by one, because we do NOT skip details in this house:

  • parent β€” Specifies the parent widget ID. it's giving "who's your mom, who's your dad" β€” your new Frame needs a home, and this is it 🫢
  • name β€” Specifies the name of the created widget. name your baby. choose wisely bestie πŸ’«
  • arglist β€” Specifies the argument list. this is where you pass all your attribute/value pairs, aka the customization menu 🌈
  • argcount β€” Specifies the number of attribute/value pairs in the argument list (arglist). literally just count them. that's the job. and yes, it has to match, iykyk πŸ’€

For a complete definition of Frame and its associated resources, see XmFrame(3). go read it, it's the sequel, it's highkey required reading πŸ“–βœ¨


πŸŽ€ RETURN πŸŽ€

Returns the Frame widget ID. that's your prize. hold it gently, use it everywhere πŸ”₯


  • XmFrame(3). β€” the main character of this whole storyline, honestly

reminder bestie: this page is XmCreateFrame(library call) β€” that's your source/version tag, straight from the Xm library call manual. the date on it is giving timeless, but the info is eternal ✨

k love you, go make some frames, and remember: every widget deserves a parent πŸ’–πŸ’…πŸŒΈ