File Close Behavior

StarOffice 6.x / OpenOffice.org 1.1

Document - ID	Specification Owner	Last Change	Status
	Matthias Müller-Prove	08/04/04	final
Conforms to	
Applies to	All modules, Start Module
Task ID(s)	104022 : Drag & Drop, Keyboard Shortcuts : new “XML Filter Settings...” menu item
Category	feature

Abstract

This present UI Spec describes the behavior of StarOffice/OpenOffice.org after the user has closed the last document. It should be possible to keep the application running without having a document open. This change has been requested especially by Linux/Solaris users, who experience long launch times of StarOffice/OpenOffice.org. The QuickStarter feature makes this problem less severe for Windows users. Here StarOffice/OpenOffice.org is facing the challenge to mimic the behavior of MS-Office.

i-Team Members (The specification owner is part of the i-Team)

	Name	E-mail Address
User Experience	Matthias Müller-Prove /MMP	mprove@sun.com
Development		
Quality Assurance		
Documentation		
		mail to iTeam

Approved for Implementation

	Approved by	Date
User Experience	Matthias Müller-Prove	4/2/03
Development		
Quality Assurance		
Documentation		
String Review	Elizabeth Matthis	10/1/02

Document Change History

Rev. Level	Change	Initials	Date
	second draft	MMP	09/27/02
	menu bar specification, backing window as drag&drop target, full screen mode & print preview mode considerations, Ctrl-N in backing window state	MMP	09/30/02
	linguistic review	EM	10/1/02
	no function bar, no View menu for backing window	MMP	10/2/02
	Bibliography and query window to be treated as document windows	MMP	10/7/02
	new section 4 User Interaction for Opening Something; use “application background” as filling	MMP	10/8/02
	3.2: In backing window state the menu item Window>Close Window is enabled 2: Status bar for backing window	MMP	12/2/02
	3: Ctrl-N to create a new document in backíng window state.	MMP	12/4/02
	Clarification for 5.2 Help Window	MMP	1/13/03
1.0	3.2 backing window > menu bar > Tools menu: new menu item: “XML Filter Settings...”	MMP	4/2/03
	update to new spec template; menu definitions use the new menu styles	MMP	08/04/04

Contents

Glossary	4

1	Motivation	4

2	User Scenarios	4

3	Goals	4

4	Requirements and Dependencies	4

4.1	Requirements	4

4.2	Technical Dependencies	4

5	Competitive Analyses	4

6	Detailed Specification	4

7	User Interface	5

7.1	Window Menu	5

7.2	Document Window	5

8	User Interaction for Closing Something	5

8.1	Actions	5

8.2	Menu Events	6

8.3	Window Events	6

8.4	Keyboard Events	7

8.5	Toolbar Events	7

9	Backing Window State	7

9.1	Application Window	8

9.2	Menu Bar	8

9.3	Toolbars	10

9.4	Drag & Drop Target	10

10	User Interaction for Opening Something	10

11	Special Conditions	10

11.1	Full Screen Mode & Print Preview Mode	10

11.2	Help Window	11

11.3	Bibliography & Query Window	11

11.4	G11n	11

11.5	Error Conditions	11

11.6	Migration	11

12	Future Tasks	11

13	Notes	11

14	References	12

Glossary

Term	Description
<Term 1>	

Motivation

<What is the reason for pursuing this project?>

User Scenarios

<A user scenario is a idealized description of a specific interaction. This description shall be written short and specific. User scenarios can describe a leak of functionality, or based on the requirements, a solution.>

Goals

<The goals section must be short but also provide a clear statement of the goals, to achieve with this feature, project or task. A clear statement in this section gives Development, Quality Assurance and Documentation guidance.>

Requirements and Dependencies

Requirements

<State the requirement(s) of this feature here.>

Technical Dependencies

<Are there any technical dependencies for this feature? Does the implementation of this feature create any technical dependencies to other program parts? Or very important any issues for automatedd GUI Testing?>

Competitive Analyses

<Describe or reference to solutions which are already on the market. Describe what is done well or what is done bad.>

Detailed Specification

User Interface

Window Menu

The standard installation of StarOffice/OpenOffice.org has a new item for the Window menu. The item is called “Close Window”. The shortcut is Ctrl-W.

Document Window

The appearance of the document window changes from StarOffice 6.0 / OpenOffice.org 1.0 to StarOffice 6.x/OpenOffice.org 1.x for the last open document window. In this case only, a document close button is displayed to the right end of the menu bar.

The document close button will not be displayed if the there are more than two open document windows.

Design of the Document Close Button

Illustration 1 Document Close button

Illustration 2 Document Close button with mouse-over effect

The slot info for the Document Close button is “Close Document”.

User Interaction for Closing Something

The user has several options to close a window or document in StarOffice/OpenOffice.org. This section defines the behavior for menu events like File>Close, for keyboard events like Ctrl-W, and for mouse events like pressing the window Close button.

Actions

This section defines three actions with a pseudo code notation.They are used in the following sections to describe the behavior that should take place on dedicated user interface event.

close window:=	if this is the last open window for a document close document else close the current window
close document:=	if document has changes to be saved show save changes alert if not (document has changes to be saved) close all windows for the current document and close the document itself else cancel
exit application:=	for all documents from top to bottom do close document // If any close document fails the exit is canceled, too.

Menu Events

File > Close

The menu item File>Close calls the action close document. This means if the document has two windows open both will be closed.

If the document was the last document the application goes in the backing window state

File > Exit

The menu File>Exit calls the action exit application.

The menu shortcut is Ctrl-Q.

Window > Close Window

The menu item Window>Close Window calls the action close window. If the document was the last document the application goes in the backing window state.

If the application is already in the backing window state the menu Close Window calls the action exit application.

The menu shortcut is Ctrl-W. Additionally, the shortcut Ctrl-F4 is mapped to this item, too.

Window Events

Window Close Button

Clicking the window's Close button calls the action close window. If the document was the last document the action exit application is called.

Document Close Button

Clicking the Document Close button calls the action close document. Because the document window was the last open window of the last open document the application goes in the backing window state.

Keyboard Events

Ctrl-W and Ctrl-F4

These shortcuts have the same effect as the menu Window>Close Window. (that is they calls the action close window. If the document was the last document the application goes in the backing window state. If the application is already in the backing window state the menu Close Window calls the action exit application.)

Alt-F4

The keyboard shortcut calls the action close window. If the document was the last document the action exit application is called.

Ctrl-Q

Same as menu command File>Exit.(that is Ctrl-Q calls the action exit application.)

Toolbar Events

Function Bar: Close Document button

Clicking the Close Document button in the function bar calls the action close document. If this was the last open document the application goes in the backing window state.

Backing Window State

The backing window is a full-sized application window without a document open. It has a menu bar with a reduced menu structure. No tool bars are displayed. The status bar can display a progress indicator.

Illustration 3 Backing Window state for SO/OOo

Application Window

The window title is “%PRODUCTNAME +space + “%PRODUCTVERSION” + space + + %PRODUCTEXTENSION.
The system menu's icon is the StarOffice/OpenOffice.org application icon.

The empty canvas uses “application background” as filling.

Menu Bar

The reduced menu structure has just the menus File, Edit, Tools, Window, and Help.

File Menu

The File menu contains the following items: (This should be the same as the File menu for the Bibliography window.)

File

New	>	same as SO 1.0 / OO.o 1.0

Open...

AutoPilot	>	same as SO 1.0 / OO.o 1.0

---------------

Close	always disabled

Save	always disabled

Save As...	always disabled

Save All	always disabled

Reload	always disabled

Versions...	always disabled

---------------

Send	>	all items disabled

---------------

Properties...	always disabled

Templates	>	same as SO 1.0 / OO.o 1.0

---------------

Page Preview	always disabled

Print...	always disabled

Printer Settings...	always disabled

---------------

Exit

---------------

List of recently used files	same as SO 1.0 / OO.o 1.0

During the backing window state Ctrl-N triggers the Templates and Documents dialog.

Edit Menu

The Edit menu contains the following items:

Edit

Undo	always disabled

---------------

Cut	always disabled

Copy	always disabled

Paste	always disabled

Tools Menu

The Tools menu contains the following items:

Tools

Macros	>

XML Filter Settings...	enabled

Options...	enabled

Macros	>

Record Macro	always disabled

Macro...	enabled

Window Menu

The Window menu contains the following items:

Window

New Window	always disabled

Close Window	enabled to exit the application cf. 2.2

---------------

List of windows	TBD: do we have something like Help or Bibliography windows open??

Help Menu

as usual

Toolbars

The backing window has no object bar, no main toolbar, no hyperlink bar, and no formula bar. The backing window has even no function bar, although it would be nice to have one.

Drag & Drop Target

A StarOffice/OpenOffice.org document can be opened by dragging its file icon from the file system to the empty canvas of the backing window. Another valid target area is the title bar of the backing window.

User Interaction for Opening Something

While the application is in the backing window state the user has several options to open a document or to create a new one. This document replaces the backing window with the same position and size.

Ctrl-Shift-N triggers the Templates and Documents dialog.

Ctrl-N creates a new document of the default StarOffice/OpenOffice.org component..

Special Conditions

Full Screen Mode & Print Preview Mode

Assume the application is either in full screen mode or print preview mode. Now the last document window is closed and the application has to go into the backing window state. Under these conditions the special mode (full screen or print preview) is terminated as well and the standard backing window can be displayed.

Help Window

The Help window does not count as an open document. As a consequence, closing the backing window exits the application and closes the help window as well.

Bibliography & Query Window

The bibliography and query window are treated as normal document windows, with respect to the close behavior.

String list

Item	English	German	Comments
	Close Window	Fenster schließen	item in Window menu
	Close Document	Dokument Schließen	slot info

Tab Order

<If necessary Describe or visualize the tabbing order. The description of the tab order has to contain which control has the initial focus.>

Key Board Shortcuts

<Key Board shortcuts used in dialogs have to be listed in a table with a small description.>

G11n

<Globalization related topics should be stated here. A globalization related topic is for example when a feature needs to be enhanced to satisfy special regional needs.>

Error Conditions

<List all error conditions, and the action the system takes about them. If an alert box comes up, which kind is it? Include exact text of messages, or say what points need to be covered. Error Messages need a string list>

Migration

<Any migration issues have to be stated here. For example how can users migrate from one version of a database to another?>

Future Tasks

<If there are features which couldn't be implemented but have to be implemented in the future. State these in here with a description why the feature couldn't be implemented right now.>

Notes

<Questions will arise during the writing of the specification. State these in here.>

References

<Give references to related documentation, such as engineering designs, technical specs, and other sources for related units. Also include links to documents that other sections in this spec need to refer to, such as user opinions usability test reports.>

3	File Close Behavior

File Close Behavior	3

http://ui.openoffice.org/proposals/File_close_behavior.sxw

Matthias Müller-Prove

2004-08-04T14:01:16