DTEDITORSETCONTENTS(3)

💖 NAME 💖

okay so, bestie, this is DtEditorSetContents from the library call section 💅 — it places data into a DtEditor widget. No cap, that’s the whole gig ✨

---

🎀 SYNOPSIS 🎀

#include &<Dt/Editor.h>
DtEditorErrorCode DtEditorSetContents(
Widget widget,
DtEditorContentRec *data);

---

🦋 DESCRIPTION 🦋

The DtEditorSetContents function places a NULL-terminated string, a wide character string, or a sized buffer into a DtEditor widget. Any data currently in the DtEditor widget is lost. Yep, gone-gone, so vibe-check before you call this one 😭

The data gets transferred to the DtEditor widget using a DtEditorContentRec, which tells you the type of data being transferred along with the actual data. After the data is placed into the DtEditor widget, the insertion cursor is positioned at the first character. Cute, right? 🎀

The widget argument specifies the DtEditor widget ID.

The data argument is a pointer to a data structure containing the new contents of widget.

For the full definition of the DtEditor widget and its associated resources, see DtEditor(3).

For the full definition of DtEditorContentRec, see Dt/Editor.h - DtEditor(5).

⚠️ heads up bestie: calling this replaces whatever was already in the widget. The original data is lost. Periodt.

---

🌸 RETURN VALUE 🌸

Upon successful completion, the DtEditorSetContents function returns one of these little icons:

• DtEDITOR_NO_ERRORS — the data was loaded successfully. slay ✨
• DtEDITOR_NULLS_REMOVED — NULL characters were found and removed from the data. okay cleanup crew 🧹

Otherwise, if the DtEditorSetContents function cannot load the data into the DtEditor widget, it returns one of these:

• DtEDITOR_INVALID_TYPE — the Type field is unrecognized. not the vibe 🙈
• DtEDITOR_ILLEGAL_SIZE — the size of the buffer passed in is negative. ma’am?? 💀
• DtEDITOR_NULL_ITEM — the buffer is NULL.
• DtEDITOR_INSUFFICIENT_MEMORY — not enough system memory is available to load the data. the memory said no 😭

---

🌈 EXAMPLES 🌈

The following code segment sets the contents of a DtEditor widget to ``The quick brown fox.'' 🦊

Widget                  editor;
DtEditorContentRec      cr;
DtEditorErrorCode       status;
char                    *sampleString="The quick brown fox";
cr.type = DtEDITOR_TEXT;
cr.value.string = sampleString;
status = DtEditorSetContents(editor, &&cr);
if (status != DtEDITOR_NO_ERRORS &&&& status != DtEDITOR_NULLS_REMOVED) {
        printf("Unable to set contents of the widget0);

---

💜 APPLICATION USAGE 💜

If the data is in a disk file instead of in memory, the application should use DtEditorSetContentsFromFile(3). iykyk — file data has its own little entrance 💅

---

👑 SEE ALSO 👑

• Dt/Editor.h - DtEditor(5)
• DtEditor(3)
• DtEditorAppend(3)
• DtEditorAppendFromFile(3)
• DtEditorGetContents(3)
• DtEditorInsert(3)
• DtEditorInsertFromFile(3)
• DtEditorReplace(3)
• DtEditorReplaceFromFile(3)
• DtEditorSaveContentsToFile(3)
• DtEditorSetContentsFromFile(3)

---

later, bestie 💅 — this page is a library call situation, and the footer has no source/version or date attached, so that’s the whole cute little sign-off 🎀✨