DTEDITORGETINSERTIONPOSITION(3)

💖 DtEditorGetInsertionPosition (library call) — cursor-position bestie guide 💖

Okay bestie, this page is a library call — header shorthand is DtEditorGet...ionPosition, and the full name is DtEditorGetInsertionPosition. We're getting the insert-cursor position, and it's gonna be cute and precise. 🫶

✨ NAME ✨

DtEditorGetInsertionPosition — retrieve the position of the insert cursor in a DtEditor widget. 📍

✨ SYNOPSIS ✨

#include &<Dt/Editor.h>
XmTextPosition DtEditorGetInsertionPosition(
Widget widget);

✨ DESCRIPTION ✨

So the DtEditorGetInsertionPosition function accesses the current position of the insertion cursor in the DtEditor widget. 📍

That position is an integer number of characters from the beginning of the widget's text buffer. The first character position is zero — not one, bestie, zero. 🫶

The position of the insertion cursor can be set with DtEditorSetInsertionPosition(3).

The widget argument specifies the DtEditor widget ID.

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). iykyk 📚

✨ RETURN VALUE ✨

Upon successful completion, DtEditorGetInsertionPosition returns an XmTextPosition value that indicates the position of the insertion cursor in the text; otherwise, it returns NULL. That's the vibe check: position on success, NULL otherwise. 😭

✨ SEE ALSO ✨

• Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorGetLastPosition(3), DtEditorSetInsertionPosition(3).

---

Source/version + date sign-off 🎀: the footer shorthand is just DtEditorGet...ionPosition(library call) — so the source/version label is the library call manual name, and no separate date is provided. That's the whole footer tea, no cap. 💅