Software Specification Document

OpenOffice.org
5 Chart Toolbars

Specification Status
Last Change November 5, 2009
Status Standard

Abstract
10 A list box containing all chart elements was added to the chart formatting tool bar. Selecting an item in the list
does select the according element within the chart. Press the new button named 'Format Selection' next to the
list to open the properties dialog for that element and change the formatting.

i-Team Members
Role First Name, Last Name, Initials E-Mail Address
Project Lead Ingrid Halama iha at openoffice.org
Specification Owner Ingrid Halama iha at openoffice.org
User Experience Frank Loehmann fl at openoffice.org
Development Ingrid Halama iha at openoffice.org
Development Thomas Benisch tbe at openoffice.org
Quality Assurance Thomas Klarhöfer kla at openoffice.org
Quality Assurance Sophie Gautier sgauti at openoffice.org
Documentation Uwe Fischer ufi at openoffice.org
Test Scripting Oliver Craemer oc at openoffice.org

1
 Chart Toolbars

15

Contents
Abstract........................................................................................................................................... 1
i-Team Members.............................................................................................................................. 1
References and Reference Documents........................................................................................... 3
Acronyms and Abbreviations........................................................................................................... 3

1 Detailed Specification................................................................................................................... 4
1.1 The Standard Toolbar...................................................................................................................... 4
1.2 The Formatting Toolbar.................................................................................................................... 4
1.2.1 List box containing the Chart Elements........................................................................................... 7
1.3 The Drawing Toolbar........................................................................................................................ 7

2 Migration........................................................................................................................................ 8

3 Open Issues................................................................................................................................... 8
Document Change History............................................................................................................... 8

http://specs.openoffice.org/chart/Toolbars.odt 2
Chart Toolbars

References and Reference Documents

Reference Document Check Location (URL)

Specification Process Entry Check Passed N/A
Product Requirement,, RFE, issue (required) Available I70287, i7049, i12587
Product Concept Document Not Available <Please enter location here>
Competitive Analysis Available See Appendix
Test Case Specification (required) Available http://www.openoffice.org/nonav/iss
ues/showattachment.cgi/44859/tcs_
toolbars.html
i7049 TCS for Chart Element
Selector
Software Specification Rules N/A N/A
Application-Wide Toolbar Specification http://specs.openoffice.org/appwide/
toolbars/Toolbar_content_spec.odt
Specification of names for chart elements http://specs.openoffice.org/chart/Ch
artObjectNames.odt

Acronyms and Abbreviations

Acronym / Abbreviation Definition

http://specs.openoffice.org/chart/Toolbars.odt 3
 Chart Toolbars

20 1 Detailed Specification
There are two tool bars in a chart, the standard bar and the formatting bar. The standard bar contains the
icons that are available in all applications and covers tasks like OPEN, SAVE, PRINT, and UNDO. The
formatting toolbar is chart-specific and contains commands for manipulating the chart itself.

1.1 The Standard Toolbar

Figure 1: The Chart's "Standard" Toolbar

The following commands are available in the standard bar. The icon numbers refer to the index of the icon in
Figure 1 from left to right. Invisible buttons, that can be made visible by the “Visible Buttons” command of the
toolbar are shown in the list without Icon numbers.

Icon Command Functionality

1 .uno:AddDirect New
.uno:NewDoc New from Template (can be made visible)
2 .uno:Open Open a new Document
3 .uno:Save Save Document
.uno:SaveAs Save Document with a different name (can be made visible)
4 .uno:SendMail Send document as Mail
Separator
.uno:EditDoc (can be made visible)
Separator
5 .uno:ExportDirectToPDF Export directly as PDF
6 .uno:PrintDefault Print file directly
Separator
.uno:Cut Clipboard Cut
7 .uno:Copy Clipboard Copy
8 .uno:Paste Clipboard Paste
Separator
9 .uno:Undo No drop down
10 .uno:Redo No drop down
30

1.2 The Formatting Toolbar

Figure 2: Formatting Toolbar for Charts

http://specs.openoffice.org/chart/Toolbars.odt 4
 Chart Toolbars

The formatting toolbar contains icons for commands to modify the chart.
35
Icon Command Functionality
1 .uno:ChartElementSelector Offers a list of existing chart elemets for comfortable
selection.
2 .uno:FormatSelection Opens the Properties Dialog of the selected element.
3 .uno:DiagramType Open the dialog for changing the chart type
4 .uno:DiagramData Open the dialog for editing the data of a chart with own
data. This is not available if the chart gets its data from
outside, e.g. from a sheet in a spreadsheet document.
Separator
5 .uno:ToggleGridHorizontal Remove the main grid of the first y-axis if it exists, add it
when it was not visible.
6 .uno:ToggleLegend Remove the legend if it exists, add it when it was not
visible.
7 .uno:ScaleText Switches the text scaling on for all chart objects if it was off
before, and off for all objects if it was on before.
Separator
8 .uno:NewArrangement Removes all user-defined object sizes and positions, so
that these switch back to auto-calculation.

Table 1: User Interface elements of Error: Reference source not found

# Type Properties Comment
1 Button Control Properties
Icon: yes
Enabled: yes
Toggle: no
String English
Format Selection

2 ListBox Control Properties The names of all the

Enabled: yes chart elements are
Visible Row Count: drop down line count depends on specified in
number of existing chart elements (maximum is 100) http://specs.openoffi
Item Selected: The first entry 'Chart Area' is ce.org/chart/ChartO
selected initially bjectNames.odt
Enable Sorting by DnD: no
A11Y Text:
ToolTip Text: Select Chart Element
String English

3 Button Control Properties

Icon: yes
Enabled: yes
Toggle: no
String English String German
Chart Type Diagrammtyp

http://specs.openoffice.org/chart/Toolbars.odt 5
Chart Toolbars

# Type Properties Comment

4 Button Control Properties
Icon: yes
Enabled: If the chart uses own data
Toggle: no
String English String German
Chart Data Table Diagrammdatentabelle

5 Button Control Properties

Icon: yes
Enabled: if chart type can have horizontal
grid lines
Toggle: yes
String English String German
Horizontal Grid Gitter horizontal
On/Off ein/aus

6 Button Control Properties

Icon: yes
Enabled: yes
Toggle: yes
String English String German
Legend On/Off Legende ein/aus

7 Button Control Properties

Icon: yes
Enabled: yes
Toggle: no
String English String German
Scale Text Textskalierung

8 Button Control Properties

Icon: yes
Enabled: yes
Toggle: no
String English String German
Automatic Layout Diagramm automatisch
anordnen

<#> CustomControl Control Properties

Features: <Please specify here>
Toolbar
String English String German
Formatting Format

<#> ListBox Control Properties

Enabled: <Yes/No>
Visible Row Count: <Specify Number here e.g. 8>
Item Selected: <Specify item name here>
Enable Sorting by DnD: <Yes/No>
A11Y Text: <If needed specify text here>
ToolTip Text: <If needed specify text here>
String English String German
<Enter String Here> <Enter String Here>

http://specs.openoffice.org/chart/Toolbars.odt 6
 Chart Toolbars

40 1.2.1 List box containing the Chart Elements

The list box does list the following elements in given order in case they are contained in
the accessory chart:

Chart Area
45 Chart
Chart Wall (only in case of 3D charts)
Chart Floor (only in case of 3D charts)
Legend
Main Title
50 Subtitle
X Axis
X Axis Title
X Axis Major Grid
X Axis Minor Grid
55 Secondary X Axis
Secondary X Axis Title
Y Axis and its children
Secondary Y Axis and its children
Z Axis and its children
60 Data Series 'SERIESNAME'
Data Series 'SERIESNAME' Data Labels
Data Series 'SERIESNAME' Mean Value Line
Data Series 'SERIESNAME' Trend Line
Data Series 'SERIESNAME' Equation
65 Data Series 'SERIESNAME' Error Bars

The strings are defined in the object naming specification:

http://specs.openoffice.org/chart/ChartObjectNames.odt

1.3 The Drawing Toolbar

Figure 3: Drawing Toolbar for Charts

The drawing toolbar can be found near the lower border of the document and allows to insert drawing objects
into the current chart. By default the drawing toolbar is visible and all toolbar buttons are visible and enabled.
The supported commands are shown in the following table. The icon numbers refer to the index of the icon in
Figure 3 from left to right.
75
Icon Command Functionality
1 .uno:SelectObject Allows to select an object in the current chart.
Separator
2 .uno:Line Allows to insert a line into the current chart.
3 .uno:LineArrowEnd Allows to insert an arrow.
4 .uno:Rect Insert a rectangle into the current chart.

http://specs.openoffice.org/chart/Toolbars.odt 7
 Chart Toolbars

Icon Command Functionality

5 .uno:Ellipse Insert an ellipse.
6 .uno:Freeline_Unfilled Allows to insert a freeform line into the current chart.
7 .uno:DrawText Allows to insert a text box.
8 .uno:DrawCaption Insert a callout into the current chart.
9 .uno:BasicShapes Opens the Basic Shapes toolbar which allows to insert
different shape types into the current chart.
10 .uno:SymbolShapes Opens the Symbol Shapes toolbar.
11 .uno:ArrowShapes Opens the Block Arrows toolbar.
12 .uno:FlowChartShapes Opens the Flowchart toolbar.
13 .uno:CalloutShapes Opens the Callouts toolbar.
14 .uno:StarShapes Opens the Stars and Banners toolbar.

The Basic Shapes, Symbol Shapes, Block Arrows, Flowchart, Callouts and Stars and Banners toolbars are
the same as used in the other OpenOffice.org modules and therefore not seperately specified. For more
details see the application-wide toolbar specification at
80 http://specs.openoffice.org/appwide/toolbars/Toolbar_content_spec.odt

2 Migration
n/a

3 Open Issues
Issue Initials Date

85 Document Change History

Rev. Change Initials Date
1 Added standard bar. Added some to-be-discussed issues BM Oct 16, 2006
2 Make Cut command invisible per default, as this is always BM Nov 17, 2006
disabled
3 User Experience review: ok MMP Dec 27, 2006
new string table
suggestion to change the sting for “Reorganize Chart” to
“Automatic Layout”
4 Some textual changes from JSI BM Jan 9, 2007
5 Added link to testcase spec, set to Standard BM May 4, 2007
6 Added list box to select single elements within the chart + some IHA Aug 7, 2009
cleanup
7 Added more detailed description of the content of the chart IHA Aug 27, 2009
element selector list
8 Added link to test case specification for issue 7049 IHA Sep 8, 2009

http://specs.openoffice.org/chart/Toolbars.odt 8
Chart Toolbars

Rev. Change Initials Date

9 Set to standard IHA Sep 16, 2009
10 Changed abstract to suitable text for the 'what's new guide' IHA Oct 14, 2009
11 Added section on drawing toolbar. TBE Nov 5, 2009

http://specs.openoffice.org/chart/Toolbars.odt 9