IRibbonCategory.LargeImages

Синтаксис

LargeImages: IImageList;

Описание

Свойство LargeImages определяет компонент, содержащий большие изображения, которые будут использоваться элементами управления данной вкладки на ленте инструментов.

Комментарии

В качестве значения данного свойства необходимо указать компонент ImageList либо GlobalImageList.

При настройке ленты с определенными элементами управления могут быть связаны какие-либо большие изображения. В рамках отдельной вкладки изображения хранятся в виде коллекции IMAGE_LARGE:

//...

<CATEGORY>

<ELEMENT_NAME>Category</ELEMENT_NAME>

<NAME>Главная</NAME>

<IMAGE_LARGE>

<NAME>IDR_BCGP_IMAGE_CATEGORY_LARGE_0</NAME>

</IMAGE_LARGE>

//...

<CATEGORY>

//...

Определенные элементы управления связаны с изображениями в коллекции по индексам:

//...

<ELEMENT>

<ELEMENT_NAME>Button</ELEMENT_NAME>

<ID>

<NAME>IDC_BUTTON1110</NAME>

<VALUE>1110</VALUE>

</ID>

<TEXT>Button</TEXT>

<INDEX_LARGE>0</INDEX_LARGE>

</ELEMENT>

//...

При загрузке XML-строки ленты среди ресурсов будет произведен поиск изображения, наименование которого совпадает с элементом <Name> тега <IMAGE_LARGE>. Данное изображение должно содержать горизонтальную ленту пиктограмм. При загрузке будет осуществлена разбивка на отдельные пиктограммы и полученные пиктограммы по индексам будут связаны с соответствующими элементами управления.

Если большие пиктограммы отсутствуют в ресурсах, то их можно установить используя данное свойство. Изображения из устанавливаемого компонента также будут загружены по индексам.

Примечание. При динамическом изменении коллекции изображений данного свойства автоматическое обновление изображений в элементах управления не производится. Для применения всех изменений необходимо повторно указать компонент в данном свойстве.

Пример

Использование свойства приведено в примере для IRibbonCategories.Add.

См. также:

IRibbonCategory