Download Project Management:
Transcript
ih: identifier of the dialog. x: x coordinate of the dialog’s left corner. The following macros are valid: IUP_LEFT: Positions the dialog on the left corner of the screen IUP_CENTER: Horizontally centralizes the dialog on the screen IUP_RIGHT: Positions the dialog on the right corner of the screen IUP_MOUSEPOS: Positions the dialog on the mouse position IUP_CENTERPARENT: Horizontally centralizes the dialog relative to its parent (Since 3.0) IUP_CURRENT: use the current position of the dialog (if used at the first time the dialog is shown, then it is replaced by IUP_CENTERPARENT if PARENTDIALOG is defined or simply by IUP_CENTER). This is the default value in Lua if the parameter is not defined or nil. (Since 3.0) y: y coordinate of the dialog’s upper part. The following macros are valid: IUP_TOP: Positions the dialog on the top of the screen IUP_CENTER: Vertically centralizes the dialog on the screen IUP_BOTTOM: Positions the dialog on the base of the screen IUP_MOUSEPOS: Positions the dialog on the mouse position IUP_CENTERPARENT: Vertically centralizes the dialog relative to its parent (Since 3.0) IUP_CURRENT: use the current position of the dialog (if used at the first time the dialog is shown, then it is replaced by IUP_CENTERPARENT if PARENTDIALOG is defined or simply by IUP_CENTER). This is the default value in Lua if the parameter is not defined or nil.(Since 3.0) This function returns IUP_NOERROR if sucessful. Returns IUP_INVALID if not a dialog. If there was an error returns IUP_ERROR. Notes Will call IupMap for the element. See the PLACEMENT attribute for other position and show options. This function can be executed more than once for the same dialog. This will make the dialog be placed above all other dialogs in the application, changing its Z-order, and update its position and/or size on screen. IMPORTANT: Calling IupShow for a visible dialog shown with IupPopup does nothing. See Also IupShow, IupHide, IupPopup, IupMap IupHide Hides an interface element. This function has the same effect as attributing value "NO" to the interface element’s VISIBLE attribute. Parameters/Return int IupHide(Ihandle *ih); [in C] iup.Hide(ih: ihandle) -> (ret: number) [in Lua] or ih:hide() -> (ret: number) [in Lua] ih: Identifier of the interface element. This function returns IUP_NOERROR always. Notes Once a dialog is hidden, either by means of IupHide or by changing the VISIBLE attribute or by means of a click in the window close button, the elements inside this dialog are not destroyed, so that you can show them again. To destroy dialogs, the IupDestroy function must be called. See Also IupShowXY, IupShow, IupPopup, IupDestroy. Creation Attributes Callbacks Notes Examples See Also IupFileDlg Creates the File Dialog element. It is a predefined dialog for selecting files or a directory. The dialog can be shown with the IupPopup function only. Creation Ihandle* IupFileDlg(void); [in C] iup.filedlg() -> (elem: ihandle) [in Lua] filedlg() [in LED] Returns the identifier of the created dialog, or NULL if an error occurs. Attributes ALLOWNEW: Indicates if non-existent file names are accepted. If equals "NO" and the user specifies a non-existing file, an alert dialog is shown. Default: if the dialog is of type "OPEN", default is "NO"; if the dialog is of type "SAVE", default is "YES". Not used when DIALOGTYPE=DIR. DIALOGTYPE: Type of dialog (Open, Save or Directory). Can have values "OPEN", "SAVE" or "DIR". Default: "OPEN". In Windows, when DIALOGTYPE=DIR the dialog shown is not the same dialog for OPEN and SAVE, this dialog does not have the Help button neither