IUP/Attributes/Common/SIZE

From Vendetta Lua
Jump to navigationJump to search

SIZE

Size of the element in units proportional to the size of a character.

Value

"widthxheight", where width and height are integer values corresponding to the horizontal and vertical size, respectively, in characters. When this attribute is not defined it will be calculated to fit the contents of the control.
The element may have only one dimension which is applicable to be modified - for instance, IupText, which has only width. In this case, the second parameter does not need to be passed. You can also change only one of the parameters by removing the other one and maintaining "x". For example: "x40" (height only) or "40x" (width only). The other size will be chosen by IUP depending on the composition elements and on the EXPAND attribute.
Default: Depends on the element and on the element's EXPAND attribute.

Notes

The size observes the following heuristics:
  • Width in 1/4's of the average width of a character.
  • Height in 1/8's of the average height of a character.
When this attribute is changed by means of a call to function IupSetAttribute or IupStoreAttribute, the size will be the minimum size for the element. If you wish to use this size only as an initial size, change this attribute to NULL after the control is mapped, the returned size in IupGetAttribute will still be the current size.

Affects

All.

See Also

EXPAND