Difference between revisions of "File Chooser Type Handling Specification"
(→References) |
(→Detailed Specification) |
||
| Line 88: | Line 88: | ||
== Detailed Specification == | == Detailed Specification == | ||
| − | + | ||
| + | 1. When the user does a File | Open, the File Chooser (also known as the File Picker) dialog shall be displayed. The File Chooser dialog shall allow the user to browse the files available on the local and network storage locations using either a OOo dialog or a native (operating system) dialog. | ||
| + | |||
| + | Comment: Support for this specification in a native dialog may depend on the host operating system. | ||
| + | |||
| + | Comment: The above paragraph describes the behavior already implemented in OOo v2.1. | ||
| + | |||
| + | 2. The File Chooser dialog shall display a drop down selection for File Type. | ||
| + | |||
| + | The default type shall be "All Files (*.*)" and it shall be displayed as the first or top option in the drop down selection. | ||
| + | |||
| + | The following document type groups shall also be available options for the File Type and shall be displayed immediately under "All Files (*.*)": | ||
| + | |||
| + | Text documents | ||
| + | Spreadsheets | ||
| + | Presentations | ||
| + | Drawings | ||
| + | Web pages | ||
| + | Master documents | ||
| + | Formulas | ||
| + | Database documents | ||
| + | |||
| + | In addition, each specific format shall also be an option, for example, there shall be an option available for: | ||
| + | |||
| + | OpenDocument Text (*.odt) | ||
| + | OpenDocument Text Template (*.ott) | ||
| + | OpenOffice.org 1.0 Text document (*.swx) | ||
| + | etc. | ||
| + | |||
| + | The specific formats shall be grouped by application type, separated a horizontal line, with Text document types first, then Spreadsheets types, Presentation types, Drawing types, Web page types, Master document types, Formula types and Database document types. | ||
| + | |||
| + | Comment: The above paragraph describes the behavior already implemented in OOo v2.1, with the exception that OOo v2.1 lists Database document types above Formula document types. | ||
| + | |||
| + | 3. When "All Files (*.*)" is selected, all files shall be displayed in the File Chooser dialog, with the exception of hidden files not displayed by the operating system's native dialog. | ||
| + | |||
| + | When one of the document type groups is selected, the list of displayed files shall be filtered by extension, and only files with extensions corresponding to known document types shall be displayed. So for example, when "Text documents" is selected, only files with .odt, .ott, .swx, etc., shall be displayed. | ||
| + | |||
| + | When one of the specific document formats is selected, only the files with extensions corresponding to that document type shall be displayed. | ||
| + | |||
| + | Comment: The above paragraph describes the behavior already implemented in OOo v2.1. | ||
| + | |||
| + | |||
| + | |||
[[Specification_Template_Help#Detailed_Specification|Help]] | [[UI-Elements|User Interface Element Templates]] | [[Specification_Example|Example Spec]] | [[Specification_Template_Help#Detailed_Specification|Help]] | [[UI-Elements|User Interface Element Templates]] | [[Specification_Example|Example Spec]] | ||
Revision as of 15:10, 13 February 2007
| Specification Status | |
| Author | Allen Pulsifer |
| Last Change | 2007-02-13 |
| Status | Preliminary Help |
Abstract
The specification relates to the handling of file "types" in the File | Open dialog. It specifies how the user's choice of file type affects the files displayed in the file chooser and the filters that may be used to open or import the file. It also specifies how files with unrecognized formats are handled.
Contents
References
| Reference Document | Check | Location (URL) |
| Specification Process Entry Check | [passed/failed] | n/a |
| Product Requirement, RFE, Issue ID (required) | available | http://qa.openoffice.org/issues/show_bug.cgi?id=74277 |
| Product Concept Document | [available/not available] | <PLEASE ENTER LOCATION HERE> |
| Test case specification (required) | [available/not available] | <PLEASE ENTER LOCATION HERE> |
| IDL Specification | [available/not available] | <PLEASE ENTER LOCATION HERE> |
| Software Specification Rules | n/a | n/a |
| Other, e.g. references to related specs | <PLEASE ENTER LOCATION HERE> |
Contacts
| Role | Name | E-Mail Address |
| Developer | <First Name, Last Name> | <User@openoffice.org> |
| Quality Assurance | <First Name, Last Name> | <User@openoffice.org> |
| Documentation | <First Name, Last Name> | <User@openoffice.org> |
| User Experience | <First Name, Last Name> | <User@openoffice.org> |
Acronyms and Abbreviations
| Acronym / Abbreviation | Definition |
| <WYSIWYG> | <What You See Is What You Get> |
Detailed Specification
1. When the user does a File | Open, the File Chooser (also known as the File Picker) dialog shall be displayed. The File Chooser dialog shall allow the user to browse the files available on the local and network storage locations using either a OOo dialog or a native (operating system) dialog.
Comment: Support for this specification in a native dialog may depend on the host operating system.
Comment: The above paragraph describes the behavior already implemented in OOo v2.1.
2. The File Chooser dialog shall display a drop down selection for File Type.
The default type shall be "All Files (*.*)" and it shall be displayed as the first or top option in the drop down selection.
The following document type groups shall also be available options for the File Type and shall be displayed immediately under "All Files (*.*)":
Text documents Spreadsheets Presentations Drawings Web pages Master documents Formulas Database documents
In addition, each specific format shall also be an option, for example, there shall be an option available for:
OpenDocument Text (*.odt) OpenDocument Text Template (*.ott) OpenOffice.org 1.0 Text document (*.swx) etc.
The specific formats shall be grouped by application type, separated a horizontal line, with Text document types first, then Spreadsheets types, Presentation types, Drawing types, Web page types, Master document types, Formula types and Database document types.
Comment: The above paragraph describes the behavior already implemented in OOo v2.1, with the exception that OOo v2.1 lists Database document types above Formula document types.
3. When "All Files (*.*)" is selected, all files shall be displayed in the File Chooser dialog, with the exception of hidden files not displayed by the operating system's native dialog.
When one of the document type groups is selected, the list of displayed files shall be filtered by extension, and only files with extensions corresponding to known document types shall be displayed. So for example, when "Text documents" is selected, only files with .odt, .ott, .swx, etc., shall be displayed.
When one of the specific document formats is selected, only the files with extensions corresponding to that document type shall be displayed.
Comment: The above paragraph describes the behavior already implemented in OOo v2.1.
Help | User Interface Element Templates | Example Spec
Migration
<START TYPING HERE --- If this part is irrelevant state a reason for its absence.>
Configuration
<START TYPING HERE --- If this part is irrelevant state a reason for its absence.>
Help | Configuration Table Template
File Format
<START TYPING HERE --- If this part is irrelevant state a reason for its absence.> Help
Help | File Format Table Template
Open Issues
<State a bulleted list of issues Issue here>
