UIdialog

Synopsis

base class for all dialog objects in the UI kit

UIdecorContainer UIdialog<cxx_name="UI_UIdialog"> {
       string+IPort2 title=> name_of(<-,1); /* Appears on the        window title */
       int+IPort isModal; /* 1 -> thedialog is modal */
       Boolean autoUnmanage=1; /* Dflt == True */
       Boolean destroyOnUnmanage=0; /* Default */
       int+IPort ok; /* OK button has been pressed */
       int cancel; /* Cancel button has been pressed */
       /* or window has been closed by WM */

       /* If okButton or cancelButton are not set or have a value of 1 (1) * the buttons will be visible. */

       Boolean okButton;
       string okLabelString;
  
       /* Effect the text displayed on the OK and Cancel buttons of the dialog. */

       Boolean cancelButton;
       string cancelLabelString;
       string display; /* Can set to another X display name */
       visible = 0;
  };

Description

UIdialog is the base class for all dialog objects in the UI Kit.

A UIdialog is not instantiable.

Although UIdialog does not require a parent, it is best to assign one ( UIapp or UIshell). A UIdialog whose isModal is on and that has no parent stops input from getting to any interface in the same process.

UIdialogs are alway stacked on top of their parent so that the parent never obscures its child UIdialogs.

A UIdialog cannot be iconified.

Subobjects

message

UIdecorContainer class attribute.

x; y;

width; height;

UIgeom class attributes.

clientWidth; clientHeight

UIdecorgeom class attributes

parent;

grouptoParent;

&cursor;

events <Not visible in Network Editor>;

UIwindow class attributes

shellParent <Not visible in Network Editor>;

canHaveChildren <Not visible in Network Editor>

UIconnection class attributes inherited from UIwindow.

&visible=0;

&active;

pixmap;

color;

fontAttribute;

fontlist <No longer used. Not visible in Network Editor>;

cxxhandle <Internal Object. Not visible in Network Editor>;

handle <Internal Object. Not visible in Network Editor>;;

motif_resources <No longer used. Not visible in Network Editor>;

window_resources <No longer used. Not visible in Network Editor>;

layout <No longer used. Not visible in Network Editor>

Attributes inherited from UIcore class through UIwindow class.

title

(String. IPort.) Sets the title to display on the dialog's window decoration.

isModal

(Integer. IPort). When on, windows in the interface of the parent window do not accept input until the dialog is popped down. 1=on; 0=off

autoUnmanage

(Boolean). If off, a UIdialog can be popped down by selecting the OK or the Cancel button. 1=on; 0=off. The default is 1.

destroyOnUnmanage

(Boolean). 1=on; 0=off. The default is 0.

ok

(Integer. IPort). Value changes when the OK button is pressed.

cancel

(Integer) Value changes when the Cancel button has been pressed, or the window has been closed by the Window Manager.

okButton

(Boolean.) If okButton is not set or is 1, the OK button is visible.

okLabelString

(String.) Sets the text on the OK button.

cancelButton

(Integer.) If cancelButton is not set or is 1, the Cancel button is visible

cancelLabelString

(String.) Sets the text on the Cancel button.

display

(String.) Sets the name of the X11 display (on Unix systems only). The dialog window appears on the named X11 display if it is available.

Example

Examples.Applications.UIApp
examples/ui_samp.v
Main.Filters.extract_component
v/modules.v

File

v/UI.v

See Also Related Modules

UImessageBox

UIprimitive

UIfileDialog

UIsliderUnbnd