/usr/dt/share/man/cat1/dtfile.1(/usr/dt/share/man/cat1/dtfile.1)
dtfile(1) USER COMMANDS dtfile(1)
NAME
dtfile - the TED File Manager
SYNOPSIS
dtfile [options...] NOTE: Although dtfile may be invoked
from the command line, developers who wish to interface to
File Manager function should use TED Actions (see RELATED
INFORMATION - TED Actions).
DESCRIPTION
The TED File Manager is the Desktop's primary interface to
the file system. It provides a GUI for file manipulation and
application execution. The main File Manager interface con-
sists of a top-level window which shows the contents of a
single folder or a set of nested folders (folder tree). A
single File Manager process may provide many top-level win-
dows each of which may show the contents of a different
folder. The File Manager has many manipulation features. It
will allow a user to:
- Traverse folders via a double-click, menu options, or
a click-and-type mechanism. - Change folder display
modes (i.e. large icons, small icons, alphabetical
order, date order, single folder, folder tree, etc.)
and filtering options. - Create, move, copy, link, and
delete objects via menu options and/or drag-and-drop.
- Rename objects via menu options or a click-and-type
mechanism. - Modify object file system attributes via
menu options. - Invoke actions (applications such as
Edit or Print) on objects via a double-click, menu
options, or drag-and-drop. - Locate objects by name or
by contents. - Place frequently used objects on a
desktop/workspace.
The File Manager also supports additional features for two
special types of top level windows: application views and
the trash container. Application views are designed to
organize application objects such as actions. Application
view windows have the same general appearance and function
as folder windows with the following exceptions:
- The user is not allowed to traverse above the main
application view. - When a user drags an object from
an application view to another application view or to a
folder, the object is copied to the new location (as
opposed to being moved as is the case in a folder.)
The trash container is designed to be a holding area for
objects that users wish to delete. Like application views,
the trash container window has the same general appearance
as a folder window; however, trash container function
differs as follows: Users may move, restore, or delete a
trash object and may change the display mode for the trash
container. Users MAY NOT:
Unix System LaboratLastschange: 1 August 1995" 1
dtfile(1) USER COMMANDS dtfile(1)
- Traverse out of the trash container. - Copy, rename,
or execute any other manipulation on a trash object.
Key Supported Tasks
Desktop
A Desktop is a place where users can store commonly used
objects for easy access. Within the TED, each workspace is
considered a Desktop. A user may place any object on the
background of a workspace and the object will remain there.
The user can also select actions for that object via a popup
menu which is activated by selecting mouse button 3.
Folder Window
A folder window is a top-level window which shows the con-
tents of a single folder or a set of nested folders (folder
tree). Folder windows may be launched from the Front Panel,
actions, or a command line interface. The objects in a
folder are displayed in a user-selected icon/text combina-
tion. The icon visual shows the icon type. Users can use
menu options to reread folder views, open new folder views,
and to select/unselect all objects in a folder. In tree
mode, buttons next to icons representing subfolders allow
users to expand or collapse folder branches and to control
whether all objects in a folder or only the folder structure
is shown in the window.
Application View Window
A application view window is a top-level window which shows
the contents of a single application folder. An application
folder is a restricted folder which is designed to organize
application objects such as actions. Application views are
launched from the Front Panel or a predefined action.
Trash Container Window
When an object is no longer needed, a user can move the
object to the trash container. The trash container is a res-
tricted folder which is used to store files temporarily
until the user asks to permanently remove them. A user can
view the contents of the trash container in a top level win-
dow which is launched from a menu option in a folder or
application view, the Front Panel, or a predefined action.
Users can also restore objects from the trash container pro-
vided that actions have not been taken to permanently remove
them.
Object Movement and Modification
Menu options are provided which allow users to create
objects, rename objects, copy objects, modify object proper-
ties, and move objects to a desktop or to the trash con-
tainer. (NOTE: In addition to the menu options, users can
rename objects with the following steps: 1. Click mouse but-
ton 1 on the text portion of an object icon, 2. An edit box
Unix System LaboratLastschange: 1 August 1995" 2
dtfile(1) USER COMMANDS dtfile(1)
will appear; type the new file name, 3. Select Enter.)
File System Awareness
The File Manager is file system aware. It can be enabled to
launch dialogs that allow editing of file system specific
parameters (See FILES - dtfile.config).
Object Search
A menu option/dialog box combination is provided to allow
users to search for objects by name or by content. During a
name search, the File Manager looks for an object whose name
matches specified search criteria. During a content search,
the File Manager looks for an object which contains speci-
fied character strings. Content searches are case insensi-
tive. When an object is located, the File Manager can either
open a window to display the folder where the object is
located or place the object on the desktop.
Folder Traversal
Simple folder traversal can be accomplished by double-
clicking on a folder icon. This action displays the contents
of the selected folder. If the user moves the mouse before
releasing the mouse button on the second click of a double
click ("double-click-drag" action), a new window will pop up
to show the contents of the selected folder. The new window
will be placed at the position where the user released the
mouse button. In addition, the File Manager provides the
following folder traversal mechanisms:
This dialog lists folders that are frequently used. A
user may traverse to a new folder by double-clicking on
a folder in this list.
Click-and-Type Mechanism
When a user clicks on the "Text Path", it is
remapped to a text edit widget. Again the
user may traverse to a new folder by typing a
new folder title and then selecting Enter.
Iconic Path Selection
If a user double-clicks on a folder icon in
the iconic path, the File Manager will update
the current window to show the contents of
the selected folder.
Find Dialog This dialog searches the file system for a
folder or folders whose name(s) match user-
supplied criteria. The user may open new win-
dows for folders located by the Find dialog.
Home and Up Menu Options
These options allow the user to traverse to
Unix System LaboratLastschange: 1 August 1995" 3
dtfile(1) USER COMMANDS dtfile(1)
$HOME and parent folders respectively.
Tree Display Mode
In this mode, the folder hierarchy is
displayed as a tree that can be traversed by
selecting the buttons located next to the
folder icons (See Tree Mode below)
Tree Mode In tree mode, the current folder and its sub-
folders are shown initially. Traversing into
subfolders can be accomplished by single-
clicking on the button next to the folder
icon. Clicking the left mouse button over the
folder button cycles through three states:
partially expanded, fully expanded, and col-
lapsed. Clicking the middle mouse button
cycles through these three states in reverse
order. When the user first clicks on the
folder button, the contents of the subfolder
are read and added to the tree (partially
expanded state). If the user clicks on the
button a second time, the non-folder contents
of the folder are added to the tree (fully
expanded state). If the user clicks on the
button a third time, the folder contents are
removed from the tree (collapsed state). If a
folder does not have subfolders, the par-
tially expanded state is skipped. If a folder
does not contain non-folder objects, the
fully expanded state is skipped. If a folder
is empty, the folder button is desensitized.
Setting Display Preferences
The File Manager provides many options for displaying
objects. For example, objects can be displayed in iconic or
non-iconic formats. The user may also choose to position
files in either a grid or random pattern. (NOTE: The File
Manager provides a Clean Up menu option which can be used to
align randomly placed objects to a grid pattern.) If the
user has write permission in a folder and the user chooses
to randomly place files, the positioning information is
saved when the user leaves the folder. Therefore, each time
the user reenters the folder the files will be positioned as
they were when the user left the folder.
Object Filtering
Folders can contain many different types of objects. The
File Manager's filtering mechanism allows the user to selec-
tively display objects depending on their type. The File
Manager also provides a Show Hidden Files menu toggle option
which allows the user to turn the filtering mechanism on and
off.
Unix System LaboratLastschange: 1 August 1995" 4
dtfile(1) USER COMMANDS dtfile(1)
Object Type/Action Association
When an object is selected, the File Manager builds an
Actions menu for that object based on the type of the
object. For example, data files are provided with a menu
containing the following actions: Open, Print. Folders are
provided with a menu containing: OpenNewView, OpenInPlace.
Actions can be run on an object by selecting an object and
then selecting an action from the Actions menu. Also,
double-clicking on an object will activate the default
action for the object.
Quick Help
The File Manager provides quick help via F1 throughout the
dtfile application. This includes quick help on object
icons. To access quick help, position the cursor/pointer
over the item for which you wish to get help, then press F1.
Popup Menus
The File Manager provides popup menus for objects within a
File Manager view or on the Desktop. To access the popup
menu for a particular object, position the cursor over the
object and press and hold mouse button 3. A popup menu will
appear. The menu will contain a list of the actions which
can be performed on that particular object. If multiple
objects are selected, the popup menu will show all of those
actions which can be done on all of the selected objects at
once.
Direct Manipulation
Objects can be dragged between different File Manager views,
to Desktops, and to cooperating clients. Direct manipulation
may be used to copy, move, or link objects as well as to
supply objects as input to applications. See the REGISTERING
OBJECTS AS DROP SITES section.
The File Manager also supports drops of buffers on its views
and objects such as TED Mailer attachments.
Terminal Access
A menu option is provided which gives users access to termi-
nal windows.
Exit Services
Menu options are provided which allow users to close File
Manager views and which allow users to save setting informa-
tion before exiting a File Manager session.
Object Name Completion
The File Manager supports object name completion in the fol-
lowing text widgets: the "Text path", the "Destination
Folder" field of the "Go To" dialog, the "Search Folder"
Unix System LaboratLastschange: 1 August 1995" 5
dtfile(1) USER COMMANDS dtfile(1)
field of the "Find" dialog. Press the spacebar and the name
will complete to the extent that it can.
Multibyte Character Set Support
The File Manager is fully internationalized. It supports
both single-byte and multi-byte locales.
Error Condition Notification
The File Manager uses dialog boxes to report various error
conditions.
OPTIONS
The following options are available from the command line:
-noview
Dtfile runs in "server mode". In other words, a window is
not displayed until a cooperating client makes a request to
display a folder.
-session session_file
Dtfile runs with the session file specified in the
session_file parameter. Session files are generated as a
dtfile session shuts down.
-dir folder
OR
-folder folder
Dtfile displays a window for each folder specified in the
folder parameter (Note: No spaces are allowed in folder). If
this option is not used, the user's current folder (the
folder from which dtfile was started) is displayed.
-title title_name
This option allows the user to specify a title (title_name)
for the File Manager windows. All windows and dialogs gen-
erated by this session will use this title. If this option
is not used, the name of the folder shown in a window will
be used as the window title.
-help_volume help_volume_name
This option allows the user to specify a help volume
(help_volume_name) to use with the File Manager windows.
This option is useful if the user is using the File Manager
to display a specific folder and wants to have specific help
for that folder. Note: All File Manager views that are
created from this folder will also use this help volume.
Unix System LaboratLastschange: 1 August 1995" 6
dtfile(1) USER COMMANDS dtfile(1)
-restricted
Dtfile will not display folders above the restricted folder.
If the -dir option is used, the folder specified by that
option is the restricted folder. If the -dir option is not
used, the user's current folder is the restricted folder.
-grid on/off
Dtfile displays files in a pattern specified by the on/off
parameter. As the name implies, on/off will either have a
value of on or a value of off.
on Files are always displayed in a grid pattern.
The File Manager automatically rearranges the
files if a file is moved. This is the
default pattern.
off Files are always displayed where they are
placed by the user. The File Manager does not
rearrange the files.
-tree on/off
This option controls whether Dtfile displays files in single
folder mode (off) or in folder tree mode (on).
-tree_files never/always/choose
This option controls whether or not files may be displayed
in the folder tree mode.
never Files are never displayed. The user may tog-
gle between two states: partially expanded
and collapsed.
always Files are always displayed. The user may tog-
gle between two states: fully expanded and
collapsed.
choose Files may or may not be displayed. The user
may toggle between three states: partially
expanded, fully expanded, or collapsed.
-order order_type
Dtfile displays files in the order specified by the
order_type parameter. Order_type must have one of the fol-
lowing values:
alphabetical Files are displayed in alphabetical order.
This is the default order.
file_type Files are displayed in groups based on their
filetypes.
Unix System LaboratLastschange: 1 August 1995" 7
dtfile(1) USER COMMANDS dtfile(1)
date Files are displayed in an order based on the
date when they were last modified.
size Files are displayed in an order based on
their size.
-view view_type
Dtfile displays files in the format specified by the
view_type parameter. View_type must have one of the follow-
ing values:
no_icon Files are displayed by name.
large_icon Files are displayed by name and large icon.
The icon shows the type of the file. This is
the default format.
small_icon Files are displayed by name and small icon.
The icon shows the type of the file.
attributes Files are displayed by attributes. A small
icon is used to represent the file type.
(This format is similar to the listing
obtained by issuing ls -l from an aixterm
command line.)
-direction direction
Dtfile displays files in the direction specified by the
direction parameter. Direction must have one of the follow-
ing values:
ascending Files are displayed in an ascending direc-
tion. This is the default direction.
descending Files are displayed in a descending direc-
tion. Both the -noview and the -session
options are normally used by the session
manger to start dtfile. The -title,
-help_volume, and -restricted options can
also be set via resources (See the RESOURCES
section.) The -grid, -tree, -treefiles,
-order, -view, and -direction options can
also be set by 1) selecting the Set Prefer-
ences option from the View pulldown menu or
by 2) resources (See the RESOURCES section.)
-small_icon_width size
The default small icon width is 24 pixels. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this option to specify small icon width. Size must
be in pixel.
Unix System LaboratLastschange: 1 August 1995" 8
dtfile(1) USER COMMANDS dtfile(1)
-small_icon_height size
The default small icon height is 24 pixels. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this option to specify small icon height. Size
must be in pixel.
-large_icon_width size
The default large icon width is 38 pixels. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this option to specify large icon width. Size must
be in pixel.
-large_icon_height size
The default large icon height is 38 pixels. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this option to specify large icon height. Size
must be in pixel.
EXAMPLES
dtfile -view no_icon -order date -direction
The File Manager will display files in text format, ordered
by date, most current to oldest date.
dtfile -dir /u/guest -restricted
The File Manager will begin execution by displaying a window
showing the /u/guest folder. The user will not be allowed to
navigate above this folder.
dtfile -session session.jan.12
The File Manager will run with the session file called
session.jan.12.
RESOURCES
Name Class Type Default
dirWidth DirWidth XmRDimension 555
dirHeight DirHeight XmRDimension 305
appWidth AppWidth XmRDimension 365
appHeight AppHeight XmRDimension 365
rereadTime RereadTime XmRInt 10
(s)
checkBrokenLink CheckBrokenLink XmRInt 180
(s)
maxDirectoryProcesses MaxDirectoryProcesses XmRInt 10
maxRereadProcesses MaxRereadProcesses XmRInt 5
maxRereadProcsPerTick MaxRereadProcsPerTick XmRInt 1
moveThreshold MoveThreshold XmRInt 4
(pix)
title Title XmRString NULL
rootTitle RootTitle XmRString
"ROOT"
Unix System LaboratLastschange: 1 August 1995" 9
dtfile(1) USER COMMANDS dtfile(1)
help_volume Help_volume XmRString NULL
fileManagerIcon FileManagerIcon XmRString
home.i.bm
restrictMode RestrictMode XmRBoolean
false
showFilesystem ShowFilesystem XmRBoolean true
grid Grid string on
treeView TreeView string off
treeFiles TreeFiles string
never
order Order string
alpha
view View string
large_icon
direction Direction string
ascend
desktopIcon DesktopIcon string
large
objectPlacement ObjectPlacement string top
rt
openFolder OpenFolder string
current
smallIconWidth SmallIconWidth XmRInt 16
smallIconHeight SmallIconHeight XmRInt 16
largeIconWidth LargeIconWidth XmRInt 32
largeIconHeight LargeIconHeight XmRInt 32
Dtfile *dirWidth:
Specifies the width of a File Manager folder window.
Dtfile *dirHeight:
Specifies the height of a File Manager folder window.
Dtfile *appWidth:
Specifies the width of a File Manager application view win-
dow
Dtfile *appHeight:
Specifies the height of a File Manager application view win-
dow.
Dtfile *rereadTime:
Determines how often the File Manager rereads the open fold-
ers and monitors the Desktop objects. This resource must be
specified in seconds. If it is set to 0, the reread will not
occur and the user must manually reread the folders. This
will conserve processor cycles but may cause views to become
stale as well.
Unix System LaboratLastschange: 1 August 1995" 10
dtfile(1) USER COMMANDS dtfile(1)
Dtfile *checkBrokenLink
Determines how often the File Manager checks open folders
for broken links. This resource must be specified in
seconds. If it is set to 0, the check for broken links will
not occur.
Dtfile *maxDirectoryProcesses:
Specifies the maximum number of background processes which
may be devoted to folder activities (ie. reading the folder,
updating the folder, writing positional information for the
folder, checking for broken links or checking for other
folder updates).
Dtfile *maxRereadProcesses:
Specifies the maximum number of background processes which
may be devoted to folder reread activities (ie. checking for
broken links or checking for other folder updates).
Dtfile *maxRereadProcsPerTick:
Specifies the number of reread processes that may be started
per reread timer tick. In other words, the currently
displayed folders will be checked for changes in a round-
robin fashion, x folders per timer tick where x is equal to
maxRereadProcsPerTick.
Dtfile *moveThreshold:
Specifies the number of pixels that the cursor must move
while a button is held down before the drag controller
recognizes the button down action as a drag.
Dtfile *title:
Specifies the title for all File Manager windows. If this
resource is set to NULL, then the title of each File Manger
window will be the name of the folder displayed in the win-
dow.
Dtfile *rootTitle:
Specifies the title of the root folder. This title will
appear in the title bar of any File Manager window which is
showing the root folder. It will also be the name shown with
the icon representing the root folder on the Desktop.
Dtfile *help_volume:
Specifies the help volume.
Dtfile *fileManagerIcon :
Specifies the icon to display when a File Manager window is
minimized.
Unix System LaboratLastschange: 1 August 1995" 11
dtfile(1) USER COMMANDS dtfile(1)
Dtfile *restrictMode :
Determines whether or not the user is operating in res-
tricted mode. If this resource is set to true, the user is
operating in restricted mode. The user is restricted to the
user's $HOME folder and below. All folder change requests
are interpreted relative to the user's $HOME folder. All
folders above the user's $HOME folder are hidden from the
user. If this resource is set to false, the user's folder
requests are not limited in any way.
Dtfile *showFilesystem :
Determines whether or not the path name for the current
folder is visible. If this resource is set to TRUE, the path
name is visible. If it is set to FALSE, the path name is not
visible. This resource can be used to hide the file system
from the user.
Dtfile *grid :
Determines the pattern used to display files. This resource
must have one of two values:
on Files are always displayed in a grid pattern.
The File Manager automatically rearranges the
files if a file is moved. This is the
default pattern.
off Files are always displayed where they are
placed by the user. The File Manager does not
rearrange the files.
Dtfile treeView :
Determines whether files are displayed in single folder mode
(on) or folder tree mode (off).
Dtfile *treeFiles :
This folder tree mode.
never Files are never displayed. The user may tog-
gle between two states: partially expanded
and collapsed.
always Files are always displayed. The user may tog-
gle between two states: fully expanded and
collapsed.
choose Files may or may not be displayed. The user
may toggle between three states: partially
expanded, fully expanded, or collapsed.
Unix System LaboratLastschange: 1 August 1995" 12
dtfile(1) USER COMMANDS dtfile(1)
Dtfile *order :
Determines the order used to display files. This resource
must have one of four values:
alphabetical Files are displayed in alphabetical order.
This is the default order.
file_type Files are displayed in groups based on their
filetypes.
date Files are displayed in an order based on the
date when they were last modified.
size Files are displayed in an order based on
their size.
Dtfile *view :
Determines the format used to display files. This resource
must have one of four values:
no_icon Files are displayed by name.
large_icon Files are displayed by name and large icon.
The icon shows the type of the file. This is
the default format.
small_icon Files are displayed by name and small icon.
The icon shows the type of the file.
attributes Files are displayed by attributes. A small
icon is used to represent the file type.
(This format is similar to the listing
obtained by issuing ls -l from an aixterm
command line.)
Dtfile *direction :
Determines the direction used to display files. This
resource must have one of two values:
ascending Files are displayed in an ascending direc-
tion. This is the default direction.
descending Files are displayed in a descending direc-
tion.
Dtfile *desktopIcon :
Determines the type of icon used to represent files/folders
on the Desktop. This resource must have one of two values:
large Large icons are used to represent
files/folders on the Desktop.
Unix System LaboratLastschange: 1 August 1995" 13
dtfile(1) USER COMMANDS dtfile(1)
small Small icons are used top represent
files/folders on the Desktop.
Dtfile *objectPlacement:
Specifies the placement scheme used to place objects on the
Desktop. This resource has the following syntax:
primary_layout secondary_layout. The primary_layout deter-
mines whether an object placed on the Desktop is put into a
row or a column. The secondary_layout determines where to
place new rows or columns. The layouts must have one of four
values:
top Objects are placed top to bottom. (vertical
value)
bottom Objects are placed bottom to top. (vertical
value)
left Objects are placed left to right. (horizontal
value)
right Objects are placed right to left. (horizontal
value) The user should use one value from
each category--vertical and horizontal. For
example if the primary_layout is top, then
the secondary_layout should be either left or
right. In this case, the secondary_layout
should NOT be top or bottom. Likewise, if the
primary_layout is left, then the
secondary_layout should be either top or bot-
tom. In this case, the secondary_layout
should NOT be left or right.
Dtfile *openFolder :
Determines how a folder is opened when a user double clicks
on a folder icon. This resource must have one of two values:
current Open the folder in the current window. (This
is the same as using the OpenInPlace action.)
new Open the folder in a new window or, if a win-
dow showing this folder currently exists,
move the existing window to this workspace
and place it in the forefront. (Note: Only
one view of a folder can be opened at once
under these conditions. If the user defines
an `open folder' file type, the folder icon
will change state to indicate when a given
folder is currently open somewhere in the
user's environment. In order to define an
`open folder' file type, the user should 1)
Unix System LaboratLastschange: 1 August 1995" 14
dtfile(1) USER COMMANDS dtfile(1)
define a file type with the same name as the
normal folder file type except that the name
is preceded with OPEN_, 2) create an `open
folder' icon, and 3) use the name of the
`open folder' icon as the icon name in the
`open folder' file type definition.
Dtfile *smallIconWidth :
The default small icon size is 16 pixel. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this resource to specify small icon width.
Dtfile *smallIconHeight :
The default small icon height is 16 pixel. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this resource to specify small icon height.
Dtfile *largeIconWidth :
The default large icon width is 32 pixel. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this resource to specify large icon width.
Dtfile *largeIconHeight :
The default large icon height is 16 pixel. Any customized
icons that have larger size will be clipped. To avoid clip-
ping, use this resource to specify large icon height.
ASYNCHRONOUS EVENTS
The following Tool Talk Desktop and Media requests are sup-
ported by the File Manager:
Edit (Document and Media Exchange Message Set)
The specified file is opened for editing in a
separate window.
Display (Document and Media Exchange Message Set)
The specified file is opened for viewing only
in a separate window.
Quit (Desktop Message Set)
This request will terminate the File Manager
and its children.
RELATED INFORMATION
TED Actions
The following Desktop actions can be used to access File
Manager folder and application view windows as well as the
File Manager trash container window. These actions are
defined in /usr/dt/appconfig/types/$LANG/dtfile.dt.
Unix System LaboratLastschange: 1 August 1995" 15
dtfile(1) USER COMMANDS dtfile(1)
Dtfile
Opens a folder window for a specified folder.
Dtappmgr
Opens an application view window.
Dttrash
Opens a window to display the contents of the Trash
Container.
OpenNewView
Opens a new window to show the contents of the selected
folder.
OpenInPlace
Displays the contents of the selected folder in the
current window.
FILESYSTEM_MOVE
Moves a set of dragged objects to the selected drop
site.
FILESYSTEM_COPY
Copies a set of dragged objects to the selected drop
site.
FILESYSTEM_LINK
Creates symbolic links to a set of dragged objects from
the selected drop site.
Registering Objects As Drop Sites
Every TED data type has three associated drop attributes:
MOVE_TO_ACTION, COPY_TO_ACTION, and LINK_TO_ACTION. The File
Manager registers every object whose data type has a value
for at least one of these attributes as a drop site. When
an object is dragged to a drop site, the File Manager is
triggered by the drag-and-drop API. The drag-and-drop API
provides the File Manager with a gesture code (Move, Copy,
or Link) which is dictated by a combination of the modifier
keys used and the manner in which the drop site was
registered. Based on the gesture code and the data type of
the drop site, the File Manager retrieves a drop attribute
(ie. MOVE_TO_ACTION) from the Datatypes database. The File
Manager then calls the CDE API, DtActionInvoke according to
the following rules:
1. If objects A and B are dropped on object C, then the
parameters to DtActionInvoke are as follows:
DtActionInvoke (drop action name, C, A, B)
Unix System LaboratLastschange: 1 August 1995" 16
dtfile(1) USER COMMANDS dtfile(1)
2. There is one exception, if object C is an action, then
the parameters will not include object C. ie
DtActionInvoke (drop action name, A, B)
FILES
File Manager uses the following files.
dtfile
Executable file. This file is located in /usr/dt/bin.
dtfile_copy
Utility to support folder copy. This executable file is
located in /usr/dt/bin.
dtfile_error
This script can be used by applications to display an error
dialog when it would be difficult or impossible to do in the
context of the executing program. For example, it can be
used when exec fails in a child process or if an error is
detected before an applications main window can be realized.
This executable file is located in /usr/dt/bin.
Dtfile
App-defaults file. This file is located in /usr/dt/app-
defaults/$LANG. See the RESOURCES section for a list of
those resources which can be set using the app- defaults
file.
dtfile.config
Configuration file. This file is located in
/usr/dt/config/$LANG. It may be used to add a file system
specific button to the File Properties dialog. This button
launches an additional dialog allowing the user to modify
file system specific parameters. For example, the user can
add a stanza defining a dialog for setting the Access Con-
trol List for a file from the Andrew File System. If the
user also adds a stanza defining a dialog for setting the
Access Control List for the Distributed File System, then
the File Manager will determine which dialog is associated
with the selected file and will display that dialog. See the
text in the dtfile.config file for instructions on how to
create stanzas.
dtfile.dt
TED type/action definition file. This file is located in
/usr/dt/appconfig/types/$LANG.
Unix System LaboratLastschange: 1 August 1995" 17
dtfile(1) USER COMMANDS dtfile(1)
Dtinf.*, Dtlink.*, DtdirR.*, Fphome*, Fpapps*, Fptrsh*
Icon files. These files are located in
/usr/dt/appconfig/icons/$LANG.
dtfile.cat
Message catalog. This file is located in
/usr/dt/lib/nls/msg/$LANG.
Filemgr.sdl, FM*.tif, FM*.pm
Help files. These files are located in
/usr/dt/appconfig/help/$LANG/Filemgr and
/usr/dt/appconfig/help/$LANG/Filemgr/graphics.
dtfile.1
Man page.
SEE ALSO
- Data Interchange Mechanisms (drag-and-drop library) - Win-
dow Manager - Object Services (action/filetype database) -
ICCCM Messaging - ToolTalk
Unix System LaboratLastschange: 1 August 1995" 18
See also dtfile(1)
Man(1) output converted with
man2html