Adjust terms and
introduce 'Follow text flow'

for to frame anchored Writer fly frames

MS-Interoperability

Document - ID	Specification Owner	Last Change	Status
	Oliver-Rainer Düsterhöft	11/20/2003	Final
Conforms to	
Applies to	OpenOffice Writer
Task ID(s)	IssueZilla task 22305
Category	Fix of defect & Feature

Abstract

In light of re-work of positioning of objects in Writer text it becomes necessary to correct the terms of the current possible vertical alignments. Also the new option 'Follow text flow' introduced for Writer fly frames which are anchored to frame are addressed.

i-Team Members

	Name	E-mail Address
Specification Owner	Oliver-Rainer Düsterhöft (OD)	oliver-rainer.duesterhoeft@sun.com
User Experience	Falko Tesch (FT)	falko@sun.com
Development	Oliver-Rainer Düsterhöft (OD)	oliver-rainer.duesterhoeft@sun.com
Quality Assurance	Michael Rüß (MRU)	michael.ruess@sun.com
Documentation	Uwe Fischer (UFI)	uwe.fischer@sun.com

Approved for Implementation

	Approved by	Date
User Experience	Falko Tesch	11/07/2003
Development	Andreas Martens	11/06/2003
Quality Assurance	Michael Rüß	11/10/2003
Documentation	Uwe Fischer	11/10/2003
String Review	<not needed, because no new strings>	

Document Change History

Rev. Level	Change	Initials	Date
1.0	Initial version	OD	10/23/2003
1.1	no alignment at page areas, but new option 'Follow text flow'	OD	11/06/2003
1.2	Including FT's adjustments	OD	11/06/2003
1.3	Adjust title and add FT's approval	OD	11/10/2003
1.4	Finalize specification: add links to related documents, minor formatting adjustments	OD	11/20/2003

Contents

Glossary	1

1	Motivation	1

1.1	Correct vertical alignment names	1

1.2	Option 'Follow text flow'	1

2	User Scenarios	1

3	Goals	1

4	Requirements and Dependencies	1

4.1	Requirements	1

4.2	Technical Dependencies	1

5	Competitive Analyses	2

6	Detailed Specification	2

6.1	Correct used names for the vertical alignments	2

6.2	Influence of option 'Follow text flow' to the positioning	2

6.3	Error Conditions	3

7	Future Tasks	3

8	Legal Issues	3

9	Notes	3

10	References	3

Glossary

Term	Description
floating screen object	This term denotes the objects 'Writer fly frame' and 'drawing object' in Writer and the objects 'text box', 'graphic', 'frame', 'picture' etc. in MS Word.
Writer fly frame	Floating screen object containing normal Writer content (text, tables, sections, columns, etc.), graphics, or OLE content.
anchor [of a floating screen object]	Content the floating screen object is connected to. In Writer this could be a paragraph, a character, a page, or a Writer fly frame. In MS Word this is always a character.

Motivation

Correct vertical alignment names

Terms used for the currently possible vertical alignments to frame anchored Writer fly frames are wrong.

Option 'Follow text flow'

The new option 'Follow text flow' for to paragraph and to character anchored Writer fly frames has been introduced [reference to specification]. To be consistent inside Writer this option will be also applied to Writer fly frames that are anchored to frame(s). The dependence of the possible positions to frame anchored Writer fly frames has to be defined.

User Scenarios

Users are often confused and irritated by some positioning terminology of frames in text. To better this as well as to ease the migration for users that change from Word to Writer better wording must be found.

Goals

Provide the correct terms for the currently possible vertical alignments and the possibility to use option 'Follow text flow' for Writer fly frames that are anchored to frame in order to influence its positioning.

Requirements and Dependencies

Requirements

This specification requires the new option 'Follow text flow' for to paragraph and to character anchored Writer fly frames (specification found here).

Technical Dependencies

Not known.

Competitive Analyses

This is a Writer-internal issue that has no competitiveness.

Detailed Specification

Correct used names for the vertical alignments

Currently the vertical alignments 'Margin' and 'Paragraph text area' can be chosen to frame anchored Writer fly frames.

The vertical alignment 'Margin' affects the relative positioning to the Writer fly frame the dedicated Writer fly frame is anchored to. Thus the correct name for this alignment has to be 'Entire frame' as well as for the corresponding horizontal alignment.

The vertical alignment 'Paragraph text area' affects the relative positioning to the text area of the Writer fly frame the dedicated Writer fly frame is anchored to. Thus the correct name for this alignment has to be 'Frame text area' as well as for the corresponding horizontal alignment.

By this correction no new strings are introduced – the intrinsic strings and its definitions are already known from the horizontal alignments of to frame anchored Writer fly frames.

Illustration 1 The Frame-to-Frame dialogue as it is now

Influence of option 'Follow text flow' to the positioning

Considering the option 'Follow text flow' – see specification [reference] – the area where a to frame anchored Writer fly frame can be positioned in has to be defined:

If option 'Follow text flow' is activated, the Writer fly frame has to follow the text flow and can only be positioned inside its anchor.

If option 'Follow text flow' is deactivated the Writer fly frame doesn't follow the text flow, but can now be positioned on the complete page, on which the anchor is.

Error Conditions

Not known.

Future Tasks

See corresponding chapters in specification 'Follow text flow vs. leaving layout environment for Writer fly frames' (found here) and in specification 'Vertical alignments at page areas for Writer fly frames' (found here).

Legal Issues

None.

Notes

References

Related PCD document chapter can be found here.

Related specification for new option 'Follow text flow' can be found here.

Related specification for vertical alignments at page areas can be found here.

Required - 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.

Adjust terms and introduce 'Follow text flow' for to frame anchored Writer fly frames

Page 3

/home/od138299/so-doc-objpos/specifications-not-published-yet/spec-AdjustToFrameAnchored-v1.4-approved.sxw

Oliver-Rainer Düsterhöft

2003-10-16T16:35:26

Falko Tesch