Athena Widget Set - C Language Interface - X Consortium ... - X.Org

Text Widgetsint XawTextReplace( w, end, *text);wstartendtextSpecifies the Text widget.Specifies the starting character position of the text replacement.Specifies the ending character position of the text replacement.Specifies the text to be inserted into the file.This function will not be able to replace text in read-only text widgets. It will alsoonly be able to append text to an append-only text widget.See section 5.4 for a description of XawTextPosition and XawTextBlock.This function may return the following values:XawEditDoneXawPositionErrorXawEditErrorThe text replacement was successful.The edit mode is XawtextAppend and start is not theposition of the last character of the source.Either the Source was read-only or the range to bedeleted is larger than the length of the Source.The XawTextReplace arguments start and end represent the text source characterpositions for the existing text that is to be replaced by the text in the text block. Thecharacters from start up to but not including end are deleted, and the charactersspecified on the text block are inserted in their place. If start and end are equal, notext is deleted and the new text is inserted after start.Searching for TextTo search for a string in the Text widget, use XawTextSearch:XawTextPosition XawTextSearch( w, dir, text);wdirtextSpecifies the Text widget.Specifies the direction to search in. Legal values are XawsdLeftand XawsdRight.Specifies a text block structure that contains the text to searchfor.See section 5.4 for a description of XawTextPosition and XawTextBlock. The Xaw-TextSearch function will begin at the insertion point and search in the directionspecified for a string that matches the one passed in text. If the string is found thelocation of the first character in the string is returned. If the string could not befound then the value XawTextSearchError is returned.Redisplaying TextTo redisplay a range of characters, use XawTextInvalidate:78