Каждый элемент документа в TRichView имеет связанное с ним строковое значение – тег. Теги предоставляются для удобства хранения дополнительных строковых значений для особых нужд вашего приложения. Основное назначение тегов – организация работы с гипертекстом.
Не путайте теги элементов документа со свойством Tag компонентов (потомков TComponent)! (TRichView использует свойства Tag вставленных компонентов для собственных нужд; вы можете установить свойства Tag компонентов TImageList для организации сохранения/загрузки значков и интерактивных значков из RVF; но эта тема посвящена совершенно другим тегам!)
Что нужно знать о тегах элементов
▪Если вы не хотите их использовать – просто забудьте о них; они всегда будут равны '';
▪закладки также имеют теги; все правила для тегов элементов работают для тегов закладок;
▪ячейки таблицы также имеют теги; все правила для тегов элементов работают для тегов ячеек;
▪редактор может очистить (установить значение '') теги при применении другого стиля к тексту в соответствии с RichViewEdit.EditorOptions;
▪Если вы хотите сохранить и загрузить документ в RVF, необходимо обеспечить, что строки тегов не содержат символов #1 и #2.
Примечание о Юникоде: теги – это юникодные строки.
Пример:
var
Tag: TRVTag;
S: TRVUnicodeString;
// Преобразование видимого текста и тега
// первого элемента документа
// в верхний регистр
MyRichView.GetTextInfo(0, S, Tag);
MyRichView.SetItemText(0, UpperCase(S));
MyRichView.SetItemTag(0, UpperCase(Tag));
Теги в старых версиях ТРВ-Редактора
В версиях ТРВ-Редактора до 13.2 теги представляли собой целые числа. В зависимости от опции rvoTagsArePChars (см. Options) они могли быть либо численными значениями, либо указателями на строки.
Этот режим может быть возвращён путем определения директивы RVOLDTAGS в файле RV_Defs.inc.
См. также
Методы TRichView для добавления элементов в конец документа (тег является необязательным параметром):
AddNL, AddBreak, AddPicture, AddHotspot, AddBullet, AddControl, AddBreak
Методы TRichView для добавления закладок в конец документа (тег является необязательным параметром):
Методы TRichView для получения информации об элементах (включая теги):
GetItemTag, GetBreakInfo, GetBulletInfo, GetHotspotInfo, GetPictureInfo, GetControlInfo, GetTextInfo.
Методы TRichView для изменения элементов (включая теги):
SetItemTag, SetBreakInfo, SetBulletInfo, SetHotspotInfo, SetPictureInfo, SetControlInfo.
Методы TRichView для работы с тегами закладок:
FindCheckpointByTag, GetCheckpointInfo, SetCheckpointInfo.
Методы TRichViewEdit для получения информации об элементе, находящемся в позиции каретки:
GetCurrentTag, GetCurrentBreakInfo, GetCurrentBulletInfo, GetCurrentHotspotInfo, GetCurrentPictureInfo, GetCurrentControlInfo, GetCurrentTextInfo.
Методы TRichViewEdit для вставки:
InsertStringTag, InsertStringATag, InsertStringWTag
Методы TRichViewEdit для изменения элементов (включая теги):
SetItemTagEd, SetBreakInfoEd, SetBulletInfoEd, SetHotspotInfoEd, SetPictureInfoEd, SetControlInfoEd.
Методы TRichViewEdit для изменения информации об элементе, находящемся в позиции каретки:
SetCurrentTag, SetCurrentBreakInfo, SetCurrentBulletInfo, SetCurrentHotspotInfo, SetCurrentPictureInfo, SetCurrentControlInfo
Методы TRichViewEdit для работы с тегами закладок:
SetCheckpointInfoEd, SetCurrentCheckpointInfo.
Свойства TRichViewEdit, влияющие на теги: