Action/MenuAction style attributes
These style attributes apply to default action views (MenuAction
and Action
classes).
scaleIcon
Defines the scaling behavior of the associated icon, if the source image size is bigger than the place reserved for it in the widget.
If the scaleIcon
attribute is undefined, the behavior depends on the type of
action view: toolbar button icons and action panel button icons are scaled down to match the size of
the widget. For other widgets, by default no scaling occurs, as for
scaleIcon="no"
.
"no"
: No scaling occurs and the image is taken as-is. It is up to the developer to resize the source image to avoid misalignment."yes"
: Images are scaled down following the height of the widget (button or edit field). Setting a big font can result in a big icon.
Independently of the scaleIcon
attribute value,to avoid pixelization or
blurring of images, raster images are never upscaled. However, SVG images and TTF icons can
be upscaled without any penalty.
If the icon must be enlarged, the image is centered and a transparent border is added to "fill" the empty space. This allows a mix of larger and smaller icons while keeping widget alignment.
If scaling takes place, the aspect ratio of the original image is kept. A non-square source image displays as a non-square scaled icon.