DTEDITORFORMAT(3)

okay so bestie, this is DtEditorFormat, and the manual name is library call. it’s giving “format my editor text, please” energy, and we’re about to go through the whole page. 💅✨

💖 NAME 💖

DtEditorFormat — format all or part of the contents of a DtEditor widget. periodt. 🫶

✨ SYNOPSIS ✨

#include &<Dt/Editor.h>
DtEditorErrorCode DtEditorFormat(
Widget widget,
DtEditorFormatSettings *formatSettings,
unsigned int amountToFormat);

🌸 DESCRIPTION 🌸

okay so DtEditorFormat formats all or part of the contents of the DtEditor widget according to the current text format settings in the Format Settings dialog. these options specify which margins and alignments (left aligned, right aligned, justified or centered) are used. optionally, alternative settings can be passed as an argument to DtEditorFormat in a data structure. this function formats either the paragraph containing the insertion cursor or the entire contents of the DtEditor widget, depending on the value of the amountToFormat argument. 🦋

the Format Settings dialog is displayed with DtEditorInvokeFormatDialog(3). for a complete description of formatting and the Format Settings dialog, see DtEditor.

quick arg check, bestie: ✨

• widget — specifies the editor widget ID. 👑
• formatSettings — specifies left margin value, right margin value and the justification style. the LeftMargin and RightMargin fields of DtEditorFormatSettings must be zero or larger. the Alignment field can have a value of DtEDITOR_ALIGN_CENTER, DtEDITOR_ALIGN_JUSTIFY, DtEDITOR_ALIGN_LEFT or DtEDITOR_ALIGN_RIGHT. if the formatSettings argument is NULL, DtEditorFormat uses the last format settings specified in the Format Settings dialog. 🎀
• amountToFormat — when the amountToFormat argument is set to DtEDITOR_FORMAT_ALL, it reformats all the text in the edit window. when this argument is set to DtEDITOR_PARAGRAPH, only the paragraph containing the insertion cursor is formatted. 💅

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

for a complete definition of DtEditorFormatSettings, see Dt/Editor.h - DtEditor(5). 🌈

🎀 RETURN VALUE 🎀

upon successful completion, the DtEditorFormat function returns DtEDITOR_NO_ERRORS; otherwise, it returns one of the following values:

• DtEDITOR_NO_TMP_FILE — the DtEditorFormat function cannot create two temporary files in the directory returned by tmpnam3S. 😭
• DtEDITOR_ILLEGAL_SIZE — the left or right margin values are negative. 💀
• DtEDITOR_INVALID_RANGE — the amountToFormat argument is not recognized. 🙈
• DtEDITOR_INVALID_TYPE — the Alignment field is not recognized. ⭐

🔗 SEE ALSO 🔗

the whole squad, no cap:

• Dt/Editor.h - DtEditor(5)
• DtEditor(3)
• DtEditorInvokeFormatDialog(3)
• tmpnam3S

---

that’s the whole page, bestie — DtEditorFormat, library call, signing off from the footer with no separate source/version/date line to hype up. 🫶💜