
8.6.2 TEXTSW_CONTENTS
TEXTSW_CONTENTS lets you insert a text string from memory, instead of a file, into the text
subwindow. The default for this attribute is NULL.
Using xv_create() with this attribute specifies the initial contents for a nonfile text
subwindow.
Using xv_set() with this attribute sets the contents of a window, as in:
xv_set(textsw, TEXTSW_CONTENTS, "text", NULL);
If you use xv_get() with this attribute, you will need to provide additional parameters, as
in:
xv_get(textsw, TEXTSW_CONTENTS, pos, buf, buf_len);
The return value is the next position to be read. The buffer array:
buf[0 ... buf_len-1]
is filled with the characters from textsw beginning at the index pos and is NULL-ter-
minated only if there were too few characters to fill the buffer.
8.6.3 TEXTSW_INSERT_FROM_FILE
TEXTSW_INSERT_FROM_FILE
allows a client to insert the contents of a file into a text
subwindow at the current insertion point. It is the programming equivalent of a user choos-
ing “Include File” from the text menu.
The code below demonstrates this attribute:
Textsw textsw;
Textsw_status status;
xv_set(textsw,
TEXTSW_STATUS, &status,
TEXTSW_INSERT_FROM_FILE, filename,
NULL);
Three status values can be returned for this attribute when the argument TEXTSW_STATUS is
passed in the same call to xv_create() or xv_set():
TEXTSW_STATUS_OKAY
TEXTSW_STATUS_CANNOT_INSERT_FROM_FILE
TEXTSW_STATUS_OUT_OF_MEMORY
Text Subwindows
Text Subwindows ...