ControlInfo(3U)

✨ ControlInfo — it's giving "control room" 💅

okay bestie, sit down, we're doing the InterViews Reference Manual version of ControlInfo(3U) and honestly? it's lowkey iconic. this little guy lives in the Unidraw library, and it's about to become your new obsession. 🎀

🌸 NAME 🌸

ControlInfo — the object that stores control-related information. yes that's the whole vibe. it holds the receipts. 🧾✨

🦋 SYNOPSIS 🦋

#include <Unidraw/ctrlinfo.h>

that's it. one include. slay. 💖

👑 DESCRIPTION 👑

so a ControlInfo object stores information from which to build a Control — you know, the thing that actually executes a command or engages the current tool. 🫶

here's the part that's genuinely genius: the ControlInfo object is stored with the command or tool. so when your command or tool gets retrieved from disk through a catalog, you have all the information necessary to recreate the interface. no cap. it's giving "we remembered everything so you don't have to". 💅

also — and this is the main character moment — ControlInfo defines the mapping between a keycode and a UControl instance, which is what supports keyboard equivalents via the KeyMap class. keyboard shortcuts, but make it structurally sound. ⌨️✨

💜 PUBLIC OPERATIONS 💜

the constructors, aka how we get born 🌈

ControlInfo(
    GraphicComp* label, const char* keylabel = '',
    const char* keycode = '', void* owner = nil
)

ControlInfo(
    const char* label, const char* = '',
    const char* = '', void* = nil
)

Create a new ControlInfo instance, bestie! you supply either a GraphicComp or a character string to define its label's appearance. pick your fighter. 🥊

• label — an iconic or textual cue that a control displays to identify the command or tool it activates. it's the lil face on the button.
• keylabel — a string to be displayed in the control that identifies the control's keyboard equivalent. so people know which key to smash.
• keycode — defines the mapping between a keyboard event and the ControlInfo. this is the ✨magic✨ link.
• owner — specifies the command or tool instance to which the ControlInfo object corresponds. like, whose info is this.

the setters & getters, aka explicit communication 💬

void SetLabel(GraphicComp*)
void SetLabel(const char*)
void SetKeyLabel(const char*)
void SetKeyCode(const char*)
void SetOwner(void*)

GraphicComp* GetLabel()
const char* GetKeyLabel()
const char* GetKeyCode()
void* GetOwner()

Explicitly set or get a constructor-specified parameter. that's the whole job. 🔥

⚠️ heads up bestie, this one matters: the Set operations delete the value they replace if it is different from the given one. and the string setting operations copy their arguments. so no aliasing drama, no dangling anything, we're responsible in this house. 🫶

virtual ControlInfo* Copy() 📋

Return a copy of this ControlInfo object, copying its constituent members.

a whole duplicate. its own lil clone. copying every constituent member because we're thorough like that. 💖

🌟 SEE ALSO 🌟

• Catalog(3U)
• Command(3U)
• KeyMap(3U)
• Tool(3U)
• UControl(3U)
• uctrls(3U)

go read those too, iykyk. 📚✨

okay that's the whole page bestie, you ate that 💅

this masterpiece came to you courtesy of Unidraw, dated 20 November 1990 — vintage but make it forever relevant. 🦋💖 no cap, it's still serving. 🎀