Proposal: Header/Footer Presentation objects

[Michael Brauer <michael.brauer@sun.com>]

Dear TC members,

attached is a proposal for header and footer drawing objects that can be 
used inside presentations.

Best regards

Michael

Title: Impress Header and Footer

1Header and footer presentation placeholders

This is a proposal for additions to the OASIS Open Office 1.0 file format, with respect to header and footer presentation placeholders in presentation application.

1.1Additional presentation placeholder classes

The presentation:class attribute's value, that is used to classify placeholder objects , changes to the following:

<define name="presentation-classes">

<choice>

<value>title</value>

<value>outline</value>

<value>subtitle</value>

<value>text</value>

<value>graphic</value>

<value>object</value>

<value>chart</value>

<value>table</value>

<value>orgchart</value>

<value>page</value>

<value>notes</value>

<!-- The following values are new! -->

<value>header</value>

<value>footer</value>

<value>date-time</value>

<value>page-number</value>

</choice>

</define>

The additional placeholders behave differently to the already existing once. They can be used only inside master pages, and there is no corresponding drawing shape existing for drawing pages that use the master page. For such pages, the placeholder shapes will be displayed automatically, depending on the settings of the page.

The new values have the following meaning:

• header: The drawing shape is a placeholder for an header. Header placeholders are standard text shapes.

• footer: The drawing shape is a placeholder for a footer. Footer placeholders are standard text shapes.

• date-time: The drawing shape is a placeholder for a date and/or time. Date and Time placeholders are standard text shapes.

• page-number: The drawing shape is a placeholder for a page number. Page Number placeholders are standard text shapes.

1.2Additional text fields declarations

<define name="presentation-decls">

<zeroOrMore>

<ref name="presentation-decl"/>

</zeroOrMore>

</define>

1.2.1Header field declaration

The <presentation:header-decl> element specifies the text of an header field. See section 1.3.1 for details.

<define name="presentation-decl" combine="choice">

<element name="presentation:header-decl">

<ref name="presentation-header-decl-attlist"/>

<text/>

</element>

</define>

Name

The presentation:name attribute specifies the name of the header declaration.

<define name="presentation-header-decl-attlist" combine="interleave>

<attribute name="presentation:name">

<ref name="string"/>

</attribute>

</define>

1.2.2Footer field declaration

The <presentation:footer-decl> element specifies the text of a footer field. See section 1.3.2 for details.

<define name="presentation-decl" combine="choice">

<element name="presentation:footer-decl">

<ref name="presentation-footer-decl-attlist"/>

<text/>

</element>

</define>

Name

The presentation:name attribute specifies the name of the footer declaration.

<define name="presentation-footer-decl-attlist" combine="interleave>

<attribute name="presentation:name">

<ref name="string"/>

</attribute>

</define>

1.2.3Date and Time field declaration

The <presentation:date-time-decl> element specifies the text of a date-time field. See section 1.3.3 for details.

<define name="presentation-decl" combine="choice">

<element name="presentation:date-time-decl">

<ref name="presentation-date-time-decl-attlist"/>

<text/>

</element>

</define>

Name

The presentation:name attribute specifies the name of the date-time declaration.

<define name="presentation-date-time-decl-attlist" combine="interleave>

<attribute name="presentation:name">

<ref name="string"/>

</attribute>

</define>

Source

The presentation:source attribute specifies whether the current date/time or the fixed content of the the field declaration is displayed.

<define name="presentation-date-time-decl-attlist" combine="interleave>

<attribute name="presentation:source">

<choice>

<value>fixed</value>

<value>current-date</value>

</choice>

</attribute>

</define>

Date and time formatting style

The date style referenced by the style:data-style-name attribute is used to format the date and time of the presentation:date-time fields if the field is not fixed.

<define name="presentation-date-time-decl-attlist" combine="interleave">

<optional>

<attribute name="style:data-style-name">

<ref name="styleName"/>

</attribute>

</optional>

</define>

1.3Additional Text Fields

1.3.1Header field

Header fields display a header text specified in a header field declaration (see section 1.2.1). Which header field declaration is used is specified the presentation:use-header-name attribute of the draw page where the field occurs. If the field is contained in a presentation placeholder inside a master page, then the presentation:use-header-name attribute of the drawing page for which the placeholder is displayed is used.

This field is mainly used inside master pages. Since its value may differ for the individual drawing pages that make use of a master page, the current field value is not available.

<define name="paragraph-content" combine="choice">

<element name="presentation:header">

<empty/>

</element>

</define>

1.3.2Footer field

Footer fields display a footer text specified in a footer field declaration (see section 1.2.2). Which footer field declaration is used is specified the presentation:use-footer-name attribute of the draw page where the field occurs. If the field is contained in a presentation placeholder inside a master page, then the presentation:use-footer-name attribute of the drawing page for which the placeholder is displayed is used.

This field is mainly used inside master pages. Since its value may differ for the individual drawing pages that make use of a master page, the current field value is not available.

<define name="paragraph-content" combine="choice">

<element name="presentation:footer">

<empty/>

</element>

</define>

1.3.3Date and time field

Date and time fields display a date/time text as specified in the date time field declaration(see section 1.2.3). Which date-time field declaration is used is specified the presentation:use-date-time-name attribute of the draw page where the field occurs. If the field is contained in a presentation placeholder inside a master page, then the presentation:use-date-time-name attribute of the drawing page for which the placeholder is displayed is used.

This field is mainly used inside master pages. Since its value may differ for the individual drawing pages that make use of a master page, the current field value is not available.

<define name="paragraph-content" combine="choice">

<element name="presentation:date-time">

<empty/>

</element>

</define>

1.4Additional drawing page properties

1.4.1Header Declaration

The presentation:use-header-name attribute specifies the name of the header field declaration (see section 1.2.1) that is used for all header fields (see section 1.3.1) that are displayed on the page.

<define name="draw-page-attlist" combine="interleave">

<optional>

<attribute name="presentation:use-header-name">

<ref name="string"/>

</attribute>

</optional>

</define>

1.4.2Footer Declaration

The presentation:use-footer-name attribute specifies the name of the footer field declaration (see section 1.2.2) that is used for all footer fields (see section 1.3.2) that are displayed on the page.

<define name="draw-page-attlist" combine="interleave">

<optional>

<attribute name="presentation:use-footer-name">

<ref name="string"/>

</attribute>

</optional>

</define>

1.4.3Date and Time Declaration

The presentation:use-date-time-name attribute specifies the name of the date-time field declaration (see section 1.2.3) that is used for all date-time fields (see section 1.3.3) that are displayed on the page.

<define name="draw-page-attlist" combine="interleave">

<optional>

<attribute name="presentation:use-date-time-name">

<ref name="string"/>

</attribute>

</optional>

</define>

1.5Additional drawing page style properties

You can alter the display of the new presentation shape placeholders by using one of the following attributes in the properties element of a drawing page style:

Display Header

The presentation:display-header attribute sets the visibility of placeholder shapes from the master page with the presentation class header.

<define name="style-drawing-page-properties-attlist" combine="interleave">

<optional>

<attribute name="presentation:display-header">

<ref name="boolean"/>

</attribute>

</optional>

</define>

Display Footer

The presentation:display-footer attribute sets the visibility of placeholder shapes from the master page with the presentation class footer

<define name="style-drawing-page-properties-attlist" combine="interleave">

<optional>

<attribute name="presentation:display-footer">

<ref name="boolean"/>

</attribute>

</optional>

</define>

Display Page Number

The presentation:display-page-number attribute sets the visibility of placeholder shapes from the master page with the presentation class page-number.

<define name="style-drawing-page-properties-attlist" combine="interleave">

<optional>

<attribute name="presentation:display-page-number">

<ref name="boolean"/>

</attribute>

</optional>

</define>

Display Date And Time

The presentation:display-date-time attribute sets the visibility of placeholder shapes from the master page with the presentation class date-time.

<define name="style-drawing-page-properties-attlist" combine="interleave">

<optional>

<attribute name="presentation:display-date-time">

<ref name="boolean"/>

</attribute>

</optional>

</define>

00-09-06-MyNewFeature.sxw 22 March 2004

Copyright © Sun Microsystems, Inc 2004. All Rights Reserved. Page 6 of 6