Expand/Shrink

IupSetGlobal

Definition: include pGUI.e

IupSetGlobal(string name, atom_string v)
-- or --
IupSetStrGlobal(string name, nullable_string v)
-- or --
IupSetGlobalInt(string name, integer v)
Description: Sets an attribute in the global environment. If the driver process the attribute then it will not be stored internally.

name: name of the attribute.
v: value of the attribute. If it equals NULL (except for IupSetGlobalInt), the attribute will be removed.
Notes: IupSetGlobal can store only constant strings (like "Title", "30", etc) or application pointers.
The given value is not duplicated as a string, only a reference is stored.
Therefore, you can store application custom attributes, such as a context structure to be used in a callback.

IupSetStrGlobal (previously named IupStoreGlobal, still available) can only store strings. The given string value will be duplicated internally.
See Also: IupSetAttribute, IupGetGlobal, Global Attributes