IRibbonCategory.LargeImages

Fore Syntax

LargeImages: IImageList;

Fore.NET Syntax

LargeImages: Prognoz.Platform.Interop.Forms.ImageList;

Description

The LargeImages property determines component that contains the large images that should be used by the control elements of this tab.

Comments

The following component should be set as a value of this property ImageList or GlobalImageList.

When configuring the ribbon, any large images can be connected with the particular control elements. The images are stored as the IMAGE_LARGE collection within the separate tab:

//...

<CATEGORY>

<ELEMENT_NAME>Category</ELEMENT_NAME>

<NAME>Main</NAME>

<IMAGE_LARGE>

<NAME>IDR_BCGP_IMAGE_CATEGORY_LARGE_0</NAME>

</IMAGE_LARGE>

//...

<CATEGORY>

//...

The determined control elements are connected with the images in the collection by indexes:

//...

<ELEMENT>

<ELEMENT_NAME>Button</ELEMENT_NAME>

<ID>

<NAME>IDC_BUTTON1110</NAME>

<VALUE>1110</VALUE>

</ID>

<TEXT>Button</TEXT>

<INDEX_LARGE>0</INDEX_LARGE>

</ELEMENT>

//...

When the XML string of the ribbon is loaded, the image whose name matches the <Name> element of the <IMAGE_LARGE> tag is searched for in resources. This image should contain the horizontal ribbon of icons. During the loading the dividing into separate icons is performed and received icons are connected by indexes with the corresponding control elements.

If there are no large icons in the resources, they can be set using this property. The images from the set component can also be loaded by indexes.

NOTE. When the collection of images of this property is changed dynamically, the images in the control elements are not refreshed automatically. Specify again the component in this property to apply all changes.

Example

The example of use is given in description of the IRibbonCategories.Add method.

See also:

IRibbonCategory