IUP - Portable User Interface


Creates a Frame interface element, which draws a frame with a title around an interface element.


Ihandle* IupFrame(Ihandle *element); [in C]
iup.frame{element: ihandle} -> (elem: ihandle) [in Lua]
frame(element) [in LED]

element: Identifier of an interface element which will receive the frame.

This function returns the identifier of the created frame, or NULL if an error occurs.


FGCOLOR: Text color.

SIZE: Frame size.

TITLE: Text the user will see at the top of the frame. If not defined during creation it can not be added lately, to be changed it must be at least "" during creation.

MARGIN: Margin of the visible element. Its value has the format "widthxheight", where width and height are integer values corresponding to the horizontal and vertical margins, respectively. Default: "0x0" (no margin).

SUNKEN: (Windows Only) When not using a title, the frame line defines a sunken area (lowered area). Valid values: YES or NO. Default: NO.


Though this element has the attribute MARGIN, it does not have the attributes ALIGNMENT and GAP, because it can contain only one element.

The BGCOLOR attribute has no effect.