Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
 Motif and Common Desktop Environment: Style Guide Reference > Motif and CDE Reference Topics (A - F)

File Selection (Dialog)
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

NAME

File Selection (Dialog) — Reference

Description

A file selection dialog is a dialog that allows the user to specify a file or element.

Figure 26 File Selection Dialog

File Selection Dialog

When to Use

Use a file selection dialog when the user needs to open a file for processing.

Guidelines

Required

Allow the user to continue interacting with the application when a file selection dialog is displayed.

Required

The file selection dialog box must be composed of at least the following:

  • A text component for displaying and editing a directory mask (or filter) used to select the file to be displayed. The directory mask must be a string that specifies the base directory to be examined and a search path.

  • A list component for displaying file names. The list should display all files and subdirectories in the base directory that match the search pattern. The list must use either the single or browse selection model.

  • A text component for displaying and editing a file name.

  • A group of push buttons labeled OK, Filter, Cancel, and Help. If the file selection dialog is used to perform a specific action to the selected files, OK can be replaced by a label that describes the action to be done.

Required

The user must be able to select a new directory to examine by scrolling through the list of subdirectories and selecting the desired directory or by editing the directory mask. Selecting a new directory from the directory list must not change the search pattern. A user must be able to select a new search pattern by editing the directory mask.

Required

Allow the user to navigate the text within each list component by pressing ↑, ↓, Ctrl Begin, and CtrlEnd. Allow the navigation actions PageUp and PageDown to move the cursored element within each list.

Required

The contents of the directory in the text-entry field must correspond to the contents of the directory list. The contents of the file name text must also correspond to the contents of the file name list.

Required

The user must be able to select a file by scrolling through the list of file names and selecting the desired file or by entering the file name directly into the text-entry field. Selecting a file from the list causes that file name to appear in the file selection text-display field.

Required

The user can select a new file as many times as desired. The application must not process the file until one of the following events occurs:

  • The user activates the OK button.

  • The user presses Enter or Return while the file name text-entry field has focus.

  • The user presses Enter or Return while the cursor is on an item in the file list.

  • The user double-clicks the SELECT button on an item in the file list.

Required

The file selection dialog must initiate a directory and file search when any of the following occurs:

  • The file selection dialog box is initialized

  • The user activates the Filter push button

  • The user double-clicks the SELECT button or presses Enter or Return on an item in the directory list

  • The user presses Enter or Return while the directory mask text-entry field has focus

Essential Related Topics

For more information, see the Dialog (Choice Type), Text Display Field, and Text-Entry Field (Control) reference pages.

Supplemental Related Topics

For more information, see the Dialog (Window) reference page.



File Menu
  		 


Find (Choice and Dialog)  
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© Hewlett-Packard Development Company, L.P.