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 UIshell in 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.

&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