GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PRIMA::FILEDIALOG (3)

.ds Aq ’

NAME

Prima::FileDialog - File system related widgets and dialogs.

CONTENTS

SYNOPSIS

# open a file
        use Prima qw(Application);
        use Prima::StdDlg;



        my $open = Prima::OpenDialog-> new(
                filter => [
                        [Perl modules => *.pm],
                        [All => *]
                ]
        );
        print $open-> fileName, " is to be opened\n" if $open-> execute;

        # save a file
        my $save = Prima::SaveDialog-> new(
                fileName => $open-> fileName,
        );
        print $save-> fileName, " is to be saved\n" if $save-> execute;

        # open several files
        $open-> multiSelect(1);
        print $open-> fileName, " are to be opened\n" if $open-> execute;



DESCRIPTION

The module contains widgets for file and drive selection, and also standard open file, save file, and change directory dialogs.

Prima::DirectoryListBox

A directory listing list box. Shows the list of subdirectories and upper directories, hierarchy-mapped, with the folder images and outlines.

    Properties

closedGlyphs INTEGER Number of horizontal equal-width images, contained in closedIcon property.

Default value: 1

closedIcon ICON Provides an icon representation for the directories, contained in the current directory.
indent INTEGER A positive integer number of pixels, used for offset of the hierarchy outline.

Default value: 12

openedGlyphs INTEGER Number of horizontal equal-width images, contained in openedIcon property.

Default value: 1

openedIcon OBJECT Provides an icon representation for the directories, contained in the directories above the current directory.
path STRING Runtime-only property. Selects a file system path.
showDotDirs BOOLEAN Selects if the directories with the first dot character are shown the view. The treatment of the dot-prefixed names as hidden is traditional to unix, and is of doubtful use under win32.

Default value: 1

    Methods

files [ FILE_TYPE ] If FILE_TYPE value is not specified, the list of all files in the current directory is returned. If FILE_TYPE is given, only the files of the types are returned. The FILE_TYPE is a string, one of those returned by Prima::Utils::getdir ( see getdir in Prima::Utils.

Prima::DriveComboBox

Provides drive selection combo-box for non-unix systems.

    Properties

firstDrive DRIVE_LETTER Create-only property.

Default value: ’A:’

DRIVE_LETTER can be set to other value to start the drive enumeration from. Some OSes can probe eventual diskette drives inside the drive enumeration routines, so it might be reasonable to set DRIVE_LETTER to C: string for responsiveness increase.

drive DRIVE_LETTER Selects the drive letter.

Default value: ’C:’

Prima::FileDialog

Provides a standard file dialog, allowing to navigate by the file system and select one or many files. The class can operate in two modes - ’open’ and ’save’; these modes are set by Prima::OpenDialog and Prima::SaveDialog. Some properties behave differently depending on the mode, which is stored in openMode property.

    Properties

createPrompt BOOLEAN If 1, and a file selected is nonexistent, asks the user if the file is to be created.

Only actual when openMode is 1.

Default value: 0

defaultExt STRING Selects the file extension, appended to the file name typed by the user, if the extension is not given.

Default value: ’’

directory STRING Selects the currently selected directory.
fileMustExist BOOLEAN If 1, ensures that the file typed by the user exists before closing the dialog.

Default value: 1

fileName STRING, ... For single-file selection, assigns the selected file name, For multiple-file selection, on get-call returns list of the selected files; on set-call, accepts a single string, where the file names are separated by the space character. The eventual space characters must be quoted.
filter ARRAY Contains array of arrays of string pairs, where each pair describes a file type. The first scalar in the pair is the description of the type; the second is a file mask.

Default value: [[ ’All files’ => ’*’]]

filterIndex INTEGER Selects the index in filter array of the currently selected file type.
multiSelect BOOLEAN Selects whether the user can select several ( 1 ) or one ( 0 ) file.

See also: fileName.

noReadOnly BOOLEAN If 1, fails to open a file when it is read-only.

Default value: 0

Only actual when openMode is 0.

noTestFileCreate BOOLEAN If 0, tests if a file selected can be created.

Default value: 0

Only actual when openMode is 0.

overwritePrompt BOOLEAN If 1, asks the user if the file selected is to be overwrittten.

Default value: 1

Only actual when openMode is 0.

openMode BOOLEAN Create-only property.

Selects whether the dialog operates in ’open’ ( 1 ) mode or ’save’ ( 0 ) mode.

pathMustExist BOOLEAN If 1, ensures that the path, types by the user, exists before closing the dialog.

Default value: 1

showDotFiles BOOLEAN Selects if the directories with the first dot character are shown the files view.

Default value: 0

showHelp BOOLEAN Create-only property. If 1, ’Help’ button is inserted in the dialog.

Default value: 1

sorted BOOLEAN Selects whether the file list appears sorted by name ( 1 ) or not ( 0 ).

Default value : 1

system BOOLEAN Create-only property. If set to 1, Prima::FileDialog returns instance of Prima::sys::XXX::FileDialog system-specific file dialog, if available for the XXX platform.

system knows only how to map FileDialog, OpenDialog, and SaveDialog classes onto the system-specific file dialog classes; the inherited classes are not affected.

    Methods

reread Re-reads the currently selected directory.

Prima::OpenDialog

Descendant of Prima::FileDialog, tuned for open-dialog functionality.

Prima::SaveDialog

Descendant of Prima::FileDialog, tuned for save-dialog functionality.

Prima::ChDirDialog

Provides standard dialog with interactive directory selection.

    Properties

directory STRING Selects the directory
showDotDirs Selects if the directories with the first dot character are shown the view.

Default value: 0

showHelp Create-only property. If 1, ’Help’ button is inserted in the dialog.

Default value: 1

AUTHOR

Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

Prima, Prima::Window, Prima::Lists, examples/drivecombo.pl, examples/launch.pl.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PRIMA::FILEDIALOG (3) 2015-11-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.