IUP::Frame - [GUI element] frame with a title around an interface element
Creates a Frame interface element, which draws a frame with a title around an interface element.
$frame = IUP::Frame->new(Ihandle *child);
child: Identifier of an interface element which will receive the frame around. It can be undef.
undef
Returns: the identifier of the created element, or undef if an error occurs.
NOTE: You can pass to new() other ATTRIBUTE=>'value' or CALLBACKNAME=>\&func pairs relevant to this element - see IUP::Manual::02_Elements.
new()
ATTRIBUTE=>'value'
CALLBACKNAME=>\&func
For more info about concept of attributes (setting/getting values etc.) see IUP::Manual::03_Attributes. Attributes specific to this element:
ignored, transparent in all systems. Will use the background color of the native parent. Except if TITLE is not defined and BGCOLOR is defined before map (can be changed later), then the frame will have a color background.
(non inheritable)
The default value is "YES".
Text title color. Not available in Windows when using Windows Visual Styles. Default: the global attribute DLGFGCOLOR.
(creation only)
When not using a title, the frame line defines a sunken area (lowered area). Valid values: YES or NO. Default: NO.
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.
The following common attributes are also accepted:
ACTIVE, FONT, SCREENPOSITION, POSITION, CLIENTSIZE, CLIENTOFFSET, MINSIZE, MAXSIZE, WID, SIZE, RASTERSIZE, ZORDER, VISIBLE
For more info about concept of callbacks (setting callback handlers etc.) see IUP::Manual::04_Callbacks. Callbacks specific to this element:
MAP_CB
UNMAP_CB
In Windows, a Frame with TITLE==undef is not the same control as then TITLE!=undef. When TITLE==undef it does not have Visual Styles and uses a sharp rectangle border. When TITLE!=undef it has Visual Styles and the border is a rounded rectangle. To always use Visual Styles set the title to "" before mapping, but be aware that a vertical space for the title will be always reserved at the top border.
TITLE==undef
TITLE!=undef
The frame can be created with no elements and be dynamic filled using Append or Insert.
The element IUP::Frame is used in the following sample scripts:
0-basic/cbox.pl - IUP::Cbox example
0-basic/dial.pl - IUP::Dial example
0-basic/fill.pl - IUP::Fill Example
0-basic/frame1.pl - IUP::Frame Example
0-basic/frame2.pl - IUP::Image example
0-basic/gridbox.pl - IUP::GridBox example
0-basic/hbox.pl - IUP::Hbox example
0-basic/image.pl - IUP::Image example
0-basic/layoutdialog.pl - IUP::LayoutDialog example
0-basic/list1.pl - IUP::List example
0-basic/plot_advanced.pl - Plot controls
0-basic/radio.pl - IUP::Radio example
0-basic/val.pl - IUP::Val example
0-basic/vbox.pl - IUP::Vbox example
0-basic/zbox.pl - IUP::Zbox example
1-apps/app-mdi.pl - IUP app example
1-apps/app-plot-demo.pl - dials for zooming
1-apps/app-sample1.pl - example used for screenshot - IUP.pod
1-apps/app-sample2.pl - example based on the original sample.c
1-apps/app-simple-demo.pl - example used for screenshot - IUP.pod
The original doc: iupframe.html
To install IUP, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IUP
CPAN shell
perl -MCPAN -e shell install IUP
For more information on module installation, please visit the detailed CPAN module installation guide.