TCustomRichViewEdit.SetItemTextEd, SetItemTextEdA, SetItemTextEdW

Top Previous Next

Editing-methods for changing text of text item or name of non-text item.

procedure SetItemTextEd(ItemNo: Integer; const s: String);

procedure SetItemTextEdA(ItemNo: Integer; const s: TRVAnsiString);

procedure SetItemTextEdW(ItemNo: Integer; const s: TRVUnicodeString);

(Introduced in version 1.4, 1.7)

Parameters:

ItemNo – index of the item. Items are indexed from 0 to ItemCount-1, GetItemStyle returns type of item.

Items of subdocuments (table cells) are not included in the items range of the main document. For items in cells, activate inplace-editor, select the proper item in the cell (SelSelectionBounds), and call SetItemTextEd* of this inplace-editor. Alternatively, you can use SetCurrentItemText*.

s – text assigned to the item. For text items, this is a visible text. For non-text item, this is a string value associated with the item (not displayed). S must not contain line break (CR and LF) characters. For text items, it must not contain CR, LF, TAB, FF characters (#13, #10, #9, #12).

Unicode notes:

SetItemTextEdA sets text from ANSI string:

▪If the item is a non-text item or a text item of ANSI style, the text is assigned as it is.

▪If the item is a Unicode text item, the function converts s to Unicode (conversion is based on Charset of the item style).

SetItemTextEdW sets text from Unicode string:

▪If the item is a Unicode text item, the text is assigned as it is.

▪If the item is a non-text item or a text item of ANSI style, the function converts s to ANSI (conversion is based on Charset of the item style, or on RVStyle.DefCodePage for non-text items).

SetItemTextEd works like SetItemTextEdW in Delphi/C++Builder 2009 or newer, and like SetItemTextEdA in the older versions of Delphi/C++Builder.

Methods type: editing-style.