diff --git a/docs/xml/lcl/menus.xml b/docs/xml/lcl/menus.xml index 05a0c6b504..6b9f293df2 100644 --- a/docs/xml/lcl/menus.xml +++ b/docs/xml/lcl/menus.xml @@ -2417,22 +2417,38 @@ Indicates whether a TBitmap instance has been assigned to the Bitmap property. -Gets the size for the icon (glyph) used on the menu item. +Gets the size for the icon (glyph) when used on the menu item.

-The return value is a TPoint instance with the Width and Height -for the glyph displayed on the menu item. +The return value is a TPoint instance with the Width (X) and Height +(y) for the glyph displayed on the menu item. The return value is an empty +TPoint instance if HasIcon returns False.

-Calls HasIcon to determine if GlyphShowMode allows (or -requires) a glyph to be displayed for the menu item, and whether image(s) are -available. When HasIcon returns True, the images available for the -menu item are retrieved to get the Width and Height required for the device -context in ADC. If an image list is not available, the Width and -Height in Bitmap are used in the return value. +If HasIcon returns True, GetImageList is called to get the +images and their Width. If ImageIndex does not exist in the image list, the +method is exited with an empty TPoint instance in the return value. +

+

+DPI indicates the Dots Per Inch requested for the icon image. When +DPI contains the default value (0), GetDeviceCaps is called to get the logical +pixel size for the device context in the ADC argument. The SizeForPPI method +in the image list is called to get the size for the scaled image resolution +for the DPI value. The size information is stored in the return value. +

+

+If an image list has not been assigned to Images or SubMenuImages, the Width +and Height values in Bitmap as used in the return value. +

+

+GetIconSize is called when a widgetset class renders the menu or menu item to +the device context for its window Handle.

+ +Modified in LCL version 2.4 to include the DPI argument. +
@@ -2446,11 +2462,17 @@ item. Device context used to get the display density (PPI) for the glyph images. + + +DPI setting used to scale the icon images retrieved in the method to the +monitor where menu item is displayed. + + -Removes all handlers for the specified object instance from the internal list -of handlers. +Removes all handler routines for the specified object instance from the +internal handler lists.