Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DtEditorChange(library call)			  DtEditorChange(library call)

NAME
       DtEditorChange  — change one or all occurrences of a string in a DtEdi‐
       tor widget

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

DESCRIPTION
       The DtEditorChange function replaces the next occurrence of  a  string,
       all occurrences of the string, or the currently selected text in a DtE‐
       ditor 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_CUR‐
       RENT_SELECTION, the Find field of DtEditorChangeValues is ignored.

       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	DtEDI‐
       TOR_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 -
       DtEditor(5).

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

SEE ALSO
       Dt/Editor.h  -  DtEditor(5),  DtEditor(3), DtEditorFind(3), DtEditorIn‐
       vokeFindChangeDialog(3).

						  DtEditorChange(library call)

Vote for polarhome