*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtEditorFormat (3)              


 DtEditorFormat(library call)                   DtEditorFormat(library call)

 NAME    [Toc]    [Back]
      DtEditorFormat - format all or part of the contents of a DtEditor

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Editor.h>
      DtEditorErrorCode DtEditorFormat(
      Widget widget,
      DtEditorFormatSettings *formatSettings,
      unsigned int amountToFormat);

 DESCRIPTION    [Toc]    [Back]
      The DtEditorFormat function 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

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

      The widget argument specifies the editor widget ID.

      The formatSettings argument 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,
      If the formatSettings argument is NULL, DtEditorFormat uses the last
      format settings specified in the Format Settings dialog.

      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 -

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the DtEditorFormat function returns
      DtEDITOR_NO_ERRORS; otherwise, it returns one of the following values:

                                    - 1 -       Formatted:  January 24, 2005

 DtEditorFormat(library call)                   DtEditorFormat(library call)

                The DtEditorFormat function cannot create two temporary
                files in the directory returned by tmpnam3S.

                The left or right margin values are negative.

                The amountToFormat argument is not recognized.

                The Alignment field is not recognized.

 SEE ALSO    [Toc]    [Back]
      Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorInvokeFormatDialog(3);

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
DtEditorReplaceFromFile HP-UX replace a portion of the contents of a DtEditor widget with the contents of a file
DtEditorGetContents HP-UX retrieve the contents of a DtEditor widget
DtEditorReplace HP-UX replace a portion of the contents of a DtEditor widget
DtEditorSaveContentsToFile HP-UX save the contents of a DtEditor widget to a file
DtEditor HP-UX the DtEditor widget class
DtEditorSetContents HP-UX place data into a DtEditor widget
DtEditorInsert HP-UX insert data into a DtEditor widget
DtEditorSelectAll HP-UX select all text in a DtEditor widget
DtCreateEditor HP-UX create a new instance of a DtEditor widget
DtEditorAppend HP-UX append data to a DtEditor widget
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service