UIapp

Synopsis

Parent object of all interfaces intended to run as standalone applications

UIshell UIapp<inst_func ="UIappInstance"> {
     Boolean &tidyWhenIconified = 1;
     parent<NEportLevels =0> {
          shellParent = -1;
          };

   }

Description

UIapp is defined to act as the parent object of all user interfaces that run as standalone processes.UIapp differs from its base class UIshellin these ways:

UIapp knows about application resources (such as the command line arguments argv and argc). UIshell does not.

UIapps can have no parent objects. UIshells can have a UIapp as a parent.

You must use UIapp if the application will have child UIshells.

In Windows, the child UIshells will be physically within the UIapp window. They will share the UIapp's menubar and message areas -- the data for whichever UIshell is selected will occupy the space.

In Motif, the child UIshells will be physically outside the UIapp window, under independent Motif window management.

UIapp defines the additional subobject &tidyWhenIconified. When set, all child UIshells (if any) are iconified when the UIapp window is iconified.

Subobjects

message

UIdecorContainer class attribute.

x; y;

width=300;

height=300;

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> =1;

canHaveChildren <Not visible in Network Editor> =1(can have children);

UIConnection class attributes inherited from UIwindow

clientWidth; clientHeight;

UIdecorGeom class attributes.

&visible=1;

&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.

title;

iconName;

&iconic;

&menu;

display;

cancel;

showStatusBar =0;

statusString

Attributes inherited from UIshell.

&tidyWhenIconified

Boolean. Flag indicating that when the UIapp window is iconified, all of its child UIshells are also iconified. 1=iconify; 0=don't iconify. The default is 1.

Note: This is not currently implemented; this subobject has no effect.

Example

Examples.Applications.UIapp

examples/ui_samp.v

File

v/UI.v

See Also Related Modules

UIshell