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

Text WidgetsName Class Type Notes Default Valuecallback Callback XtCallbackList NULLDataCompressiondestroy-CallbackdataCompressionBoolean TrueCallback Callback NULLeditType EditType EditMode XawtextReadlength Length Int A length ofstringpieceSize PieceSize Int BUFSIZstring String String NULLtype Type AsciiType XawAsciiStringuseStringIn-Place_UseStringIn-PlaceConvenience RoutinesBoolean FalseThe AsciiSrc has a few convenience routines that allow the application programmerquicker or easier access to some of the commonly used functionality of the AsciiSrc.Conserving MemoryWhen the AsciiSrc widget is not in useStringInPlace mode space must be allocatedwhenever the file is saved, or the string is requested with a call to XtGetValues.This memory is allocated on the fly, and remains valid until the next time a stringneeds to be allocated. You may save memory by freeing this string as soon as youare done with it by calling XawAsciiSourceFreeString.void XawAsciiSourceFreeString( w);wSpecifies the AsciiSrc object.Saving FilesThis function will free the memory that contains the string pointer returned byXtGetValues. This will normally happen automatically when the next call to XtGet-Values occurs, or when the widget is destroyed.To save the changes made in the current text source into a file use XawAsciiSave.Boolean XawAsciiSave( w);wSpecifies the AsciiSrc object.XawAsciiSave returns True if the save was successful. It will update the file namedin the string resource. If the buffer has not been changed, no action will be taken.This function only works on an AsciiSrc of type XawAsciiFile.XawAsci-To save the contents of the current text buffer into a named file useiSaveAsFile.95