XMMAINWINDOWSETAREAS(3)

💖 XmMainWindowSetAreas 💖

okay bestie, welcome to the XmMainWindowSetAreas page from the library call manual — this is the one that tells your MainWindow which kiddos belong in which area 🎀

✨ NAME ✨

XmMainWindowSetAreas — a MainWindow function that identifies manageable children for each area 🫶

🌸 SYNOPSIS 🌸

#include <Xm/MainW.h>
void XmMainWindowSetAreas(
Widget widget,
Widget menu_bar,
Widget command_window,
Widget horizontal_scrollbar,
Widget vertical_scrollbar,
Widget work_region);

💅 DESCRIPTION 💅

XmMainWindowSetAreas is literally the girl who does the seating chart 💁‍♀️ she identifies which of the valid children for each area (like the MenuBar and the work region) are gonna be actively managed by MainWindow. She also sets up — or adds — the MenuBar, work window, command window, and ScrollBar widgets to the application's main window widget. so she's not just assigning seats, she's also walking them to the table. iconic.

Every single area is optional, so you can pass NULL to one or more of the arguments below. and no, you don't need to worry about the title bar — the window manager handles that one. not your problem, bestie 💅

⚠️ NOTE: XmMainWindowSetAreas is obsolete and only exists for compatibility with previous releases 😭 the info that this function used to hand you can now be obtained through a call to XtGetValues on the XmNscrolledWindowChildType resource. so like… she's retired but still shows up to the function. respect.

• widget — specifies the MainWindow widget ID. this is the main character 👑
• menu_bar — specifies the widget ID for the MenuBar to be associated with the MainWindow widget. ⭐ set this ID only after creating an instance of the MainWindow widget. the attribute name associated with this argument is XmNmenuBar.
• command_window — specifies the widget ID for the command window to be associated with the MainWindow widget. set this ID only after creating an instance of the MainWindow widget. the attribute name associated with this argument is XmNcommandWindow.
• horizontal_scrollbar — specifies the ScrollBar widget ID for the horizontal ScrollBar to be associated with the MainWindow widget. set this ID only after creating an instance of the MainWindow widget. the attribute name associated with this argument is XmNhorizontalScrollBar.
• vertical_scrollbar — specifies the ScrollBar widget ID for the vertical ScrollBar to be associated with the MainWindow widget. set this ID only after creating an instance of the MainWindow widget. the attribute name associated with this argument is XmNverticalScrollBar.
• work_region — specifies the widget ID for the work window to be associated with the MainWindow widget. set this ID only after creating an instance of the MainWindow widget. the attribute name associated with this argument is XmNworkWindow.

also!! if you want the complete definition of MainWindow and all its associated resources, go read XmMainWindow(3). she's the source of truth, no cap 📚

🦋 RELATED 🦋

• XmMainWindow(3).

and that's the whole page, bestie 💖 this one's a library call page for XmMainWindowSetAreas, straight from the Xm manual set — no fancy date stamp on this one, she's timeless like that ✨ go forth and set your areas, you got this 🫶💅