TCustomRichView.GetPictureInfo

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.GetPictureInfo

Возвращает основные свойства элемента документа: рисунка или интерактивного рисунка.

procedure GetPictureInfo(ItemNo: Integer; out AName: TRVUnicodeString;

  out Agr: TRVGraphicout AVAlign: TRVVAlign;

  out ATag: TRVTag);

Входной параметр:

ItemNo номер элемента. Элемент должен быть рисунком или интерактивным рисунком (rvsPicture или rvsHotPicture), в противном случае метод вызывает исключение ERichViewError. Элементы документа нумеруются от 0 до ItemCount-1, GetItemStyle возвращает тип элемента. Элементы поддокументов (ячеек таблиц) не включены в диапазон элементов основного документа; для элементов в ячейках используйте Cell.GetRVData.GetPictureInfo.

 

Выходные параметры:

AName имя элемента. Оно также может быть получено методом GetItemText.

Agr графический объект. Метод возвращает объект, которым владеет TRichView. Не освобождайте память под него. Редко используемые изображения могут быть «деактивированы», т.е. сохранены в потоке в памяти и уничтожены (см. RichViewMaxPictureCount). Поэтому не следует хранить ссылку на этот графический объект.

AVAlign вертикальное выравнивание изображения относительно строки.

ATag тег элемента. Используйте SetItemTag или SetPictureInfo для его изменения. Он также может быть получен методом GetItemTag.

 

Дополнительные свойства элемента (включая изменение размера, прозрачность изображений bitmap, имя файла, альтернативный текст для сохранения HTML) возвращаются методами GetItemExtraIntProperty и GetItemExtraStrProperty.

 

См. также методы:

SetPictureInfo;

GetItemStyle;

GetItemExtraIntProperty;

GetItemExtraStrProperty.

См. также свойства:

ItemCount.

См. также:

Получение элементов документа;

Типы элементов документа;

Теги.