This interface provides methods to manage a menu that uses images rather than text strings to display its options.
Method |
Description |
| IASImageMenu::Add | Adds an item and its associated image to the image menu. |
| IASImageMenu::get_CenteredFocus | Retrieves whether or not centered focus is enabled. |
| IASImageMenu::get_Count | Gets the number of items in the menu. |
| IASImageMenu::get_FocusColor | Gets the color assigned to an image that has the focus. |
| IASImageMenu::get_FocusIndex | Gets the index of the item with the focus. |
| IASImageMenu::get_Horizontal | Retrieves whether the menu scrolls horizontally or vertically. |
| IASImageMenu::get_ImageHeight | Gets the height of an image. |
| IASImageMenu::get_ImageWidth | Gets the width of an image. |
| IASImageMenu::get_ItemHeight | Gets the height of an item. |
| IASImageMenu::get_ItemWidth | Gets the width of an item. |
| IASImageMenu::get_MenuLabel | Gets the Auto PC label control associated with the image menu. |
| IASImageMenu::get_ID | Gets the identifier of a menu item, specified by its index. |
| IASImageMenu::get_Image | Gets the image associated with a menu item, specified by its menu index. |
| IASImageMenu::get_MenuWrap | Retrieves whether or not the menu should wrap at the end of a line of text. |
| IASImageMenu::get_NonFocusImageColor | Gets the color assigned to a non-focused image. |
| IASImageMenu::get_Overlay | Gets an image to display over a focus item or the entire image menu. |
| IASImageMenu::get_OverlayOffset | Gets pointers to the position of the overlay. |
| IASImageMenu::get_String | Gets the string associated with a menu item. |
| IASImageMenu::InsertAt | Inserts an item at a specified index. |
| IASImageMenu::put_CenteredFocus | Sets whether or not centered focus is enabled. |
| IASImageMenu::put_FocusColor | Sets the color assigned to an image that has the focus. |
| IASImageMenu::put_FocusIndex | Gives the focus to the item with the specified index |
| IASImageMenu::put_Horizontal | Sets scrolling to horizontal or vertical. |
| IASImageMenu::put_ImageHeight | Sets the height of an image. |
| IASImageMenu::put_ImageWidth | Sets the width of an image. |
| IASImageMenu::put_ItemHeight | Sets the height of an item. |
| IASImageMenu::put_ItemWidth | Sets the width of an item. |
| IASImageMenu::put_MenuLabel | Specifies an Auto PC label control to be associated with the image menu. |
| IASImageMenu::put_MenuWrap | Sets whether or not a menu should wrap. |
| IASImageMenu::put_NonFocusImageColor | Sets the color for a non-focused image. |
| IASImageMenu::put_Overlay | Sets an image to display over a focus item or the entire image menu. |
| IASImageMenu::put_OverlayOffset | Sets the position of the overlay. |
| IASImageMenu::RemoveAtIndex | Removes an item specified by its index. |
| IASImageMenu::RemoveByID | Removes an item specified by its identifier. |
| IASImageMenu::put_ID | Sets the identifier of a menu item. |
| IASImageMenu::put_Image | Replaces one item image with another. |
| IASImageMenu::put_String | Assigns a string to an item. |
The IASImageMenu interface, which has a global unique identifier (GUID) equal to IID_ASIMAGEMENU, extends the IASControl interface.
When an image item is selected, a WM_COMMAND event is sent to the event sink. The high-order word contains the control’s identifier and the low-order word contains the item’s identifier. The index of the menu item is sent in the lParam. When the focus changes from one item to the next, a WM_COMMAND message is fired to the event sink. The high-order word of wParam contains LBN_SELCHANGE, and the low-order word contains the control’s identifier.