UIfileDialog

Synopsis

a file selection dialog

UIdialog UIfileDialog {
       int applyButton;
       string applyLabelString;
       string+OPort2 filename;
       enum typeMask{choices={"directorey","file","any"};};
       string typeMask<NEvisible=0>= "file";
       string searchPattern;
       int confirmFileWrite;

    method_inst inst<NEvisible=0,lang="cxx",interruptable=0>="UIfileSBInstance";
    method_val update<NEvisible=0,lang="cxx",interruptable=0>="UIfileSBUpdate";
    #ifdef MSDOS
    method_del delete<NEvisible=0,lang="cxx",interruptable=0>= "UIfileSBDestroy";
    #endif
    };

Description

UIfileDialog is a UIdialog that lets a user select a file for input or output. A UIfileSB is an older, deprecated no longer used version of UIfileDialog.

A UIdialog is not instantiable.

A UIdialog does not require a parent, but 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 always stack on top of their parent, so that the parent never obscures its child UIdialogs.

A UIdialog cannot be iconified.

Subobjects

title;

isModal;

autoUnmanage;

destroyOnUnmanage;

ok;

cancel;

okButton;

okLabelString;

cancelButton;

cancelLabelString;

display

Attributes inherited from UIdialog.

Message

Attribute inherited from UIcore class through UIwindow.

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> =0(cannot have children)

UIconnection class attributes inherited from UIwindow.

&visible;

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

applyButton

Integer. The applyButton works like an OK button, except that the dialog remains after it is pressed. 0=not visible; 1=visible.

applyLabelString

String. Sets the text on the applyButton.

filename

(String. OPort.) The selected filename. This should connect to the object that creates the output file.

This subobject is read/write so that it can provide a default filename.

typeMask

(enum) Sets the type of file to display in the file list: a choice of directories, files, or both types. This value fixes the enums.

searchPattern

String. Defines the pattern string used to determine the files that the dialog displays. An * is interpreted as a wildcard.

confirmFileWrite

(Integer) When on (any non-zero value), a confirmation dialog is displayed if the user presses OK while the current filename is the name of an existing file. In addition, an error dialog is displayed if the user does not have write permission for the selected file. The default is 0.

Example

Main.Input.Read_Field
v/modules.v
Examples.Applications.UIApp

examples/ui_samp.v
AVS5_Modules.Data_Input.Read_Field
v/ACUmods.v

File

v/UI.v

See Also Related Modules

UIdialog

UImessageBox

UIprimitive

UIsliderUnbnd