Difference between revisions of "IUP/Dialogs/IupMap"

From Vendetta Lua
Jump to: navigation, search
(Created page with "__NOTOC__ =IupHide= :Hides an interface element. This function has the same effect as attributing value "NO" to the interface element’s VISIBLE attribute. ===Parameters/Re...")
 
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
=IupHide=
+
=IupMap=
  
:Hides an interface element. This function has the same effect as attributing value "NO" to the interface element’s VISIBLE attribute.
+
:Creates native interface objects corresponding to the given IUP interface elements.
  
 
===Parameters/Return===
 
===Parameters/Return===
  
:iup.Hide('''element''': ihandle) -> (ret: number)
+
:iup.Map('''element''': ihandle) -> ret: number
  
:'''element''': Identifier of the interface element.
+
:'''element''': Identifier of an interface element.
  
:This function returns IUP_NOERROR if the element was removed from the screen.
+
===Notes===
  
===Note===
+
:When '''element''' is of type ''dialog'', this function creates the native interface element of a dialog and of each element it contains, but only if the element has not been mapped yet.
  
:Once a dialog is hidden, either by means of IupHide or by changing the VISIBLE attribute or by means of a callback returning IUP_CLOSE, the elements in this dialog are not destroyed, so that you can show them again. To destroy dialogs, the IupDestroy function must be called.
+
:When '''element''' is not of type ''dialog'', this function will only create the native interface element if the element is inside an already mapped dialog.
 +
 
 +
:If '''element''' was already mapped, nothing happens.
 +
 
 +
:This function should always be called before making a dialog visible for the first time.
  
 
===See Also===
 
===See Also===
  
:[[IUP/Dialogs/IupShowXY|IupShowXY]], [[IUP/Dialogs/IupShow|IupShow]], [[IUP/Dialogs/IupPopup|IupPopup]], [[IUP/Dialogs/IupDestroy|IupDestroy]].
+
:[[IUP/Dialogs/IupShowXY|IupShowXY]], [[IUP/Dialogs/IupShow|IupShow]], [[IUP/Dialogs/IupPopup|IupPopup]].

Latest revision as of 05:07, 9 May 2023

IupMap

Creates native interface objects corresponding to the given IUP interface elements.

Parameters/Return

iup.Map(element: ihandle) -> ret: number
element: Identifier of an interface element.

Notes

When element is of type dialog, this function creates the native interface element of a dialog and of each element it contains, but only if the element has not been mapped yet.
When element is not of type dialog, this function will only create the native interface element if the element is inside an already mapped dialog.
If element was already mapped, nothing happens.
This function should always be called before making a dialog visible for the first time.

See Also

IupShowXY, IupShow, IupPopup.