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

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


 DtEditorChange(library call)                   DtEditorChange(library call)

 NAME    [Toc]    [Back]
      DtEditorChange - change one or all occurrences of a string in a
      DtEditor widget

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Editor.h>
      Boolean DtEditorChange(
      Widget widget,
      DtEditorChangeValues *findChangeStrings,
      unsigned int instanceToChange);

 DESCRIPTION    [Toc]    [Back]
      The DtEditorChange function replaces the next occurrence of a string,
      all occurrences of the string, or the currently selected text in a
      DtEditor widget with a replacement string.  The string to search for
      and the value to change it to can be the last values entered in the
      Find/Change dialog (see DtEditorInvokeFindChangeDialog(3)) or passed
      as arguments to DtEditorChange.

      The search begins at the insertion cursor.  If the string is not found
      by the time the end of the document is reached, the search continues
      at the beginning of the document, stopping at the character before the
      insertion cursor.

      The widget argument specifies the DtEditor widget ID.

      The findChangeStrings argument specifies the string to change and the
      replacement value.  If findChangeStrings is NULL, DtEditorChange uses
      the last string specified in the Find and Change To fields of the
      Find/Change dialog.  If the instanceToChange argument is
      DtEDITOR_CURRENT_SELECTION, the Find field of DtEditorChangeValues is

      If the instanceToChange argument is set to DtEDITOR_NEXT_OCCURRENCE,
      DtEditorChange replaces the next occurrence (relative to the insertion
      cursor) of the find string.  If this argument is set to
      DtEDITOR_ALL_OCCURRENCES, all instances of the find string are
      changed.  If this argument ia set to DtEDITOR_CURRENT_SELECTION, the
      Find field of DtEditorChangeValues, is ignored and the currently
      selected text is replaced.

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

      For a complete definition of DtEditorChangeValues, see Dt/Editor.h -

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the DtEditorChange function returns True
      if the substitution occurred; otherwise, it returns False.

                                    - 1 -       Formatted:  January 24, 2005

 DtEditorChange(library call)                   DtEditorChange(library call)

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

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
DtEditorFind HP-UX search for the next occurrence of a string in a DtEditor widget
DtEditor HP-UX the DtEditor widget class
DtEditorAppend HP-UX append data to a DtEditor widget
DtEditorSetContents HP-UX place data into a DtEditor widget
DtEditorGetContents HP-UX retrieve the contents of a DtEditor widget
DtEditorSelectAll HP-UX select all text in a DtEditor widget
DtEditorInsert HP-UX insert data into a DtEditor widget
DtCreateEditor HP-UX create a new instance of a DtEditor widget
DtEditorSetInsertionPosition HP-UX set the position of the insert cursor in a DtEditor widget
DtEditorGetLastPosition HP-UX retrieve the position of the last character in a DtEditor widget
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service