DTEDITORCOPYTOCLIPBOARD(3)

💖 DtEditorCopyToClipboard — library call 💖

🌸 NAME 🌸

okay bestie, DtEditorCopyToClipboard is the copy the primary selection in a DtEditor widget to the clipboard function. It's literally in the name, and it's giving clipboard glow-up. 🫶

🌸 SYNOPSIS 🌸

#include &<Dt/Editor.h>
Boolean DtEditorCopyToClipboard(
Widget widget);

That's the whole signature: include the header, call the function, pass in a Widget. 💅

💅 DESCRIPTION 💅

The DtEditorCopyToClipboard function copies to the clipboard the currently selected text in the DtEditor widget specified by the widget argument. So whatever text is selected in that editor widget gets copied to the clipboard. Iconic. ✨

The widget argument specifies the DtEditor widget ID.

Text can be selected and deselect programmatically with DtEditorSelectAll(3) and DtEditorDeselect(3). Those are your selection-state besties. 🎀

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). Lowkey required reading for the full widget lore. 🧚

🎀 RETURN VALUE 🎀

Upon successful completion, DtEditorCopyToClipboard returns True. Slay! 💖

Otherwise, it returns False if:

• the primary selection is NULL, or
• the widget does not own the primary selection, or
• the function is unable to gain ownership of the clipboard selection.

No cap: those are the exact False cases. 🙈

🦋 SEE ALSO 🦋

Go read these next, bestie:

• Dt/Editor.h - DtEditor(5)
• DtEditor(3)
• DtEditorClearSelection(3)
• DtEditorCutToClipboard(3)
• DtEditorDeleteSelection(3)
• DtEditorDeselect(3)
• DtEditorPasteFromClipboard(3)
• DtEditorSelectAll(3)
• DtEditorUndoEdit(3)

That's the whole crew. 👑

---

💖 Source/version + date sign-off: the page footer is just DtEditorCopyToClipboard(library call) — no extra version or date line provided. Bye bestie! 💖