Contents/Application Interface functions/Text Insert, Append and Delete/

TerInsertLine

Insert a line of text before the current line.

BOOL TerInsertLine(hWnd, text, FontId, ParaId, CellId, reserved, repaint)

HWND hWnd; The handle of the window to be accessed

BYTE huge *text; // pointer to the text to be appended. The text must be NULL terminated. The length of the text must not exceed MAX_WIDTH - 1 or 299.

`int FontId;`	font id to use for the new text. Use -1 for the default value.
`int ParaId;`	paragraph id to use for the new text. Use -1 for the default value.
`int CellId;`	Cell id to use for this new text. Use -1 for the default value. When creating a table structure using this function, you must specify the current cell id for this parameter.
`int ParaFID;`	Paragraph frame id. Use -1 for the default value.
`BOOL repaint;`	Repaint the window after this operation

Description: This function provides a very fast method of inserting a line of text before the current line. After the insertion the cursor is moved to the first character of the next line. In a batch of calls to the TerInsertLine function, the 'repaint' argument should be set to TRUE only for the last call to this function.

Return Value: This function returns TRUE when successful.