Global attributes are not associated with any particular element. They represent and affect the global behavior of the toolkit.
To access global attributes use the IupGetGlobal and IupSetGlobal functions. In Lua global attributes can only be accessed trough those functions. In C, the functions IupGetAttribute and IupSetAttribute can also be used if you set the element handle to NULL.
The language used by some pre-defined dialogs.
Can have the values ENGLISH and PORTUGUESE. Default: ENGLISH. Can also be set by IupSetLanguage.
Returns the name of IUP's version.
The value follows the "major.minor.micro" format, major referring to broader changes, minor referring to smaller changes, and micro referring to corrections only. Ex.: "1.7.2".
Returns the IUP's copyright.
Ex: "Copyright (C) 1994-2013 Tecgraf/PUC-Rio".
If an error is found, returns a string with the system error description.
If defined allow IUP to be used inside coroutines in Lua.
Informs the current driver being used.
Two drivers are available now, one for each platform: "GTK", "Motif" and "Win32".
When the last visible dialog is closed the IupExitLoop function is called. To avoid that set LOCKLOOP=YES before hiding the last dialog. Possible values: "YES" or "NO". Default: "NO".
By default IUP uses strings in the current locale (See FONT attribute). To use UTF-8 strings set this attribute to Yes. Default: NO.
By default IUP uses file names in the current locale, even when UTF8MODE=Yes. To use UTF-8 file names set this attribute to Yes. Default: NO.
Force the display of images in menus. Default: Yes
Flag indicating that GTK is using a global menu instead of a per window menu. See more information at the GTK driver documentation.
Restricts the number of instances of the application by using a name to identify it. The value must also be a partial match to the title of a dialog that will receive the COPYDATA_CB callback with the command line of the second instance. When consulted returns NULL if inside the second instance. So usually in the application initialization after IupOpen, set SINGLEINSTANCE and then consult its value, if NULL abort the second instance by calling IupClose and returning from main.
Controls and returns the cursor position in absolute coordinates relative to the upper left corner of the screen. Accept values in the format "XxY" (in C "%dx%d), example "200x200". In GTK and Motif also generates mouse motion messages. (since GTK 2.8)
Simulates a mouse button press, release or motion at the given coordinates. The position is in absolute coordinates relative to the upper left corner of the screen. Accept values in the format "XxY button state" (in C "%dx%d %c %d"), example "200x200 1 1". button can be one of the IUP_BUTTON1,... definitions. state can be 2=double click, 1=pressed, 0=released, or -1=motion. The cursor position is always updated. In Windows button can be 'W' and state=delta, so a wheel button scroll is simulated.
IMPORTANT: not fully working. In Windows and GTK, menu items are not activated. Although submenus open, menu items even in the menu bar are not activated. In Windows, inside the IupFileDlg dialog, clicks in the folder navigation list are not correctly interpreted. In Motif click and drag operations are not performed.
Returns the state of the Shit keys (left and right). Possible values: "ON" or "OFF".
Returns the state of the Control keys (left and right). Possible values: "ON" or "OFF".
Returns the state of the keyboard modifier keys: Shift, Ctrl, Alt and sYs(Win/Apple). In the format of 4 characters: "SCAY". When not pressed the respective letter is replaced by a space " ".
Sends a key press message to the element with the focus. The value is a key code. See the Keyboard Codes table for a list of the possible values.
Sends a key release message to the element with the focus. The value is a key code. See the Keyboard Codes table for a list of the possible values.
Sends a key press and a key release messages to the element with the focus. The value is a key code. See the Keyboard Codes table for a list of the possible values.
Turns on/off ("YES" or "NO") the auto-repeat of keyboard keys in the whole system. May be used as an optimization in high performance applications.
Turns on/off ("YES" or "NO") the global callbacks used to intercept global mouse and keyboard events. The callbacks must be set using the IupSetFunction function using the following names: GLOBALKEYPRESS_CB, GLOBALMOTION_CB, GLOBALBUTTON_CB and GLOBALWHEEL_CB (Windows Only). Their parameters are the same as the standard callbacks, but without the Ihandle* parameter.
In Lua use the iup.SetGlobalCallback(name, func) function. (since 3.7)
Informs the current operating system. On UNIX, it is equivalent to the command "uname -s" (sysname). On Windows, it identifies if you are on Windows 2000, Windows XP or Windows Vista. Some known names:
- "MacOS"
- "FreeBSD"
- "Linux"
- "SunOS"
- "Solaris"
- "IRIX"
- "AIX"
- "HP-UX"
- "Win2K"
- "WinXP"
- "Vista"
- "Win7"
- "Win8"
Informs the current operating system version number.
On UNIX, it is equivalent to the command "uname -r" (release). On Windows, it identifies the system version number and service pack version. On MacOSX is system version.
Returns a text with a description of the system language.
Returns a text with a description of the system locale.
Returns the width of the vertical scrollbar (the same as the height of the horizontal scrollbar).
Returns the run time version of the GTK toolkit. This is the version being used at the time of the IupOpen function was called by the application.
Returns the development version of the GTK toolkit. This is the version at the time the IUP library was compiled.
Returns the version of the run time Motif.
Returns the number of the Motif Version if full form, e.x: 2.2.3 = "2203".
Returns the hostname.
Returns the user logged in.
X-Windows Server Vendor string.
X-Windows Server Vendor release number.
Returns the full screen size in pixels.
String in the "widthxheight" format.
Returns the screen size in pixels available for dialogs, i.e. not including menu bars, task bars, etc. In Motif has the same value as the FULLSIZE attribute. The main screen size does not include additional monitors.
String in the "widthxheight" format.
Returns the screen depth in bits per pixel.
Returns the screen resolution in dots or pixels per inch (DPI).
Indicates if the display allows creating TrueColor (> 8bpp) IupCanvas controls, even if PseudoColor is the default, i.e. even if SCREENDEPTH<=8 . Returns "YES" or "NO". Usefull in Motif.
Returns the virtual screen position and size in pixels. It is the virtual space defined by all monitors in the system.
String in the "x y width height" format.
Returns the position and size in pixels of all monitors. Each monitor information is terminated by a "\n" character.
String in the "x y width height\nx y width height\n..." format.
Returns a handle (HINSTANCE) that identifies the application in the native system.
Changes and returns a handle (HINSTANCE) that identifies the DLL where resources are stored.
Returns the shell Widget created by XtOpenApplication.
Returns the X-Windows Display.
Returns the X-Windows Screen.
The default background color for all elements that have the background similar of the dialog.
The default foreground color for all elements that have text over the background of the dialog or similar. Usually is "0 0 0".
The default menu background color. Usually is "255 255 255".
The default menu foreground color. Usually is "0 0 0".
The default background color for editable text, also used by lists and tree. Usually is "255 255 255".
The default foreground color for editable text, also used by lists and tree. Usually is "0 0 0".
The default foreground color for linked text. In GTK and Motif is "0 0 238".
The default font used by all elements, except for menus.
Auxiliar attribute to retrieve and set the default font size used by all elements. It retrieves the size from DEFAULTFONT. When changed will actually change the DEFAULTFONT.