UIshell

Synopsis

parent object of other widgets

UIdecorContainer+OPort UIshell<NEvisible=1> {
       x = ;
       y = ;
       width = 300;
       height = 300;
       string title=> name_of(<-,1);
       string iconName;
       Boolean &iconic = 0;
       UIcmdList+IPort2 &menu;
       string display;

       parent {
              shellParent = 1;
              };
       int cancel;
       Boolean showStatusBar=0;
       string statusString;

omethod+notify_inst+notify update<NEvisible=0,lang="cxx",interruptable=0>="UIshellUpdate"};

Description

A UIshell is a window that holds other widgets. It, along with its alternative UIapp, is the parent object of the UIpanelwidgets on which all other visible widgets are placed.

The UIapp reference page lists the differences between UIapp and UIshell:

In Motif, UIshells do not require a parent. They are managed by the window manager. In Windows, UIshells require a UIapp as parent.

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

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

motif_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

String. Specifies the string that labels the window at the top of the window manager's title bar. The default is "UIshell".

This value is read only.

iconName

String. Specifies the string that labels the window when it is iconified (Motif). The default is the value for title.

This value is read only.

&iconic

Boolean. Flag that indicates and sets the iconic status of the UIshell. 1=iconified; 0=not iconified. The default is 0.

This value is read/write.

&menu

See UIcmdList . A reference to a UIcmdList that defines a pulldown menu or series of pulldown menus across the top of the UIshell. This menu would provide the basic controls for the window, such as File, Save, Exit, etc.

display

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

shellParent <Not visible in Network Editor> =1

Integer. If =1, UIshells are allowed to have UIshells as parents. This is the default. Notice this sub-object is inherited from the UIconnection class (see above).

cancel

Integer. Set to 1 by the application if the window is closed via the window manager.

showStatusBar =0

Boolean. If = 1, UIshells can display messages in the status bar at the bottom of the window. If=0, disables all status strings. The default is 0. Message is in statusString.

Boolean. If = 1, cursor is made visible in window of attached UI object. If = 0, cursor defaults to default cursor for window.

statusString

String containing message to display in status bar.

Example

Main.Viewers.Viewer3D
v/view.v
Examples.Applications.IsoApp
examples/iso_app.v
Examples.Applications.UIApp
examples/ui_samp.v

File