OpenOffice.org XML File Format
O.eTechnical Reference Manual
Version 2
December 2ee2

Sun Microsystems, Inc.
9eO San Antonio Road
Palo Alto, CA 943e3
U.S.A. 65e-96e-O3ee

December 2ee2

Copyrights and Trademarks
Copyright 220 Sn

iirosystemss nics 20 an ntonio oads Caaiiornia 9424s c c c aa rights reserredc

This doiSmentation is distribSted Snder aiienses restriiting its Ssec YoS may make iopies oi and redistribSte its bSt yoS may notmodiiy or make deriratire torks oi this doiSmentation tithoSt prior tritten aSthorikation oi Sn and its aiiensorss ii anyc
Sns Sn iirosystemss the Sn aogos tarPortaas tarOiiiiesthe tarOiiiie aogos Jaras Jara Beans Jara iripts and the Jara Coiiee
CSp are trade marks or registered trademarks oi Sn iirosystemss nic in the c c and other ioSntriesc
Federaa iqSisitions: Commeriiaa oittare - Gorernment sers Sbjeit to tandard Liiense Terms and Conditionsc
DOC
ENT T ON P OV DED "" ND LL EXP E O
PL ED COND T ON s EP E ENT T ON
D
NT E s NCL D NG NY PL ED DNTY OF E CO NT B L TYs F TNE FO
P TC LP PO E O NON- NF NGE ENTs
E D CLEDs EXCEPT TO TOE EXTENT TO T
CO D CLE
OELD TO BE LEG LLY NV L Dc

ND
EContents
1 Intro un1i nito 1teeuo inI.irg iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i1
0c0

Namespaiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccm0c

trSitSre oi OpenOiiiiecorg X L DoiSmentscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

0c c0

DoiSment oot ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0c c

DoiSments and SbdoiSments cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0c c4

Primary DoiSment Charaiteristiis cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccr

0c4

DoiSment niormation cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

42

0c9

tyaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

40

0c9c0

Loiation oi tyaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

0c9c

E.ampaes oi tyaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

0c5

Formscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

0c6

DoiSment Contentcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

0cm

Dhite- paie Proiessing and EOL Oandaingcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

0cr

DoiSment Vaaidationccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49

0crc0
1

n
c0

Proiessing the CSrrent Version cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49
n1ionor1 i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i2

etadataccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

45

c0c0

Generator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

c0c

Titae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

c0c4

Desiription ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

c0c9

Sbjeit cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

c0c5

2eytords ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

c0c6

nitiaa Creator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

c0cm

Creator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

c0cr

Printed By cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

c0c

Creation Date and Time ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r

c0c02

odiiiiation Date and Time cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r

c0c00 Print Date and Time ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r
c0c0

DoiSment Tempaate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r

c0c04

Stomatii eaoad ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

c0c09 Oyperaink Beharior cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 92
c0c05 LangSage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90
c0c06 Editing Cyiaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90
c0c0m Editing DSration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9
c0c0r

c

c4

DoiSment tatistiis cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9

c0c 2

ampae

etadata cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

Formatting Properties and tyaesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99

c c0

Formatting Property ets cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95

c c

impae Formatting Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95

c c4

Compae. Formatting Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95

c c9

tyaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 96

c c5

tyae

appings cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9Page tyaes and LayoStcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

50

Page

aster cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5

c4caster Pages cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5r

c4c4

Oeaders and Footers ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5

c4c9

Oeader and Footer tyaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 62

c4c5

Footnote LayoSt ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 60

c4c6

Footnote eparator Line ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 60

Font Deiaarationsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
c9c0

c5

etadata ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9

c0c0

c4c0

c9

ser-deiined

6

Font Deiaaration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 64

Data tyaescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

69

c5c0

NSmber tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 69

c5c

CSrreniy tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 66

c5c4

Perientage tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 6rc5c9

Date tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 6r

c5c5

Time tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc m

c5c6

Booaean tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc m9

c5cm

Te.t tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc m5

c5cr

Common Data tyae Eaements ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

c5c

Common Data tyae ttribStes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc m6

m6

c5c02 Common NSmber tyae ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc r0

c6

Framescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r9

c6c0

Te.t Bo.es ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc r5

c6c

mages cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc r6

c6c4

Dratings cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc rm

c6c9

Objeits cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc rr

c6c5

ppaets ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc r

c6c6

PaSgins cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

c6cm

Parameters ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

c6cr

Faoating Frames cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

c6cCommon Frame Eaements cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

c6c02 Common Frame ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

c6c00 Frame Formatting Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m

c6c0

0

Faoating Frame Formatting Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 024

c6c04 Objeit Formatting Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 029
c6c09 Frame Erents cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 029
cm

Forms and Controascccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

025

cr

Oyperainkscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

025

c

crc0

impae Oyperainks cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 025

crc

Caient ide mageaps ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 026

NSmber Formatcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

c02

02

c c0

Preii. and Siii. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 02

c c

Format peiiiiiation cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 002

c c4

Letter ynihronikation in NSmber Formats ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 002

iriptsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

002

c00 Erent Tabaesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

000

c00c0 Erent cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 000
c0

Change Traikingcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc00

c0 c0 Change niormation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

004

c04 OpenOiiiiecorg ppaiiation ettingsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc009

c04c0 Base ettings cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 009
c04c

eqSenie oi ettings cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 009

c04c4

nde. iiess oi eqSenies cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 005

c04c9 Name iiess oi eqSenies cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 005
2
4c0

i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
Oeadings and Paragraphsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

00m

4c0c0

Primary Oeading and Paragraph Components ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 00m

4c0c

Dhite- paie Charaiters ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 2

4c

4c4

4c9

4c5

4c6

4cm

4c0c4

Tab tops ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 2

4c0c9Line Breaks cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 04c0c5

Te.t tyaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 04c0c6

Te.t Formatting Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 0

4c0cm

Oyperainks cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 04c0cr

Bookmarks ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 9

4c0cnde. Entries cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 5

4c0c02eierenies cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 5

4c0c00oit Oyphenss Oyphenss and Non-breaking Baanks ccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 6

eitionscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0 6

4c c0

eition oSrie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4c c

DDE oSrie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0

BSaaeted and NSmbered Listsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0 r

042

4c4c0

List Baoiks ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 040

4c4c

List Oeader ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 04

4c4c4

List tem ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 04

4c4c9

List tyaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 049

4c4c5

NSmber Lerea tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 045

4c4c6

BSaaet Lerea tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 04m

4c4cm

mage Lerea tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

04r

OStaine NSmberingccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

092

4c9c0

OStaine tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 090

4c9c

OStaine Lerea tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

090

Line NSmberingccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

09

4c5c0

Line NSmbering ConiigSration cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 09

4c5c

eparator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 095

4c5c4

Line NSmbering Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 095

Footnotes and Endnotesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

096

4c6c0

Footnotes ConiigSration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 096

4c6cEndnotes ConiigSration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4c6c4

Footnotes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 09

4c6c9

Endnotes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 050

Fieadscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

09

05

4cmc0

Common Charaiteristiis oi Fiead Eaements ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 05

4cmc

DoiSment Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 054

4cmc4Date Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 054

4cmc9Time Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 059

4cmc5Page NSmber Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 055

4cmc6

Page ContinSation Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 056

4cmcm

ender Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 05m

4cmcr

Sthor Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 062

4cmc

Paaiehoaders ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 060

4cmc02 Database Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 06
4cmc00 Dispaaying Database Content ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 064
4cmc0

eaeiting the Ne.t Database ot cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 064

4cmc04

eaeiting a ot NSmber cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 069

4cmc09 Dispaaying the ot NSmber cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 065
4cmc05 Dispaay CSrrent Database and Tabae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 066
4cmc06

etadata Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 066

4cmc0m Conditionaa Te.t Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m2
4cmc0r Oidden Te.t Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m
4cmc0

Oidden Paragraph Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m4

4cmc 2 Chapter Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m9
4cmc 0 Fiae Name Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m5
4cmc

DoiSment Tempaate Name Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m6

4cmc 4 Page Variabae Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0m6
4cmc 9airo Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0mr

4cmc 5 DDE Conneitions cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0mr
4cmc 6 DDE Conneition Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r2
4cmc meierenie Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r2

4cmc r Variabae Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r4
4cmc

Deiaaring impae Variabaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r4

4cmc42etting impae Variabaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r9

4cmc40 Dispaaying impae Variabaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r5
4cmc4

impae Variabae npSt Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r6

4cmc44 Deiaaring ser Variabaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0rm
4cmc49 Dispaaying ser Variabaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0rm
4cmc45

ser Variabae npSt Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0rr

4cmc46 Deiaaring eqSenie Variabaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0r
4cmc4msing eqSenie Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 2

4cmc4r E.pression Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 0
4cmc4

Te.t npSt Fieads cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0

4cmc92

iript Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0

4cmc90easSre Fieads ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 4

4cmc9

Tabae FormSaa Fiead ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 44cmc94 Common Fiead ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0 9

4cr

Frames in Te.t DoiSmentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0

4crc0

nihor Type cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0

4crc

nihor Position cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 0

4crc4

nihor Page NSmber ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

20

Sbyccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

20

4c

4c c0

Sby Base cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c c

Sby Te.t ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

24

4c02 Te.t Formatting Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

24

4c02c0 Font Variant ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

24

4c02c

Te.t Transiormations ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

24

4c02c4 Coaor cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

24

4c02c9 Dindot Font Coaor ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

29

4c02c5 Te.t OStaine ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

29

4c02c6 Crossing OSt cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

29

4c02cm Te.t Position cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

29

4c02cr Font Name cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

25

4c02c

Font Famiay cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

25

4c02c02 Font Famiay Generii cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

26

4c02c00 Font tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

26

4c02c0 Font Pitih ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2m

4c02c04 Font Charaiter et cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2m

4c02c09 Font ike cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2r

4c02c05

eaatire Font ike cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2r

4c02c06 Letter paiing cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c02c0m LangSage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c02c0r CoSntry ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c02c0 Font tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

02

4c02c 2 Font eaiei cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

02

4c02c 0 Te.t hadot cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

02

4c02c

nderaining cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

00

4c02c 4nderaine Coaor ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

00

4c02c 9 Font Deight cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

00

4c02c 5 Te.t Deioration Dordode ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0

4c02c 6 Letter 2erning cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0

4c02c m Te.t Bainking ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0

4c02c r Te.t BaikgroSnd Coaor cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

04

4c02c

Te.t Combine ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

04

4c02c42 Te.t Combine tart and End Charaiters cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

04

4c02c40 Te.t Emphasis cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

09

4c02c4 Te.t Stospaie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

09

4c02c44 Te.t iaae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

09

4c02c49 Te.t otation ngae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

05

4c02c45 Te.t otation iaae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

05

4c02c46 PSnitSation Drap ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

05

4c02c4m Line Break cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

05

4c00 Paragraph Formatting Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

06

4c00c0 Fi.ed Line Oeight cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

06

4c00c

inimSm Line Oeight cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

06

4c00c4 Line Distanie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

06

4c00c9 Te.t aign cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0m

4c00c5 Te.t aign oi Last Line cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0m

4c00c6 JSstiiy ingae Dord cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0m

4c00cm Break nside ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0r

4c00cr Didots cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0r

4c00c

Orphans cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0r

4c00c02 Tab tops ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0r

4c00c00 Oyphenation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c00c0 Oyphenation 2eep cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c00c04 Oyphenation emain Char CoSnt cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

4c00c09 Oyphenation PSsh Char CoSnt ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

0

4c00c05

0a.imSm Oyphens cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4c00c06 Drop Caps cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
4c00c0m

egister TrSe ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44c00c0r NSmbering tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44c00c0 Leit and ight

argins cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44c00c 2 Te.t ndent ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44c00c 094c00c

Stomatii Te.t ndent ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
Top and Bottom

argins ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

4c00c 4 Page eqSenie Entry Point cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

4c00c 9 Break Beiore and Break iter ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

4c00c 5 Paragraph BaikgroSnd Coaor ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5

4c00c 6 Paragraph BaikgroSnd mage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5

4c00c m Border cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6

4c00c r Border Line Didth ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m

4c00c

Padding cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

4c00c42 hadot cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccr

4c00c40 2eep tith Ne.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

4c00c4 Line NSmbering ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
4c00c44 Te.t Stospaies PSnitSation Draps Line Break cccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
4c00c49 Vertiiaa aignment ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
4c0

eition Formatting Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
4c0 c0eition BaikgroSnd ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

42

4c0 c

CoaSmns ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

42

4c0 c4 CoaSmn peiiiiiation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

42

4c0 c9 CoaSmn eparator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

4c0 c5 Proteit cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

4c04 Change Traiking in Te.t DoiSmentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

4c04c0 Traiked Changes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

44

4c04c

Changed egions ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49

4c04c4

egion tart and End ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49

4c04c9nsertion ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

45

4c04c5 Deaetion cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

45

4c04c6 Format Change ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

46

4c09 Optionaa niormationcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

46

4c09c0Sto

ark Fiae ior aphabetiiaa ndiies ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m

4 T i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii12T
9c0

Generaa ntrodSition to OpenOiiiiecorg Tabaescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

9c

DoiSment Proteitioncccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

92

9c4

CaaiSaation ettingscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

92

9c9

9c4c0

NSaa Date cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

9c4c

teration cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

Change Traiking in preadsheetscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

94

9c9c0

Traiked Changes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99

9c9c

Dependenies cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99

9c9c4

Dependenie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99

9c9c9

Deaetions cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

95

9c9c5

Ceaa Content Deaetion ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

95

9c9c6

Change Deaetion ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

95

9c9cm

nsertion ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

96

9c9cr

Deaetion cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m

9c9c

CSt Oiis cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r

9c9c02

nsertion CSt Oii cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99c9c00orement CSt Oii ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99c9c0orement cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

52

9c9c04 Target ange ddresss oSrie ange ddress cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

52

9c9c09 Change Traik Ceaa ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5

9c9c05 Ceaa Content Change cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

54

9c9c06 Ceaa ddress ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

54

9c9c0m PrerioSs cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

54

9c9c0rejeition cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

59

9c9c0

Common Change Traiking ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

59

Tabaes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

55

9c5

9c5c0

Tabae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

55

9c5c

Tabae oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5m

9c5c4

ienario Tabae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5r

9c5c9

hapes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

62

CoaSmnsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

60

9c6

9c6c0

GroSping cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

60

9c6c

CoaSmn GroSps ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

60

9c6c4

CoaSmn Desiription cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6

otsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

69

9cm

9cmc0

GroSping cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

69

9cmc

ot GroSps cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

69

9cmc4

ot ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

65

Ceaascccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6m

9cr

9crc0

Tabae Ceaa cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6m

9crc

Ceaa ange oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m4

9crc4

nnotation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m5

9crc9

Deteitire cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m6

9crc5

Oighaighted ange ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m6

9crc6

Operation cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

mm

9crcm

Ceaa ddress Entity cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

mr

9crcr

Ceaa ange ddress Entity ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

m

9crc

Ceaa ange ddress List Entity cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

mTabae Ceaa Content Vaaidationscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r2

9c

9c c0

Tabae Ceaa Content Vaaidation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r2

9c c

Oeap

essage ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

9c c4

Error

essage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

9c c9

Error

airo cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r4

Sbtabaes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r99c00 Labea angescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

rr

9c02

9c0

9c00c0 Labea ange ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

rr

Named E.pressionscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

r

9c0 c0 Named ange ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2

9c0 c

0

Named E.pression ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9c04 Fiaterscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
9c04c0 Tabae Fiater ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
9c04c

Fiater nd ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

9c04c4 Fiater Or ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

9c04c9 Fiater Condition ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99c09 Database angescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6

9c09c0 Database ange ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

6

9c09c

r

Database oSrie oL ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9c09c4 Database oSrie Tabae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
9c09c9 Database oSrie oSery cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 422
9c09c5ort cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 422

9c09c6ort By cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 420

9c09cm

Sbtotaa Saes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 42

9c09crort GroSps ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 424

9c09c

Sbtotaa Sae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 429

9c09c02 Sbtotaa Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 429
9c05 Data Piaot Tabaescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

425

9c05c0 Data Piaot Tabae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 425
9c05c

oSrie erriie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

42r

9c05c4oSrie Ceaa ange cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 42

9c05c9 Fiater ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 42
9c05c5 Data Piaot Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 42
9c05c6 Data Piaot Lerea ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 400
9c05cm Data Piaot Sbtotaas cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 400
9c05cr Data Piaot Sbtotaa ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40
9c05c

Data Piaot

embers ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40

9c05c02 Data Piaot

ember ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40

9c06 Consoaidationccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

404

9c0m DDE Linkscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

405

9c0mc0 DDE Link ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 405
9c0mc

DDE oSrie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 405

9c0r Tabae Formatting Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

406

9c0rc0 Tabae Didth ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 406
9c0rc

Tabae aignment ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 406

9c0rc4 Tabae Leit and ight

argin cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 406

9c0rc9 Tabae Top and Bottom

argin cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m

9c0rc5 Page eqSenie Entry Point cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m
9c0rc6 Break Beiore and Break iter ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m
9c0rcm Tabae BaikgroSnd and BaikgroSnd mage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m
9c0rcr Tabae hadot ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m
9c0rc

2eep tith Ne.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m

9c0rc02

ay Break Betteen ots ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40m

9c0rc00 Borderodea Property cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40r

9c0rc0 Page tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40r
9c0rc04 Dispaay ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40r
9c0

CoaSmn Formatting Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

40

9c0 c0 CoaSmn Didth cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40
9c 2 Tabae ot Formatting Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

40

9c 2c0ot Oeight cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 40

9c 2c

Break Beiore and Break iter ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 2

9c 0 Tabae Ceaa Formatting Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 2

9c 0c0 Vertiiaa aignment ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 2
9c 0cTe.t aign cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 2

9c 0c4 Te.t aign oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 0
9c 0c9 Te.t OStaine ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 0
9c 0c5 Direition cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 0

9c 0c6 Vertiiaa Gayph Orientation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 0
9c 0cm Te.t hadot cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 0
9c 0cr Ceaa hadot ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 0
9c 0cCeaa BaikgroSnd cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

9c 0c02 Ceaa Borders and Border Line Didth cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4
9c 0c00 Padding cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4
9c 0c0 Leit

argin cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

9c 0c04 Drap Option ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4
9c 0c09

otation ngae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4

9c 0c05

otation aign cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 4

9c 0c06 Ceaa Proteit ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 4
9c 0c0m Print Content cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 4
9c 0c0r Data tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 4I4oruoi n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i21
5c0

aster Pagescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 6

5c

5c4

5c0c0

OandoSt

aster cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 m

5c0cPresentation Notes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 r

Drating Pagescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 r

5c c0

BaikgroSnd tyae Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 442

5c c

Presentation Notes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

442

Drating hapescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

440

5c4c0

eitangae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 440

5c4cLine cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 44

5c4c4

Poayaine cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 444

5c4c9

Poaygon cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 449

5c4c5Path cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 449

5c4c6

Ciriae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 445

5c4cm

Eaaipse cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 44m

5c4cr

Conneitor ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 44r

5c4c

Caption ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 492

5c4c02

easSre cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c4c00 Controa ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 494
5c4c0Page ThSmbnaia ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 494

5c4c04 GroSping cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 499
5c4c09 Common Drating hape ttribStes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 499
5c9

Presentation hapescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49m

5c9c0

Common Presentation hape ttribStes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49m

5c9c

Titae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49r

5c9c4

OStaine cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49r

5c9c9

Sbtitae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49r

5c9c5

Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49r

5c9c6

Graphii ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c9cm

Objeit ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c9cr

Chart ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c9c

Tabae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c9c02 Orgiharts cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49
5c9c00 Pages cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49
5c9c0
5c5

Notes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

4D hapesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

49

5c5c0

iene cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 49

5c5cLight ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 45

5c5c4

CSbe ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 454

5c5c9

phere cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 459

5c6

5cm

5c5c5

E.trSde ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 455

5c5c6

otate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 455

Graphii tyae Eaementscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

456

5c6c0

Gradient cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 456

5c6c

Oatih cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 45r

5c6c4

mage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 45

5c6c9

Transpareniy Gradient ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 462

5c6c5

arker cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 460

5c6c6

Dash ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

troke Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

464

5cmc0

tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

469

5cmc

Dash ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 469

5cmc4

Didth cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 469

5cmc9

Coaor cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 469

5cmc5

tart

arker ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 465

5cmc6

End

arker cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 465

5cmcm

tart

arker Didth cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 465

5cmcr

End

arker Didth ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 465

5cmc

tart

arker Center cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 465

5cmc02 Endarker Center ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 466

5cmc00 Opaiity ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 466
5cmc0
5cr

5c

Joint cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 466

Fiaa Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

466

5crc0

tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

46m

5crc

Coaor cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46m

5crc4

Gradient cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46m

5crc9

Gradient tep CoSnt ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46m

5crc5

Oatih cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46m

5crc6

oaid Oatih ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46r

5crcm

Bitmap cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46r

5crcr

Transpareniy cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 46

Te.t nimation Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m2

5c02 Te.t Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m

5c02c0Sto Grot Didth and Oeight cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

5c02c

Fit To ike cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m

5c02c4 Te.t rea Vertiiaa aign cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m
5c02c9 Te.t rea Oorikontaa aign ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m
5c00 Graphii Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m4

5c00c0 Coaor

ode ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m4

5c00c

Coaor nrersion cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m4

5c00c4

djSst LSminanie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m4

5c00c9

djSst Contrast ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5c00c5

djSst Gamma cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m9

5c00c6

djSst ed cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5c00cmdjSst Green ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m9

5c00cr

djSst BaSe ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m9

5c00c

djSst Transpareniy cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4m9

5c0

4m4

4m9

hadot Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m5

5c04 Conneitor Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m6

5c09

easSre Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m6

5c05 Caption Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4m

5c06 4D Geometry Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r0

5c0m 4D Lighting Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r

5c0r 4D Te.tSre Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r4

5c0

ateriaa Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r9

5c 2 4D hadot Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r5

5c 0 Layer etsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r5

4D

5c 0c0 Layer cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r5
5cGaSe Pointsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
5c

4r5

c0 GaSe Point cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r5

5c 4 Presentation Page LayoStscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4r6

5c 4c0 Presentation Paaiehoader cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r6
5c 9 Presentation Page ttribStescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4rm

5c 9c0 Transition Type cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4rm
5c 9cTransition tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4rr

5c 9c4 Transition peed cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4rr
5c 9c9 Page DSration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4rr
5c 9c5 Page Visibiaity cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r
5c 9c6

oSnd ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r

5c 9cm BaikgroSnd ike cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r
5c 9cr BaikgroSnd Objeits Visibae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4r
5c 9c

BaikgroSnd Visibae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 25c 5 Presentation ettingscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 2

5c 5c0 Presentation cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 2
5c 5chots ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 95c 6 Presentation nimationsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4 5

5c 6c0oSnd ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 55c 6c

hot hape cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 65c 6c4

hot Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 r

5c 6c9 Oide hape ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 4 r
5c 6c5 Oide Te.t ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 45c 6c6 Dim ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 45c 6cm Paay cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

4

nI i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i
6c0

Formscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
6c0c0

6c

920

Form ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 920

Controascccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

92m

6c c0

Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 92r

6c cTe.t rea ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 92

6c c4

Passtord cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 902

6c c9

Fiae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 902

6c c5

Formatted Te.t ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 900

6c c6Fi.ed Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90

6c cm

Combo Bo. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90

6c cr

tem cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 904

6c c

List Bo. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 909

6c c02 Option cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 909
6c c00 BStton ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 905
6c c0mage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 905

6c c04 Cheik Bo. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 906
6c c09adio BStton cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90m

6c c05 Frame ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90r
6c c06

mage Frame ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90r

6c c0m Oidden cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90
6c c0r Grid cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 90
6c c0

CoaSmn ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 2

6c c 2 Generii Controa cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 2
6c4

Common Form and Controa ttribStesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9 2

6c9

Common Controa ttribStesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9 0

6c9c0
6c5

Database ttribStes cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 942

Erentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

94

6c5c0

Erents tith an EqSiraaent OT L Erent Type cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94

6c5c

OpenOiiiiecorg Erent Types ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 944

6c6

Propertiesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

949

6c6c0

Property et cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 949

6c6cProperty cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 945

6c6c4

Property VaaSe ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 946

1t u1.iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i 2
mc0

mc

mc4

Basii Components oi OpenOiiiiecorg X L nde.escccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
mc0c0

nde. oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94m

mc0c

nde. Body ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94r

mc0c4

nde. Titae Tempaate cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94r

mc0c9

nde. Entry Tempaates ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94r

mc0c5

Common nde. and nde. oSrie ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 94

nde. Entriescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

mc5

mc6

mcm

990

mc c0

Chapter NSmber ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 990

mc c

Chapter niormation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 990

mc c4

Entry Te.t cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

mc c9

Page NSmber cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

mc c5

Fi.ed tring cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

mc c6

Bibaiography niormation ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

mc cm

Tab top ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 994

mc cr

Oyperaink tart and End ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 999

mc cE.ampae oi an nde. Entry ConiigSration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 995

nde. oSrie tyaescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
mc4c0

mc9

94m

nde.

996

nde. oSrie tyae ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 996
arksccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

99m

mc9c0

Tabae oi Content nde.

arks ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99m

mc9c

ser-Deiined nde.

arks ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99r

mc9c4

aphabetiiaa nde.

ark ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 99

mc9c9

Bibaiography nde.

ark ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 952

Tabae oi Contentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

950

mc5c0

Tabae oi Content oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95

mc5c

Tabae oi Content Entry Tempaate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 954

nde. oi aaSstrationscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

955

mc6c0

nde. oi aaSstration oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 955

mc6c

aaSstration nde. Entry Tempaate cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 956

nde. oi Tabaesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

95m

mcmc0

Tabae nde. oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95m

mcmc

Tabae nde. Entry Tempaate cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95r

mcr

nde. oi Objeitsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

95r

mcrc0

Objeit nde. oSrie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 95r

mcrc

Objeit nde. Entry Tempaate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 962

mc

ser-Deiined nde.cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

962

mc c0

ser-Deiined nde. oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 962

mc c

ser-Deiined nde. Entry Tempaate cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 96

mc02

aphabetiiaa nde.ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

964

mc02c0aphabetiiaa nde. oSrie ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 964

mc02c

aphabetiiaa nde. Entry Tempaate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 966

mc00 Bibaiographyccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

96m

mc00c0 Bibaiography nde. oSrie cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 96m
mc00c

Bibaiography Entry Tempaate ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 96r

r4I i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i
rc0

ntrodSition to Chart DoiSmentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m0

rc

Chartccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m

rc4

Titaecccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m4

rc9

Sbtitaeccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m4

rc5

Legendcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m9

rc6

Paot reaccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m9

rcm

Daaacccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9m6

rcr

Faoorccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9mm

rc

.iscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9mm

rc c0
rc02

Grid cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r0

eriescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r0

rc02c0 Domain ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r
rc00 Categoriesccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r

rc0

Data Pointccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r4

rc04 Common Chart Propertiescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r4

rc04c0 Fiaa Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r4
rc04c

troke Properties cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r4

rc04c4 Te.t Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r9rc04c9aignment Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r9rc04c5 Data Labea Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r9rc04c6

tatistiiaa Properties ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r5

rc04cmotation oi Three-Dimensionaa Diagrams ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9rm

T

9 Ii 1 Ie4o i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
c0

enSbarscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9r

T

c0c0

enSbar ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9r

c0c

enS cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 2

c0c4

enS PopSp ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 2

c0c9

enS tem cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 2

c0c5

enS eparator cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 0

c0c6
c

c4

c9

c5

c6

CommonenSbar ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9

iieaeratorscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

c c0

iieaerator List cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9c ciieaerator tem ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 4

tatSs Barscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9 5

c4c0

tatSs Bar ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 6

c4c

tatSs Bar tem ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9 6

Tooabars cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

9

c9c0

Tooabar ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 9c9c

Tooabar tem ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 522

c9c4

Tooabar LayoSts ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 524

c9c9

Tooabar LayoSt ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 524

Erentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

526

c5c0

Erents ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 52m

c5cErent cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 52mmagescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

52r

c6c0

mages Container ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 52

c6cmages cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 52

c6c4

Entry ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 502

c6c9

E.ternaa mages cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 500

c6c5

E.ternaa Entry cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 500

ou4Tn.i n1 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i
02c0 Diaaog Containersccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

2504

02c0c0 BSaaetin Board cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 509
02ctyaescccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
02c c0505

tyae cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 505

02c4 Controascccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

50r

02c4c0 Common Controa ttribStes ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 50r
02c4c

BStton ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 50

02c4c4 Cheik Bo. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 2
02c4c9 List Bo. and Combo Bo. ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 0
02c4c5adio GroSp and Titaed Bo. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 4

02c4c6 Labea cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5 5

02c4cm Te.t Fiead ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 502c4crmage cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 m

02c4c

Fiae Diaaog ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

5 m

02c4c02 Date Fiead ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5 r
02c4c00 Time Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 5
02c4c0 NSmerii Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 542
02c4c04 CSrreniy Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 540
02c4c09 Pattern Fiead ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 54
02c4c05 Formatted Fiead cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 544
02c4c06 Fi.ed Line cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 545
02c4c0m iroaabar ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 545
02c4c0r Progress Bar ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 546
02c9 Erentsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

54m

02c9c0 Erents peiiiied sing Common Erent Names cccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 54m
02c9c

E.paiiit Erents peiiiied by Listener cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 54

4o 4. i nI 4 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii i
00c0 ntrodSitioncccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

590

00c

1ip Fiae trSitSreccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

59

00c4 Eniryptioncccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

59

00c9

594

aniiest Fiaecccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc

00c9c0aniiest oot Eaement cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 594

00c9cFiae Entry cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 594

00c9c4 Eniryption Data ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 599
00c9c9agorithm ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 599

00c9c5 2ey Deriration ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc 595

Preiaie
boSt This

anSaa

This manSaa desiribes the OpenOiiiiecorg X L iiae iormatc X L is the net natire iiae iormat ior the
OpenOiiiiecorg sSites repaaiing the oad binary iiae iormatc OSr goaa is ttoioad: to hare a iompaete speiiiiiation eniompassing aaa OpenOiiiiecorg iomponentss and to proride an open standard ior oiiiie doiSmentsc n oSr opinions X L is ideaa as an open standard beiaSse oi the iree araiaabiaity oi X L
speiiiiiations and doiSment type deiaarations iDTDsos and the X L sSpport ior X Ls X LTs XLinks
VGs ath Ls and many other important and emerging standardsc One singae X L iormat appaies todiiierent types oi doiSmentss ior e.ampaes the same deiinition appaies to tabaes in te.t doiSments andtabaes in spreadsheetsc
This torking drait manSaa iontains the iSrrent speiiiiiation oi the OpenOiiiiecorg X L iiae iormatc s
the term "torking drait" impaiess the OpenOiiiiecorg X L iiae iormat is tork in progressc This iait has
the ioaaoting impaiiations ior this manSaa:●

The speiiiiiation iontained in this torking drait is not iompaetec The X L speiiiiiation ior many oi
the OpenOiiiiecorg ieatSres has not yet been deiided or doiSmentedc●

This torking drait may iontain speiiiiiations that are not iSrrentay impaemented in the OpenOiiiiecorg
X L import and e.port iiatersc This drait shoSad aaso not omit speiiiiiations ior any ieatSres that areaaready impaemented in the OpenOiiiiecorg X L iiaters bSt there may be e.ieptions to thisc●

The speiiiiiations desiribed in this torking drait may ihangec This is espeiiaaay trSe ior speiiiiiations
that are not iSrrentay impaemented in the OpenOiiiiecorg X L iiaterss bSt may aaso be the iase ior
speiiiiiations that are aaready impaementedc The reasons ior ihanging the speiiiiiations iniaSdeihanges to reaated torking draits aike X L-FO or VGs sSggestions irom rerieters oi the manSaas
errors or inionsisteniies that are ioSnds or probaems tith net speiiiiiations that ian onay be resoared
by ihanging e.isting speiiiiiationsc●

This torking drait may iontain errorss missing iniormations or iniompaete speiiiiiationsc

Dho hoSad ead This

anSaa

This manSaa is intended ior soittare dereaoperss both internaa and e.ternaa to Sn

trSitSre oi ThisiirosystemsTc

anSaa

This manSaa iontains the ioaaoting seitions:●

Chapter 0s ntrodSition to OpenOiiiiecorg X L●

Chapter s Common DoiSment Content
23●Chapter 4s Te.t Content●

Chapter 9s Tabae Content●

Chapter 5s Graphii Content●

Chapter 6s Form Content●

Chapter ms nde.ing●

Chapter rs Chart Content●

Chapter s Paikage Format●

Gaossary●nde.

eaated DoiSmentation
The ioaaoting doiSments proride additionaa X L-reaated iniormation:●

E.tensibae
htma

arkSp LangSage iX Lo 0c2s D4C eiommendation http:sstttct4corgsT s EC-.mac●

iaaabae Veitor Graphiis i VGo 0c2 peiiiiiations D4C Dorking Drait http:sstttct4corgsT s 222s
24sDD- VG- 2222424sinde.chtma●

Namespaies in X Ls Dorad Dide Deb ConsortiSm http:sstttct4corgsT s EC-.ma-names●

X L Transiormations iX LTo Version 0c2s D4C eiommendation http:sstttct4corgsT s.sat●

X L Path LangSage iXPatho Version 0c2s D4C eiommendation http:sstttct4corgsT s.path●

X L Linking LangSage iXLinko Version 0c2s D4C Candidate eiommendation http:sstttct4corgs
T s.aink●

E.tensibae tyaesheet LangSage iX Lo Version 0c2s D4C Dorking Drait http:sstttct4corgsT s.sa●

OT L 9c20 peiiiiiations D4C eiommendation http:sstttct4corgsT shtma920●

O r620s http:sstttcisocihsmarketesr620cpdi●

O 64 s http:sstttcoasis-opencorgsiorersiso64 achtma●

O 4066s http:sstttcoasis-opencorgsiorersioSntry4066chtma

t the time oi triting this doiSments some oi these reaated doiSments are torking draitsc Paease note that
any iniormation irom these draits that is Ssed in this doiSment may ihangec

Conrentions
The ioaaoting ionrentions are Ssed in this manSaa:
n1v 1 un1

24

o 9oIuo un1

italic typetaaii type is Ssed to indiiate iompaete titaes oi manSaas and toemphasike te.tc

nTte4o i yo

Boadiaie type indiiates an item that is iontained in the gaossaryc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual

Version 2

December 2ee2

n1v 1 un1courier fonto 9oIuo un1
CoSrier iont is Ssed to indiiate aaa X L eaements and attribStes andtheir raaSesc

Terminoaogy
The ioaaoting terms are Ssed ireqSentay in this manSaa and hare a speiiiii meaning in the ionte.t oi the
manSaa:I

g 41u1.

Saes

This term is Ssed in the tabaes that e.paain the OpenOiiiiecorg X L
eaements and attribStesc n this ionte.ts the term Saes means thetays in thiih yoS ian Sse the eaement or attribStes that speiiiii
raaSes are aiieptabae and not aiieptabaes and any other speiiiii
points that yoS need to knot aboSt Ssing the eaement or attribStec

Preface25

CHAPTER

10

ntrodSition to OpenOiiiiecorg X LThis ihapter introdSies the strSitSre and basii design ieatSres oi the OpenOiiiiecorg X L iiae iormat in
OpenOiiiiecorg doiSmentsc The ihapter iontains the ioaaoting seitions:●●●Namespaies
trSitSre oi OpenOiiiiecorg X L DoiSments
DoiSment niormation

●
●
●

tyaes

●

Forms

●

DoiSment Content●

Dhite- paie Proiessing and EOL Oandaing●

DoiSment Vaaidation

0c0 Namespaies
aists the OpenOiiiiecorg X L namespaies and their preii.esc For more iniormation aboSt X L namespaiess
paease reier to the Namespaies in X L speiiiiiations aoiated at http:sstttct4corgsT s EC-.ma-names
4 T i Tito 1teeuo inI.irg i 4

9o4o 9I euo 9oIuo un1

4

9o4o iofficeFor aaa iommon pieies oi iniormation that are not iontained inanothers more speiiiii namespaiec

http://openoffice.org/2000/officestyle

For eaements and attribStes thatdesiribe the styae and inheritanie
modea Ssed by OpenOiiiiecorg as
teaa as some iommon iormatting
attribStesc

http://openoffice.org/2000/stylescriptFor eaements and attribStes that
represent siripts or erentsc

http://openoffice.org/2000/script

api

For eaements and attribStes that arereaated to the OpenOiiiiecorg P c

http://openoffice.org/2000/api

27

0c

I eu

o 9oIuo un1

4

form

For eaements and attribStes thatdesiribe iorms and iontroasc

text

For eaements and attribStes that may http://openoffice.org/2000/text
oiiSr tithin te.t doiSments and te.t
parts oi other doiSment typess sSih
as the iontents oi a spreadsheet ieaac

table

For eaements and attribStes that
may oiiSr tithin spreadsheets ortithin tabae deiinitions oi a te.t
doiSmentc

http://openoffice.org/2000/tablemeta

For eaements and attribStes thatdesiribe meta iniormationc

http://openoffice.org/2000/meta

numberFor eaements and attribStes thatdesiribe data styae iniormationc

http://openoffice.org/2000/tatastyletraw

For eaements and attribStes thatdesiribe graphii iontentc

http://openoffice.org/2000/trawing

presentation

For eaements and attribStes thatdesiribe presentation iontentc

http://openoffice.org/2000/presentationchart

For eaements and attribStes thatdesiribe ihart iontentc

http://openoffice.org/2000/chart

xlink

The r u1 namespaiec

http://www.w3.org/1999/xlink

fo

The rh iormatting objeits andproperties namespaiec

http://www.w3.org/1999/XSL/Format

svg

The hhhttp://www.w3.org/2000/svg

tialogFor eaements and attribStes thatdesiribe diaaogsc

namespaiec

9o4o i

http://openoffice.org/2000/form

http://openoffice.org/2000/tialog

trSitSre oi OpenOiiiiecorg X L DoiSments
Eaih strSitSraa iomponent in an OpenOiiiiecorg X L doiSment is represented by an T
1 s tith assoiiated4 Iu r 9c The strSitSre oi X L doiSments appaies to aaa OpenOiiiiecorg appaiiationsc There is no diiierenie
betteen a te.t doiSments a spreadsheet or a dratings apart irom the iontentc asos aaa doiSment types may
iontain diiierent styaesc YoS ian e.ihange doiSment iontent that is iommon to aaa doiSment types irom one typeoi doiSment to anotherc

0c c0 DoiSment oot
The tnor 1 iInn i T
1 iis the primary eaement oi an OpenOiiiiecorg X L doiSmentc t iontains the entire
doiSmentc aa types oi OpenOiiiiecorg X L doiSmentss ior e.ampaes te.t doiSmentss spreadsheetss and drating
doiSments Sse the same type oi doiSment root eaementc

28

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<office:tocument<

RrT 9Ti

aa OpenOiiiiecorg X L doiSments mSst hare a doiSment root eaementc
aa other seitions oi an OpenOiiiiecorg X L doiSment are represented by eaements that areiontained tithin the doiSment root eaementc<!ELEMENT office:tocument (office:meta?, office:settings?,
office:script?,
office:font-tecls?,
office:styles?,office:automatic-styles?,office:master-styles?,office:botyy<o oTi

0c c DoiSments and SbdoiSments
n OpenOiiiiecorg X L doiSment ian be represented in the ioaaoting tto tays:●●s a singae X L doiSment that ioniorms to the OpenOiiiiecorg doiSment type deiinitionc
s a ioaaeition oi sereraa sSbdoiSmentsc The sSbdoiSments are raaid X L doiSments bSt eaih sSbdoiSment
has a diiierent doiSment rootc Eaih sSbdoiSment stores a partiiSaar aspeit oi the X L doiSments ior
e.ampaes one sSbdoiSment ian iontain the styae iniormation and another sSbdoiSment ian iontain the iontent
oi the doiSmentc aa types oi doiSmentss ior e.ampaes te.t and spreadsheet doiSmentss Sse the same doiSment and sSbdoiSments deiinitionsc

Dhen storing an OpenOiiiiecorg X L doiSment on disks the OpenOiiiiecorg soittare aatays Sses the sSbdoiSment iormats there eaih sSbdoiSment is stored as one entry in the oreraaa paikagec This method is based on the
popSaar 1 P iiae iormatc
The sSbdoiSments that OpenOiiiiecorg sSpports and the names that are Ssed in the paikage are sSmmariked in
the ioaaoting tabae:
hr tnor
4

1

Rnn iET1hrtnor

1 i n1 1 9

meta.xml<office:tocument-meta<

DoiSment meta iniormations sSih as the aSthor or thetime oi the aast sare aitionc

styles.xml<office:tocument-styles<

tyaes Ssed in the doiSment iontent and aStomatii
styaes Ssed in the styaes themsearesc

content.xml<office:tocument-content<

DoiSment iontent and aStomatii styaes Ssed in theiontentc

settings.xml<office:tocument-settings<

ppaiiation-speiiiii settingss sSih as the tindot sikeor printer iniormationc

The deiinitions oi the root eaements desiribed in the tabae abore are anaaogoSs to the deiinition oi <office:tocument<s e.iept that the ihiad eaement speiiiiiation is sSitabay restriitedc

0c c4 Primary DoiSment Charaiteristiis
YoS deiine primary doiSment iharaiteristiis in the doiSment root eaement Ssing the ioaaoting attribStes:
●

Caass

●

Version
Chapter O Introduction to OpenOffice.org XML

29

CaassThe office:class attribSte identiiies the doiSment iaass oi an OpenOiiiiecorg X L doiSmentc DoiSmentiaasses that yoS ian assign are as ioaaots:
●

Te.t

●

Gaobaa doiSment●

preadsheet●

Drating●

Presentation

athoSgh the doiSment strSitSre is the same ior aaa doiSment iaassess most appaiiations ian onay deaa tith a
iertain iaass oi doiSmentsc For e.ampaes ii yoS read a spreadsheet doiSment Ssing a tord proiessor appaiiation
there is aatays some aoss oi iniormationc The iaass attribSte enabaes an appaiiation to deteit the doiSment iaass
tithoSt parsing the doiSmentc This is partiiSaaray SseiSa in the ioaaoting sitSations:●

Dhen appaiiations ian deaa tith sereraa doiSment iaassesc●

Dhen an rhtransiormation to another iormat shoSad be appaieds and there are sereraa styaesheets araiaabae
there eaih styaesheet is speiiiii to a iertain doiSment iaassc

rg i nt Ti

office:classRrT 9TYoS mSst speiiiy a doiSment iaass attribSte ior erery OpenOiiiiecorg X L doiSmentc

o oTi<!ATTLIST office:tocument office:class (text|text-global|
spreatsheet|trawing|presentation|charty teEt|IeEt<

Versionn OpenOiiiiecorg X L iiae ian iontain the rersion nSmber oi the iiae iormatc The rersion nSmber is in theiormat revision.versionc i the iiae has a rersion and the OpenOiiiiecorg appaiiation reiognikes the DTD
that beaongs to this rersions it may raaidate the doiSmentc Othertises the appaiiation does not need to raaidate thedoiSments bSt the doiSment mSst be A TTienI tc
The office:version attribSte prorides the rersion nSmber oi the doiSmentc
rg i nt Ti

office:version

RrT 9TThe version attribSte is attaihed to the root eaementc

o oTi<!ATTLIST office:tocument office:version CtATA tIMPLIEt<

n 9Ti

The rersion nSmber oi the teihniiaa preriet is 2c ct some eaementss yoS ian attaih iSstom attribStess thiih OpenOiiiiecorg appaiiation keeps
in iase the doiSment is e.portedc i yoS Sse this ieatSres then there mSst be no rersion
nSmbers beiaSse this ioSad resSat in raaidating errors that prerent the doiSment irom aoadingc

0c4 DoiSment niormationn this manSaas iniormation aboSt an OpenOiiiiecorg X L doiSment is iaaaed
are:
●

30

4t4 4c E.ampaes oi metadata

DoiSment titae

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●
●

Sthor
DoiSment ireation date

YoS speiiiy metadata tithin the <office:meta< eaementc
rg i nt Ti<office:meta<

RrT 9T

This eaement iontains metadatac

o oTi<!ENTITY % meta "(meta:generator?,tc:title?,
tc:tescription?,tc:subiect?,
meta:initial-creator?,meta:creation-tate?,
tc:creator?,tc:tate?,
meta:printet-by?,meta:print-tate?,
tc:keyworts?,tc:language?,
meta:etiting-cycles?,meta:etiting-turation?,
meta:hyperlink-behaviour?,meta:auto-reloat?,meta:template?,meta:user-tefineta, meta:
tocument-statistics?y<!ELEMENT office:meta %meta;<

n T

0c9

n the DTDs the eaement names iorrespond to the DSbain Core Eaement et ihttp:sspSracoiaic
orgsdisoc This is indiiated by the tc namespaie preii.ctyaes
n OpenOiiiiecorg X L doiSment iontains the ioaaoting types oi 9 yT 9:●nn1i9 yT 9
The X L representations oi the styaes that are araiaabae in the OpenOiiiiecorg Sser interiaie are reierred to asstyaess ors there a diiierentiation irom the other types oi styaes is reqSireds they are reierred to as iommon
styaesc The term common indiiates that this is the type oi styae that an OpenOiiiiecorg Ssers tho is not interested in the OpenOiiiiecorg X L iiae iormats ionsiders to be a styaec●

Ar n 4 uoi9 yT 9
n aStomatii styaeiiontains iormatting properties thats in the Sser interiaie riet oi a doiSments are assigned
to an objeit sSih as a paragraphc The term automatic indiiates that the styae is generated aStomatiiaaay at
e.port timec n other tordss iormatting properties that are immediateay assigned to a speiiiii objeit are represented by an aStomatii styae tithin an OpenOiiiiecorg X L doiSmentc This tays a separation oi iontent andaayoSt is aihieredc●

g49 Ii9 yT 9
master styae is a iommon styae that iontains iormatting iniormation and additionaa iontent that is dispaayedtith the doiSment iontent then the styae is appaiedc n e.ampae oi a master styae is an OpenOiiiiecorg Dratmaster pagec n this iases the additionaa iontent is any shapes that are dispaayed as the baikgroSnd oi the drat
pagec nother e.ampae oi master styaes are page mastersc n this iases the additionaa iontent is the headers andiootersc Paease note that the iontent that is iontained tithin master styaes is additionaa iontent that iniaSenies
the representation oi a doiSment bSt does not ihange the iontent oi a doiSmentc

s iar as the OpenOiiiiecorg Sser is ionierneds aaa types oi styaes are part oi the doiSmentc They represent theoStpSt deriie-independent aayoSt and iormatting iniormation that the aSthor oi a doiSment has Ssed to ireate oredit the doiSmentc The assSmption is that the aSthor oi the doiSment tants this iormatting and aayoSt iniormation
to be preserred then the doiSment is reaoaded or dispaayed on a iertain deriies beiaSse this is iommon praitiie
ior doiSments ireated by tord proiessorsc
This type oi styae iniormation diiiers irom hh or X LT styae sheets that are Ssed to dispaay a doiSmentc nadditionaa styae sheet ior C s X LTs and so ons is reqSired to dispaay an OpenOiiiiecorg X L doiSment on a
iertain deriiec This styae sheet mSst take into aiioSnt the styaes in the doiSment as teaa as the reqSirements andChapter O Introduction to OpenOffice.org XML

31

iapabiaities oi the oStpSt deriiec The ideaa iase is that this styae sheet depends on the oStpSt deriie onayc

0c9c0 Loiation oi tyaes
Common and aStomatii styaes hare the same OpenOiiiiecorg X L representations bSt they are iontained tithin
tto distinit iontainer eaementss as ioaaots:●<office:styles< ior iommon styaes●<office:automatic-styles< ior aStomatii styaes
aster styaes are iontained tithin a iontainer eaement oi its otn:●

<style:master-styles<

0c9c E.ampaes oi tyaesr ienTTnAu1.i 4 oT 9iuTTr9 I4 i r ituee I 1 i yo 9ineiOpenOiiiiecorgirg i9 yT 9ii
E 4 oT Tito 1teeuo inI.irg i9 yT 9
<office:tocument ...<
<office:styles<...
</office:styles<<office:automatic-styles<...
</office:automatic-styles<</office:tocument<
E 4 oT Tio o

32

o oTi

<!ENTITY % styles "(style:tefault-style|style:style|
text:list-style|number:number-style|number:currency-style|number:percentage-style|number:tate-style|number:time-style|number:boolean-style|number:text-style|traw:gratient|traw:hatch|
traw:fill-image|traw:marker|traw:stroke-tash|style:presentation-page-layout|traw:transparencyy"<<!ELEMENT office:styles (%styles;|text:outline-style|
text:footnotes-configuration|
text:entnotes-configuration|
text:bibliography-configuration|
text:linenumbering-configurationya<<!ELEMENT office:automatic-styles (%styles;|style:page-masteryay<<!ELEMENT office:master-styles (traw:layer-set?,style:hantoutmaster?,style:master-pageay<n T

tyaes in a doiSment are ainked to the doiSment by an X L eaement instead oi a <?xmlstylesheet?< proiessing instrSitionc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

0c5 Forms
The <office:forms< eaement iontains aaa oi the iorms in an OpenOiiiiecorg X L doiSmentci
rg i nt Ti<office:forms<

RrT 9Tiniormation to be sSppaiedc

o oT<!ELEMENT office:forms (form:formya<

0c6 DoiSment Content
The <office:boty< eaement iontains the iontent oi a doiSment in one or more page seqSeniess as ioaaots:●

The iontent distribStion oi te.t doiSments is speiiiied in eition c●

spreadsheet iontains one page seqSenie ior erery tabae that is iontained in the doiSmentc●

drating iontains one page seqSenie ior erery pagec

rg i nt Ti<office:boty<

RrT 9Tniormation to be sSppaiedc

o oT<!ELEMENT office:boty ANY<

0cm Dhite- paie Proiessing and EOL Oandaing
The T2 X L speiiiiiation reqSires that thite-spaie iharaiters are ignored ior eaements that hare eaement
iontents in other tords that iontain eaements bSt not te.tc This iondition appaies to the ioaaoting thite-spaie andend-oi-aine iEt o niiode iharaiters:●

OO 1ONT L T B L T ON i2.222 o●

L NE FEED i2.222 o

●

C

●

GE ET

N i2.222Do

P CE i2.22 2oo

For any other eaements thite-spaies are preserred by deiaSatc naess othertise stateds there is no speiiaa proiessing ior any oi the ioSr thite-spaie iharaitersc For some eaementss diiierent thite-spaie proiessing may takepaaies ior e.ampae the paragraph eaementc
The X L speiiiiiation aaso reqSires that any oi the ioSr thite-spaie iharaiters that is iontained in an attribSte
raaSe is normaaiked to a P CE iharaiterc
One oi the ioaaoting iharaiters may be Ssed to represent aine ends:●

L NE FEED●C●

The seqSenie oi the iharaiters C

GE ET

N
GE ET

N and L NE FEED

Coniorming to the X L speiiiiiations aaa the possibae aine ends are normaaiked to a singae L NE FEED iharaiterc
s a ionseqSenie oi the thite-spaie and EOL proiessing rSaess any C
GE ET N iharaiters that areiontained either in the te.t iontent oi an eaement or in an attribSte raaSe mSst be enioded by the iharaiter entity
Chapter O Introduction to OpenOffice.org XML

33

Atx0t;c The same appaies to the OO 1ONT L T B L T ON and L NE FEED iharaiters ii they areiontained in an attribSte raaSec

0cr DoiSment Vaaidationn generaas an X L doiSment may be raaidated or notc i it is raaidateds it mSst matih the DTD e.aitayc n some
sitSationss it is not appropriate to raaidate an X L doiSmentc For e.ampae:●

The doiSment tas ireated by a diiierent rersion oi the OpenOiiiiecorg appaiiationc●

The doiSment iontains a iSstom e.tensionc

These types oi doiSments may iontain attribStess attribSte raaSess or eaements that are Snknotn to the appaiiationthat proiesses the iiaec The iortard-iompatibae proiessing rSaes desiribe hot an appaiiation shoSad handae sSih
eaements and attribStes to get the most irom the iontents oi the doiSmentc

0crc0 Proiessing the CSrrent Version
Vaaidation and iortard-iompatibae proiessing is iontroaaed by the office:version attribStec Erery appaiiation has a orII 1 ieuT ienI 4 irersions thiih stores aaa the iniormation iontained in the doiSment tithoSt aosing
any iniormation then the doiSment is read againc n appaiiation may aaso be abae to proiess doiSments ireated
Ssing other rersionsc For simpaiiitys it is assSmed that these rersions are aaso iorered by the ioniept oi a iSrrent
rersionc For erery rersions there is a speiiiii DTD that may be Ssed to raaidate doiSmentsc
shots the reaationships betteen a iSrrent rersion oi a doiSments ionsisting oi a major rersion and a minor
rersions and the tay it is proiessed by an appaiiation:34

4 T i Ti Ino 99u1.iR T4 un19ruo9i nIi rII 1 ionor

1 ih I9un19

ei r i 4jnIiv I9un1inei rtnor 1 iu9iii

41t/nI

nIA4It-on o4 u T ioIno- h4Tut4 un1ih 4 r999u1.iu9iiii

cccthe same as the iSrrent
major rersionccc

cccand the minor rersion oi Disabaed
the doiSment is aess or thesame as the iSrrent minor
rersionccc

The doiSment may be
raaidateds bSt it does notneed to bec

cccthe same as the iSrrent
major rersionccc

cccand the minor rersion oi Enabaed
the doiSment is greaterthan the iSrrent minor
rersionccc

The doiSment mSst not be
raaidatedc The onay type oi
iniormation that may beaost is iniormation aboSt
ieatSres that are sSpportedby the more reient rersion
oi OpenOiiiiecorgc

cccdiiierent irom theiSrrent major rersionccc

cccor ii there is no rersion Enabaed
iontained in the doiSmentat aaaccc

The doiSment mSst not be
raaidatedc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CHAPTER

2

Common DoiSment Content
This ihapter desiribes the OpenOiiiiecorg X L iiae iormat ior iontent that is iommon to aaa doiSment typesc tiontains the ioaaoting seitions:●etadata●

Formatting Properties and tyaes●

Page tyaes and LayoSt●

Data tyaes●

Frames●

Forms and Controas●

Oyperainks●

NSmber Format●

iripts●Erent Tabaes●

Change Traiking

●
●

c0

OpenOiiiiecorg ppaiiation ettings

etadataetadata is generaa iniormation aboSt a doiSmentc n an OpenOiiiiecorg X L doiSments aaa oi the metadataeaements are iontained in an <office:meta< eaements SsSaaay aoiated at start oi the doiSmentc

35

rg i nt Ti<office:meta<

RrT 9T

This eaement iontains metadata eaementsc

o oTi<!ENTITY % meta "(meta:generator?,tc:title?,
tc:tescription?,tc:subiect?,
meta:initial-creator?,meta:creation-tate?,
tc:creator?,tc:tate?,
meta:printet-by?,meta:print-tate?,
tc:keyworts?,tc:language?,
meta:etiting-cycles?,meta:etiting-turation?,
meta:hyperlink-bahviour?,meta:auto-reloat?,meta:template?,meta:user-tefineta,
meta:tocument-statistic?y<!ELEMENT office:meta %meta;<

c0c0 Generator
The <meta:generator< eaement iontains a string that identiiies the appaiiation or tooa that tas Ssed to ireateor aast modiiy the X L doiSmentc
rg i nt T<meta:generator<

RrT 9Ti the appaiiation that ireated the doiSment ioSad not proride an identiiier strings the appaiiation
does not e.port this eaementc i another appaiiation modiiies the doiSment and it iannot proride a
SniqSe identiiiers it is not aaaoted to e.port the originaa identiiier beaonging to the appaiiation that
ireated the doiSmentc

o oT<!ELEMENT meta:generator (tPCtATAy<

c0c Titae
The <tc:title< eaement speiiiies the titae oi the doiSmentc
rg i nt T<tc:title<RrT 9To oT<!ELEMENT tc:title (tPCtATAy<

c0c4 Desiription
The <tc:tescription< eaement iontains a briei desiription oi the doiSmentc
rg i nt T<tc:tescription<

RrT 9To oT<!ELEMENT tc:tescription (tPCtATAy<

c0c9 Sbjeit
The <tc:subiect< eaement speiiiies the sSbjeit oi the doiSmentc

36

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<tc:subiect<RrT 9To oT<!ELEMENT tc:subiect (tPCtATAy<

c0c5 2eytords
The <meta:keyworts< eaement iontains keytords ior the doiSmentc The metadata ian iontain any nSmberoi <meta:keywort< eaementss eaih eaement speiiiying one keytordc
rg i nt T<meta:keyworts<

RrT 9T

This eaement ian iontain one keytordc

o oT<!ELEMENT meta:keyworts (meta:keywortya<<!ELEMENT meta:keywort (tPCtATAy<

c0c6 nitiaa Creator
The <meta:initial-creator< eaement speiiiies the name oi the person tho ireated the doiSment
initiaaayc
rg i nt T<meta:initial-creator<

RrT 9To oT<!ELEMENT meta:initial-creator (tPCtATAy<

c0cm Creator
The <tc:creator< eaement speiiiies the name oi the person tho aast modiiied the doiSmentc
rg i nt T<tc:creator<

RrT 9To oT
n 9T<!ELEMENT tc:creator (tPCtATAy<
The name oi this eaement tas ihosen ior iompatibiaity tith the DSbain Corec

c0cr Printed By
The <meta:printet-by< eaement speiiiies the name oi the aast person tho printed the doiSmentc
rg i nt T<meta:printet-by<

RrT 9To oT<!ELEMENT meta:printet-by (tPCtATAy<

Chapter 2 Common Document Content

37c0c Creation Date and TimeThe <meta:creation-tate< eaement speiiiies the date and time then the doiSment tas ireated initiaaayc
rg i nt T<meta:creation-tate<

RrT 9T

To ioniorm tith O r620s the date and time iormat is YYYYior a pointer to O r620c

o oT<!ENTITY % c-tate-time "(tPCtATAy"<<!ELEMENT meta:creation-tate %c-tate-time;<

c0c02-DDThh:mm:ssc ee page 9

odiiiiation Date and TimeThe <tc:tate< eaement speiiiies the date and time then the doiSment tas aast modiiiedc
rg i nt T<tc:tate<

RrT 9T

To ioniorm tith O r620s the date and time iormat is YYYYior a pointer to O r620c

o oT<!ELEMENT tc:tate %c-tate-time;<

n 9T-DDThh:mm:ssc ee page 9

The name oi this eaement tas ihosen ior iompatibiaity tith the DSbain Corec

c0c00 Print Date and TimeThe <meta:print-tate< eaement speiiiies the date and time then the doiSment tas aast printedc
rg i nt T<meta:print-tate<

RrT 9T

To ioniorm tith O r620s the date and time iormat is YYYYior a pointer to O r620c

o oT<!ELEMENT meta:print-tate %c-tate-time;<-DDThh:mm:ssc ee page 9

c0c0 DoiSment Tempaate
The <meta:template< eaement iontains amentc The
L is speiiiied as an XLinkc

L ior the doiSment tempaate that tas Ssed to ireate the doiS-rg i nt T<meta:template<RrT 9T

This eaement ioniorms to the XLink peiiiiiationc ee page 9 ior a pointer to this speiiiiiationc

o oT<!ELEMENT meta:template EMPTY<<!ATTLIST meta:template xlink:type (simpley tFIXEt "simple"<<!ATTLIST meta:template xlink:role CtATA tIMPLIEt<<!ATTLIST meta:template xlink:actuate (oneequesty tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <meta:template< eaement are:38●

Tempaate aoiation●

Tempaate titae●

Tempaate modiiiiation date and time

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Tempaate Loiationn xlink:href attribSte speiiiies the aoiation oi the doiSment tempaatec
xlink:href

rg i nt T
RrT 9T<!ATTLIST meta:template xlink:href %url; teEt|IeEt<

o oT

Tempaate Titae
The xlink:title attribSte speiiiies the name oi the doiSment tempaatec
xlink:title

rg i nt T
RrT 9T<!ATTLIST meta:template xlink:title CtATA tIMPLIEt<

o oT

Tempaate

odiiiiation Date and TimeThe meta:tate attribSte speiiiies the date and time then the tempaate tas aast modiiieds prior to being Ssed toireate the iSrrent doiSmentc
rg i nt T

meta:tate

RrT 9T

To ioniorm tith O r620s the date and time iormat is YYYYior a pointer to O r620c

o oT<!ENTITY %tate-time "CtATA"<<!ATTLIST meta:template meta:tate %tate-time; tIMPLIEt<

c0c04-DDThh:mm:ssc ee page 9

Stomatii eaoad

The <meta:auto-reloat< eaement speiiiies thether a doiSment is reaoaded or repaaied by another doiSment aiter a iertain period oi time has eaapsedc<meta:auto-reloat<

rg i nt T
RrT 9T<!ELEMENT meta:auto-reloat EMPTY<o oT

The attribStes that yoS ian assoiiate tith the <meta:auto-reloat< eaement are:
●

eaoad

●

eaoad deaay

eaoad

L

L

i a aoaded doiSment shoSad be repaaied by another doiSment aiter a iertain period oi times the <meta:autoreloat< eaement is presented as an XLinkc n xlink:href attribSte identiiies theL oi the repaaiement
doiSmentc

Chapter 2 Common Document Content

39

rg i nt T

xlink:href

RrT 9To oT<!ATTLIST meta:auto-reloat xlink:type (simpley tIMPLIEt<<!ATTLIST meta:auto-reloat xlink:show (replacey tIMPLIEt<<!ATTLIST meta:auto-reloat xlink:actuate (onLoaty tIMPLIEt<<!ATTLIST meta:auto-reloat xlink:href %url; tIMPLIEt<

eaoad Deaay
The meta:telay attribSte speiiiies the reaoad deaayc
rg i nt T

meta:telay

RrT 9T

To ioniorm tith O r620s the iormat oi the raaSe oi this attribSte is PnYnMntTnmnMnSc eeeition 5c5c4c oi O r620 ior more detaiaed iniormation on this time iormatc ee page 9 ior apointer to O r620c

o oT<!ENTITY % turation "CtATA"<<!ATTLIST meta:auto-reloat meta:telay %turation; "P0S"<

c0c09 Oyperaink Beharior
The <meta:hyperlink-behaviour< eaement speiiiies the deiaSat beharior ior hyperainks in the doiSmentc
rg i nt T<meta:hyperlink-behaviour<RrT 9To oT

To be supplied

The attribSte that yoS ian assoiiate tith the <meta:hyperlink-behaviour< eaement is:●

Target irame

Target Frame
The meta:target-frame-name attribSte speiiiies the name oi the deiaSat target irame in thiih to dispaay a
doiSment reierenied by a hyperainkc

40

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

meta:target-frame-name

RrT 9T

This attribSte ian hare one oi the ioaaoting raaSes:●_self : The reierenied doiSment repaaies the iontent oi the iSrrent iramec●_blank : The reierenied doiSment is dispaayed in a net iramec●_parent : The reierenied doiSment is dispaayed in the parent irame oi the iSrrent iramec●_top : The reierenied doiSment is dispaayed in the topmost irames that is the irame that
iontains the iSrrent irame as a ihiad or desiendent bSt is not iontained tithin another iramec●

irame name : The reierenied doiSment is dispaayed in the named iramec i the named irame
does not e.ists a net irame tith that name is ireatedc

To ioniorm tith the XLink peiiiiiations an additionaa xlink:show attribSte is attaihed to
the <meta:hyperlink-behavour< eaementc ee page 9 ior a pointer to the XLink peiiiiiationc i the raaSe oi the meta:target-frame-name attribSte is _blanks the xlink:show attribSte raaSe is newc i the raaSe oi the meta:target-frame-name attribSte is
any oi the other raaSe optionss the raaSe oi the xlink:show attribSte is replacec
o oT<!ATTLIST meta:hyperlink-behaviour meta:target-frame-name
CtATA tIMPLIEt<<!ATTLIST meta:hyperlink-behaviour xlink:show (new|replaceytIMPLIEt<

c0c05 LangSage
The <tc:language< eaement speiiiies the deiaSat aangSage oi the doiSmentc
rg i nt T<tc:language<RrT 9T

The manner in thiih the aangSage is represented is simiaar to the aangSage tag desiribed in FC
0m66 s aoiated at http:ssiniocinternetcisicedSsin-notessriisiiaessrii0666ct.t c t ionsists oi a tto-aetter
LangSage Code taken irom the O 64 standard optionaaay ioaaoted by a hyphen i-o and a ttoaetter CoSntry Code taken irom the O 4066 standardc ee page 9 ior pointers to O 64 andO 4066co oT<!ENTITY % c-language "(tPCtATAy"<<!ELEMENT tc:language %c-language;<c0c06 Editing Cyiaes
The <meta:etiting-cycles< eaement speiiiies the nSmber oi editing iyiaes the doiSment has been
throSghc
rg i nt T<meta:etiting-cycles<

RrT 9TThe raaSe oi this eaement is iniremented erery time the doiSment is saredc The eaement iontains
the nSmber oi editing iyiaes as te.tc

o oT<!ENTITY % c-number "(tPCtATAy"<<!ELEMENT meta:etiting-cycles %c-number;<

Chapter 2 Common Document Content

41

c0c0m Editing DSration
The <meta:etiting-turation< eaement speiiiies the totaa time spent editing the doiSmentc
rg i nt T<meta:etiting-turation<

RrT 9TThe dSration is represented in the manner desiribed in eition 5c5c4c oi
ior a pointer to O r620c

o oT<!ENTITY % c-turation "(tPCtATAy"<<!ELEMENT meta:etiting-turation %c-turation;<c0c0r

ser-deiined

O r620c ee page 9

etadata

The <meta:user-tefinet< eaement speiiiies any additionaa Sser-deiined metadata ior the doiSmentc
rg i nt T<meta:user-tefinet<

RrT 9T

Eaih instanie oi this eaement ian iontain one pieie oi Sser-deiined metadatac The eaement
iontains:●●

meta:name attribStes thiih identiiies the name oi the metadata eaementc
The raaSe oi the eaements thiih is the metadatac<!ELEMENT meta:user-tefinet (tPCtATAy<<!ATTLIST meta:user-tefinet meta:name CtATA teEt|IeEt<

o oTc0c0 DoiSment tatistiis
The <meta:tocument-statistic< eaement speiiiies the statistiis oi the doiSments ior e.ampaes the page
ioSnts tord ioSnts and so onc The statistiis are speiiiied as attribStes oi the <meta:tocument-statistic<eaement and the statistiis that are e.ported tith the doiSment depend on the doiSment type and the appaiiation
Ssed to ireate the doiSmentc
onor

1 i yoonor

1 ih 4 u9 uo9iA Iu r 9

Te.t

meta:page-countmeta:table-countmeta:traw-countmeta:ole-obiect-countmeta:paragraph-countmeta:wort-countmeta:character-countmeta:row-countpreadsheet

meta:page-countmeta:table-countmeta:cell-countmeta:obiect-countGraphii

meta:page-countmeta:obiect-countrg i nt T<meta:tocument-statistic<RrT 9T
42

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

o oT<!ELEMENT meta:tocument-statistic EMPTY<<!ATTLIST meta:tocument-statistic meta:page-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:table-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:traw-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:ole-obiect-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:paragraph-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:wort-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:character-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:row-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:cell-count %positiveInteger; tIMPLIEt<<!ATTLIST meta:tocument-statistic meta:obiect-count %positiveInteger; tIMPLIEt<

Chapter 2 Common Document Content

43c0c 2 ampae
E 4 oT Tih4 oT i

etadata

4t4 4iu1i41ito 1teeuo inI.irg itnor

1<office:meta<<tc:title<Title of the tocument</tc:title<<tc:tescription<tescription/Comment for the tocument</tc:tescription<<meta:initial-creator<|ser Name</meta:initial-creator<<meta:creation-tate<1999-10-1-T12:3::4:</meta:creation-tate<<tc:creator<|ser Name</tc:creator<<tc:tate<1999-10-19T14:1::1:</tc:tate<<meta:printet-by<|ser Name</meta:printet-by<<meta:print-tate<1999-10-20T1::1::1-</meta:print-tate<<tc:subiect<tescription of the tocument</tc:subiect<<meta:turation-time<PT4m10M10S</meta:etiting-turation<<meta:keyworts<<meta:keywort<First keywort</meta:keywort<<meta:keywort<Secont keywort</meta:keywort<<meta:keywort<Thirt keywort</meta:keywort<</meta:keyworts<<meta:template xlink:typep"simple"
xlink:hrefp"file:///c|/office42/share/template/german/finance/butget.
vor"
xlink:titlep"Template name"meta:tatep"1999-10-14T10:11:12" /<<meta:auto-reloat
xlink:typep"simple"
xlink:hrefp"file:///..."
meta:telayp"P:0S" /<<tc:language<te-tE</tc:language<<meta:user-tefinet meta:namep"Fielt 1"<"alue 1</meta:user-tefinet<<meta:user-tefinet meta:namep"Fielt 2"<"alue 2</meta:user-tefinet<</office:meta<cFormatting Properties and tyaes
any objeits in an OpenOiiiiecorg doiSment hare iormatting propertiesc iormatting property iniaSenies the
risSaa representation oi an objeit bSt it does not iontribSte to the iontent or strSitSre oi the doiSmentc E.ampaes
oi iormatting properties are:●

Font iamiay●

Font sike●

Font ioaor●

Page margins

n an OpenOiiiiecorg X L doiSments iormatting properties are onay stored tithin styaesc This diiiers to the
OpenOiiiiecorg Sser interiaies there yoS ian assign iormatting properties to an objeit direitay or yoS ian appay astyae to the objeitc ssigning iormatting properties to an objeit direitay has the same eiieit as assigning an
Snnamed styae tith the same properties to that objeitc Thereiores Sser interiaie styaes remain Snihanged ionieptSaaay in the OpenOiiiiecorg X L iiae iormats thiae iormatting properties assigned direitay to an objeit are
assSmed to be Snnamed styaesc n order to Sse Snnamed styaess they are assigned a name and thereiore beiome
aStomatii styaesc
There are tto main reasons ior Ssing styaes to store iormatting properties:
0c YoS ian keep the iormat and aayoSt oi the doiSment separate irom the doiSment iontentc
44

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c i tto or more objeits hare the same iormatting properties and styaes assigneds the iormatting properties thatare assigned to the objeits direitay ian be represented by a singae aStomatii styae ior aaa objeitsc This sares
disk spaie and aaaots styaes to integrate seamaessay into the oreraaa doiSment styaec

c c0 Formatting Property ets
doiSment ian iontain sereraa styae eaementsc To aiqSire a iommon set oi iormatting propertiess yoS Sse a<style:properties< eaement thiih is iniaSded as a ihiad eaement oi any styae eaementc This iontainer
eaement oiiers tto important adrantagess as ioaaots:●

Formatting properties ian be addressed by C

or X L styaesheets regardaess oi the styae typec●

tyaes iontain additionaa iniormation that is not a iormatting propertys ior e.ampaes the styae name and parent
styaec t is good praitiie to separate this type oi iniormationc

rg i nt T<style:properties<

RrT 9TYoS mSst Sse this iontainer eaement to store a iommon set oi iormatting propertiesc

o oT<!ELEMENT style:properties ANY<c c

impae Formatting Properties

ost iormatting properties are simpae and ian be represented as attribStes oi the <style:properties<
eaementc Dhere possibaes X L attribStes are Ssed to represent iormatting propertiesc n this speiiiiiations thenamespaie preii. fo is Ssed ior X L propertiess that is properties that are part oi the X L-FO namespaiec ngeneraas iormatting properties that iannot be represented by X L properties are part oi the style namespaiecn OpenOiiiiecorgs there are some iormatting properties that yoS iannot speiiiy tithoSt speiiiying one or more
additionaa iormatting propertiesc i the reqSired properties are missings a deiaSat raaSe is assSmedc This speiiiiiation highaights the properties there this aimitation appaiesc
E 4 oT Tihu oT i9 yT ioIno I u 9This e.ampae shots a iormatting property iontainer that speiiiies an Spper margin oi 0 im as teaa as a aoter
margin oi 2c5 im:<style:properties fo:margin-leftp”1cm” fo:margin-bottomp”.4cm”/<

c c4 Compae. Formatting Propertiesi a iormatting property is too iompae. to be represented by X L attribStess it is represented by an X L
eaementc Eaih sSih property is represented by an eaement type oi its otnc
E 4 oT Ti n oT ienI 4 u1.ioIno I u 9This is an e.ampae oi a iormatting property iontainer that speiiiies Spper and aoter margins as teaa as tab stop
position at and 9 imc

Chapter 2 Common Document Content

45

<style:properties<<style:tab-stops<<style:tab-stop style:positionp"2cm"/<<style:tab-stop style:positionp":cm"/<</style:tab-stops<</style:properties<

c c9 tyaes
ome styae iamiaies are rery simiaar in strSitSre and ian be represented by the same eaementc For e.ampaes the<style:style< eaement ian represent paragraphs te.ts and irame styaesc
rg i nt T<style:style<RrT 9To oT
n T<!ELEMENT style:style (style:properties?,style:mapay<
The same eaements ian represent iommon and aStomatii styaes bSt the diiierenie is that they areiontained in diiierent iontainer eaementsc n e.ieption to this is aStomatiiaaay generated styaes
ior eaements iontained in the <office:styles< eaementss thiih are marked tith thestyle:automatic attribStec

The attribStes that yoS ian assoiiate tith the <style:style< eaement are:●tyae name●tyae iamiay●

Stomatii●

Parent styae●

Ne.t styae●

List styae●

aster page name●Stomatiiaaay Spdate●

Formatting properties●

OStaine aerea nSmberingtyae Name
The style:name attribSte identiiies the name oi the styaec

46

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:nameRrT 9T
o oT
n 9T<!ENTITY % style-name "CtATA"<<!ATTLIST style:style style:name %style-name; tIMPLIEt<
This attribStes iombined tith the style family attribStes SniqSeay identiiies a styaec YoS
iannot hare tto styaes tith the same iamiay and the same namec
For aStomatii styaess a name is generated dSring doiSment e.portc i the doiSment is e.ported
sereraa timess yoS iannot assSme that the same name is generated eaih timec
n an X L doiSments the name oi eaih styae is a SniqSe name that is independent oi the aangSage
seaeited ior the OpenOiiiiecorg Sser interiaiec These styae names are the same as the names Ssedby the OpenOiiiiecorg P and are SsSaaay the names Ssed ior the Engaish rersion oi the Sserinteriaiec

tyae Famiay
The style:family attribSte identiiies the iamiay oi the styaes ior e.ampaes paragraphs te.ts or iramec
rg i nt T

style:family

RrT 9To oT<!ATTLIST style:style style:family (paragraph|text|framey
teEt|IeEt<

Stomatii
The style:automatic attribSte speiiiies thether or not the styae is an aStomatii styaec
rg i nt T

style:automaticRrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST style:style style:automatic %boolean; tIMPLIEt<

Parent tyae
The style:parent-style-name attribSte speiiiies the name oi the parent styaec
rg i nt T

style:parent-style-name

RrT 9Ti a parent styae is not speiiiieds a deiaSat parent styae deiined by the appaiiation is Ssedc
The parent styae iannot be an aStomatii styae and ii yoS speiiiy a parent styae that is not deiineds
an error oiiSrsc

o oT<!ATTLIST style:style style:parent-style-name %style-name;tIMPLIEt<

Ne.t tyae
The style:next-style-name attribSte speiiiies the styae to Ssed ior the ne.t paragraph ii a paragraphbreak is inserted in the Sser interiaiec

Chapter 2 Common Document Content

47

rg i nt T

style:next-style-name

RrT 9T

i yoS do not iniaSde this attribStes by deiaSat the iSrrent styae is Ssed as the ne.t styaeco oT<!ATTLIST style:style style:next-style-name %style-name;tIMPLIEt<

n TThis ioniept is onay sSpported by the paragraph styae iamiayc

List tyaeparagraph styae ian hare an assoiiated aist styaec This appaies to aStomatii and iommon styaesc
rg i nt T

style:list-style-name

RrT 9T

i yoS speiiiy a aist styaes it is only appaied to paragraphs that are iontained in a aists there the aist
does not speiiiy a aist styae itseais and the aist has no aist styae speiiiiiation ior any oi its parentsc

o oT<!ATTLIST style:style style:list-style-name %style-name;tIMPLIEt<

aster Page Nameparagraph or tabae styae ian hare an assoiiated style:master-page-name attribStec This appaies to aStomatii and iommon styaesc i this attribSte is assoiiated tith a styaes a page break is inserted then the styae isappaied and the speiiiied master page is appaied to the preieding pagec
rg i nt T

style:master-page-name

RrT 9T

This attribSte is ignored ii it is assoiiated tith a paragraph styae that is appaied to a paragraphtithin a tabaec

o oT<!ATTLIST style:style style:master-page-name %style-name;tIMPLIEt<

Stomatiiaaay pdate
The style:auto-uptate attribSte determines thether or not styaes are aStomatiiaaay Spdated then theiormatting properties oi an objeit that has the styae assigned to it are ihangedc For e.ampaes ii yoS hare a paragraph styae that iontains a iormatting property speiiiying that paragraph te.t is ientereds and this paragraph styae
is appaied to a paragraphc i yoS manSaaay ihange the iormatting oi the paragraph te.t to be right-aaigned and the
raaSe oi the style:auto-uptate is true, the paragraph styae is aStomatiiaaay Spdated to reiaeit the net
paragraph iormatting and erery paragraph that Sses the paragraph styae is aaso modiiied to right-aaign the paragraph te.tc
rg i nt T

style:auto-uptate

RrT 9T

This attribSte ian hare a raaSe oi true or falsec

o oT<!ATTLIST style:style style:auto-uptate %boolean; "false"<oT
1 4 un1
Tu u 4 un1T

This ieatSre is onay sSpported in OpenOiiiiecorg Driter doiSmentsc

Formatting Properties
i a styae has iormatting attribStes assigneds the styae eaement iontains a iormatting property iontainer eaement
48

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

iaaaed <style:properties<c ee eition c c0 ior detaiaed iniormation aboSt this eaementc

OStaine NSmbering Lerea
ee eition 4c9c ior iniormation on the oStaine nSmbering aerea ior a styaec

ampae tyae
E 4 oT Tito 1teeuo inI.irg iI oI 9 1 4 un1inei r iEi ntypio4I4.I4ori9 yT i

<style:style style:namep"Text boty" style:familyp"paragraph"style:parent-style-namep"Stantart"style:pool-itp"20:9"<<style:properties fo:margin-topp"0cm" fo:margin-bottomp".21cm"/<</style:style<c c5 tyaeappingsn TiThe eaements and attribStes desiribed in this seition onay appay to ionditionaa styaesc
The <style:map< eaement speiiiies the mapping to another styaes ii iertain ionditions e.istc
rg i nt T<style:map<

RrT 9T

This eaement is iontained in the styae eaement oi a ionditionaa styaec There is one eaement ior
erery iondition that the styae Ssesco oT<!ELEMENT style:map EMPTY<oT
1 4 un1
Tu u 4 un1T

Conditionaa styaes are onay sSpported by OpenOiiiiecorg Driter paragraph styaesc

The attribStes that yoS ian assoiiate tith the <style:map< eaement are:●Condition●

ppaied styae●

Base ieaa address

Condition
The style:contition attribSte speiiiies the iondition in thiih a styae map shoSad be appaiedc

Chapter 2 Common Document Content

49

rg i nt T

style:contition

RrT 9TThe raaSe oi this attribSte is a Booaean e.pressionc The synta. oi the e.pression is simiaar to the
XPath synta.c The ioaaoting ionditions are raaid ior paragraph styaes:•

list-level(ypls there l is a nSmber betteen 0 and 02•

outline-level(ypl, there l is a nSmber betteen 0 and 02•

table(y and table-heater(y•section(y•heater(y and footer(y•footnote(y and entnote(y•Contition ::p TrueFunction | TrueContition•➢

TrueFunction ::p is-true-formula(Formulay | cellcontent-is-between("alue, "aluey | cell-content-isnot-between("alue, "aluey➢

TrueContition ::p Expression

Expression ::p GetFunction Operator "alue➢

GetFunction ::p cell-content(y➢Operator ::p '<' | '<' | '<p' | '<p' | 'p' | '!p'➢"alue ::p Number"alue | String | Formulan T
Number"alue is a thoae or deiimaa nSmberc
String iomprises one or more iharaiters sSrroSnded by qSotation marksc
Formula is a iormSaa isee 9crc0o tithoSt the eqSaas i o sign at the beginningc

YoS mSst iniaSde an Operatorc
The nSmber in a Number"alue or Formula iannot iontain iomma separators ior
nSmbers oi 0222 or greaterc
The ionditions that appay ior diiierent types oi styaes may diiierc
o oT
n 9T

<!ATTLIST style:map style:contition CtATA teEt|IeEt<
i an appaiiation deteits a iondition that it does not reiognikes it mSst ignore the entire <style:map< eaementc

ppaied tyae
The style:apply-style-name attribSte speiiiies the styae to appay then the iondition speiiiied by thestyle:contition attribSte is truec

50

rg i nt T

style:apply-style-name

RrT 9Ti the reierenied styae is Sndeiined or is an aStomatii styaes an error oiiSrsc

o oT<!ATTLIST style:map style:apply-style-name %style-nameteEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Base Ceaa ddress
The style:base-cell-attress attribSte speiiiies the base ieaa ior reaatire addresses in iormSaascrg i nt T

style:base-cell-attressRrT 9T

This attribSte onay appaies to ieaa styaes there the iondition iontains a iormSaac
The raaSe oi this attribSte mSst be an absoaSte ieaa address tith a tabae namec

o oT<!ATTLIST style:map style:base-cell-attress %cell-attress;tIMPLIEt<

ampae tyaeappingE 4 oT Tih yT i 4oou1.
<style:style style:namep"Text boty" style:familyp"paragraph"style:parent-style-namep"Stantart"style:next-style-namep"Text boty"<<style:properties fo:margin-topp"0cm" fo:margin-bottomp".21cm"/<<style:map style:contitionp"footnote" style:apply-style-namep"footnote"/<<style:map style:contitionp"heating(1y"style:apply-style-namep"meating 1"/<<style:map style:contitionp"heating(2y"style:apply-style-namep"meating 2"/<</style:style<c4 Page tyaes and LayoSt
The styae and aayoSt oi the pages in a doiSment is determined by:
●
●

Page

astersaster Pages

o4. i 49 I desiribes the physiiaa properties or geometry oi a pages ior e.ampaes page sikes marginss header
heights and iooter heightc
49 Iio4. is a tempaate ior pages in a doiSmentc t iontains a reierenie to a page master thiih speiiiies thephysiiaa properties oi the page and ian aaso iontain statii iontent that is dispaayed on aaa pages in the doiSmentthat Sse the master pagec E.ampaes oi statii iontent are headerss iooterss or baikgroSnd graphiisci a te.t or spreadsheet doiSment is dispaayed in a paged aayoSts the master pages are instantiated to generate a
seqSenie oi pages iontaining the doiSment iontentc Dhen a master page is instantiateds an empty page is generated tith the properties oi the page master and the statii iontent oi the master pagec The body oi the page is theniiaaed tith iontentc i mSatipae pages in a doiSment Sse the same master pages the master page ian be instantiatedsereraa times tithin the doiSmentc
n te.t and spreadsheet doiSmentss yoS ian assign a master page to paragraph and tabae styaes Ssing a style:master-page-name attribStec Eaih time the paragraph or tabae styae is appaied to te.ts a page break is inserted
beiore the paragraph or tabaec The page that starts at the page break position Sses the speiiiied master pagec
n dratings and presentationss yoS ian assign master pages to drating pages Ssing a style:parent-stylename attribStec
n T The OpenOiiiiecorg X L paging methodoaogy diiiers signiiiiantay irom the methodoaogy Ssed in X Lc n
X Ls headers and iooters are iontained tithin page seqSenies that aaso iontain the doiSment iontentc The
Chapter 2 Common Document Content

51

iontent oi headers and iooters ian be ihanged or omitted tithoSt aiieiting the doiSment iontentc n OpenOiiiiec
org X Ls headers and iooters are iontained in page styaesc

c4c0 Page

aster

The <style:page-master< eaement speiiiies the physiiaa properties oi a pagec
rg i nt T<style:page-master<RrT 9T

This eaement iontains a <style:properties< eaement thiih speiiiies the iormatting properties oi the page and three optionaa eaements that speiiiy the properties oi headerss iooterss and aiootnote seitionc

o oT<!ELEMENT style:page-master(style:properties, style:heater-style?,style:footer-style?, style:footnote-layout?y<The attribStes that yoS ian assoiiate tith the <style:page-master< eaement are:
●

Name

●

Page Ssage●

Page sike●

Page nSmber iormat●

Paper tray●

Print orientation●●

Border●Border aine tidth●

Padding

●

hadot

●

BaikgroSnd●

CoaSmns●

egister-trSth

●

Print

●

Print page order●First page nSmber

●
●
●
●

52

arginsiaae
Tabae ientering
a.imSm iootnote height
Footnote separator

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Name
The style:name attribSte speiiiies the name oi the page masterc
rg i nt T

style:nameRrT 9To oT<!ATTLIST style:page-master style:name %styleName teEt|IeEt<

Page sage
The style:page-usage attribSte speiiiies the type oi pages that the page master shoSad generatec
rg i nt T

style:page-usage

RrT 9TThe raaSe oi this attribSte ian be:

o oT
n T

●

all l aaa pages are the same●left l aaa pages are aeit pages●

right l aaa pages are right pages●

mirror l aeit and right pages are the same e.iept that the margins are mirrored<!ATTLIST style:page-master style:page-usage (all|left|right|
mirrorety "all"<
X L sSpports aeit and right pages bSt Sses a diiierent modea to OpenOiiiiecorg X Lc

Page ike
The fo:page-witth and fo:page-height attribStes speiiiy the physiiaa sike oi the pagec
rg i nt T

fo:page-witth
fo:page-heightRrT 9T

The fo:page-witth attribSte mSst iorrespond to the orientation oi the pagec For e.ampaes ii
a page is printed in portraits the fo:page-witth attribSte speiiiies the tidth oi the shorter
page sidec i the page is printed in aandsiapes the fo:page-witth attribSte speiiiies the tidth
oi the aonger page sidec

o oT<!ATTLIST style:properties fo:page-witth %length; tIMPLIEt<<!ATTLIST style:properties fo:page-height %length; tIMPLIEt<n T

X L sSpports some more raaSe that are not sSpported by OpenOiiiiecorg X Lc

Page NSmber Format
YoS ian speiiiy a deiaSat nSmber iormat ior page styaess thiih is Ssed to dispaay page nSmbers tithin headers
and iootersc ee eition c ior detaiaed iniormation on nSmber iormat attribStesc

Chapter 2 Common Document Content

53

rg i nt T

style:num-format
style:num-letter-sync

RrT 9T

The style:num-format attribSte ian be emptyco oT<!ATTLIST style:properties style:num-format CtATA teEt|IeEt<<!ATTLIST style:properties style:num-letter-sync %boolean;"false"<Paper Tray
The style:paper-tray-name attribSte speiiiies the paper tray to Sse then printing the doiSmentc The
names assigned to the printer trays depend on the printerc
rg i nt T

style:paper-tray-name

RrT 9Ti the raaSe oi this attribSte is tefaults the deiaSat tray speiiiied in the printer ioniigSration
settings is Ssedc

o oT<!ATTLIST style:properties style:paper-tray-name CtATAtIMPLIEt<

Print Orientation
The style:print-orientation attribSte speiiiies the orientation oi the printed pagec
rg i nt T

style:print-orientation

RrT 9TThe raaSe oi this attribSte ian be portrait or lantscapeco oT<!ATTLIST style:properties style:print-orientation (portrait|
lantscapey tIMPLIEt<

arginsThe margins attribStes speiiiy the sike oi the page marginsc ee Taeameapi soemattinm Teopeeties in Chapter 4 oi
this manSaa ior detaiaed iniormation on these attribStescrg i nt T

fo:margin-top
fo:margin-bottom
fo:margin-left
fo:margin-rightBorder
The border attribStes speiiiy the border properties oi the pagec ee Taeameapi soemattinm Teopeeties in Chapter
4 oi this manSaa ior detaiaed iniormation on these attribStescrg i nt T

n T

54

fo:borter
fo:borter-top
fo:borter-bottom
fo:borter-left
fo:borter-rightX L does not hare border properties ior page mastersc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Border Line Didthi a page iontains borderss the border aine tidth attribStes speiiiy the properties oi the border aines oi the pagec
ee Taeameapi soemattinm Teopeeties in Chapter 4 oi this manSaa ior detaiaed iniormation on these attribStescrg i nt T

style:borter-line-witth
style:borter-line-witth-top
style:borter-line-witth-bottom
style:borter-line-witth-leftstyle:borter-line-witth-right

Padding
The padding attribStes speiiiy the padding properties oi the pagec ee Taeameapi soemattinm Teopeeties in
Chapter 4 oi this manSaa ior detaiaed iniormation on these attribStescrg i nt T

fo:patting
fo:patting-top
fo:patting-bottom
fo:patting-left
fo:patting-righthadot
ee Taeameapi soemattinm Teopeeties in Chapter 4 oi this manSaa ior detaiaed iniormation on this attribStec
rg i nt T

style:shatow

BaikgroSnd
The baikgroSnd attribStes speiiiy the baikgroSnd properties oi the pagec ee Taeameapi soemattinm Teopeeties
in Chapter 4 oi this manSaa ior detaiaed iniormation on these attribStescrg i nt T
n T

fo:backgrount-color and <style:backgrount-image<
X L does not hare baikgroSnd properties ior page mastersc

CoaSmns
The <style:columns< eaement speiiiies ii the page iontains ioaSmnsc ee Taeameapi soemattinm Teopeeties
in Chapter 4 oi this manSaa ior detaiaed iniormation on this attribStec
rg i nt T<style:columns<

egister-trSth
The style:register-truth-ref-style-name attribSte reierenies a paragraph styaec The aine distanie
speiiiied oi the paragraph styae is Ssed as the reierenie aine distanie ior aaa paragraphs that hare the register-trSth
ieatSre enabaedc

Chapter 2 Common Document Content

55

rg i nt T

style:register-truth-ref-style-name

RrT 9To oT<!ATTLIST style:properties style:register-truth-ref-style-name%styleName tIMPLEt<

Print
The style:print attribSte speiiiies thiih iomponents in a spreadsheet doiSment to printc
rg i nt T

style:print

RrT 9TThe raaSe oi this attribSte is a aist oi the ioaaoting raaSes separated by baanks:
●
●
●
●
●
●
●
●

o oT

Oeaders
Gridnnotations
Objeits igraphiis or OLE Objeitso
ChartsDratings
FormSaas
1ero raaSes<!ATTLIST style:properties style:print CtATA tIMPLEt<

Print Page Order
The style:print-page-orter attribSte speiiiies the order in thiih data in a spreadsheet is nSmbered andprinted then the data does not iit on one printed pagec
rg i nt T

style:print-page-orterRrT 9TThe raaSe oi this attribSte ian be ttb or ltrc se ttb to print the data rertiiaaay irom theaeit ioaSmn to the bottom rot oi the sheetc se ltr to print the data horikontaaay irom the
top rot to the right ioaSmn oi the sheetc

o oT<!ATTLIST style:properties style:print-page-orter ("ttb" |"ltr"y tIMPLEt<

First Page NSmber
The style:first-page-number attribSte aaaots yoS to speiiiy a nSmber other than 0 ior the iirst pagec
rg i nt T

style:first-page-number

RrT 9TThe raaSe oi this attribSte ian be an integer or continuec i the raaSe is continues thepage nSmber is the aast page nSmber iniremented by 0co oT<!ATTLIST style:properties style:first-page-number %positiveInteger; tIMPLEt<

iaae
The siaae attribStes speiiiy hot the appaiiation shoSad siaae the doiSment ior printingc

56

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:scale-tostyle:scale-to-pages

RrT 9TYoS ian Sse one the abore attribStes to speiiiy hot to siaae the doiSment ior printingc inone oi these attribStes are presents the doiSment is not siaaedc
i yoS Sse the style:scale-to attribStes the doiSment is siaaed to a perientage raaSec
022 perient is the normaa raaSec YoS ian enaarge or redSie aaa printed pages Ssing this
attribStec
i yoS Sse the style:scale-to-pages attribStes yoS ian speiiiy the nSmber oi pages
on thiih the the doiSment shoSad be printedc The doiSment is then siaaed to iit the deiined
nSmber oi pagesc

o oT<!ATTLIST style:properties style:scale-to %percentage;tIMPLEt<<!ATTLIST style:properties style:scale-to-pages %positiveInteger; tIMPLEt<

Tabae Centering
The style:table-centering attribSte speiiiies hot the appaiiation shoSad ienter tabaes on the pagec This
attribSte onay appaies to spreadsheet doiSmentsc
rg i nt T

style:table-centeringRrT 9TThe raaSe oi this attribSte ian be horivontals verticals boths or noneco oT<!ATTLIST style:properties style:table-centering (horivontal,
vertical, both, noney tIMPLIEt<

i this attribSte is not presents the tabae is not ientredc

a.imSm Footnote OeightThe style:footnote-max-height attribSte speiiiies the ma.imSm amoSnt oi spaie on the page that aiootnote ian oiiSpyc The raaSe oi the attribSte is a aengths thiih determines the ma.imSm height oi the iootnote
areac
rg i nt T

style:footnote-max-heightRrT 9Ti the raaSe oi this attribSte is set to 0s there is no aimit to the amoSnt oi spaie that the iootnote ian oiiSpyc

o oT<!ATTLIST style:properties style:footnote-max-height %length;tIMPLIEt<

Footnote eparator
The <style:footnote-sep< eaement desiribes the aine that separates the iootnote area irom the body te.tarea on a pagec
The <style:footnote-sep< eaement sSpports the ioaaoting attribStes:●style:witth l speiiiies the tidth or thiikness oi the ainec●

style:rel-witth l speiiiies the aength oi the aine as a perientage oi the body te.t areac
Chapter 2 Common Document Content

57●style:color l speiiiies the ioaor oi the ainec●

style:atiustment l speiiiies hot the aine is aaigned on the pages that is aeits rights or ienterc●

style:tistance-before-sep l speiiiies the spaie betteen the body te.t area and the iootnote ainec●

style:tistance-after-sep l speiiiies the spaie betteen the iootnote aine and the iootnote te.tc<style:footnote-sep<rg i nt T
RrT 9T<!ELEMENT style:footnote-sep EMPTY<<!ATTLIST style:footnote-sep style:witth %length; tIMPLIEt<<!ATTLIST style:footnote-sep style:rel-witth %percentage;tIMPLIEt<<!ATTLIST style:footnote-sep style:color %color; tIMPLIEt<<!ATTLIST style:footnote-sep style:atiustment (left|center|righty "left"<<!ATTLIST style:footnote-sep style:tistance-before-sep %length; tIMPLIEt<<!ATTLIST style:footnote-sep style:tistance-after-sep %length;tIMPLIEt<

o oT

c4c

aster Pages

This seition oi the manSaa desiribes the master page ieatSres that are sSpported by te.t and spreadsheets doiSmentsc The master pages Ssed in dratings and presentations hare some additionaa ieatSres that are desiribed inseition caster pages are iontained tithin a master styae eaementc
rg i nt T<style:master-page<RrT 9Tn te.t and spreadsheet doiSmentss this eaement iontains the iontent oi headers and iootersc n
dratings and presentations it iontains baikgroSnd shapesc

o oT<!ELEMENT style:master-page( (style:heater, style:heater-left?y?,(style:footer, style:footer-left?y?,style:stylea, (%shapes;ya, presentation:notes? y<

The attribStes that yoS ian assoiiate tith the <style:master-page< attribSte are:●Page name●

Page master●

Ne.t styae name

Page Name
The styles:name attribSte speiiiies the name oi the master pagec Eaih master page is reierenied Ssing its
page namec

58

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

styles:nameRrT 9Ti

page name is reqSired ior eaih master page and the name mSst be SniqSec

o oT<!ATTLIST style:master-page style:name %styleName;
teEt|IeEt<

Page

aster

The style:page-master-name attribSte speiiiies page master thiih iontains the sikes borders and orientation oi the master pagec
rg i nt Ti

style:page-master-name

RrT 9Ti

This attribSte is reqSired ior eaih master pagec

o oT<!ATTLIST style:master-page style:page-master-name %styleName; teEt|IeEt<

Ne.t tyae Name
The style:next-style-name attribSte ian be Ssed to speiiiy the master page Ssed ior the ne.t pages ii
there is a ne.t pagec
rg i nt T

style:next-style-name

RrT 9Ti the ne.t styae name is not speiiiieds the iSrrent master page is Ssed ior the ne.t pagec

o oT<!ATTLIST style:master-page style:next-style-name %styleNametIMPLIEt<

n TThis attribSte repaaies the X L page-seqSenie-master ionieptc

c4c4 Oeaders and Footers
The header and iooter eaements speiiiy the iontent oi headers and iootersc The <style:heater< and<style:footer< eaements iontain the iontent oi headers and iootersc The tto additionaa eaementss <style:heater-left< and <style:footer-left<s ian be Ssed to speiiiy diiierent iontent ior aeit pagess ii
appropriatec i the aatter tto eaements are missings the iontent oi the headers and iooters on aeit and right pages is
the samec
These eaements are iontained tithin a master page eaementc

Chapter 2 Common Document Content

59

rg i nt T

<style:heater<<style:footer<<style:heater-left<<style:footer-left<

RrT 9Ti the style:page-usage attribSte assoiiated tith the page master has a raaSe oi all or
mirroret and there are no <style:heater-left< or <style:footer-left<
eaementss the header and iooter iontent is the same ior aeit and right pagesci the style:page-usage attribSte has a raaSe oi left or rights the <style:heater-left< or <style:footer-left< eaements are ignoredc
The iontent oi headers and iooters is either:●

tandard te.t iontents ior e.ampae paragraphss tabaess or aists●

seqSenie oi any oi the ioaaoting eaements; <style:region-left<s <style:region-center< and <style:region-reight<●

Emptys thiih stitihes oii the dispaay oi aaa headers or iootersc t is not possibae to stitih oii
the dispaay oi headers or iooters ior aeit pages onayc

o oT<!ENTITY %ht-ft-content"( %text; |(style:region-left?|style:region-center?|style:region-right?y y"<<!ELEMENT style:heater %ht-ft-content;<<!ELEMENT style:footer %ht-ft-content;<<!ELEMENT style:heater-left %ht-ft-content;<<!ELEMENT style:footer-left %ht-ft-content;<oT
1 4 un1
Tu u 4 un1T

OpenOiiiiecorg Driter onay sSpports headers and iooters that iontain normaa te.ts thiae
OpenOiiiiecorg Caai onay sSpports headers and iooters that Sse the region eaementsc

c4c9 Oeader and Footer tyaes
The header and iooter styae eaements speiiiy the iormatting properties ior headers and iooters on a pagec
rg i nt T<style:heater-style< and <style:footer-style<RrT 9T

These eaements mSst be iontained tithin a page master eaementc

o oT<!ELEMENT style:heater-style (style:properties?y<<!ELEMENT style:footer-style (style:properties?y<The attribStes that yoS ian assoiiate tith the header and iooter eaements are iontained tithin a <style:properties< eaementc These attribStes are:●Fi.ed and minimSm heights - see eition c6c00●

Leit and right margins - see eition c6c00●

Bottom iior headers onayo and top iior iooters onayo margins - see eition c6c00●

Borders - see eition 4c00c m and 4c00c r

●
●

60

hadots l see e ition 4c00c42
BaikgroSnds l see eition 4c00c 5 and 4c00c 6

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c4c5 Footnote LayoSt
The <style:footnote-layout< eaement speiiiies the aayoSt ior iootnotes that are iontained on a pagec
rg i nt T<style:footnote-layout<

RrT 9T

This eaement mSst be iontained in the page master eaementc t iontains a <style:properties< eaement that speiiiies the ma.imSm height and spaiing oi the iootnote area and a<style:footnote-sep< eaement that speiiiies the separator aine betteen the page body area
and the iootnote areac
i this eaement is not presents a deiaSat iootnote aayoSt is Ssedc

o oT<!ELEMENT style:footnote-layout (style:properties?,style:footnote-sep?y<The attribStes that yoS ian assoiiate tith the <style:footnote-layout< eaement in the <style:properties< eaement are:●a.imSm height●paiinga.imSm OeightThe style:max-height attribSte speiiiies the ma.imSm height oi the iootnote areac
rg i nt T

style:max-heightRrT 9T

This attribSte sSpports a raaSe oi no-limits thiih aaaots the iootnote area to inirease Sntia it
eqSaas the height oi the page heightc

o oT<!ENTITY % lengthOrNoLimit "CtATA"<<!ATTLIST style:properties style:max-height %lengthOrNoLimittIMPLEt<

paiing
The spaiing attribStes speiiiy the distanies beiore and aiter the aine that separates the iootnote area irom the page
body areac
rg i nt T

style:tistance-before-sep
style:tistance-after-sep

RrT 9T

These attribStes are raaid eren ii there is no iootnote separator aine speiiiiedc

o oT<!ATTLIST style:properties style:tistance-before-sep %lengthtIMPLEt<<!ATTLIST style:properties style:tistance-after-sep %lengthtIMPLEt<

c4c6 Footnote eparator LineThe <style:footnote-sep< eaement speiiiies the separator aine to Sse betteen the page body area and theiootnote areac

Chapter 2 Common Document Content

61

rg i nt T

<style:footnote-sep<

RrT 9T

This eaement ian be iontained in a <style:footnote-layout< eaementc

o oT<!ELEMENT style:footnote-sep EMPTY<

The attribStes that yoS ian assoiiate tith the <style:footnote-sep< eaement are:●Line tidth●

Line aength●

Oorikontaa aine aaignment

Line Didth
The style:witth attribSte speiiiies the tidth oi the separator ainec
rg i nt T

style:witth

RrT 9To oT<!ATTLIST style:footnote-sep style:witth %length; teEt|IeEt<

Line Length
The style:length attribSte speiiiies the aength oi the separator ainec
rg i nt T

style:length

RrT 9TThe raaSe oi this attribSte is a perientage that reaates to the tidth oi the page e.iaSding the pagemarginsco oT<!ATTLIST style:footnote-sep style:length %percentage; "100%"<

Oorikontaa Line aignment
The style:horivontal-align attribSte speiiiies hot to horikontaaay aaign a aine that is aess than 022l
aongc
rg i nt T

style:horivontal-alignRrT 9TThe raaSe oi this attribSte ian be lefts centers or righto oT<!ATTLIST style:footnote-sep style:horivontal-align (left|
center|righty "left"<c9 Font Deiaarationsn X L and C s a iont is desiribed by its iont iamiayc The OpenOiiiiecorg X L iiae iormat aaso Sses an additionaa set oi attribStes to desiribe a iontc These additionaa attribStes are eraaSated ii the iont speiiiied in the iont
iamiay is not araiaabaes enabaing the appaiiation to ihoose an aaternatire iontc The additionaa attribStes are:●●62

tyae name
Generii iamiay

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●

Font pitih●

Charaiter set

i a iont is reierenieds ior e.ampae in a styaes the additionaa iont attribStes ian be either speiiiied tith the iont
iamiay or Ssing the <office:font-tecls< eaementc iont deiaaration assigns a SniqSe name to a set oi iont
attribStesc Font deiaarations heap to redSie iiae sikesc
rg i nt Ti<office:font-tecls<

RrT 9Ti

This eaement is a iontainer ior aaa iont deiaarationsc t mSst appear beiore any styae
iontainer eaementc

o oT<!ELEMENT office:font-tecls (style:font-teclya<

c9c0 Font Deiaaration
iont deiaaration assigns a set oi iont iormatting properties to a SniqSe iont namerg i nt Ti<style:font-tecl<

RrT 9Tio oT<!ELEMENT style:font-tecl EMPTY<

The attribStes that yoS assoiiate tith a <style:font-tecl< eaement are:●

Font name●

Font properties

Font Name
The style:name attribSte speiiiies the SniqSe name oi the iontc
rg i nt Ti

style:nameRrT 9Ti
o oT<!ENTITY % fontName "CtATA"<!ATTLIST style:font-tecl style:name %fontName; teEt|IeEt<

Font Properties
The ioaaoting iont properties ian be Ssed to speiiiy a iont:●

Font iamiay●

Font styae name●

Generii iont iamiay●

Font pitih●

Font iharset

The iont iamiay is reqSired ior erery iont deiaarationc aa other properties are optionaac ee Teet soemattinm
Teopeeties in Chapter 4 oi this manSaa ior more iniormation on these iont propertiesc
Chapter 2 Common Document Content

63rg i nt Ti

fo:font-familystyle:font-style-namestyle:font-family-genericstyle:font-pitch
style:font-charset

RrT 9Tio oT<!ATTLIST style:font-tecl fo:font-family %string; teEt|IeEt<<!ATTLIST style:font-tecl style:font-style-name %string;tIMPLIEt<<!ENTITY % fontFamilyGeneric "(roman|swiss|motern|
tecorative|script|systemy"<<!ATTLIST style:font-tecl style:font-family-generic%fontFamilyGeneric; tIMPLIEt<<!ENTITY % fontPitch "(fixet|variabley"<<!ATTLIST style:font-tecl style:font-pitch %fontPitch;tIMPLIEt<<!ATTLIST style:font-tecl style:font-charset CtATA tIMPLIEt<

c5 Data tyaes
Data styaes desiribe hot to dispaay diiierent types oi datas ior e.ampaes a nSmber or a datec The eaements andattribStes that are Ssed to represent data styaes are iontained in the namespaie http://openoffice.org/
2000/tatastylec The preii. number denotes the data styaes namespaiec
This seition desiribes the OpenOiiiiecorg X L representation oi the ioaaoting data styaes:●

NSmber styae●

CSrreniy styae●

Perientage styae●

Date styae●

Booaean styae●

Te.t styae

c5c0 NSmber tyae
The <number:number-style< eaement desiribes the styae ior deiimaa nSmbersc

64

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<number:number-style<RrT 9T

This eaement ian iontain one oi the ioaaoting eaements:●<number:number<●<number:scientific-number<●<number:fraction<

These eaements desiribe the dispaay iormat oi the nSmberc The eaements ian be preieded or
ioaaoted by <number:text< eaementss thiih iontain any additionaa te.t to be dispaayedbeiore or aiter the nSmberc
n additions this eaement ian iontain a <style:properties< eaement and a <style:map< eaementc
o oT<!ENTITY % any-number "( number:number | number:scientificnumber | number:fraction y"<<!ENTITY % number-style-content "( number:text |(number:text?,%any-number;,number:text?y y"<<!ELEMENT number:number-style ( style:properties?, %numberstyle-content;, style:map? y<

YoS ian Sse the ioaaoting eaements tith the <number:number-style< eaement:●●●

NSmberiientiiii nSmber
Fraition

NSmber
The <number:number< eaement speiiiies the dispaay properties ior a deiimaa nSmberc
rg i nt T<number:number<RrT 9T

This eaement is iontained in the <number:number-style< eaementc The <number:number< eaement ian iontain mSatipae <number:embettet-text< eaementsc

o oT<!ELEMENT number:number ( number:embettet-texta y<ee eition c5c02 ior iniormation aboSt the attribStes that yoS ian assoiiate tith the nSmber styae eaementsc

Embedded Te.t
The <number:embettet-text< eaement speiiiies te.t that is dispaayed at one speiiiii position tithin anSmberc This eaement is diiierent to a groSping separators thiih appears sereraa times tithin a nSmberc
rg i nt T<number:embettet-text<

RrT 9T

This eaement is iontained in the <number:number< eaementc The <number:number<eaement ian iontain mSatipae oiiSrrenies oi the <number:embettet-text< eaement todesiribe te.t at diiierent positions in the nSmberc

o oT<!ELEMENT number:embettet-text (tPCtATAy<

The number:position attribSte speiiiies the position there the te.t appearsc
n9u un1iA Iu r
Chapter 2 Common Document Content

65rg i nt T

number:position

RrT 9T

The position is ioSnted irom right to aeits irom beiore the deiimaa point ii one e.istss or ease irom
the end oi the nSmberc For e.ampaes position nSmber 0 indiiates that the te.t is inserted beiore
the aast digitc Position nSmber indiiates that the te.t is inserted beiore the seiond aast digits andso onco oT<!ATTLIST number:embettet-text number:position %integer;
teEt|IeEt<

iientiiii NSmber
The <number:scientific-number< eaement speiiiies the dispaay properties ior a nSmber styae that shoSad
be dispaayed in siientiiii iormatc
rg i nt T<number:scientific-number<RrT 9T

This eaement is iontained in the <number:number-style< eaementc

o oT<!ELEMENT number:scientific-number EMPTY<

ee eition c5c02 ior iniormation on the attribStes that yoS ian assoiiate tith the nSmber styae eaementsc

Fraition
The <number:fraction< eaement speiiiies the dispaay properties ior a nSmber styae that shoSad be dispaayed
as a iraitionc
rg i nt T<number:fraction<

RrT 9T

This eaement is iontained in the <number:number-style< eaementc

o oT<!ELEMENT number:fraction EMPTY<

ee eition c5c02 ior iniormation on the attribStes that yoS ian assoiiate tith the nSmber styae eaementsc

c5c CSrreniy tyae
The <number:currency-style< eaement desiribes the styae ior iSrreniy raaSesc

66

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<number:currency-style<RrT 9T

This eaement ian iontain one <number:number< eaement and one <number:currencysymbol< eaementc t ian aaso iontain <number:text< eaements s thiih dispaay additionaa
te.ts bSt it iannot iontain tto oi these eaements ionseiStireayc
n additions this eaement ian iontain a <style:properties< eaement and a <style:map< eaementc
o oT<!ENTITY % currency-symbol-ant-text "number:currency-symbol,
number:text?"<<!ENTITY % number-ant-text "number:number,number:text?"<<!ENTITY % currency-style-content"( number:text |(number:text?,%number-ant-text;,(currency-symbol-ant-texty?y |(number:text?,%currency-symbol-ant-text;,(number-ant-texty?yy"<<!ELEMENT number:currency-style ( style:properties?, %currency-style-content;, style:map? y<

YoS ian Sse the ioaaoting eaements tith the <number:currency-style< eaement:●

NSmbers see eition c5c0c●CSrreniy symboa

CSrreniy ymboa
The <number:currency-symbol< eaement determines thether or not a iSrreniy symboa is dispaayed in a
iSrreniy styaec
rg i nt T<number:currency-symbol<

RrT 9T

The iontent oi this eaement is the te.t that is dispaayed as the iSrreniy symboac i the eaement isempty or iontains thite spaie iharaiters onays the deiaSat iSrreniy symboa ior the iSrreniy styaeor the aangSage and ioSntry oi the iSrreniy styae is dispaayedc
This eaement is iontained in the <number:currency-style< eaementc

o oT<!ELEMENT number:currency-symbol (tPCtATAy<i the iSrreniy symboa iontained in a iSrreniy styae beaongs to a diiierent aangSage or ioSntry to that oi the
iSrreniy styaes yoS ian Sse the iSrreniy aangSage and ioSntry attribStes to speiiiy the aangSage and ioSntry oi
the iSrreniy symboacrII 1oyi 41.r4. i41ti nr1 IyiA Iu r 9
rg i nt T

number:language
number:country

RrT 9To oT<!ATTLIST number:currency-symbol number:language CtATAtIMPLIEt<<!ATTLIST number:currency-symbol number:country CtATAtIMPLIEt<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the iSrreniy styae eaementsc

Chapter 2 Common Document Content

67c5c4 Perientage tyae
The <number:percentage-style< eaement desiribes the styae ior perientage raaSesc
rg i nt T<number:percentage-style<RrT 9T

This eaement ian iontain one <number:number< eaements thiih desiribes the dispaay iormat
ior the perientagec The eaement ian be preieded or ioaaoted by <number:text< eaementss
thiih iontain any additionaa te.t to dispaay beiore or aiter the perientagec
n additions the <number:percentage-style< eaement ian iontain a <style:properties< eaement and a <style:map< eaementc

o oT<!ENTITY % percentage-style-content "( number:text |(number:text?,%number-ant-text;y y"<<!ELEMENT number:percentage-style ( style:properties?,%percentage-style-content;, style:map? y<oT
1 4 un1
Tu u 4 un1T

CSrrentays the OpenOiiiiecorg soittare reqSires this eaement to iontain at aeast one <number:text< eaement and the te.t mSst iontain a elr iharaiterc

ee eition c5c ior iniormation on the attribStes that yoS ian assoiiate tith the perientage styae eaementc

c5c9 Date tyae
The <number:tate-style< eaement desiribes the styae ior date raaSesc
rg i nt T<number:tate-style<RrT 9T

This eaement ian iontain one instanie oi eaih oi the ioaaoting eaements: <number:tay<s<number:month<s <number:year<s <number:era<s <number:tay-of-week<s<number:week-of-year<s <number:quarter<s <number:hours<s <number:minutes<s <number:seconts<s and <number:am-pm<c
The <number:tate-style< eaement ian aaso iontain <number:text< eaements s thiih
dispaay additionaa te.ts bSt it iannot iontain tto oi these eaements ionseiStireayc n additions it
ian iontain a <style:properties< eaement and a <style:map< eaementc

o oT<!ENTITY % any-tate "( number:tay | number:month | number:year| number:era | number:tay-of-week | number:week-of-year |number:quarter | number:hours | number:am-pm | number:minutes| number:seconts y"<<!ENTITY % tate-style-content "( number:text | (number:text?,(%any-tate;,number:text?yty y"<<!ELEMENT number:tate-style ( style:properties?, %tate-stylecontent;, style:map? y<n TiThis DTD does not reiaeit the iait that some eaements mSst not oiiSr more than oniec

ee eition c5c ior iniormation on the attribStes that yoS ian assoiiate tith the date styae eaementsc
The <number:tate-style< eaement ian iontain the ioaaoting eaements:

68●<number:tay< < day oi month●<number:month< < month●<number:year< < year●

<number:era< < era

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●<number:tay-of-week< < day oi teek●

<number:week-of-year< < teek oi year●

<number:quarter< < qSarterDay oionth

The <number:tay< eaement speiiiies the day oi the month in a datec
rg i nt T<number:tay<

RrT 9Ti this eaement is Sseds it shoSad be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:tay EMPTY<

The iormat attribSte speiiiies thether the day oi month eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For dayss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the day oi the month is dispaayed Ssing one or tto digits●

long means that the day oi the month is dispaayed Ssing tto digits<!ATTLIST number:tay number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

onth
The <number:month< eaement speiiiies the month in a datec
rg i nt T<number:month<RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:month EMPTY<

The number:textual attribSte determines thether the name or nSmber oi a month is dispaayed in the montheaement oi a datec
r4TiR oI 9 1 4 un1iA Iu r
rg i nt T

number:textualRrT 9Ti the raaSe oi this attribSte raaSe is trues the name oi the month is dispaayedc i the attribSte
raaSe is falses the nSmber oi the month is dispaayedc

o oT<!ATTLIST number:month number:textual %boolean; "false"<

The number:style attribSte speiiiies thether the month eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r

Chapter 2 Common Document Content

69

rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For monthss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the abbreriated name oi the month is dispaayed or the month is dispaayed
Ssing one or tto digits●

long means that the iSaa name oi the month is dispaayed or the month is dispaayed Ssing tto
digits<!ATTLIST number:month number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

Year
The <number:year< eaement speiiiies the year in the datec
rg i nt T<number:year<

RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:year EMPTY<

The number:style attribSte speiiiies thether the year eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For yearss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the year is dispaayed Ssing tto digits●

long means that the year is dispaayed Ssing ioSr digits<!ATTLIST number:year number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

Era
The <number:era< eaement speiiiies the era in thiih the year is ioSntedc
rg i nt T<number:era<

RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:era EMPTY<

The number:style attribSte speiiiies thether the era eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r

70

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For erass ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the abbreriated era name is Ssed●

long means that the iSaa era name is Ssed<!ATTLIST number:era number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

Day Oi Deek
The <number:tay-of-week< eaement speiiiies the day oi the teek in a datec
rg i nt T<number:tay-of-week<

RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:tay-of-week EMPTY<

The number:style attribSte speiiiies thether the day oi teek eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For days oi the teeks the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the abbreriated name oi the day is dispaayed●

long means that the iSaa name oi the day is dispaayed<!ATTLIST number:tay-of-week number:style (short|longy short<

Deek Oi Year
The <number:week-of-year< eaement speiiiies the teek oi the year in the datec
rg i nt T<number:week-of-year<

RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:week-of-year EMPTY<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

oSarter
The <number:quarter< eaement speiiiies the qSarter oi the year in the datec

Chapter 2 Common Document Content

71

rg i nt T

<number:quarter<RrT 9Ti Sseds this eaement mSst be iontained in the <number:tate-style< eaementc

o oT<!ELEMENT number:quarter EMPTY<

The number:style attribSte speiiiies thether the qSarter eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the date styaec
For qSarterss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the abbreriated name oi the qSarter is dispaayeds ior e.ampaes o0●long means that the iSaa name oi the qSarter is dispaayeds ior e.ampaes oSarter 0<!ATTLIST number:quarter-of-year number:style (short|longy
short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the date styae eaementsc

c5c5 Time tyae
The <number:time-style< eaement desiribes the styae ior time raaSesc
rg i nt T<number:time-style<RrT 9T

This eaement ian iontain one instanie oi any oi the ioaaoting eaements: <number:hours<s<number:minutes<, <number:seconts< and <number:am-pm<.
The <number:time-style< eaement ian aaso iontain <number:text< eaements s thiih
dispaay additionaa te.ts bSt it iannot iontain tto oi these eaements ionseiStireayc n additions it
ian iontain a <style:properties< eaement and a <style:map< eaementc

o oT<!ENTITY % any-time "( number:hours | number:am-pm | number:minutes | number:seconts y"<<!ENTITY % time-style-content "( number:text | (number:text?,(%any-time;,number:text?yty y"<<!ELEMENT number:time-style ( style:properties?, %time-stylecontent;, style:map? y<n T This DTD does not reiaeit the iait that some eaements mSst not oiiSr more than oniec

ee eition c5c ior iniormation on the attribStes that yoS ian assoiiate tith the time styae eaementsc
The ioaaoting eaements ian be iontained in the <number:time-style< eaement:

72●<number:hours< < hoSrs●<number:minutes< < minStes●<number:seconts< < seionds●<number:am-pm< < amspm

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

OoSrsThe <number:hours< eaement speiiiies ii hoSrs are dispaayed as part oi a date or timec
rg i nt T<number:hours<

RrT 9To oT<!ELEMENT number:hours EMPTY<

The number:style attribSte speiiiies thether the hoSrs eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the time styaec
For hoSrss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the hoSrs are dispaayed Ssing at aeast one digit●

long means that the hoSrs are dispaayed Ssing at aeast tto digits<!ATTLIST number:hours number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the time styae eaementsc

inStesThe <number:minutes< eaement speiiiies ii minStes are dispaayed as part oi a date or timec
rg i nt T<number:minutes<

RrT 9To oT<!ELEMENT number:minutes EMPTY<

The number:style attribSte speiiiies thether the minStes eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the time styaec
For minStess ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the minStes are dispaayed Ssing at aeast one digit●

long means that the minStes are dispaayed Ssing at aeast tto digits<!ATTLIST number:minutes number:style (short|longy short<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the time styae eaementsc

eiondsThe <number:seconts< eaement speiiiies ii seionds are dispaayed as part oi a date or timec

Chapter 2 Common Document Content

73

rg i nt T

<number:seconts<

RrT 9To oT<!ELEMENT number:seconts EMPTY<

The number:style attribSte speiiiies thether the seionds eaement is dispaayed in short or aong iormatc
nI 4 iA Iu r
rg i nt T

number:style

RrT 9TThe raaSe oi this attribSte ian be short or longc The meaning oi these raaSes depends on the
raaSe oi the number:format-source attribSte that is attaihed to the time styaec
For seiondss ii the raaSe oi the number:format-source attribSte is fixet:

o oT

●

short means that the seionds are dispaayed Ssing at aeast one digit●

long means that the seionds are dispaayed Ssing at aeast tto digits<!ATTLIST number:seconts number:style (short|longy short<

Dhen yoS are dispaaying iraitionss yoS ian iniaSde iraitions oi seiondsc The number:tecimal-places
attribSte determines the nSmber oi deiimaa paaies to Sse then dispaaying iraitionsco ou 4Ti T4o 9iA Iu r
rg i nt T

number:tecimal-places

RrT 9Ti this attribSte is not Ssed or ii the raaSe oi the attribSte is 0s iraitions are not dispaayedc

o oT<!ATTLIST number:seconts number:tecimal-places %number; "0"<ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the time styae eaementsc

sP
The <number:am-pm< eaement speiiiies ii

sP

is iniaSded as part oi the date or timec

rg i nt T<number:am-pm<

RrT 9Ti a <number:am-pm< eaement is iontained in a date or time styaes hoSrs are dispaayed Ssing
raaSes irom 1 to 12 onayc

o oT<!ELEMENT number:am-pm EMPTY<

ee eition c5c ior iniormation on the other attribStes that yoS ian assoiiate tith the time styae eaementsc

c5c6 Booaean tyae
The <number:boolean-style< eaement desiribes the styae ior Booaean raaSesc

74

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<number:boolean-style<RrT 9T

This eaement ian iontain one <number:boolean< eaements thiih ian be preieded or
ioaaoted by <number:text< eaementsc n additions it ian iontain a <style:properties< eaement and a <style:map< eaementc

o oT<!ENTITY % boolean-style-content "(number:text| (number:text?,
number:boolean,number:text?yy"<<!ELEMENT number:boolean-style ( style:properties?,%booleanstyle-content;, style:map? y<Booaean
The <number:boolean< eaement iontains the Booaean raaSe oi a Booaean styaec
rg i nt T<number:boolean<

RrT 9To oT<!ELEMENT number:boolean EMPTY<

ee eition c5c ior iniormation on the attribStes that yoS ian assoiiate tith the Booaean styae eaementsc

c5cm Te.t tyae
The <number:text-style< eaement desiribes the styae ior dispaaying te.tc
rg i nt T<number:text-style<RrT 9T

This eaement ian iontain any nSmber oi <number:text-content< eaementsc t ian aaso
iontain <number:text< eaements s thiih dispaay additionaa te.ts bSt it iannot iontain tto oi
these eaements ionseiStireayc n additions it ian iontain a <style:properties< eaement anda <style:map< eaementc

o oT<!ENTITY % text-style-content "(number:text| (number:text?,
number:text-content, number:text?yy"<<!ELEMENT number:text-style ( style:properties?,%text-stylecontent;, style:map? y<n 9T

The <number:text-content< eaements represent the rariabae te.t iontent to dispaays
thiae the <number:text< eaements iontain any additionaa ii.ed te.t to dispaayc

ee eition c5c ior iniormation on the attribStes that yoS ian assoiiate tith the te.t styae eaementsc

Fi.ed Te.t
The <number:text< eaement iontains any ii.ed te.t ior a data styaec
rg i nt T<number:text<

RrT 9T

This eaement is iontained in the data styaes eaementc

o oT<!ELEMENT number:text (tPCtATAy<

Chapter 2 Common Document Content

75

Te.t Content
The <number:text-content< eaement iontains the te.t iontent oi a te.t styaec
rg i nt T<number:text-content<

RrT 9T<!ELEMENT number:text-content EMPTY<

o oT

c5cr Common Data tyae Eaements
YoS ian Sse some styae eaements tith any oi the primary data styae eaementsc These eaements are:●●Formatting properties
tyae mappings

Formatting Properties
The <style:properties< eaement speiiiies the te.t iormatting properties to appay to any te.t dispaayed in
the data styaec ee eition c c0 ior iniormation on the iormatting properties eaementc

tyaeappings

The <style:map< eaement speiiiies an aaternatire data styae to map to ii a iertain iondition e.istsc ee eitionc c5 ior iniormation on the <style:map< eaementc
RrT 9ienIir9u1.
ru9i T
1 iAu rt4 4i9 yT
T
1 9T

●

This eaement mSst be the aast ihiad eaement in the data styae eaementc●

The styae reierenied by the style:apply-style attribSte mSst be oi the same type as
the styae iontaining the mapc●

The iondition mSst be in the iormat value(y Th ls there Th is a reaationaa operator andl is a nSmberc For Booaean styaes the iondition raaSe mSst be true and falsec

c5c Common Data tyae ttribStes
any oi the data styae attribStes are appaiiabae to more than one data styae eaementc The ioaaoting data styae
attribStes are iommon to many oi the data styae eaements:
●

Name

●

LangSage●

CoSntry

●

Titae

●

Voaatiaity

●
●

76

Stomatii Order
Format oSrie

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Time VaaSe TrSniation●

Transaiteration

Name
The style:name attribSte speiiiies the name oi the data styaec t ian be Ssed tith the ioaaoting data styaeeaements:●<number:number-style<●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<rg i nt T

style:nameRrT 9To oT<!ATTLIST number:number-style style:name %style-name;teEt|IeEt<

LangSage
The number:language attribSte speiiiies the aangSage oi the styaec The raaSe oi the attribSte is a aangSage
iode ioniorming tith O64 c OpenOiiiiecorg X L Sses the aangSage iode to retriere iniormation aboSt any
dispaay properties that are aangSage-dependentc The aangSage attribSte ian be Ssed tith the ioaaoting data styaeeaements:●<number:number-style<●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<rg i nt T

number:language

RrT 9Ti a aangSage iode is not speiiiieds either the system settings or the setting ior the system's
aangSage are Sseds depending on the property those raaSe shoSad be retrieredc

o oT<!ATTLIST number:number-style number:language CtATA tIMPLIEt<

Chapter 2 Common Document Content

77

CoSntry
The number:country attribSte speiiiies the ioSntry oi the styaec The raaSe oi the attribSte is a ioSntry iodes
ioniorming tith O4066c OpenOiiiiecorg X L Sses the ioSntry iode to retriere iniormation aboSt any dispaay
properties that are ioSntry-dependentc The aangSage attribSte ian be Ssed tith the ioaaoting data styae eaements:●<number:number-style<●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<rg i nt T

number:country

RrT 9Ti a ioSntry is not speiiiieds either the system settings or the setting ior the system's ioSntry are
Sseds depending on the property those raaSe shoSad be retrieredc

o oT<!ATTLIST number:number-style number:country CtATA tIMPLIEt<

Titae
The number:title attribSte speiiiies the titae oi the data styaec t ian be Ssed tith the ioaaoting data styaeeaements:●<number:number-style<●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<rg i nt T

number:title

RrT 9To oT<!ATTLIST number:number-style number:title CtATA tIMPLIEt<

Voaatiaity
ometimes then a doiSment is openeds not aaa oi the styaes are Ssedc The SnSsed styaes ian be retained or
disiarded; depending on the appaiiation yoS are Ssingc The style:volatile attribSte aaaots yoS to speiiiythat to do tith the SnSsed styaesc The roaatiaity attribSte ian be Ssed tith any oi the ioaaoting data styaeeaements:●

78<number:number-style<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<rg i nt T

style:volatile

RrT 9Ti the raaSe oi the attribSte is trues the appaiiation keeps the styae ii possibaec i the raaSe isfalses the appaiiation disiards the SnSsed styaesco oT<!ATTLIST number:number-style style:volatile %boolean;tIMPLIEt<n T

i a styae is iontained in a <style:styles< eaements the deiaSat raaSe oi the style:volatile attribSte is truec i a styae is iontained in a <style:automatic-styles<
eaements the deiaSat raaSe is falsec

Stomatii OrderThe number:automatic-orter attribSte ian be Ssed to aStomatiiaaay order data to matih the deiaSat orderior the aangSage and ioSntry oi the data styaec This attribSte is Ssed tith the ioaaoting eaements:●<number:currency-style<, there nSmber and iSrreniy symboas are reordered●<number:tate-style<, there the <number:tate-style< ihiad eaements that are not <number:text< or <style:properties< eaements are reorderedrg i nt T

number:automatic-orterRrT 9T

The attribSte raaSe ian be true or falsec

o oT<!ATTLIST number:currency-style number:automatic-orter %boolean; "false"<nI<!ATTLIST number:tate-style number:automatic-orter %boolean;"false"<n T

i aStomatii ordering is enabaeds bSt the aangSage and ioSntry are not speiiiieds the systemsettings ior the order oi nSmbers and iSrreniy symboas is Ssedc

Format oSrie
The number:format-source attribSte speiiiies the soSrie oi the short and long dispaay iormatsc t is
Ssed tith the ioaaoting eaements:●<number:tate-style<●<number:time-style<

Chapter 2 Common Document Content

79

rg i nt T

number:format-source

RrT 9TThe raaSe oi this attribSte ian be fixet or languagec
i the raaSe is fixets the appaiiation determines the raaSe oi short and longc i the raaSe islanguages the raaSe oi short and long is taken irom the aangSage and ioSntry oi the styaec<!ATTLIST number:tate-style number:format-source (fixet|
languagey fixet<o oT

i the raaSe oi the number:format-source attribSte is languages the meaning oi shortand short depends on the aangSage and ioSntry oi the date styaes ors ii neither oi these are speii iieds OpenOiiiiecorg X L Sses the system settings ior short and aong date and time iormatsc

n 9TTime VaaSe TrSniation
The number:truncate-on-overflow attribSte is Ssed tith the <number:time-style< eaementc i atime or dSration is too aarge to dispaay Ssing the deiaSat raaSe range ior a time iomponents i2 to 4 ior<number:hours<ys yoS ian Sse the time raaSe trSniation attribSte to speiiiy ii it ian be trSniated or the raaSe
range e.tendedc
rg i nt T

number:truncate-on-overflow

RrT 9T<!ATTLIST number:time-style number:truncate-on-overflow %boolean; "true"<o oTTransaiteration
The nSmber:transaiteration-* attribStes speiiiy the natire nSmber system oi the styae to dispaay the nSmber Ssingsior e.ampaes CJ2 nSmber iharaitersc The notation is inspired by the D4C X LT c2 draits see "NSmber to tring
Conrersion ttribStes" thttp:sstttct4corgsT s.sat 2s*ionrertTc Ooterers to be abae to iSaay distingSish betteen
aaa possibae natire nSmber systems additionaa attribStes are needed in iombinationc For e.ampaes 2orean Sses 00
diiierent systems there the digits are not aatays diiierent bSt short and aong and iormaa and iniormaa iorms e.istc
The transaiteration attribStes ian be Ssed tith the ioaaoting data styae eaements:●<number:number-style<●<number:currency-style<●<number:percentage-style<●<number:tate-style<●<number:time-style<●<number:boolean-style<●<number:text-style<Transaiteration Format
The number:transliteration-format attribSte speiiiies thiih nSmber iharaiters to Ssec The raaSe oi
the attribSte is the digit "0" e.pressed as a natire nSmberc

80

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

number:transliteration-format

RrT 9Ti no iormat is speiiiied the deiaSat
C representation oi rabii digits is Sseds other transait eration attribStes present in this iase are ignoredc

o oT<!ATTLIST number:number-style number:transliteration-format
CtATA "1"<

Transaiteration LangSage
The number:transliteration-language attribSte speiiiies thiih aangSage the natire nSmber systembeaongs toc The raaSe oi the attribSte is a aangSage iode ioniorming tith O64 c
rg i nt T

number:transliteration-language

RrT 9Ti no aangSagesioSntry iaoiaaeo iombination is speiiiied the aoiaae oi the data styae is Ssedc

o oT<!ATTLIST number:number-style number:transliteration-language
CtATA tIMPLIEt<

Transaiteration CoSntry
The number:transliteration-country attribSte speiiiies thiih ioSntry the natire nSmber systembeaongs to c The raaSe oi the attribSte is a ioSntry iode ioniorming tith O4066c
rg i nt T

number:transliteration-country

RrT 9Ti no aangSagesioSntry iaoiaaeo iombination is speiiiied the aoiaae oi the data styae is Ssedc

o oT<!ATTLIST number:number-style number:transliteration-country
CtATA tIMPLIEt<

Transaiteration tyae
The number:transliteration-style attribSte speiiiies thiih styae the natire nSmber system beaongs
toc i more than one natire nSmber system matihes the transaiteration-iormat this attribSte seaeits onec
rg i nt T

number:transliteration-style

RrT 9T

short styae shoSad resSat in a one to one mapping oi rabii digits to natire nSmber digits ii
possibaec

o oT<!ATTLIST number:number-style number:transliteration-style(short|metium|longy "short"<

c5c02 Common NSmber tyae ttribStes
any oi the nSmber styae attribStes are appaiiabae to more than one nSmber styae eaementc The ioaaoting attribStes are iommon to many oi the nSmber styae eaements:●●

Deiimaa paaies
inimSm integer digits●

GroSping separator●

Deiimaa repaaiement
Chapter 2 Common Document Content

81

●inimSm e.ponent digits●

inimSm nSmerator digits●

inimSm denominator digits●

Caaendar system

Deiimaa Paaies
The number:tecimal-places attribSte speiiiies the nSmber oi deiimaa paaies to dispaayc YoS ian Sse this
attribSte tith the ioaaoting eaements:●<number:number<●<number:scientific-number<rg i nt T

number:tecimal-places

RrT 9Ti this attribSte is not speiiiieds a deiaSat nSmber oi deiimaa paaies is Ssedc

o oT<!ATTLIST number:number number:tecimal-places %number;tIMPLIEt<

inimSm nteger Digits
The number:min-integer-tigits attribSte speiiiies the minimSm nSmber oi integer digits to dispaay in anSmbers a siientiiii nSmbers or a iraitionc YoS ian Sse this attribSte tith the ioaaoting eaements:●<number:number<●<number:scientific-number<●<number:fraction<

rg i nt T

number:min-integer-tigits

RrT 9Ti this attribSte is not speiiiieds a deiaSat nSmber oi integer digits is Ssedc

o oT<!ATTLIST number:number number:min-integer-tigits %number;tIMPLIEt<

GroSping eparator
The number:grouping attribSte speiiiies thether or not the integer digits oi a nSmber shoSad be groSped
Ssing a separator iharaiterc YoS ian Sse this attribSte tith the ioaaoting eaements:

82●<number:number<●<number:scientific-number<●<number:fraction<

rg i nt T

number:groupingRrT 9T

The groSping iharaiter that is Ssed and the nSmber oi digits that are groSped together depends on
the aangSage and ioSntry oi the styaeco oT<!ATTLIST number:number number:grouping %boolean; "false"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Deiimaa epaaiementi a nSmber styae speiiiies that deiimaa paaies are Ssed bSt the nSmber dispaayed is an integers yoS ian dispaay
repaaiement te.t instead oi the deiimaa paaiesc The number:tecimal-replacement attribSte speiiiies therepaaiement te.tc YoS ian Sse this attribSte tith the <number:number< eaementc
rg i nt T

number:tecimal-replacement

RrT 9To oT<!ATTLIST number:number number:tecimal-replacement CtATAtIMPLIEt<

oT
1 4 un1
Tu u 4 un1T

CSrrentays OpenOiiiiecorg onay sSpports repaaiement te.t that ionsists oi the same nSmber oi e-r
iharaiters as deiimaa paaiesc

Dispaay Faitor
The number:tisplay-factor attribSte speiiiies a iaitor by thiih eaih nSmber is siaaed idiridedo beiore
dispaayingc iaitor oi 0222s ior e.ampaes iaSses nSmbers to be dispaayed in thoSsandsc YoS ian Sse this attribSte
tith the <number:number< eaementc
rg i nt T

number:tisplay-factor

RrT 9To oT<!ATTLIST number:number number:tisplay-factor %float; "1"<oT
1 4 un1
Tu u 4 un1T

CSrrentays OpenOiiiiecorg onay sSpports dispaay iaitors oi 0222 to the poter oi a non-negatire
integer nSmbers that is 0s 0222s 0222222s 0222222222s etic

inimSm E.ponent Digits
The number:min-exponent-tigits attribSte speiiiies the minimSm nSmber oi digits to Sse to dispaay ane.ponentc YoS ian Sse this attribSte tith the <number:scientific-number< eaementc
rg i nt T

number:min-exponent-tigits

RrT 9To oT<!ATTLIST number:scientific-number number:min-exponent-tigits%number; tIMPLIEt<

inimSm NSmerator Digits
The number:min-numerator-tigits attribSte speiiiies the minimSm nSmber oi digits to Sse to dispaay
the nSmerator in a iraitionc YoS ian Sse this attribSte tith the <number:fraction< eaementc
rg i nt T

number:min-numerator-tigits

RrT 9To oT<!ATTLIST number:fraction number:min-numerator-tigits %number;tIMPLIEt<

Chapter 2 Common Document Content

83inimSm Denominator Digits
The number:min-tenominator-tigits attribSte speiiiies the minimSm nSmber oi digits to Sse todispaay the denominator oi a iraitionc YoS ian Sse this attribSte tith the <number:fraction< eaementc
rg i nt T

number:min-tenominator-tigits

RrT 9To oT<!ATTLIST number:fraction number:min-tenominator-tigits %number; tIMPLIEt<

Caaendar ystem
The number:calentar attribSte speiiiies the iaaendar system Ssed to e.trait parts oi a datec YoS ian Sse this
attribSte tith the ioaaoting eaements:●<number:tay<●<number:month<●<number:year<●<number:era<●<number:tay-of-week<●<number:week-of-year<●<number:quarter<rg i nt T

number:calentar

RrT 9Ti this attribSte is not speiiiieds the deiaSat iaaendar system is Ssedc

o oT<!ATTLIST number:tay number:calentar CtATA tIMPLIEt<

c6 Frames
eI4 is a reitangSaar iontainer there yoS ian paaie iontent that yoS tant to position oStside the deiaSat te.tiaot oi a doiSmentc n OpenOiiiiecorg doiSmentss irames ian iontain:
●

mages

●

Dratings●

Te.t bo.es iOpenOiiiiecorg Driter doiSments onayo●

ppaets●Faoating irames●

PaSg-ins●

OpenOiiiiecorg objeits and iommon OLE objeitsirame has properties that appay to:84●

The area aroSnd the irame or the irame neighborhoods ior e.ampaes the anihor types position or trap modec●

The irame iontent onays ior e.ampaes the

OpenOffice.org XML File Format Working Draft

L ior a piitSrec

Technical Reference Manual Version 2

December 2ee2

●Both irame neighborhood and iontents ior e.ampaes the irame sikec

OpenOiiiiecorg X L does not diiierentiate betteen the diiierent types oi irame propertiesc Frame iormatting
properties are stored in an aStomatiiaaay generated styae beaonging to the graphics iamiayc The tay a irame isiontained in a doiSment depends on the iiae iormat type and is e.paained in the appaiiation-speiiiii ihapters oi
this doiSmentc
There are sereraa eaements Ssed to represent the diiierent irame typesc n this manSaas these eaements are iaaaed
eI4 i T
1 9 cThis seition desiribes the ioaaoting irame types and the eaements Ssed to represent them:●Te.t Bo.es

●

mages

●

Dratings●

Controas●

PaSg-inss appaetss and iaoating irames●

Objeits

c6c0 Te.t Bo.es
YoS ian Sse a te.t bo. to paaie te.t in a iontainer that is oStside oi the normaa iaot oi the doiSmentc
rg i nt T<traw:text-box<

RrT 9To oT
n T<!ELEMENT traw:text-box (%frame;a,%text;y<VG does not sSpport te.t bo.ess thiae X L has aimited sSpport ior te.t bo.esc

The attribStes that yoS ian assoiiate tith the <traw:text-box< eaement are:
●

Name

●

tyae

●

Chain

●

Positions sikes and transiormation isee Chapter 5o●Layer D isee eition c6c02o●

1 nde. isee eition c6c02o

Name
The traw:name attribSte speiiiies the name oi the te.t bo.crg i nt T

traw:nameRrT 9To oT<!ATTLIST traw:text-box text:name CtATA tIMPLIEt<oT
1 4 un1
Tu u 4 un1T

This attribSte is onay sSpported by OpenOiiiiecorg Driterc i a te.t bo. tithoSt a name is aoaded
into OpenOiiiiecorg Driters it is inserted as a drating te.t bo.c

Chapter 2 Common Document Content

85

tyae
The traw:style-name attribSte speiiiies the name oi the styae ior the te.t bo.crg i nt T

traw:style-name

RrT 9T

This attribSte ainks to a <style:style< eaement beaonging to the graphic styae iamiayc

o oT<!ATTLIST traw:text-box traw:style-name Astyle-name;teEt|IeEt<

ChainTe.t bo.es ian be ihaineds in other tordss ii the iontent oi a te.t bo. e.ieeds its iapaiitys the iontent iaots into
the ne.t te.t bo. in the ihaincrg i nt T

style:chain-next-name

RrT 9TThe raaSe oi this attribSte is the name oi the ne.t te.t bo. in the ihainco oT<!ATTLIST style:properties style:chain-next-name CtATAtIMPLIEt<

oT
1 4 un1
Tu u 4 un1T

Chained te.t bo.es are onay sSpported by OpenOiiiiecorg Driterc

c6c

mages

n image ian be either:●

Contained in an OpenOiiiiecorg doiSment as a aink to an e.ternaa resoSrie

or●

Embedded in an OpenOiiiiecorg doiSmentrg i nt T<traw:image<RrT 9T

This eaement ian be an XLinks in thiih iase the eaement iontains some attribStes tith ii.ed
raaSes that desiribe the aink semantiisco oT<!ELEMENT traw:image (office:binary-tata?,office:events?,traw:
image-map?,svg:tesc?,(traw:contour-polygon|traw:contourpathy?y<The attribStes that yoS ian assoiiate tith the <traw:image< eaement are:●86

Name isee eition c6c02o

●

tyae

●

mage data●

Positions sikes and transiormation isee Chapter 5o●Fiater name●

Layer D isee eition c6c02o●

1 nde. isee eition c6c02o

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

YoS ian aaso Sse the ioaaoting eaements tith the image eaement:●●

ContoSr isee eition c6c oaternatire Te.t isee eition c6c otyae
The traw:style-name attribSte speiiiies the name oi the styae ior the imagec
rg i nt T

traw:style-name

RrT 9T

This attribSte ainks to a <style:style< eaement beaonging to the graphic styae iamiayc

o oT<!ATTLIST traw:text-box traw:style-name Astyle-name;teEt|IeEt<

mage Data
The image data ian be stored in one oi the ioaaoting tays:●

The image data is iontained in an e.ternaa iiaec se the xlink:href and assoiiated attribStes desiribedbeaot to aink to the e.ternaa iiaec●

The image data is iontained in the <traw:image< eaementc The <traw:image< eaement iontains an<office:binary-tata< eaement that iontains the image data in B E69 eniodingc n this sitSation the
xlink:href attribSte is not reqSiredc

rg i nt T

xlink:hrefs xlink:types xlink:shows and xlink:actuate

RrT 9To oT<!ATTLIST traw:image xlink:href %url; tIMPLIEt<<!ATTLIST traw:image xlink:type (simpley tIMPLIEt<<!ATTLIST traw:image xlink:show (embety 'IMPLIEt<<!ATTLIST traw:image xlink:actuate (onLoaty 'IMPLIEt<

Fiater Namei reqSireds the traw:filter-name attribSte ian represent the iiater name oi the imagec
rg i nt T

traw:filter-name

RrT 9T

This attribSte iontains the internaa iiater name that the OpenOiiiiecorg soittare Ssed to aoad thegraphiico oT<!ATTLIST traw:image traw:filter-name tIMPLIEt<

c6c4 Dratings
ee Chapter 5 ior iniormation on drating shapesc

Chapter 2 Common Document Content

87c6c9 Objeitsn OpenOiiiiecorg X L doiSment ian iontain tto types oi objeitss as ioaaots:●

Objeits that hare an X L representationc These objeits are those thiih the OpenOiiiiecorg soittare ianireate and modiiys as ioaaots:➢

FormSaas ireated Ssing OpenOiiiiecorg➢

Charts ireated Ssing OpenOiiiiecorg Chart

➢

●

ath

preadsheets ireated Ssing OpenOiiiiecorg Caai➢

Te.t doiSments ireated Ssing OpenOiiiiecorg Driter➢

Dratings ireated Ssing OpenOiiiiecorg Drat➢

Presentations ireated Ssing OpenOiiiiecorg mpress

Objeits that do not hare an X L representationc These objeits onay hare a binary representation and they areaoaded and stored Ssing OLEc

rg i nt T<traw:obiect<<traw:obiect-ole<

RrT 9T

The <traw:obiect< eaement represents objeits that hare a X L representationc
The <traw:obiect-ole< eaement represents objeits that onay hare a binary representationc<!ELEMENT traw:obiect ((office:tocument|math:mathy?,office:events?,traw:image-map?,svg:tesc?,(traw:contour-polygon|traw:
contour-pathy?y<<!ELEMENT traw:obiect-ole (office:binary-tata?,office:events?,
traw:image-map?,svg:tesc?,(traw:contour-polygon|traw:contourpathy?,traw:thumbnail?y<o oT

Objeit Data
The objeit data ian be iaaaed in one oi the ioaaoting tays:●●

The xlink:href attribSte ainks to the objeit representations as ioaaots:➢

For objeits that hare an X L representations the aink reierenies the sSbpaikage oi the OLE objeitc➢

For objeits that do not hare an X L representations the aink reierenies a sSbstream oi the paikage that
iontains the binary representation oi the objeitc

The objeit data is iontained in the <traw:obiect< or <traw:obiect-ole< eaements as ioaaots:➢

The <traw:obiect< eaement iontains the X L representation oi the objeits ior e.ampaes an<office:tocument< or a <math:math< eaementc➢

The <traw:obiect-ole< eaement iontains an <office:binary-tata< eaements thiih
iontains the binary data ior the objeit in B E69 eniodingcn these sitSationss the xlink:href attribStes are not reqSiredc

88

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

xlink:hrefs xlink:types xlink:shows and xlink:actuate

RrT 9To oT<!ATTLIST traw:obiect xlink:href %url; tIMLIEt<<!ATTLIST traw:obiect xlink:type (simpley tIMPLIEt<<!ATTLIST traw:obiect xlink:show (embety tIMPLIEt<<!ATTLIST traw:obiect xlink:actuate (onLoaty tIMPLIEt<<!ATTLIST traw:obiect-ole xlink:href %url; teEt|IeEt<<!ATTLIST traw:obiect-ole xlink:type (simpley tFIXEt "simple"<<!ATTLIST traw:obiect-ole xlink:show (embety "embet"<<!ATTLIST traw:obiect-ole xlink:actuate (onLoaty "onLoat"<oT
1 4 un1
Tu u 4 un1T

The iSrrent OpenOiiiiecorg impaementation does not sSpport e.ternaa objeitsc aa objeits mSst
be aoiated in the root oi the paikage ior the doiSmentc

Notiiiiation on Tabae Change
ome objeitss espeiiaaay ihartss may reqSire a notiiiiation then a tabae in the doiSment ihangesc To enabae thisnotiiiiations Sse the traw:notify-on-change-of-table attribStes thiih iontains the name oi the tabaec
rg i nt T

traw:notify-on-change-of-table

RrT 9T

This attribSte ian be assoiiated tith the <traw:obiect< eaementc

o oT<!ATTLIST traw:obiect traw:notify-on-change-of-table %string;tIMPLIEt<

n TThis attribSte does not enabae the aStomatii Spdate oi an OLE objeit ii data tithin a tabaeihangesc The pSrposeoi the attribSte is to speed Sp Spdates to thoae doiSments by onay notiiying
the OLE objeits that hare a ionneition to any tabaec

c6c5

ppaetsn appaet is a smaaa Jara-based program that is embedded in a doiSmentc The <traw:applet< eaement isbased on the aappaet< tag in OT Lc
rg i nt T<traw:applet<

RrT 9T

This eaement mSst iontain either the traw:cote or traw:obiect attribStec
The traw:parama eaements mSst be aoiated beiore other iontentc

o oT<!ELEMENT traw:applet (traw:parama, svg:tesc?, (traw:contourpolygon|traw:contour-pathy?y<The attribStes that yoS ian assoiiate tith the <traw:applet< eaement are:●Codebase

●

Code

●

Objeit●rihire●Name isee eition c6c02o●

tyae isee eition c6c02o●

Positions sikes and transiormation isee Chapter 5o
Chapter 2 Common Document Content

89●

Layer D isee eition c6c02o●

1 nde. isee eition c6c02o●

aysiript

YoS ian aaso Sse the ioaaoting eaements:●

Alternative Text (see Section 2.6.9A

●

Param

Codebase
The traw:cotebase speiiiies the baseior the appaetc i this attribSte is not speiiiieds then it deiaSats thesame baseas ior the iSrrent doiSmentc This is represented as an .aink:hreic
rg i nt T

xlink:hrefs xlink:types xlink:shows and xlink:actuate

RrT 9To oT<!ATTLIST traw:applet xlink:href %url; teEt|IeEt<<!ATTLIST traw:applet xlink:type (simpley tFIXEt "simple"<<!ATTLIST traw:applet xlink:show (embety "embet"<<!ATTLIST traw:applet xlink:actuate (onLoaty "onLoat"<

Code
The traw:cote attribSte speiiiies one oi the ioaaoting:●

The name oi the iaass iiae that iontains the iompiaed appaet sSbiaassc●

The path to the iaasss iniaSding the iaass iiae itseaic

rg i nt T

traw:cote

RrT 9T

Either this attribSte or the traw:obiect attribSte is reqSiredc
The raaSe oi this attribSte is interpreted in reaation to the iodebase ior the appaetc

o oT<!ATTLIST traw:applet traw:cote CtATA teEt|IeEt<

Objeit
The traw:obiect attribSte speiiiies a resoSrie that iontains a seriaaiked representation oi the state oi theappaetc The seriaaiked data iontains the iaass name oi the appaet bSt not the impaementationc
rg i nt T

traw:obiect

RrT 9TThe raaSe oi this attribSte is interpreted in reaation to the iodebase ior the appaetc

o oT<!ATTLIST traw:applet traw:obiect CtATA tIMPLIEt<

n TThis attribSte is not Ssed tithin the OpenOiiiiecorg iore and is stored ior OT L e.portc

rihire
The traw:archive attribSte speiiiies a iomma-separated aist oi
90

OpenOffice.org XML File Format Working Draft

Ls ior arihires that iontain iaasses andTechnical Reference Manual Version 2

December 2ee2

other resoSries that are preaoadedc
rg i nt T

traw:archive

RrT 9To oT
n T<!ATTLIST traw:applet traw:archive CtATA tIMPLIEt<
This attribSte is not Ssed tithin the OpenOiiiiecorg iore and is stored ior OT L e.portc

aysiript
The traw:mayscript attribSte speiiiies thether or not the appaet ian be siriptedc
rg i nt T

traw:mayscript

RrT 9To oT<!ATTLIST traw:plugin traw:mayscript %boolean; "false"<

c6c6 PaSgins
paSgin is a binary objeit that is paSgged into a doiSment to represent a media-type that is not handaed natireay
by the OpenOiiiiecorg soittarec
rg i nt T<traw:plugin<

RrT 9T

This is Ssed to desiribe paSgins in the doiSmentadrat:paSgin< is Ssed ior paSgins

o oT<!ELEMENT traw:plugin (traw:parama, svg:tesc?, (traw:contourpolygon|traw:contour-pathy?y<The attribStes that yoS ian assoiiate tith the <traw:plugin< eaement are:●ime type

●

oSrie

●

Name isee eition c6c02o●

tyae isee eition c6c02o●

Positions sikes and transiormation isee Chapter 5o●Layer D isee eition c6c02o●

1 nde. isee eition c6c02o

YoS ian aaso Sse the ioaaoting eaement:●

Alternative Text (see Section 2.6.9A

●

Param

ime type
The traw:mimetype attribSte speiiiies theE type to thiih this paSgin shoSad be registeredc

Chapter 2 Common Document Content

91

rg i nt T

traw:mimetypeRrT 9To oT<!ATTLIST traw:plugin traw:mimetype CtATA teEt|IeEt<

oSrie
The XLink attribStes speiiiy the soSrie oi the paSginc
rg i nt T

xlink:href,xlink:type, xlink:show, xlink:actuate

RrT 9To oT<!ATTLIST traw:plugin<!ATTLIST traw:plugin<!ATTLIST traw:plugin<!ATTLIST traw:plugin

xlink:href %url; teEt|IeEt<
xlink:type (simpley tFIXEt "simple"<
xlink:show (embety "embet"<
xlink:actuate (onLoaty "onLoat"<c6cm Parameters
The <traw:param< eaement iontains paramaters that are passed to an appaet or paSgin then they are initiaaikedc
rg i nt T<traw:param<

RrT 9T

This eaement iontains parameters that are passed to appaets and paSginsc

o oT<!ELEMENT traw:param EMPTY<

The attribStes that yoS ian assoiiate tith the <traw:param< eaement are:●Name isee eition c6c02o

●

VaaSe

VaaSe
The traw:value speiiiies the raaSe oi a rSntime parameter speiiiied by the namec
rg i nt T

traw:value

RrT 9To oT<!ATTLIST traw:applet traw:value CtATA tIMPLIEt<

c6cr Faoating Frames
iaoating irame is a irame embedded in a doiSments thiih may iontains ior e.ampaes a te.t doiSment or spreadsheetc

92

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<traw:floating-frame<

RrT 9To oT
n T<!ELEMENT traw:floating-frame (svg:tesc?, (traw:contourpolygon|traw:contour-pathy?y<De may need to add a traw:shofloating-frame-borter attribStec

The attributes that you can associate with the <traw:floating-frame< element aree●

Name isee eition c6c02o●oSrie isee eition c6c6o●tyae isee eition c6c02o●

Positions sikes and transiormation isee Chapter 5o●Layer D isee eition c6c02o●

1 nde. isee eition c6c02o

YoS ian aaso Sse the ioaaoting eaement:●

Alternative Text (see Section 2.6.9A

c6c Common Frame Eaements
The eaements iontained in this seition ian be Ssed tith sereraa oi the irame eaementsc

ContoSrYoS ian Sse the <traw:contour-polygon< and <traw:contour-path< eaements tith the ioaaoting
eaements:●<traw:image<●<traw:obiect<●<traw:obiect-ole<

Chapter 2 Common Document Content

93

rg i nt T

<traw:contour-polygon<<traw:contour-path<

RrT 9T

These eaements desiribe the iontoSr oi an image or objeitc
ee Chapter 5 ior a desiription oi the attribStes assoiiated tith the <traw:contour-

polygon< and <traw:contour-path< eaementsc

n iontrast to any other eaement the svg:witth and svg:height attribStes may hare a pi.ea
aength iicec 2p.o as raaSe ias teaa as traditionaa aengths aike imoc
o oT

n T

<!ELEMENT traw:contour-polygon EMPTY<<!ELEMENT traw:contour-path EMPTY<<!ATTLIST traw:contour-polygon svg:witth %length; teEt|IeEt<<!ATTLIST traw:contour-polygon svg:height %length; teEt|IeEt<<!ATTLIST traw:contour-polygon svg:viewbox CtATA teEt|IeEt<<!ATTLIST traw:contour-polygon svg:points %Points; teEt|IeEt<<!ATTLIST traw:contour-path svg:witth %length; teEt|IeEt<<!ATTLIST traw:contour-path svg:height %length; teEt|IeEt<<!ATTLIST traw:contour-path svg:viewbox CtATA teEt|IeEt<<!ATTLIST traw:contour-path svg:t %Pathtata; teEt|IeEt<
X L and VG do not sSpport iontoSrsc

aternatire Te.t
YoS ian Sse the <traw:tesc< eaement tith the ioaaoting eaements:●<traw:image<●<traw:obiect<●<traw:applet<●<traw:floating-frame<●<traw:plugin<●<traw:obiect-ole<

rg i nt T<traw:tesc<

RrT 9To oT
n 9T<!ELEMENT traw:tesc (tPCtATAy<
This eaement is the same as the VG <tesc< eaementc VG does not sSpport a desiription oi
ioreign objeitsc

c6c02 Common Frame ttribStes
The attribStes iontained in this seition ian be Ssed tith sereraa oi the irame eaementsc

Name
YoS ian Sse the office:name attribSte tith the ioaaoting eaements:●

94<traw:text-box<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●<traw:image<●<traw:obiect<●<traw:applet<●<traw:param<●<traw:plugin<●<traw:floating-frame<●<traw:obiect-ole<

rg i nt T

office:nameRrT 9To oT
n T<!ATTLIST traw:image office:name CtATA tIMPLIEt<
VG does not sSpport names oi image or ioreign objeitsctyae
YoS ian Sse the style:style attribSte tith the ioaaoting eaements:●<traw:obiect<●<traw:applet<●<traw:plugin<●<traw:floating-frame<●<traw:obiect-ole<

rg i nt T

style:style

RrT 9To oT
n T<!ATTLIST traw:obiect style:style CtATA teEt|IeEt<
VG does not sSpport styaesc

Layer DYoS ian Sse the office:layer-it attribSte tith the ioaaoting eaements:●<traw:text-box<●<traw:image<●<traw:applet<●<traw:plugin<●<traw:floating-frame<●<traw:obiect<●<traw:obiect-ole<

Chapter 2 Common Document Content

95

rg i nt T

office:layer-it

RrT 9To oT
n T<!ATTLIST traw:text-box office:layer-it %number; tIMPLIEt<
VG does not sSpport aayersc

Layer DYoS ian Sse the office:layer-it attribSte tith the ioaaoting eaements:●<traw:text-box<●<traw:image<●<traw:applet<●<traw:plugin<●<traw:floating-frame<●<traw:obiect<●<traw:obiect-ole<

rg i nt T

office:layer-it

RrT 9To oT
n T<!ATTLIST traw:text-box office:layer-it %number; tIMPLIEt<
VG does not sSpport aayersc

1 nde.
YoS ian Sse the traw:v-intex attribSte tith the ioaaoting eaements:●<traw:text-box<●<traw:image<●<traw:applet<●<traw:plugin<●<traw:floating-frame<●<traw:obiect<●<traw:obiect-ole<

rg i nt T

traw:v-intex

RrT 9To oT

96<!ATTLIST traw:text-box traw:v-intex %number; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c6c00 Frame Formatting Properties
The attribStes and eaements desiribed in this seition ian be assigned to a graphii styaec

Fi.ed andinimSm Didths

There are tto types oi irame tidths; ii.ed tidths and minimSm tidthsc
rg i nt T

nIieu tiAut r9T

svg:witthnIi u1u r iAut r9T

fo:min-witth
RrT 9TThe raaSe oi both types oi tidth ian be either a aength or a perientagec The ionseqSenies oi
assigning both types oi tidth to a irame simSataneoSsay are Sndeiinedc
i the anihor ior the irame is in a tabae ieaas the perientage raaSe reaates to the sSrroSnding tabae
bo.c i the anihor ior the irame is in a irames the perientage raaSe reaates to the sSrroSnding
iramec n other iasess the perientage raaSes reaate to the tidth oi the page or tindotc

o oT

Fi.ed and<!ATTLIST style:properties svg:witth %length_or_pecentage;tIMPLIEt<<!ATTLIST style:properties fo:min-witth CtATA tIMPLIEt<

inimSm Oeights

There are tto types oi irame heights; ii.ed heights and minimSm heightsc
rg i nt T

nIieu tir u.r 9T

svg:heightnIi u1u r ir u.r 9T

fo:min-heightRrT 9TThe raaSe oi both types oi height ian be either a aength or a perientagec The ionseqSenies oi
assigning both types oi height to a irame simSataneoSsay are Sndeiinedc
i the anihor ior the irame is in a tabae ieaas the perientage raaSe reaates to the sSrroSnding tabae
bo.c i the anihor ior the irame is in a irames the perientage raaSe reaates to the sSrroSnding
iramec n other iasess the perientage raaSes reaate to the height oi the page or tindotc

o oT<!ATTLIST style:properties fo:height CtATA tIMPLIEt<<!ATTLIST style:properties fo:min-height CtATA tIMPLIEt<

a.imSm Didth and Oeight
For irames that ian inirease in sike aStomatiiaaay then iontent is addeds these attribStes speiiiy a ma.imSm
tidth and height ior the iramec Dhen the ma.imSm raaSes are reaiheds the irame stops inireasing in sikec

Chapter 2 Common Document Content

97

rg i nt T

fo:max-witth
fo:max-heightRrT 9To oT<!ATTLIST style:properties fo:max-witth CtATA tIMPLIEt<<!ATTLIST style:properties fo:max-height CtATA tIMPLIEt<

Leit and ight

argins

These properties determine the aeit and right margins to set aroSnd a iramec The properties are simiaar to those
Ssed to set the margins oi a paragraphs as desiribed in Chaper 4c
rg i nt T

fo:margin-left and fo:margin-rightRrT 9TThe raaSe oi these properties mSst be a aengthc

o oT<!ATTLIST style:properties fo:margin-left %length; tIMPLIEt<<!ATTLIST style:properties fo:margin-right %length; tIMPLIEt<n Tn iontrast to paragraph styaess then these properties are Ssed ior graphii styaes as is the iase ior
iramess perientage raaSes are not sSpportedc

Top and Bottom

argins

These properties determine the top and bottom margins to set aroSnd a iramec The properties are simiaar to those
Ssed to set the margins oi a paragraphs as desiribed in Chapter 4c
rg i nt T

fo:margin-top and fo:margin-bottom

RrT 9TThe raaSe oi these properties mSst be a aengthc

o oT<!ATTLIST style:properties fo:margin-top %length; tIMPLIEt<<!ATTLIST style:properties fo:margin-bottom %length; tIMPLIEt<n Tn iontrast to paragraph styaess then these properties are Ssed ior graphii styaes as is the iase ior
iramess perientage raaSes are not sSpportedc

Print Content
The style:print-content property speiiiies thether or not yoS ian print the iontent oi a iramec
rg i nt T

style:print-content

RrT 9To oT
n T<!ATTLIST style:properties style:print-content %boolean;tIMPLIEt<
X L does not sSpport this propertyc

Proteit
The style:protect property speiiiies thether the iontents sikes or position oi a irame is proteitedc

98

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:protect

RrT 9TThe raaSe oi this property ian be either none or a spaie separated aist that ionsists oi any oi the
raaSes contents positions or sivec

o oT<!ATTLIST style:properties fo:protect CtATA tIMPLIEt<n T

X L does not sSpport this propertyc

Oorikontaa Position
The style:horivontal-pos property speiiiies the horikontaa aaignment oi the irame in reaation to thespeiiiii areac
rg i nt T

style:horivontal-pos

RrT 9TThe raaSe oi this property ian be one oi the ioaaoting: from-lefts lefts centers rights
from-insites insites or outsitec The area that the position reaates to is speiiiied by thestyle:horivontal-rel propertyc The raaSes from-insites insite and outsite
iorrespond to the raaSes from-lefts aefts and right on pages that hare an odd pagenSmber and to the opposite raaSes on pages that hare an eren page nSmberci the property raaSe is from-left or from-insites the svg:x attribSte assoiiated tith theirame eaement speiiiies the horikontaa position oi the iramec Othertise the svg:x attribSte isignored ior te.t doiSmentsc
t is aaso possibae to Sse an svg:x attribSte tithin a graphii styaec i this is the iases then theattribSte speiiiies a deiaSat position ior net irames that are ireated Ssing this styaec
ome raaSes may be Ssed in ionneition tith iertain irame anihor and reaation types onayc

o oT<!ATTLIST style:properties style:horivontal-pos (from-left|
left|center|right|from-insite|insite|outsiteytIMPLIEt<

Oorikontaa eaation
The style:horivontal-rel property speiiiies the area to thiih the horikontaa position oi a irame reaatesc
ee the prerioSs seition ior iniormation on the style:horivontal-pos propertyc
rg i nt T

style:horivontal-rel

RrT 9TThe raaSe oi this property ian be one oi the ioaaoting: pages page-contents page-startmargins page-ent-margins frames frame-contents frame-start-margins
frame-ent-margins paragraphs paragraph-contents paragraph-startmargins paragraph-ent-margins or charc
YoS ian Sse some raaSes tith iertain irame anihor types onayc
The raaSe start-margin determines the aeit margins e.iept then the horikontaa position isfrom-insites insite or outsite and the anihor ior the irame is on a page tith an eren
page nSmbers in thiih iase it determines the right marginc The raaSe ent-margin determines
the opposite margin to the start-margin raaSesc

o oT<!ATTLIST style:properties style:horivontal-rel(page|page-content|page-start-margin|
page-ent-margin|frame|frame-content|
frame-start-margin|frame-ent-margin|
paragraph|paragraph-content|paragraph-start-margin|
paragraph-ent-margin|chary tIMPLIEt<

Chapter 2 Common Document Content

99Vertiiaa Position
The style:vertical-pos property speiiiies the rertiiaa aaignment oi the irame in reaation to a speiiiii areac
rg i nt T

style:vertical-pos

RrT 9TThe raaSe oi this property ian be one oi the ioaaoting: from-tops tops mittles or bottomc
The area that the position reaates to is speiiiied by the style:vertical-rel propertyc
i the raaSe oi this property is from-tops the svg:y attribSte assoiiated tith the irame eaement
speiiiies the rertiiaa position oi the iramec Othertises the svg:y attribSte is ignored ior te.t
doiSmentsc
t is aaso possibae to Sse an svg:y attribSte tithin a graphii styaec i this is the iases the attribSte
speiiiies a deiaSat position ior net irames that are ireated Ssing this styaec
ome raaSes may be Ssed in ionneition tith iertain irame anihor and reaation types onayc

o oT<!ATTLIST style:properties style:vertical-pos (from-top|top|
mittle|bottomy tIMPLIEt<

Vertiiaa eaation
The style:vertical-rel property speiiiies the area to thiih the rertiiaa position oi a irame reaatesc ee
the prerioSs seition ior iniormation on the style:vertical-pos propertyc
rg i nt T

style:vertical-rel

RrT 9TThe raaSe oi this property ian be one oi the ioaaoting: pages page-contents frames
frame-contents paragraphs paragraph-contents lines baselines or charc
YoS ian Sse some raaSes tith iertain irame anihor types onayc

o oT<!ATTLIST style:properties style:vertical-rel(page|page-content|frame|frame-content|
paragraph|paragraph-content|line|baseline|char|
texty tIMPLIEt<

Frame nihor
n te.t doiSmentss erery irame mSst hare an anihorc Frame anihors are desiribed in detaia in Chapter 4c

Frame BaikgroSnd
The baikgroSnd properties ior a irame are speiiiied in the same tay as the baikgroSnd properties ior a paragraphc ee Chapter 4 ior more iniormationc

Border s Border Line Didths Paddings hadots and CoaSmns
ee Chapter 4 ior iniormation on these propertiesc

Editabaete.t bo. ian be editabae eren ii the doiSment in thiih it is iontained is a read-onay doiSmentc The style:
100

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

etitable property speiiiies ii a te.t bo. ian be editedc
rg i nt T

style:etitable

RrT 9To oTn ToT
1 4 un1
Tu u 4 un1T<!ATTLIST style:properties style:etitable %boolean; tIMPLIEt<
X L does not sSpport this propertyc
This property is onay sSpported by OpenOiiiiecorg Driterc

Drapping
The style:wrap property speiiiies hot te.t aroSnd a irame is treatedc For e.ampaes te.t ian rSn aroSnd theaeit side oi the irames aroSnd the right side oi the irames or throSgh the iramec
rg i nt T

style:wrap

RrT 9To oTn ToT
1 4 un1
Tu u 4 un1T<!ATTLIST style:properties style:wrap (none|left|right|
parallel|tynamic|run-throughy
X L does not sSpport the ioniept oi trappingc nsteads the trap mode oi a irame is determinedby the anihor typec i trapping is disabaed or aaaoted ior a singae paragraph onays this ian be
simSaated by an fo:clear property that is attaihed to an eaement ioaaoting the iramec
CSrrentays this property is onay eraaSated by OpenOiiiiecorg Driterc

Paragraph-onay Drapping
i the anihor position oi a irame is a paragraph or a iharaiters and the trap mode speiiiied by the style:wrap
property is lefts rights parallels or tynamics yoS ian speiiiy the nSmber oi paragraphs that trap
aroSnd the iramec
rg i nt T

style:number-wrappet-paragraphs

RrT 9T

This property is onay reiogniked by irames or styaes that hare a style:wrap property attaihedtith a raaSe oi lefts rights parallels or tynamicc
i the raaSe is no-limits there is no aimit on the nSmber oi paragraphs that are aaaoted to trap
aroSnd a iramec

o oT<!ATTLIST style:properties style:number-paragraphs-wrappet %number_or_no_limit; tIMPLIEt<oT
1 4 un1
Tu u 4 un1T

This property is onay eraaSated by OpenOiiiiecorg Driterc
CSrrentays ii the raaSe oi this property is set to any nSmber other than 1s the eiieit on the irame isthe same as ii the raaSe tas set to no-limitc

ContoSr Drapping
For some irame types yoS ian speiiiy that the te.t shoSad trap aroSnd the shape oi the objeit in the irame rather
than aroSnd the irame itseaic This is iaaaed iontoSr trappingc

Chapter 2 Common Document Content

101rg i nt T

style:wrap-contour

RrT 9T

This property is onay reiogniked by irames or styaes that hare a style:wrap property attaihedc

o oT<!ATTLIST style:properties style:wrap-contour %boolean;tIMPLIEt<

oT
1 4 un1
u u 4 un1T

This property is onay eraaSated by OpenOiiiiecorg Driterc

ContoSr Drappingode

i the style:wrap-contour attribSte is presents yoS ian iSrther speiiiy hot the te.t shoSad trap aroSnd theiontoSrc
rg i nt T

style:wrap-contour-moteRrT 9T

This attribSte is onay reiogniked by irames or styaes that aaready hare the style:wrap andstyle:wrap-contour attribStes attaihedc
The raaSe oi the attribSte ian be outsite or fullc i the raaSe oi the attribSte is outsites thete.t traps aroSnd the generaa area to the aeit and right oi the shapec i the raaSe oi the attribSte isfulls the te.t traps aroSnd the shape and iiaas any possibae spaies and indentations in the shapec

o oT<!ATTLIST style:properties style:wrap-contour-mote (full|outsitey tIMPLIEt<oT
1 4 un1
u u 4 un1T

This property is onay eraaSated by OpenOiiiiecorg Driterc

Sn ThroSghi the raaSe oi the style:wrap attribSte is run-throughs yoS ian iSrther speiiiy thether the iontent oi theirame shoSad be dispaayed in the baikgroSnd or in the ioregroSndc This attribSte is SsSaaay Ssed ior transparent
objeitsc
rg i nt T

style:run-throughRrT 9TThe raaSe oi this attribSte ian be foregrount or backgrountc i the raaSe is foregrounts
the irame iontent is dispaayed in iront oi the te.tc i the raaSe is backgrounts the irame iontent
is dispaayed behind the te.tc

o oT<!ATTLIST style:attributet style:run-through (foregrount|backgrounty<n T

X L does not sSpport this propertyc

irroring
The style:mirror property speiiiies thether or not an image is mirrored beiore it is dispaayedc The
mirroring ian be rertiiaa or horikontaac Oorikontaa mirroring ian be restriited to images that are onay aoiated oneither odd or eren pagesc

102

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:mirror

RrT 9TThe raaSe oi this attribSte ian be nones verticals horivontals horivontal-on-otts or
horivontal-on-evenc YoS ian speiiiy the raaSe vertical and the rarioSs horikontaa
raaSes togethers separating them by a thite spaieco oT<!ATTLIST style:properties style:mirror CtATA tIMPLIEt<

Caipping
The fo:clip property speiiiies thether to dispaay:
reitangSaar seition oi an image

●

or
●

The entire imagerg i nt T

fo:clip

RrT 9To oT
n T<!ATTLIST style:properties fo:clip CtATA tIMPLIEt<
This attribSte is the same in X Lc

c6c0 Faoating Frame Formatting Properties
The attribStes desiribed in this seition ian be assigned to a graphii styae that is assigned to iaoating iramesc

Dispaay iroaabar
This attribSte speiiiies thether or not rertiiaa and horikontaa siroaabars are dispaayedc
rg i nt T

traw:tisplay-scrollbar

RrT 9T

This attribSte ian be assigned to aStomatii styaes onayc

o oT<!ATTLIST style:properties traw:tisplay-scrollbar %boolean;tIMPLIEt<
i this attribSte is not speiiiieds siroaabars are dispaayed ii they are reqSiredc

n T

Dispaay BorderThis attribSte speiiiies thether or not a border is dispaayed on the iaoating iramec
rg i nt T

traw:tisplay-borterRrT 9T

This attribSt eian be assigned to aStomatii styaes onayc

o oT<!ATTLIST style:properties traw:tisplay-borter %boolean;tIMPLIEt<

n TThis attribSte is not the same as the fo:borter propertyc

Chapter 2 Common Document Content

103

argins
These attribStes speiiiy the horikontaa and rertiiaa margins betteen the border and the iontent oi the iaoating
iramec i these attribStes are not speiiiieds the deiaSat margins are Ssedc
rg i nt T

traw:margin-horivontal
traw:margin-vertical

RrT 9T

These attribStes ian be assigned to aStomatii styaes onayc
The raaSe oi these attribStes mSst be a aength in pi.easc

o oT<!ENTITY % nonNegativePixelLength "CtATA"<<!ATTLIST style:properties traw:margin-horivontal %nonNegativePixelLength; tIMPLIEt<<!ATTLIST style:properties traw:margin-vertical %nonNegativePixelLength; tIMPLIEt<

c6c04 Objeit Formatting Properties
The attribStes desiribed in this seition ian be assigned to a graphii styae that is assigned to objeitsc

Visibae rea
The risibae area oi an objeit is the reitangSaar area oi the objeit that is iSrrentay risibaec Dhen the entire objeit isrisibaes the raaSes oi the traw:visible-area-left and traw:visible-area-top attribStes are 0
and the traw:visible-area-witth and traw:visible-area-height attribStes speiiiy the sike oi
the objeitc
rg i nt T

traw:visible-area-left
traw:visible-area-top
traw:visible-area-witth
traw:visible-area-heightRrT 9T

These attribStes ian be assigned to aStomatii styaes onayc

o oT<!ATTLIST style:properties traw:visible-area-left %nonNegativeLength; tIMPLIEt<<!ATTLIST style:properties traw:visible-area-top %nonNegativeLength; tIMPLIEt<<!ATTLIST style:properties traw:visible-area-witth %positiveLength; tIMPLIEt<<!ATTLIST style:properties traw:visible-Area-height %positiveLength; tIMPLIEt<oT
1 4 un1
Tu u 4 un1T

Not aaa objeits aSpport these attribStesc ome objeitss sSih as aaa OpenOiiiiecorg objeitss store
and aoad their otn risibae areac These attribStes speiiiy a deiaSat risibae area that the objeit has
the option to Ssec

c6c09 Frame Erents
YoS ian assign erents to a iramec The erents that are attaihed tos ior e.ampaes a te.t bo. or an images are represented by an erent eaement as desiribed in eition c00c This eaement is iontained tithin the irame type eaements
ior e.ampaes the <traw:text-box< eaement or the <traw:image< eaementc

104

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

cm Forms and Controas
ee the ihapter entitaed soem hontent ior iniormation aboSt iorms and iontroasc

cr Oyperainks
This seition desiribes hot the OpenOiiiiecorg X L iiae iormat represents hyperainks in doiSmentsc

crc0 impae Oyperainks
simpae hyperaink is a aink that aoiates one resoSrie onayc impae hyperainks are represented by the <office:a< eaementc
rg i nt T<traw:a<RrT 9T

This eaement is an XLink and has some attribStes tith ii.ed raaSes and desiribe the semantiis oi
the ainkc The eaement's iontent is the irame that shoSad be the soSrie oi the ainkc

o oT<!ELEMENT traw:a %frame;<<!ATTLIST traw:a xlink:type (simpley tFIXEt "simple"<<!ATTLIST traw:a xlink:actuate (oneequesty "oneequest"<

The attribStes that yoS ian assoiiate tith the <traw:a< eaement are:●Link aoiation●

Link target irame

●

Name

●

errer side image map

Link Loiation
The xlink:href attribSte speiiiies the target aoiation oi the ainkc
rg i nt T

xlink:href

RrT 9To oT<!ATTLIST traw:a xlink:href %url; teEt|IeEt<

Link Target Frame
The office:target-frame attribSte speiiiies the target irame oi the ainkc

Chapter 2 Common Document Content

105

rg i nt T

office:target-frame

RrT 9T

This attribSte ian hare one oi the ioaaoting raaSes:●_self : The reierenied doiSment repaaies the iontent oi the iSrrent iramec●_blank : The reierenied doiSment is dispaayed in a net iramec●_parent : The reierenied doiSment is dispaayed in the parent irame oi the iSrrent iramec●_top : The reierenied doiSment is dispaayed in the topmost irames that is the irame that
iontains the iSrrent irame as a ihiad or desiendent bSt is not iontained tithin another iramec●

irame name : The reierenied doiSment is dispaayed in the named iramec i the named irame
does not e.ists a net irame tith that name is ireatedc

To ioniorm tith the XLink peiiiiiations an additionaa xlink:show attribSte is attaihed to
the <traw:a< eaementc ee page 9 ior a pointer to the XLink peiiiiiationc i the raaSe oi thethis attribSte is _blanks the xlink:show attribSte raaSe is newc i the raaSe oi the this
attribSte is any oi the other raaSe optionss the raaSe oi the xlink:show attribSte is replacec
o oT<!ATTLIST traw:a office:target-frame CtATA "_blank"<<!ATTLIST traw:a xlink:show (new|replacey "replace"<Namesimpae aink ian hare a names bSt it is not essentiaac The office:name attribSte speiiiies the name oi the ainkc
The name ian serre as a target ior other hyperainksc
rg i nt T

office:nameRrT 9T

The name does not hare to be SniqSec

o oT<!ATTLIST traw:a office:name CtATA tIMPLIEt<

n 9T

This attribSte is speiiiied ior iompatibiaity tith OT L onays there an <a< eaement may serre
as a aink soSrie and target simSataneoSsayc De strongay reiommend that yoS do not Sse this
attribSte ior any pSrpose other than to represent ainks that originaaay iame irom a OT L doiSmentc

errer ide mageap

aink ian be a serrer side image mapc The office:server-map attribSte is Ssed by the serrer to determine
thiih aink to aitirate tithin the image mapc i this attribSte is presents the moSse ioordinates oi the iaiik positionoi the irame are appended to the
L oi the ainkc
rg i nt T

office:server-map

RrT 9To oT<!ATTLIST traw:a office:server-map %boolean; "FALSE"<

crc Caient ide mageaps

n image map is a ioaaeition oi hyperainks that are assoiiated tith graphii eaementsc The image map is a
seqSenie oi image map eaementsc Eaih image map eaement assoiiates a hyperaink tith an areac The area ian beone oi the ioaaoting shapes:

106

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●eitangSaar●

CiriSaar●

Poaygonaa

The <traw:image-map< eaement represents an image mapc
rg i nt T<traw:image-map<

RrT 9To oT<!ELEMENT traw:image-map (traw:area-rectangle|traw:areacircle|traw:area-polygonya<

The <traw:image-map< eaement ian iontain three types oi image map eaementss thiih represent the three
types oi image map areas as ioaaots:●

eitangSaar image map eaements●

CiriSaar image map eaements●

Poaygonaa image map eaements

n : mage map eaements are desiribed in terms oi absoaSte positionsc Dhen aoading the X L iiaes OpenOiiiiec
org maps the image map onto its assoiiated graphiiaa eaements ior e.ampae an images in its originaa sikec The
appaiiation siaaes the image map to matih the iSrrent sike oi the images bSt in the iiae iormat the image is aatays
sared in its Snsiaaed rersions matihing the dimensions oi the Snsiaaed imagec

eitangSaar mageap reasThe <traw:area-rectangle< eaement desiribes a reitangSaar image map areac
rg i nt T<traw:area-rectangle<

RrT 9T

The attribStes dispaayed beaot are reqSiredc The attribStes desiribed in the hommon rmame sap
Ttteibutes seition are optionaac

o oT<!ELEMENT traw:area-rectangle (svg:tesc?,office:events?y<<!ATTLIST traw:area-rectangle svg:x %coortinate; teEt|IeEt<<!ATTLIST traw:area-rectangle svg:y %coortinate; teEt|IeEt<<!ATTLIST traw:area-rectangle svg:witth %coortinate;
teEt|IeEt<<!ATTLIST traw:area-rectangle svg:height %coortinate;
teEt|IeEt<

CiriSaar mageap reasThe <traw:area-circle< eaement desiribes a iiriSaar image map areac The additionaa attribStes ior iiriSaar
image maps are desiribed beaot in the iommon attribStes seitionc

Chapter 2 Common Document Content

107

rg i nt T

<traw:area-circle<

RrT 9T

The attribStes dispaayed beaot are reqSiredc The svg:cx and svg:cy attibStes speiiiy theienter point oi the iiriaec The svg:r attribSte speiiiies the radiSs oi the iiriaec
The attribStes desiribed in the hommon rmame sap Ttteibutes seition are optionaac

o oT<!ELEMENT traw:area-circle (svg:tesc?,office:events?y<<!ATTLIST traw:area-circle svg:cx %coortinate; teEt|IeEt<<!ATTLIST traw:area-circle svg:cy %coortinate; teEt|IeEt<<!ATTLIST traw:area-circle svg:r %coortinate; teEt|IeEt<

Poaygonaa mageap reasThe <traw:area-polygon< eaement desiribes a poaygonaa image map areac
iomprised oi the ioaaoting iomponents:

poaygonaa image map area is●

boSnding bo.c
The boSnding bo.s thiih is represented in the same tay as a reitangSaar image map area Ssing the svg:xs
svg:ys svg:witths and svg:height attribStess estabaishes the reierenie irame ior the riet bo. and the
poaygon point seqSeniec The reierenie irame enabaes the ioordinates to be transaated into absoaSte ioordinatesc●

riet bo.c
The riet bo. estabaishes a ioordinate system ior the point seqSeniec The riet bo. obriates the need toreiord erery point oi the point seqSenie as absoaSte ioordinates tith aength and Snit oi measSrementc●

seqSenie oi points in riet bo. ioordinatesc

For more iniormation aboSt hot to represent poaygonss see Chapter 55c4c9c
rg i nt T<traw:area-polygon<

RrT 9T

The attribStes dispaayed beaot are reqSiredc The attribStes desiribed in the hommon rmame sap
Ttteibutes seition are optionaac

o oT<!ELEMENT traw:area-polygon (svg:tesc?,office:events?y<<!ATTLIST traw:area-polygon svg:x %coortinate; teEt|IeEt<<!ATTLIST traw:area-polygon svg:y %coortinate; teEt|IeEt<<!ATTLIST traw:area-polygon svg:witth %coortinate; teEt|IeEt<<!ATTLIST traw:area-polygon svg:height %coortinate; teEt|IeEt<<!ATTLIST traw:area-polygon svg:points %points; teEt|IeEt<<!ATTLIST traw:area-polygon svg:viewBox CtATA teEt|IeEt<

E 4 oT Ti nTy.n14Tiu 4. i 4oi4I 4The eaement shotn in the ioaaoting e.ampae deiines a triangae that is aoiated in the middae oi a im by imimagec The boSnding bo. iorers an area oi im by 0c5imc One riet bo. Snit iorresponds to 2c20mmc<traw:area-polygon …
svg:xp"0" svg:yp"0" svg:witthp"2.0cm" svg:heightp"2.0cm"
svg:viewBoxp"0 0 2000 2000"
svg:pointsp":00,1400 1:00,1400 1000,:00"/<

Common mageap ttribStesn addition to the shape attribStess eaih image map eaement ian iontain the ioaaoting iniormation:●

108

Links iniaSding a

L and aink target iramec

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●

Namec

●

naitire iaagc●

Desiriptionc se the <svg:tescription< ihiad eaementc●

Erents assoiiated tith the areac se the <office:events< ihiad eaementc

Other attribStes oi the image maps are taken irom the OT L image map representationc
Eaih image map eaement identiiies a hyperaink and Sses the Xaink hrefs types and show attribStess and theoffice:target-frame-name attribSte to desiribe the ainkc
rg i nt T

xlink:href

RrT 9To oi 4 oT T<!ATTLIST traw:area-polygon xlink:href %url; tIMPLIEt<<!ATTLIST traw:area-polygon xlink:type (simpley tIMPLIEt<<!ATTLIST traw:area-polygon xlink:show (new|replacey tIMPLIEt<<!ATTLIST traw:area-polygon office:target-frame-name CtATAtIMPLIEt<

The office:name attribSte assigns a name to eaih image map eaementc
rg i nt T

office:nameRrT 9To oi 4 oT T<!ATTLIST traw:area-polygon office:name CtATA tIMPLIEt<

The traw:nohref attribSte deiaares that the image map eaement and the assoiiated area is inaitirec The
that is iontained in the image map eaement is not Ssedc
rg i nt TL

traw:nohref

RrT 9To oT
n Tc<!ATTLIST traw:area-polygon traw:nohref (nohrefy tIMPLIEt<
n OT Ls this is aihiered by Ssing the nohref attribStec

NSmber Format
The OpenOiiiiecorg X L nSmber iormat ionsists oi three parts:●

Preii. P the te.t that is dispaayed beiore the nSmber●

Dispaay iormat speiiiiiations ior e.ampaes s Bs Cs or 0s s 4●

Siii. P the te.t that is dispaayed aiter the nSmberc c0 Preii. and Siii.
The style:num-prefix and style:num-suffix attribStes speiiiy that to dispaay beiore and aiter thenSmberc

Chapter 2 Common Document Content

109

rg i nt T

style:num-prefix and style:num-suffix

RrT 9Ti the preii. and sSiii. do not iontain aaphanSmerii iharaiterss an X LT format attribSte ianbe ireated irom the OpenOiiiiecorg attribStes by ioniatenating the raaSes oi the style:numprefixs style:num-format, and style:num-suffix attribStesco oT<!ATTIST style:properties style:num-prefix CtATA tIMPLIEt<<!ATTIST style:properties style:num-prefix CtATA tIMPLIEt<n T

Dithin the X LT format attribStes the preii. and sSiii. ian onay be non-aaphanSmerii iharaitersc This restriition does not appay to OpenOiiiiecorg soittarec

c c Format peiiiiiation
The style:num-format attribSte speiiiies the iormat oi the nSmberc
rg i nt T

style:num-format

RrT 9TThe raaSe oi this attribSte ian be "0"s "a"s " "s "i"s or " "co oT<!ATTLIST style:properties style:num-format CtATA tIMPLIEt<

n T

The raaid raaSes ior this attribSte hare the same meanings as a singae aaphanSmerii token thatappears tithin an X LT format attribStec

c c4 Letter ynihronikation in NSmber Formats
i aetters are Ssed in aaphabetiiaa order ior nSmberings there are tto tays to proiess oreriaots tithin a digits as
ioaaots:●

YoS ian insert a net digit starting tith a raaSe oi a or s that is iniremented erery time an oreriaot oiiSrs in
the ioaaoting digitc The nSmbering seqSenie in this iase is something aike asbsis cccs ks aasabsais cccsaks bas cccs
and so onc●

YoS ian insert a net digit that aatays has the same raaSe as the ioaaoting digitc The nSmbering seqSenie inthis iase is something aike as bs is cccs ks aas bbs iis cccs kks aaas cccs and so onc This is iaaaed T
Ii9y1orIn1u 4un1c

rg i nt T

style:num-letter-sync

RrT 9To oT
n T<!ATTLIST style:properties style:num-letter-sync %boolean;tIMPLIEt<
X LT does not sSpport aetter synihronikationc

c02 iripts
iripts do not impay a siripting aangSage or an objeit modeac For this reasons a siript ian operate on the DoiSment Objeit odea iDO o oi an OpenOiiiiecorg X L doiSment or on the OpenOiiiiecorg P ciripts iannot modiiy a doiSment thiae the doiSment is aoadingc Ooterers some erents are iaaaed immediateay
aiter the doiSment is aoadedc
Eaih siript is represented by a <script:script< eaementc

110

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<script:script<

RrT 9T

This eaement iontains the soSrie iode oi the siriptc t ian aaso optionaaay iontain a iompiaedrersion oi the siriptc The iompiaed rersion oi the siript is iontained tithin a <script:bytecote< baoiks thiih ian iontain any iontentc aa siripts are iontained tithin the siripting
seition oi a doiSmentcn T

Jara iript siripts that operate on the OT L DO are speiiaa siripts that hare their otn representation and they ian onay be Ssed in te.t doiSmentsc

c00 Erent Tabaes
any objeits sSih as iontroass imagess te.t bo.ess or an entire doiSment sSpport erentsc n erent binds theoiiSrrenie oi a partiiSaar iondition to an aition that is e.eiSted ii the iondition arisesc For e.ampaes ii a Sser
paaies the iSrsor orer a graphiis this iondition triggers an aition that is sSpported by OpenOiiiiecorgc This erents
iaaaed "on-moSse-orer"s ian be assoiiated tith an OpenOiiiiecorg mairo that is e.eiSted thenerer the iondition
oiiSrss that iss thenerer a Sser paaies the iSrsor orer a graphiic
The X L representation oi erents and erent tabaes is strSitSred as ioaaots:●

aa oi the erent eaements that are assoiiated tith an objeit are aoiated in a iontainer eaement iaaaed<office:events<c●Eaih erent-to-aition assoiiation is reiorded in one <script:event< eaementc●

Depending on the type oi aition that the erent triggerss the ioaaoting eaements are Ssed:➢

The <script:event< eaement represents erents that are boSnd to a mairo or siriptc➢

The <presentation:event< eaement represents erents that are boSnd to an aition that is speiiiii
to a presentations ior e.ampaes go to the ne.t pagec

The <office:events< eaement speiiiies the tabae oi erents that are assoiiated tith an objeitc
rg i nt T<office:events<

RrT 9To oT<!ELEMENT office:events (script:event,presentation:eventyt<

c00c0 Erent
The <script:event< eaement binds an erent to an OpenOiiiiecorg mairoc
rg i nt T<script:event<RrT 9To oT<!ELEMENT script:event (tPCtATAy<oT
1 4 un1
Tu u 4 un1T

The onay siript aangSage that is iSrrentay sSpported is tarBasiic Other siript aangSages may besSpported in the iStSrec

The attribStes that yoS ian assoiiate tith the <script:event< eaement are:●●●Erent nameiript aangSage
Library name
Chapter 2 Common Document Content

111

●

airo name

Erent Name
The script:event-name attribSte speiiiies the name oi the erentc
rg i nt T

script:event-name

RrT 9To oT<!ATTLIST script:event script:event-name CtATA teEt|IeEt<

iript LangSage
The script:language attribSte speiiiies the siripting aangSage in thiih the mairo or siript thiih is assoiiated tith the erent is trittenc
rg i nt T

script:language

RrT 9To oT<!ATTLIST script:event script:language CtATA teEt|IeEt<

airo Name
The script:macro-name attribSte speiiiies the name oi the OpenOiiiiecorg mairo assoiiated tith the erentc
rg i nt T

script:macro-name

RrT 9To oT<!ATTLIST script:event script:macro-name tIMPLIEt<

Library Name
The script:library attribSte speiiiies the aibrary in thiih the OpenOiiiiecorg mairo assoiiated tith theerent is iontainedc
rg i nt T

script:libraryRrT 9To oT<!ATTLIST script:event script:library tIMPLIEt<

c0 Change Traiking
Change traiking iontent and strSitSre raries depending on the type oi doiSment yoS are traikingc For e.ampaes
ihange traiking in te.t doiSments is rery diiierent irom ihange traiking in spreadsheetsc The same appaies to the
X L iiae iormats oi these doiSment typesc Ooterers the integration oi ihange traiking iniormation ioaaots thesame design priniipaes in both appaiiations and one X L eaement is Ssed by both doiSment typesc For moreiniormation on ihange traiking in a partiiSaar type oi the doiSments see the appropriate ihapter oi this bookc
n both te.t doiSments and spreadsheetss the deiaSat doiSment iaot oi an X L doiSment reiaeits the iSrrent
state oi the doiSmentc n X LT styaesheet or any other appaiiation that does not aiknotaedge ihange traiking
112

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

iniormations does ior e.ampaes proiess aaa insertions into the doiSment bSt does not proiess any deaetionsc nsertions are part oi the deiaSat doiSment iaots thiae deaetions appear oStside the deiaSat doiSment iaotc Dhen an
appaiiation proiesses a doiSment in its iSrrent states it does not interpret ihange traiking iniormationc Dhen an
appaiiation proiesses the iontent oi insertions or deaetions to the doiSments it mSst interpret the ihange traiking
iniormationc
X LT styaesheets are not intended to proiess ihange traiking iniormation and the representation oi ihange
traiking iniormation is not optimiked to be proiessed by sSih siriptsc Thereiores it is aamost impossibae ior an
X LT spreadsheet to make deaetions risibae or insertions inrisibaec To do thiss yoS need a binary appaiiation or an
appaiiation that proiesses the DO oi a doiSmentc

c0 c0 Change niormation
There is some iniormation that aaa traiked ihanges hare in iommonc The ihange iniormation is represented by a<office:change-info< eaement and the iommon pieies oi iniormation are represented by attribStes assoiiated tith the eaementc
rg i nt T<office:change-info<

RrT 9To oT<!ELEMENT office:change-info (text:pya<

The attribStes that yoS ian assoiiate tith the <office:change-info< eaement are:
●

Sthor

●

Date and time●

Comment ioptionaao

Sthor
The office:chg-author attribSte speiiiies the name oi the aSthor tho ihanged the doiSmentc
rg i nt T

office:chg-author

RrT 9To oT<!ATTLIST office:change-info office:chg-author CtATA
teEt|IeEt<

Date and Time
The office:chg-tate-time attribSte speiiiies the date and time then the ihange took paaiec
rg i nt T

office:chg-tate-time

RrT 9To oT<!ATTLIST office:change-info office:chg-tate-time %tate;
teEt|IeEt<

Comment
The <office:change-info< eaement iontains a iomment irom the aSthor aboSt a ihangec
Chapter 2 Common Document Content

113

E 4 oT Tih4 oT ior41. iu1enI 4 un1<office:change-info office:chg-authorp”Michael Brauer”
office:chg-tate-timep”1999-0:-1-T1::04:2-”<<text:p<Section about sections reworket to meet requirements of pagestyles</text:p<</office:changet<

c04 OpenOiiiiecorg ppaiiation ettings
The OpenOiiiiecorg appaiiation settings are iontained in a <office:settings< eaementc
rg i nt T<office:settings<

RrT 9To oT<!ELEMENT office:settings (config:config-item-setty<

The settings ior OpenOiiiiecorg appaiiations are dirided into the ioaaoting tto iategories:●

DoiSment settingss ior e.ampae deiaSat printerc●

Viet settingss ior e.ampae koom aereac
ettings that are shared by diiierent appaiiations hare the same name and are oi the same typec

c04c0 Base ettings
The <config:config-item< eaement iontains aaa base settingsc
rg i nt T<config:config-item<

RrT 9TThe config:name attribSte identiiies the name oi the settingc
The config:type attribSte identiiies the type oi settingc
The raaSe oi the setting is stored in the eaementc

o oT<!ELEMENT config:config-item (tPCtATAy<<!ATTLIST config:config-item config:name CtATA teEt|IeEt
config:type (boolean | short |int | long | touble | string | tatetime | base::Binaryy
teEt|IeEt<

c04c

eqSenie oi ettings

The <config:config-item-set< eaement is a iontainer eaement ior aaa types oi setting eaementsc The
settings ian be iontained in the eaement is any orderc

114

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<config:config-item-set<

RrT 9To oT<!ELEMENT config:config-item-set (config:config-item | config:
config-item-set | config:config-item-map-namet | config:
config-item-map-intexetyt<<!ATTLIST config:config-item config:name CtATA teEt|IeEt<

c04c4 nde. iiess oi eqSenies
The <config:config-item-map-intexet< eaement is a iontainer eaement ior seqSeniesc The orderspeiiiies the inde. oi the eaementsc
rg i nt T<config:config-item-map-intexet<

RrT 9TThe config:name attribSte is reqSired tith this eaementc

o oT<!ELEMENT config:config-item-map-intexet (config:config-itemmap-entryyt<<!ATTLIST config:config-item-map-intexet config:name CtATA
teEt|IeEt<

ap Entry
The <config:config-item-map-entry< eaement is a iontainer eaement ior aaa types oi setting eaementsc
rg i nt T<config:config-item-map-entry<

RrT 9TThe config:name attribSte is optionaa tith this eaementc

o oT<!ELEMENT config:config-item-map-entry (config:config-item |config:config-item-set | config:config-item-map-namet |config:config-item-map-intexetyt<<!ATTLIST config:config-item-map-entry config:name CtATAtIMPLIEt<

c04c9 Name iiess oi eqSenies
The <config:config-item-map-namet< eaement is a iontainer eaement ior seqSeniesc
rg i nt T<config:config-item-map-namet<

RrT 9TThe config:name attribSte is reqSired tith this eaementc

o oT<!ELEMENT config:config-item-map-namet (config:config-itemmap-entryyt<<!ATTLIST config:config-item-map-namet config:name CtATA
teEt|IeEt<

Chapter 2 Common Document Content

115

CHAPTER

4

3

Te.t Content
This ihapter desiribes the OpenOiiiiecorg X L representation oi te.t iontentc t iontains the ioaaoting seitions:●●Oeadings and Paragraphs
eitions●

BSaaeted and NSmbered Lists●

OStaine NSmbering●Line NSmbering●

Footnotes and Endnotes●

Fieads●Variabae Fieads●

Frames in Te.t DoiSments

●

Sby

●

Te.t Formatting Properties●

Paragraph Formatting Properties●

eition Formatting Properties●

Change Traiking in Te.t DoiSments●

Optionaa niormation

4c0 Oeadings and Paragraphs
This seition desiribes the X L eaements and attribStes that yoS Sse to represent heading and paragraph iomponents in a te.t doiSmentc

4c0c0 Primary Oeading and Paragraph Components
The X L eaements that represent both headings and paragraphs are iaaaed o4I4.I4ori T

1c

117

For headings:

rg i nt T<text:h<For paragraphs:<text:p<RrT 9T

The te.t oi the paragraph is iontained in the paragraph eaementc t ian be mi.ed tith many othereaementsc

o oT<!ENTITY % inline-text "text:s|text:tab-stop|text:line-break|text:span|text:a|%frames;|%fielts;|text:footnote|
text:ref-point|text:bookmark|text:bookmark-start|text:bookmark-ent|
text:change|text:change-start|
text:change-ent"<<!ELEMENT text:p (tPCtATA|%inline-text;ya<<!ELEMENT text:h (tPCtATA|%inline-text;ya<i the paragraph eaement or any oi its ihiad eaements iontains thite-spaie iharaiterss they are ioaaapseds in othertords they areIproiessed in the same tay that OT L proiesses themc The ioaaoting niiode iharaiters arenormaaiked to a P CE iharaiter:●OO 1ONT L T B L T ON i2.222 o

●

C

●

L NE FEED i2.222 o

●

GE ET

N i2.222Do

P CE i2.22 2on additions these iharaiters are ignored ii the preieding iharaiter is a thite-spaie iharaiterc The preieding iharaiter ian be iontained in the same eaements in the parent eaements or in the preieding sibaing eaements as aong as it
is iontained tithin the same paragraph eaement and the eaement in thiih it is iontained proiesses thite-spaie
iharaiters as desiribed aborec
Dhite-spaie proiessing takes paaie tithin the ioaaoting eaements:●<text:p<●<text:h<●<text:span<●<text:a<●<text:ref-point<●<text:ref-point-start<●<text:ref-point-ent<●<text:bookmark<●<text:bookmark-start<●<text:bookmark-ent<n T n X Ls yoS ian enabae thite-spaie proiessing oi a paragraph oi te.t by attaihing an fo:whitespacep"collapse" attribSte to the <fo:block< eaement that iorresponds to the paragraph eaementc

118

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

The attribStes that yoS ian assoiiate tith heading and paragraph eaements are:●●●Oeading aerea
tyae and ionditionaa styae
Paragraph iormatting properties

Oeading Lerea
The text:level attribSte assoiiated tith the heading eaement determines the aerea oi the headings ior
e.ampaes Oeading 0s Oeading s and so onc
rg i nt T

text:level

RrT 9T

This attribSte is assoiiated tith a <text:h< eaementc

o oT<!ATTLIST text:h text:level %number; "1"<n T

YoS mSst appay the same styae to aaa headings oi the same aereactyae and Conditionaa tyae
The styae and ionditionaa styae attribStes are optionaac
rg i nt T

text:style-name and text:cont-style-name

RrT 9TThe raaSes oi these attribStes are styae namess thiih is sSiiiiient to identiiy a styae beiaSse erery
styae addressed mSst be a paragraph styaeci a ionditionaa styae is appaied to a paragraphs the text:style-name attribSte iontains thename oi the styae that is appaied Snder that ionditionc The text:style-name attribSte does
not iontain the name oi the ionditionaa styae that iontains the ionditions and maps to other styaesc
The ionditionaa styae name is the raaSe oi the text:cont-style-name attribSteco oT<!ATTLIST text:p text:style-name %style-name; teEt|IeEt<<!ATTLIST text:p text:cont-style-name %style-name; tIMPLIEt<<!ATTLIST text:h text:style-name %style-name; teEt|IeEt<<!ATTLIST text:h text:cont-style-name %style-name; tIMPLIEt<

n TThis X L strSitSre simpaiiies X LT transiormations beiaSse X LT onay has to aiknotaedge theionditionaa styae ii the iormatting attribStes are reaerantc The reierenied styae ian be a iommon
styae or an aStomatii styaec

inie most doiSments Sse one paragraph styae ior the majority oi paragraphs in the doiSments there are paans todereaop a deiaSat styae name ior paragraphsc
E 4 oT Tih yT 9i41tion1tu un14Ti9 yT 9iu1ito 1teeuo inI.irg<text:p text:style-namep"meating 1"<"meating 1" is not a contitional style.
</text:p<<text:p text:style-namep"Numbering 1" text:cont-style-namep"Text boty"<"Text boty" is a contitional style. If it is containet in a numberetparagraph, it maps to "Numbering 1". This is assumet in this example.
</text:p<

Chapter 3 Text Content

119Paragraph Formatting Properties
The deiaSat iormatting properties that are assigned to a paragraph are represented by an aStomatii styaec Dhen the
doiSment is e.porteds an aStomatii styae is generated tith the iormatting properties oi the paragraphc The parent
styae oi the generated styae is the iommon styae that is assigned to the paragraph irom the rietpoint oi the
OpenOiiiiecorg Sser interiaiec
i a paragraph has a ionditionaa styae assigned and this styae is mapped to another styae beiaSse oi a ionditions
tto aStomatii styaes are generated then the doiSment is e.portedc Both styaes hare the same iormatting properties assigneds bSt the parent oi one styae is the ionditionaa styae thiae the parent oi the other styae is the styae thatis appaied beiaSse oi the ionditionc
E 4 oT Ti 4I4.I4orienI 4 u1.ioIno I u 9iu1ito 1teeuo inI.irg<office:styles<<style:style namep"Text Boty" ...<</office:styles<...
<office:automatic-styles<<style:style namep"P001" familyp"paragraph"style:parent-style-namep"Text Boty"<<style:properties fo:font-weightp"bolt"/<</style:style<</office:automatic-styles<...
<office:boty<<text:p style:style-namep"P001"<
This is a bolt paragraph in "Text Boty" style.
</text:p<</office:boty<

4c0c Dhite- paie Charaiters
n generaas ionseiStire thite-spaie iharaiters in a paragraph are ioaaapsedc For this reasons there is a speiiaa
X L eaement Ssed to represent the niiode iharaiter P CE i2.22 2oc
rg i nt T<text:s<RrT 9T

This eaement Sses an attribSte iaaaed text:c to speiiiy the nSmber oi P CE iharaiters thatthe eaement representsc
This eaement is reqSired to represent the seiond and aaa ioaaoting P CE iharaiters in a
seqSenie oi P CE iharaitersc YoS do not get an error ii the iharaiter preieding the eaement is
not a thite-spaie iharaiters bSt it is good praitiie to Sse this eaement ior the seiond and aaa
ioaaoting P CE iharaiters in a seqSeniec This tays an appaiiation reiognikes a singae spaie
iharaiter tithoSt reiogniking this eaementc

o oT<!ELEMENT text:s EMPTY<<!ELEMENT text:s text:c %number “1”<4c0c4 Tab tops
The <text:tab-stop< eaement represents tab stops in a heading or paragraphc

120

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:tab-stop<

RrT 9To oT<!ELEMENT text:tab-stop EMPTY<

4c0c9 Line Breaks
The <text:line-break< eaement represents a aine break in a heading or paragraphc
rg i nt T<text:line-break<RrT 9To oT
n T<!ELEMENT text:line-break EMPTY<
X L does not sSpport aine breaksc

4c0c5 Te.t tyaes
The <text:span< eaement represents portions oi te.t that are iormatted Ssing a iertain te.t styaec
rg i nt T<text:span<RrT 9T

The iontent oi this eaement is the te.t that Sses the te.t styaec
The name oi the te.t styae is the raaSe oi a text:style-name attribSte attaihed to the<text:span< eaementc The text:style-name ian be an aStomatii styaec inie a<text:span< eaement nerer addresses any other type oi styae other than te.t styaess the styaename is sSiiiiient to identiiy the styaec
YoS ian nest <text:span< eaementsc
Dhite-spaie iharaiters iontained in this eaement are ioaaapsedc

o oT
n 9T

E 4 oT Ti<!ELEMENT text:span (tPCtATA|%inline-text;ya<<!ATTLIST text:span text:style-name %style-name; tIMPLIEt<
The <text:span< attribSte is simiaar to the OT L <span< attribStec

i9 yT iu1ito 1teeuo inI.irg<text:p<
The last wort of this sentence is<text:span text:style-namep"emphasive"<emphasivet</text:span<.
</text:p<4c0c6 Te.t Formatting Properties
Formatting properties that are appaied to a portion oi te.t inside a paragraph are represented by an aStomatii te.t
styaes thiih is attaihed to the te.t portion in the same tay as iommon te.t styaesc ee eition4c0c5 ior moreiniormationc Dhen the doiSment is e.porteds an aStomatii te.t styae is generated ior aaa iormatting properties thatare attaihed to a te.t portionc YoS ian assign tto iormatting properties to the same te.t portion Ssing nested<text:span< eaementss and the iormatting properties ian be represented by one or by tto aStomatii te.t
styaescn most iasess aStomatii te.t styaes do not hare a parent styaec The onay sitSation there an aStomatii te.t styae
Chapter 3 Text Content

121might hare a parent styae is then a te.t portion has iormatting properties and a iommon te.t styae assignedc The
te.t styae ian be the parent styae oi the aStomatii styaes bSt it is not essentiaacn T n OpenOiiiiecorg appaiiationss the te.t portions that hare a iertain iormatting property appaied may
oreraap bSt the <text:span< eaements iannot oreraapc
E 4 oT Ti

ienI 4 u1.ioIno I u 9iu1ito 1teeuo inI.irg

ru9i 4 oT i9rnA9i r iOpenOiiiiecorgirg iont iI ruI ti nitu9oT4yi r ienTTnAu1.i9 1 1o T
The rain in Tpain stays mainay in the paainc<office:automatic-styles<<style:style namep"T001" familyp"text"<<style:properties fo:font-stylep"italic"/<</style:style<<style:style namep"T002" familyp"text"<<style:properties style:text-unterlinep"single"/<</style:style<</office:automatic-styles<...
<office:boty<<text:p<
The rain in<text:span text:style-namep"T001"<
Spain<text:span text:style-namep"T002"<
stays</text:span<</text:span<<text:span text:style-namep"T002"<
mainly in</text:span<
the plain.
</text:p<...
</office:boty<

4c0cm Oyperainks
Oyperainks in te.t doiSments are represented by a <text:a< eaementc
rg i nt T<text:a<RrT 9Ti this eaement iontains thite-spaie iharaiterss the iharaiters are ioaaapsedc

o oT<!ELEMENT text:a (script:events?,(%inline-text;yay<This eaement aaso iontains an erent tabae eaements <script:events<s thiih iontains the erents assigned tothe hyperainkc ee Chapter ior more iniormation on the erent tabae eaementc
The attribStes that yoS ian assoiiate tith the <text:a< eaement are:

122

●

Name

●

Link aoiation●

Target irame●

Te.t styaes

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Namehyperaink ian hare a names bSt it is not essentiaac The text:name attribSte speiiiies the name oi the hyperaink ii one e.istsc This name ian serre as a target ior some other hyperainksc
rg i nt T

text:nameRrT 9T

This name does not hare to be SniqSec

o oT<!ATTLIST text:a text:name CtATA tIMPLIEt<

n 9T

This attribSte is speiiiied ior iompatibiaity tith OT L onays there an <a< eaement may serre asa aink soSrie and target simSataneoSsayc Do not Sse this attribSte ior any pSrpose other than torepresent ainks that originaaay iame irom a OT L doiSmentc

Link Loiation
The xlink:href attribSte speiiiies therg i nt T

L ior the target aoiation oi the ainkc

xlink:href

RrT 9To oT<!ATTLIST text:a xlink:href %url teEt|IeEt<<!ATTLIST text:a xlink:type (simpley tFIXEt “simple”<<!ATTLIST text:a xlink:actuate (oneequesty “oneequest”<

Target Frame
The office:target-frame-name attribSte speiiiies the target irame oi the ainkc
rg i nt T

office:target-frame-name

RrT 9T

This attribSte ian hare one oi the ioaaoting raaSes:●_self < The reierenied doiSment repaaies the iontent oi the iSrrent iramec●_blank < The reierenied doiSment is dispaayed in a net iramec●_parent < The reierenied doiSment is dispaayed in the parent irame oi the iSrrent iramec●_top < The reierenied doiSment is dispaayed in the Sppermost irames that is the irame that
iontains the iSrrent irame as a ihiad or desiendent bSt is not iontained tithin another iramec●

irame name < The reierenied doiSment is dispaayed in the named iramec i the named
irame does not e.ists a net irame tith that name is ireatedc

To ioniorm tith the XLink peiiiiiations an additionaa xlink:show attribSte is attaihed to
the <text:a< eaementc ee page 9 ior a pointer to the XLink peiiiiiationc i the raaSe oi theattribSte is _blanks the xlink:show attribSte raaSe is newc i the raaSe oi the attribSte is
any oi the other raaSe optionss the raaSe oi the xlink:show attribSte is replacec
o oT<!ATTLIST text:a office:target-frame-name CtATA teEt|IeEt<<!ATTLIST text:a xlink:show (new|replacey "replace"<

Chapter 3 Text Content

123Te.t tyaes
Erery hyperaink has tto te.t styaes as ioaaots:●

i the aink aoiation oi the hyperaink tas not risiteds the te.t styae speiiiies by the text:style-nameattribSte is appaied to the te.t oi the hyperainkc●

i the aink aoiation oi the hyperaink tas aaready risiteds the te.t styae speiiiied by the text:visitetstyle-name attribSte is appaied to the te.t oi the hyperainkc

rg i nt T

text:style-name and text:visitet-style-name

RrT 9To oT<!ATTLIST text:a text:style-name %style-name; tIMPLIEt<<!ATTLIST text:a text:visitet-style-name %style-name;tIMPLIEt<

4c0cr Bookmarks
Bookmarks ian either mark a te.t position or a te.t rangec te.t range ian start at any te.t position and end at
another te.t positionc n partiiSaars a bookmark ian start in the middae oi one paragraph and end in the middae oi
another paragraphc The X L eaement Ssed to represent a bookmark raries depending on the type oi bookmarks as
ioaaots:●<text:bookmark< P to mark one te.t position●<text:bookmark-start< P to mark the start position in a te.t range●<text:bookmark-ent< P to mark the end position in a te.t range

rg i nt Ts aboreRrT 9To oT<!ELEMENT text:bookmark EMPTY<<!ELEMENT text:bookmark-start EMPTY<<!ELEMENT text:bookmark-ent EMPTY<<!ATTLIST text:bookmark text:name CtATA teEt|IeEt<<!ATTLIST text:bookmark-start text:name CtATA teEt|IeEt<<!ATTLIST text:bookmark-ent text:name CtATA teEt|IeEt<

E 4 oT TiBnn

4I 9iu1ito 1teeuo inI.irg<text:p<<text:bookmark text:namep“Mark 1“/<There is a text mark in front of thisparagraph.
<text:bookmark-start text:namep“Mark 2“/<In front of this paragraphthere isthe start of a bookmark.
</text:p<<text:p<This bookmark ents
<text:bookmark-ent text:namep“Mark 2“/<amit this sentence.
</text:p<124

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c0c

nde. Entries

rnfoemation to be supplied.

4c0c02eierenies

The OpenOiiiiecorg X L representation oi reierenies is modeaed on the X L representation oi bookmarksc
There are tto types oi reierenie markss as ioaaots:●

point reierenie
point reierenie marks a partiiSaar position in te.t and is represented by a singae <text:referencemark< eaementc●

range reierenie
range reierenie marks a range oi iharaiters in te.t and is represented by tto eaements; <text:
reference-mark-start< to mark the start oi the range and <text:reference-mark-ent< tomark the end oi the rangec

Erery reierenie is identiiied by its names thiih mSst be SniqSec n a range reierenies the start and end eaements
mSst Sse the same reierenie namec
n T The iSrrent rersion oi the OpenOiiiiecorg soittare does not sSpport range reierenies that span mSatipae
paragraphsc i these types oi range reierenies e.ists dSring import the OpenOiiiiecorg soittare trSniates the reierenie to the paragraph in thiih the <text:reference-mark-start< eaement appearsc

Point eierenies
The <text:reference-mark< eaement represents a point reierenie in X Lc
rg i nt T<text:reference-mark<RrT 9T

The name mSst not be reSsed ior any other reiereniec

o oT<!ELEMENT text:reference-mark EMPTY<<!ATTLIST text:reference-mark text:name %string;teEt|IeEt<

ange eierenies
The <text:reference-mark-start< and <text:reference-mark-ent< eaements represent a
range reierenie in X Lc
rg i nt T<text:reference-mark-start<<text:reference-mark-ent<

RrT 9T

The name mSst not be reSsed ior any other reiereniec

o oT<!ELEMENT text:reference-mark-start EMPTY<<!ELEMENT text:reference-mark-ent EMPTY<<!ATTLIST text:reference-mark-start text:name %string; teEt|IeEt<<!ATTLIST text:reference-mark-ent text:name %string; teEt|IeEt<

n OpenOiiiiecorg X Ls three eaements are Ssed to represent reierenies instead oi one eaement beiaSse reierChapter 3 Text Content

125enies represented as a singae X L eaement:●

Cannot sSpport oreraapping reierenies●

Do not interait teaa tith other eaements

Take the ioaaoting e.ampae:
E 4 oT Titv IT4oou1.iI41. iI e I 1o 9
<text:p<<text:reference-mark-start text:namep"first"/<This is an<text:reference-mark-start text:namep"secont"/<example of a sentence<text:reference-mark-ent text:namep"first"/<with overlapping references.
<text:reference-mark-ent text:namep"secont"/<</text:p<
The e.ampae paragraph shots tto reierenies that iorer the ioaaoting te.t:reierenie eiirstr
reierenie eseiondr

eThis is an e.ampae oi a sentenier
ee.ampae oi a sentenie tith oreraapping reiereniescr

This oreraapping strSitSre iannot be represented Ssing a singae reierenie eaement to iontain the reierenied te.tc
imiaarays a reierenie spanning mSatipae paragraphs ireates the same sitSation as tto oreraapping X L eaementss
as does iharaiter iormatting either starts or endss bSt not boths tithin the reierenied te.tc

4c0c00 oit Oyphenss Oyphenss and Non-breaking Baanks
oit hyphenss hyphenss and non-breaking baanks are represented by N CODE iharaiterscr i4c

toEior4I4o Iiii

R oI 9 1 9iii

OFT OYPOEN i22 Do

soit hyphens

NON-B E 2 NG OYPOEN i 200o

non-breaking hyphens

NO-B E 2 P CE i22 2onon-breaking baanks

eitionste.t seition is a named region oi te.t that ian be assoiiated tith iertain iormatting propertiesc The seition
starts and ends on paragraph boSndaries and ian iontain any nSmber oi paragraphsc eitions ian iontain regSaar
te.t iontent or the te.t ian be iontained in another iiae and ainked to the seitionc eitions ian aaso be triteproteited or hiddenc
i a seition is ainked to another doiSments the aink ian be throSgh one oi the ioaaoting:●●resoSrie identiiied by an Xainks represented by a text:section-source eaement
Dynamii Data E.ihange iDDEso represented by a office:tte-source eaement

i these eaements are Sseds they mSst be the iirst eaement in a <text:section<ceitions ian hare settings ior te.t ioaSmnss baikgroSnd ioaor or patterns iootnote and endnote ioniigSrationc
These settings iorm the seition styaes thiih is represented in a astyle:styles< eaementc The iormatting
properties ior seitions are e.paained in eition 4c0 c

126

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:section<

RrT 9To oT
n T<!ELEMENT text:section((text:section-source|office:tte-sourcey?, %text;y<n OpenOiiiiecorg Driters aists and seitions ian oreraapc Thereiores a te.t seition ian start on any
paragraph boSndary eren ii the paragraph is part oi a nSmbered or bSaaeted aistc This iaSses a
probaem in the X L representation oi aists beiaSse aists are represented Ssing their otn iontainer
eaements and X L iannot represent oreraapping eaementsc To soare the probaems a seition
boSndary tithin a aist iaSses the aist to spaitc

eition tyae
The text:style-name attribSte speiiiies the seition styaec
rg i nt T

text:style-name

RrT 9T

This attribSte mSst reier to a seition styaeco oT<!ATTLIST text:section text:style-name %styleName; tIMPLIEt<

eition Name
Erery seition mSst hare a name that SniqSeay identiiies the seitionc The text:name attribSte iontains the nameoi the seitionc
rg i nt T

text:nameRrT 9TYoS shoSad not ihange a seition that is marked as proteitedc

o oT<!ATTLIST text:section text:name %string; teEt|IeEt<

Oidden eitions and Conditionaa eitions
eitions ian be hidden based on a iondition or they ian be hidden Snionditionaaayc
The text:tisplay attribSte speiiiies thether or not the seition is hiddenc
rg i nt T

text:tisplay

RrT 9TThe raaSe oi this attribSte ian be:

o oT

●

trues the seition is dispaayedc This is the deiaSat settingc●

nones the seition is hidden Snionditionaaayc●

contitions the seition is hidden Snder the iondition speiiiied in the text:contition
attribStec<!ATTLIST text:section text:tisplay (true|none|contitiony"true"<The text:contition attribSte speiiiies the iondition Snder thiih the seition is hiddenc The iondition is
enioded as a stringc

Chapter 3 Text Content

127rg i nt T

text:contition

RrT 9Ti the raaSe oi text:tisplay is contitions the text:contition attribSte mSst bepresentc

o oT<!ATTLIST text:section text:contition %formula; tIMPLIEt<

Proteited eitions
YoS ian proteit a seitions thiih means that a Sser ian not edit the seitionc The text:protectet attribSte
indiiates thether or not a seition is proteitedc The Sser interiaie mSst eniorie the proteition attribSte ii it isenabaedc
rg i nt T

text:protectet

RrT 9To oT<!ATTLIST text:section text:protectet %boolean; "false"<

Sser ian Sse the Sser interiaie to reset the proteition iaags Snaess the seition is iSrther proteited by a passtordc
n this iases the Sser mSst knot the passtord in order to reset the proteition iaagc The text:protectionkey attribSte speiiiies the passtord that proteits the seitionc To aroid saring the passtord direitay into the
X L iiaes onay a hash raaSe oi the passtord is storedc
rg i nt T

text:protection-key

RrT 9TThe raaSe oi the this attribSte is theo oT<!ATTLIST text:section text:protection-key CtATA tIMPLIEt<

n T

E69 representation oi passtord hash raaSec

CSrrentays the OpenOiiiiecorg X L iiae iormat Sses theproteition key raaSec

D5 hash iSnition to iompSte the

4c c0 eition oSrie
The <text:section-source< eaement indiiates that the eniaosed seition is a ainked seitionc i this eaement
is Sseds it mSst be the iirst eaement in the <text:section< eaementc
rg i nt T<text:section-source<

RrT 9T

This eaement does not hare any iontentsc

o oT<!ELEMENT text:section-source EMPTY<

The attribStes that yoS ian assoiiate tith the <text:section-source< attribSte are:●eition soSrie

L●

Name oi ainked seition●

Fiater nameeition oSrie

L

These attribStes identiiy the doiSment or seition to thiih the seition is ainkedc

128

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

xlink:href, xlink:type, xlink:show

RrT 9T

The name oi the target seition is identiiied by the aoiaa part oi the
markc

o oT

<!ATTLIST text:section-source
xlink:href %string; tIMPLIEt
xlink:type (simpley tFIXEt "simple"
xlink:show (embety tFIXEt "embet"<n T

Ls ioaaoting the hashThe xlink:href attribSte is impaied beiaSse <text:section-source< eaements
may aaso aink to internaa seitionsc

Name oi Linked eitioni the aink targets a seition oi a doiSments the attribSte text:section name iontains the name oi the target
seitionc
rg i nt T

text:section-name

RrT 9Ti the attribSte is not presents the aink targets the entire doiSmentc

o oT<!ATTLIST text:section-source text:section-name %string;tIMPLIEt<

Fiater Name
The text:filter-name attribSte speiiiies the iiae type oi the aink targetc
rg i nt T

text:filter-name

RrT 9TThe raaSe oi this attribSte is impaementation-dependentc

o oT<!ATTLIST text:section-source text:filter-name %string;tIMPLIEt<

4c c DDE oSrie
i seitions are ainked ria DDEs they are represented by a <office:tte-source< eaementc t iontains attribStes that speiiiy the appaiiations topii and item oi the DDE ionneitionc
rg i nt T<office:tte-source<

RrT 9To oT<!ELEMENT office:tte-source EMPTY<

The attribStes that yoS ian assoiiate tith the <office:tte-source< eaement are:●

Target appaiiation●

Target topii●

Target item●

Stomatii Spdate

Chapter 3 Text Content

129

Target ppaiiation
The office:tte-application attribSte speiiiies the name oi the target appaiiation to Sse ior the DDE
ionneitionc
rg i nt T

office:tte-application

RrT 9To oT<!ATTLIST office:tte-source office:tte-application%string; teEt|IeEt<

Target Topii
The office:tte-topic attribSte speiiiies the topii to Sse ior the DDE ionneitionc
rg i nt T

office:tte-topic

RrT 9To oT<!ATTLIST office:tte-source office:tte-topic %string; teEt|IeEt<

Target tem
The office:tte-item attribSte speiiiies the iniormation that the target appaiiation tiaa deairerc
rg i nt T

office:tte-item

RrT 9To oT<!ATTLIST office:tte-source office:tte-item %string; teEt|IeEt<

Stomatii pdate
The office:automatic-uptate attribSte indiiates thether or not the ainked seition shoSad be aStomatiiaaay Spdatedc
rg i nt T

office:automatic-uptate

RrT 9Ti this attribSte is set trues the ainked seitions shoSad be Spdated aStomati iaaayc

o oT<!ATTLIST office:tte-source office:automaticuptate %boolean; "false"<

4c4 BSaaeted and NSmbered Lists
BSaaeted and nSmbered aists ionsist oi strSitSraa and aayoSt iniormationc
trSitSraa iniormation iniaSdes the ioaaoting:130●

List type l bSaaeted or nSmberedc●

List aerea l ior e.ampaes main or sSbaistc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●niormation aboSt thether or not a iertain paragraph iontained in a aist has a aabeas ior e.ampae nSmber or
bSaaetc●

The nSmber oi a paragraph tithin a nSmbered aistc This iniormation is optionaa beiaSse it ian be reiaaiSaatedc

LayoSt iniormation iniaSdes the ioaaoting:●

The indentation oi paragraphs in a aistc●

The aabea tidth and the distanie betteen it and the te.tc●

The bSaaet iharaiter or image ior bSaaeted aistsc●

The nSmber iormat ior nSmbered aistsc

The strSitSraa iniormation is iontained in the doiSment bodys tith the iontentc The OpenOiiiiecorg X L representation oi strSitSraa iniormation is rery simiaar to OT Lc The aayoSt iniormation is iontained tithin Tu9 i9 yT 9c
There are iommon aist styaes and aStomatii aist styaesc

4c4c0 List Baoiks
aist is represented by the one oi the ioaaoting eaements:●<text:orteret-list<
This eaement speiiiies an ordered aists that is a aist there erery aist item is preieded by a nSmber that is iniremented ior eaih aist itemc●<text:unorteret-list<
This eaement speiiiies an Snordered aists that is a aist there erery aist item is preieded by the same bSaaet iharaiter or imagec

rg i nt T
RrT 9Ts aboreBoth eaements hare the same iontent; an optionaa aist header ioaaoted by any nSmber oi aist
itemscErery aist has a Tu9 iT v Ti i a aist is not iontained tithin another aists the aist aerea is 0c i the aistin iontained tithin another aists the aist aerea is the aist aerea oi the aist in thiih is it iontained
iniremented by onec i a sSbaist is iontained in a tabae ieaa or te.t bo.s the aist aerea retSrns to 0s
eren thoSgh the aist eaements are nestedc

o oT<!ENTITY % list-items "((text:list-heater|text:list-itemy,
text:list-itemay"<<!ELEMENT text:orteret-list %list-items;<<!ELEMENT text:unorteret-list %list-items;<

The attribStes that yoS ian assoiiate tith the aist baoik eaements are:●●tyae nameContinSe nSmberingtyae Name
The text:style-name attribSte speiiiies the name oi the aist styae that is appaied to the aistc

Chapter 3 Text Content

131rg i nt T

text:style-name

RrT 9T

This attribSte is optionaa and ian be Ssed tith the <text:orteret-list< or <text:
unorteret-list< eaementc i this attribSte is not iniaSded and thereiore a aist styae is not
speiiiieds one oi the ioaaoting aitions is taken:

o oT

n T

●

i the aist is iontained tithin another aists the aist styae deiaSats to the styae oi the sSrroSnding
aistc

●

i there is no aist styae speiiiied ior the sSrroSnding aist bSt the aist iontains paragraphs thathare paragraph styaes attaihed speiiiying a aist styaes this aist styae is Ssed ior any oi theseparagraphsc deiaSat aist styae is appaied to any other paragraphsc<!ATTLIST text:orteret-list text:style-name %style-name;tIMPLIEt<<!ATTLIST text:unorteret-list text:style-name %style-name;tIMPLIEt<
To determine thiih iormatting properties are appaied to a aists the aist aerea and aist styae name aretaken into aiioSntc ee eition 4c4c9 ior more iniormation on aist iormatting propertiesc

ContinSe NSmbering
By deiaSats the iirst aist item in an ordered aist starts tith the nSmber speiiiied in the aist styaec i the aist ioaaots
another ordered aist and yoS tant to iontinSe the nSmbering irom the preieding aists yoS ian Sse the iontinSe
nSmbering attribStec
rg i nt T

text:continue-numberingRrT 9T

This attribSte ian be Ssed tith the <text:orteret-list< eaement and ian hare a raaSe oi
true or falsec
i the raaSe oi the attribSte is true and the nSmbering styae oi the preieding aist is the same as
the iSrrent aists the nSmber oi the iirst aist item in the iSrrent aist is the nSmber oi the aast item inthe preieding aist iniremented by onec

o oT<!ATTLIST text:orteret-list text:continue-numbering %boolean;"false"<4c4c List Oeader
aist header iontains one or more paragraphs that are dispaayed beiore a aistc The paragraphs are iormatted aike
aist items bSt they do not hare a preieding nSmber or bSaaetc The aist header is represented by the aist header
eaementc
rg i nt T<text:list-heater<RrT 9T

This eaement iontains paragraphs or seitionsc The eaement iannot iontain headingss tabaess oraistsco oT<!ELEMENT text:list-heater (text:p|text:sectionyt<

4c4c4 List tem<text:list-item< eaement ian iontain paragraphss seitionss or aistsc

132

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:list-item<

RrT 9T

The iirst aine in a aist item is preieded by a bSaaet or nSmbers depending on the aist styae assigned
to the aistc i a aist item starts another aist immediateay and does not iontain any te.ts no bSaaet or
nSmber is dispaayedc
aist item iannot iontain headings or tabaesc

o oT<!ENTITY % list-item-content "(text:p|text:section|
text:orteret-list|text:unorteret-listyt"<!ELEMENT text:list-item %list-item-content;<

The attribStes that yoS ian assoiiate tith the <text:list-item< eaement are:●estart nSmbering●

estart nSmbering raaSe

estart NSmbering
YoS ian restart the nSmbering oi a aist and the nSmbering oi the sSrroSnding aists by attaihing the text:
restart-numbering attribSte to the <text:list-item< eaementc
rg i nt T

text:restart-numberingRrT 9T

This attribSte ian hare a raaSe oi true or falsec t ian be Ssed ior aist items in ordered or
Snordered aistsc i the attribSte is appaied to a aist item in an Snordered aists it aiieits thenSmbering oi aaa sSrroSnding ordered aists and ordered aists that are iontained tithin the itemc

o oT<!ATTLIST text:list-item text:restart-numbering %boolean;"false"<estart NSmbering VaaSe
YoS ian restart the nSmbering oi the iSrrent aist at a iertain nSmberc se the text:start-value attribSte tospeiiiy the nSmber tith thiih to restart the aistc
rg i nt T

text:start-value

RrT 9T

This attribSte ian onay be appaied to paragraphs tith a nSmbering aist styaec naike the text:
restart-numbering attribStes it restarts the nSmbering oi the iSrrent aist onayc

o oT<!ATTLIST text:list-item text:start-value %number; tIMPLIEt<

E 4 oT TitIt I ti41tir1nIt I tiTu9 9i41ti9r Tu9 9

Chapter 3 Text Content

133<text:orteret-list text:style-namep"List 1"<<text:list-item<<text:p<This is the first list item</text:p<<text:p<This is a continuation of the first list item.</text:p<</text:list-item<<text:list-item<<text:p<This is the secont list item.
It contains an unorteret sub list.</text:p<<text:unorteret-list<<text:list-item<<text:p<This is a sub list item.</text:p<<text:list-item<<text:p<This is a sub list item.</text:p<<text:list-item<<text:p<This is a sub list item.</text:p<</text:unorteret-list<</text:list item<<text:list-item<<text:p<This is the thirt list item</text:p<</text:list-item<</text:orteret-list<

4c4c9 List tyaes
List styaes speiiiy the iormatting properties ior aistsc aist styae iontains a set oi speiiiiiationss eaih speiiiiiation
iontaining a set oi properties to appay to a aist oi a iertain aist aereac These speiiiiiations are iaaaed Tu9 iT v T
9 yT 9c i a aist styae is appaied to a aist bSt it does not iontain a aist aerea speiiiiiation ior the aerea oi the aists theaist aerea styae oi the nearest aoter aerea is Ssedc i a sSitabae aist aerea styae does not e.ists a deiaSat styae is Ssedc
rg i nt T<text:list-style<RrT 9T

This eaement iontains a set oi nSmber or bSaaet aist styaes ior diiierent aist aereasc The aist styaes
ian be iommon or aStomatii styaesco oT<!ELEMENT text:list-style (text:list-level-style-number|
text:list-level-style-bullet|
text:list-level-style-imageyt<

n T

List styaes iontain diiierent properties than paragraph or te.t styaesc This is thy they are represented by a diiierent eaementc

The attribStes that yoS ian assoiiate tith the <text:list-style< eaement are:
●

Name

●

Faag ior reiognition oi iSrrent nSmbers●

ConseiStire nSmberingName
The style:name attribSte speiiiies the name oi the aist styaec
rg i nt T

style:nameRrT 9To oT

134<!ATTLIST text:list-style style:name %style-name; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

ConseiStire NSmbering
The text:consecutive-numbering attribSte speiiiies thether or not the aist styae Sses ionseiStirenSmbering ior aaa aist aereas or thether eaih aist aerea restarts the nSmberingc
rg i nt T

text:consecutive-numberingRrT 9T

This attribSte ian hare a raaSe oi true or falsec

o oT<!ATTLIST text:list-style text:consecutive-numbering %boolean;"false"<4c4c5 NSmber Lerea tyae
nSmber aerea styae speiiiies a aist styae there the aist items are preieded by nSmbersc
rg i nt T<text:list-level-style-number<RrT 9T

This eaement is iontained in aist styae eaements i<text:list-style<o onayc

o oT<!ELEMENT text:list-level-style-number (style:properties?y<The attribStes that yoS ian assoiiate tith the <text:list-level-style-number< eaement are:
●

Lerea

●

tart indent●

inimSm aabea tidth●

inimSm aabea distanie●

Labea aaignment●

Te.t styae●

NSmber iormat●

Dispaay aereas●

tart raaSe

Lerea
The text:level attribSte speiiiies the aerea oi the nSmber aist styaec
rg i nt T

text:level

RrT 9TThe raaSe oi this attribSte is a nSmberc The nSmber oi the highest aerea is "0"co oT<!ATTLIST text:list-level-style-numbering text:level %number;
teEt|IeEt<

tart ndent
The text:space-before attribSte speiiiies the spaie to iniaSde beiore the nSmber ior aaa paragraphs at thisaereac i a paragraph has a aeit margin that is greater than 2s the aitSaa position oi the aist aabea bo. is the aeit
margin tidth paSs the start indent raaSec
Chapter 3 Text Content

135rg i nt T

text:space-before

RrT 9T

This attribSte ian be assoiiated tith an item set eaement that is iontained in a <text:listlevel-style-a< eaementc
The raaSe oi the attribSte is an absoaSte raaSec This means that then the position oi a aabea is
iaaiSaated the start indent raaSe oi the iSrrent aerea is onay ionsideredc The start indent raaSes ior
aoter aereas do not aiieit the aabea positionc

o oT
n T

<!ATTLIST style:properties text:space-before %length;tIMPLIEt<
This attribSte does not ioniorm tith X L or C

speiiiiiationsc

inimSm Labea Didth
The text:min-label-witth attribSte speiiiies the minimSm tidth oi a nSmberc
rg i nt T

text:min-label-witth

RrT 9T

This attribSte ian be assoiiated tith an item set eaement that is iontained in a <text:listlevel-style-a< eaementc
YoS ian aaign the aabea horikontaaay tith the tidth Ssing an fo:text-align propertyc ee
the Labea aignment attribSte beaot ior more iniormationc

o oT
n T

<!ATTLIST style:properties text:min-label-witth %length;tIMPLIEt<
This attribSte does not ioniorm tith X L or C

speiiiiiationsc

inimSm Labea Distanie
The text:min-label-tistance attribSte speiiiies the minimSm distanie betteen the nSmber and the te.toi the aist itemc
rg i nt T

text:min-label-tistanceRrT 9T

This attribSte ian be assoiiated tith an item set eaement that is iontained in a <text:listlevel-style-a< eaementc

o oT<!ATTLIST style:properties text:min-label-tistance %length;tIMPLIEt<

n TThis attribSte does not ioniorm tith X L or C

speiiiiiationsc

Labea aignment
The fo:text-align attribSte speiiiies the horikontaa aaignment oi a aabea inSmbero tithin the tidth speiiiiedby the text:min-label-witth attribStec
rg i nt T

fo:text-alignRrT 9T

This attribSte is assoiiated tith the text:min-label-witth attribStes thiih ian be assoiiated tith an item set eaement that is iontained in a <text:list-level-style-a<eaementc

o oT

ee eition 4c00c9 ior a DTD and more iniormationc

n T
136

This attribSte does not ioniorm tith X L or C

OpenOffice.org XML File Format Working Draft

speiiiiiationsc

Technical Reference Manual Version 2

December 2ee2

Te.t tyae
The text:style-name attribSte speiiiies the name oi the styae to Sse to iormat the nSmber oi the aistc
rg i nt T

text:style-name

RrT 9To oT<!ATTLIST text:list-level-style-numbering text:style-name %style-name tIMPLIEt<

NSmber Format
ee Chapter ior detaiaed iniormation on nSmber iormat attribStesc The attribStes desiribed in Chapter
be assoiiated tith the <text:list-level-style-numbering< eaementc
o oT

n T

ian aaso<!ATTLIST text:list-level-style-numbering style:num-format
CtATA teEt|IeEt<<!ATTLIST text:list-level-style-numbering style:num-prefix
CtATA tIMPLIEt<<!ATTLIST text:list-level-style-numbering style:num-suffix
CtATA tIMPLIEt<<!ATTLIST text:list-level-style-numbering style:num-lettersync %boolean; "false"<
The style:num-format attribSte ian be emptyc

Dispaay Lereas
The text:tisplay-levels attribSte speiiiies the nSmber oi aereas those nSmbers are dispaayed at theiSrrent aereac For e.ampaes it ioSad speiiiy that yoS dispaay aaa three nSmbers i0c c0o ior a aerea three heading orthat yoS onay dispaay tto aereas i c0oc
rg i nt T

text:tisplay-levels

RrT 9To oT<!ATTLIST text:list-level-style-numbering text:tisplay-levels%number; "1"<tart VaaSe
The text:start-value attribSte speiiiies the iirst nSmber oi an aist item oi the iSrrent aereac
rg i nt T

text:start-value

RrT 9To oT<!ATTLIST text:list-level-style-numbering text:start-value %number; "1"<4c4c6 BSaaet Lerea tyaebSaaet aerea styae eaement speiiiies a aist styae there the aist items are preieded by bSaaetsc

Chapter 3 Text Content

137

rg i nt T

<text:list-level-style-bullet<

RrT 9T

This eaement is iontained in aist styae eaements i<text:list-style<o onayc

o oT<!ELEMENT text:list-level-style-bullet (style:properties?y<n T

The resSat oi iniaSding this eaement in an ordered aist is Sndeiinedc t ian be either an ordered aist
Ssing a deiaSat styae or an Snordered aist Ssing the bSaaet aerea styaec

The attribStes that yoS ian assoiiate tith the <text:list-level-style-bullet< eaement are:●Lereas spaiings aaignments and te.t styae

●

Font

●

BSaaet iharaiter●BSaaet reaatire sike

Lereas paiings aignments and Te.t tyae
These attribStes are the same as those desiribed ior Sse tith the nSmber aerea styaes see eition 4c4c5c

Font
The iont attribStes that ian be attaihed to an item set eaement are desiribed in eitions 4c02c to 4c02c04c

BSaaet Charaiter
The bSaaet iharaiter attribSte speiiiies the N CODE iharaiter to Sse as the bSaaet in a bSaaet aerea styaec
rg i nt T

text:bullet-char

RrT 9TThe raaSe oi this attribSte mSst be one N CODE iharaiterc

o oT<!ENTITY % char "CtATA"<<!ATTLIST text:list-level-style-bullet text:bullet-char %char;teEt|IeEt<

BSaaet eaatire ike
The text:bullet-relative-sive attribSte speiiiies a perientage raaSe ior the bSaaet sike reaatire to theiont sike oi the paragraphs in the bSaaet aistc For e.ampaes ii the raaSe oi the text:bullet-relative-sive
attribSte is :4s the bSaaet Ssed in the aist is m5l oi the iont sike ior the paragraphc
rg i nt T

text:bullet-relative-sive

RrT 9To oT<!ATTLIST text:list-level-style-bullet text:bullet-relativesive %percentage; tIMPLIEt<

4c4cm mage Lerea tyaen image aerea styae eaement speiiiies a aist styae there the aist items are preieded by imagesc
138

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:list-level-style-image<RrT 9T

This eaement ian be an XLink and ian onay be iontained in aist styae eaementsc

o oT<!ELEMENT text:list-level-style-image (style:properties?,
office:binary-tata?y<<!ATTLIST text:list-level-style-image xlink:type (simpley
tIMPLIEt<<!ATTLIST text:list-level-style-image xlink:show (embety
tIMPLIEt<<!ATTLIST text:list-level-style-image xlink:actuate (onLoatytIMPLIEt<

n T

The resSat oi iniaSding this eaement in an ordered aist is Sndeiinedc t ian be either an ordered aist
Ssing a deiaSat styae or an Snordered aist Ssing the image aerea styaec

The eaements and attribStes that yoS ian assoiiate tith the <text:list-level-style-image< eaement
are:●Lereas spaiings and aaignment●

mage aoiation●

mage sike●

Vertiiaa aaignment

Lereas paiings and aignment
These attribStes are the same as those desiribed ior Sse tith the nSmber aerea styaes see eition 4c4c5c

mage Loiation
The image data ian be stored in one oi the ioaaoting tays:●

The image data is aoiated in an e.ternaa iiaec se the xlink:href attribSte desiribed beaot to speiiiy theaoiation oi the iiaec●

The image data is iontained in the <text:list-level-style-image< eaementc The <text:listlevel-style-image< eaement mSst iontain an <office:binary-tata< eaement that iontains theimage data in B E69 eniodingc n this sitSations the xlink:href attribSte is not reqSiredc

rg i nt T

xlink:href

RrT 9To oT
n T<!ATTLIST text:list-level-style-image xlink:href %url;
tIMPLIEt<
BSaaet images ian be embeddedc CSrrentays embedded images mSst be stored in separate iiaesc

mage ike
The sike oi the image is speiiiied by the ioaaoting attribStes:

Chapter 3 Text Content

139rg i nt T

fo:witth
fo:height

RrT 9T

These attribStes are attaihed to a <style:properties< eaement that is iontained in the<text:list-level-style-image< eaementc

ee Chapter

ior more iniormationc

Vertiiaa aignment
The rertiiaa aaignment oi the image is speiiiied by the ioaaoting attribStes:rg i nt T

style:vertical-pos
style:vertical-rel

RrT 9T

These attribStes are attaihed to a <style:properties< eaement that is iontained in the<text:list-level-style-image< eaementc

ee Chapter

ior more iniormationc

E 4 oT Ti

4. iT v Ti9 yT<text:list-style style:namep“List 1“<<text:list-level-style-numbering text:levelp“1“
fo:num-formatp“1“/<<text:list-level-style-bullet text:levelp“2“
text:bullet-charp"-"text:style-namep"Bullet Char"/<<text:list-level-style-image text:levelp“3“ xlink:hrefp"bullet.gif"<<style:properties fo:witthp".:cm" fo:heightp".:cm"
style:vertical-posp"mittle" style:verticalrelp"line"/<</text:list-level-style-image<</text:list-style<
The ioaaoting is the oStpSt irom the abore e.ampae:
0c This is the iirst aist itemc
This is a iontinSation oi the iirst aist itemc
c This is the seiond aist itemc t iontains an Snordered sSb aistc-

This is a sSb aist itemc-

This is a sSb aist itemc-

This is a sSb aist itemc

4c This is the third aist itemc

4c9 OStaine NSmbering
YoS ian aink oStaine nSmbering to paragraph styaesc

140

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c9c0 OStaine tyae
The tay in thiih OpenOiiiiecorg X L represents oStaine nSmbering styaes is rery simiaar to the tay it represents aist styaesc The <text:outline-style< eaement iontains eaements that speiiiy the styae oi eaih oStaine
aereacrg i nt T<text:outline-style<RrT 9To oT<!ELEMENT text:outline-style (text:outline-level-styleyt<

4c9c OStaine Lerea tyae
The <text:outline-level-style< eaement speiiiies the styae ior eaih oStaine aereac
rg i nt T<text:outline-level-style<RrT 9T

This eaement is iontained in <text:outline-style< eaements onayc

o oT<!ELEMENT text:outline-level-style EMPTY<

The attribStes that yoS ian assoiiate tith the <text:outline-level-style< eaement are:
●
●

Lerea
paiing and aaignment●

Te.t styae●

NSmber iormat●

Dispaay aereas●

tart raaSe

Lerea
ee eition 4c4c5 ior a desiription oi this attribStec

paiing and aignment
The <text:outline-level-style< eaement iontains a <style:properties< eaement that ian
iontain attribStes speiiiying the spaiing and aaignment ior the oStaine nSmbering aistc The attribStes are the sameas the attribStes ior the nSmbering aerea styae eaements <text:list-level-style-numbering<s asioaaots:●

tart indent l text:space-before●

inimSm aabea tidth l text:min-label-witth●

inimSm aabea distanie l text:min-label-tistance●Labea aaignment l fo:text-alignee eition 4c4c5 ior detaiaed iniormation on these attribStesc

Chapter 3 Text Content

141

Te.t tyaeee eition 4c4c5 ior iniormation on the te.t styae attribStec

NSmber Format
Paease reier to Chapter ior detaiaed iniormation on nSmber iormat attribStesc YoS ian assoiiate the attribStes
desiribed in Chapter tith the <text:outline-numbering-level-style< eaementc
o oT

n T

<!ATTLIST text:outline-level-style style:num-format CtATA
teEt|IeEt<<!ATTLIST text:outline-level-style style:num-prefix CtATAtIMPLIEt<<!ATTLIST text:outline-level-style style:num-suffix CtATAtIMPLIEt<<!ATTLIST text:outline-level-style style:num-letter-sync %boolean; "false"<
The style:num-format attribSte ian be emptyc

Dispaay Lereas
ee eition 4c4c5 ior iniormation on the dispaay aerea eaementc

tart VaaSeee eition 4c4c5 ior iniormation on the start raaSe attribStec

4c5 Line NSmbering
4c5c0 Line NSmbering ConiigSrationn OpenOiiiiecorg doiSment ian iontain none or one aine nSmbering ioniigSration eaementc i the eaement is notpresents a deiaSat aine nSmbering ioniigSration is Ssedc The deiaSat aine nSmbering may rary depending on therersion oi OpenOiiiiecorg soittare bSt erery doiSment sared Ssing the OpenOiiiiecorg soittare iontains a ainenSmbering ioniigSration eaementc
rg i nt T<text:linenumbering-configuration<

RrT 9To oT<!ELEMENT text:linenumbering-configuration (text:
linenumbering-seperator?y<The attribStes that yoS ian assoiiate tith the <text:linenumbering-configuration< eaement are:142●

Line nSmbering enabae●

NSmber iormat●

Te.t styae●

nirement

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Position●

Oiiset●CoSnt empty aines●

CoSnt in iaoating irames●

estart nSmbering on erery pageThe eaement that yoS ian assoiiate tith the <text:linenumbering-seperator< eaement is:●eparator and its assoiiated separator oiiset attribSte

Line NSmbering Enabae
The text:number-lines attribSte iontroas thether or not aines are nSmberedc
rg i nt T

text:number-lines

RrT 9To oT<!ATTLIST text:linenumbering-configuration text:number-lines %boolean; "true"<

NSmber Format
ee Chapter

ior detaiaed iniormation on nSmber iormatsc

Te.t tyae
The text:style-name attribSte speiiiies the te.t styae ior aaa aine nSmbersc
rg i nt T

text:style-name

RrT 9TThe raaSe oi this attribSte is the name oi the te.t styae that is appaied to aaa aine nSmbersc

o oT<!ATTLIST text:linenumbering-configuration text:style-name
CtATA tIMPLIEt<

nirement
The text:increment attribSte iaSses aine nSmbers that are a mSatipae oi the giren inirement to be nSmberedc
For e.ampaes ii the inirement is 5s onay aines nSmber 5s 02s 05s and so on are nSmberedc
rg i nt T

text:increment

RrT 9To oT<!ATTLIST text:linenumbering-configuration text:increment
CtATA tIMPLIEt<

Position
The text:position attribSte determines thether the aine nSmbers are printed on the aeit s rights inners or
Chapter 3 Text Content

143

oSter marginsc
rg i nt T

text:position

RrT 9To oT<!ATTLIST text:linenumbering-configuration text:position(left|right|inner|outery "left"<

Oiiset
The text:offset attribSte determines the distanie betteen the aine nSmber and the marginc
rg i nt T

text:offset

RrT 9To oT<!ATTLIST text:linenumbering-configuration text:offset %nonNegativeLength; tIMPLIEt<

CoSnt Empty Lines
The text:count-empty-lines attribSte determines thether or not empty aines are iniaSded in the aine
ioSntcrg i nt T

text:count-empty-lines

RrT 9Ti the raaSe oi this attribSte is trues empty aines are iniaSded in the aine ioSntc

o oT<!ATTLIST text:linenumbering-configuration text:count-emptylines %boolean; "true"<

CoSnt Lines in Faoating Frames
The text:count-in-floating-frames attribSte determines thether or not te.t in iaoating irames is
iniaSded in the aine ioSntc
rg i nt T

text:count-in-floating-frames

RrT 9Ti the raaSe oi this attribSte is trues te.t tithin iaoating irames is iniaSded in the aine ioSntc

o oT<!ATTLIST text:linenumbering-configuration text:count-infloating-frames %boolean; "false"<

estart NSmbering on Erery Page
The text:restart-on-page attribSte determines thether or not the aine ioSnt is reset to 0 at the start oi
erery pagec

144

rg i nt T

text:restart-on-pageRrT 9Ti the raaSe oi this attribSte is trues the aine ioSnt is reset to 0 at the beginning oi erery pages
resSating in page -speiiiii nSmbering oi ainesc The deiaSat raaSe oi this attribSte is falses
resSating in doiSment-speiiiii nSmbering oi ainesc

o oT<!ATTLIST text:linenumbering-configuration text:restart-onpage %boolean; "false"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c5c

eparator

The <text:linenumbering-seperator< eaement iontains the te.t that is dispaayed as a separatorc
rg i nt T<text:linenumbering-seperator<

RrT 9T

This eaement is iontained in the aine nSmbering ioniigSration eaementc i the eaement is notpresents no separator is dispaayedc

o oT<!ELEMENT text:linenumbering-separator (tPCtATAy<

eparator Oiiset ttribSte
The text:increment attribSte speiiiies the separator oiisetc
rg i nt T

text:increment

RrT 9T

This attribSte is assoiiated tith the aine nSmbering separator eaementc

o oT<!ATTLIST text:linenumbering-separator text:increment %number;
teEt|IeEt<

4c5c4 Line NSmbering Properties
ome oi the te.t iormatting properties that yoS ian appay to paragraphs and paragraph styaes aaso iniaSenie ainenSmberingc These te.t iormatting properties are as ioaaots:●

Line nSmbering appaiiation●

Line nSmber start raaSeLine NSmbering ppaiiation
This property iontroas thether or not paragraph aines are nSmberedc
rg i nt T

text:number-lines

RrT 9T

This attribSte ian be iontained in an item set eaement that beaongs to a paragraph or paragraphstyaeco oT<!ATTLIST style:properties text:number-lines %boolean;tIMPLIEt<

Line NSmber tart VaaSe
This property speiiiies a net start raaSe ior aine nSmberingc
rg i nt T

text:line-number

RrT 9T

This attribSte ian be iontained in an item set eaement that beaongs to a paragraph or paragraphstyaec The attribSte is onay reiogniked ii there is aaso a text:number-lines attribSte tith a
raaSe oi true in the same item set eaementc

o oT<!ATTLIST style:properties text:line-number %number; tIMPLIEt<

Chapter 3 Text Content

1454c6 Footnotes and Endnotes
4c6c0 Footnotes ConiigSrationn OpenOiiiiecorg doiSment iontains either none or one iootnotes ioniigSration eaementc i there is no iootnote
ioniigSration eaements a deiaSat iootnote ioniigSration is Ssedc Thereiores erery sared OpenOiiiiecorg doiSmentiontains a iootnote ioniigSration eaementc
rg i nt T<text:footnotes-configuration<

RrT 9To oT<!ELEMENT text:footnotes-configuration(text:footnote-continuation-notice-forwart?,
text:footnote-continuation-notice-backwart?y<The attribStes that yoS ian assoiiate tith the <text:footnotes-configuration< eaement are:●

Citation te.t styae●

Citation body te.t styae●

DeiaSat iootnote paragraph styae●

aster page●

tart raaSe●

NSmber iormat●

NSmbering siheme●

Footnote position

YoS ian iniaSde the ioaaoting eaement in the <text:footnotes-configuration< eaement:●

Footnote iontinSation notiie iiortard and baiktardo

Citation Te.t tyae
The text:citation-style attribSte speiiiies the te.t styae to Sse ior the iootnote iitation tithin the iootnotec
rg i nt T

text:citation-style

RrT 9To oT<!ATTLIST text:footnotes-configuration text:citation-style
CtATA tIMPLIEt<

Citation Body Te.t tyae
The text:citation-boty-style-name attribSte speiiiies the te.t styae to Sse ior the iootnote iitation in
the te.t iaotc

146

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

text:citation-boty-style-namerg i nt T
RrT 9T<!ATTLIST text:footnotes-configuration text:citation-botystyle-name %styleName; tIMPLIEt<

o oT

DeiaSat Footnote Paragraph tyae
The deiaSat iootnote paragraph styae is onay Ssed ior iootnotes that are inserted into an e.isting doiSmentc t is not
Ssed ior iootnotes that aaready e.istc
text:tefault-stylerg i nt T
RrT 9T<!ATTLIST text:footnotes-configuration text:tefault-style
CtATA tIMPLIEt<o oTaster Page
To dispaay the iootnotes at the end oi the doiSments the pages that iontain the iootnotes mSst be instanies oi themaster page speiiiied by the text:master-page-name attribStec
text:master-page-namerg i nt T
RrT 9T<!ATTLIST text:footnotes-configuration text:master-page-name %styleName; tIMPLIEt<

o oTtart VaaSe
The start:value attribSte speiiiies the raaSe at thiih the iootnote nSmbering startsc
rg i nt T

text:start-value

RrT 9To oT<!ATTLIST text:footnotes-configuration text:start-value %number; “1”<NSmber Format
ee Chapter

ior iniormation on the nSmber iormat ior iootnotesc

NSmbering iheme
The text:start-numbering-at attribSte speiiiies ii iootnote nSmbers start tith a net nSmber at the
beginning oi the doiSment or at the beginning oi eaih ihapter or pagec

Chapter 3 Text Content

147

rg i nt T

text:start-numbering-at

RrT 9TThe raaSe oi this attribSte ian be tocuments chapters or pagec

o oT<!ATTLIST text:footnotes-configuration text:start-numbering-at(tocument|chapter|pagey "tocument"<n T

X LT does not hare the iapabiaity to start tith net iootnote nSmbers on erery pagec

Footnotes Position
The text:footnotes-position attribSte speiiiies one oi the ioaaoting positions ior iootnotes:●

The bottom oi the page there the iootnote iitation is aoiatedc●

The end oi the doiSmentc

rg i nt T

text:footnotes-position

RrT 9TThe raaSe oi this attribSte ian be page or tocumentc

o oT<!ATTLIST text:footnotes-configuration text:footnotes-position(tocument|pagey “page”<

n T

X L does not hare the iapabiaity to dispaay iootnotes at the end oi the doiSmentc Ooterers yoS
ian Sse an X LT styaesheet to generate some other iaot objeits to dispaay sSih iootnotesc

Footnote ContinSation
The iootnote iontinSation eaements speiiiy:●

Te.t dispaayed at the end oi a iootnote that is iontinSed on the ne.t page●Te.t dispaayed beiore the iontinSed te.t

rg i nt T<text:footnote-continuation-notice-forwart<<text:footnote-continuation-notice-backwart<

RrT 9T

These eaements ian be iontained in the iootnotes ioniigSration eaementc

o oT<!ELEMENT text:footnote-continuation-notice-forwart (tPCtATAy<<!ELEMENT text:footnote-continuation-notice-backwart (tPCtATAy<n T

X L and X LT do not sSpport iootnote iontinSationc

E 4 oT Ti nn 1n ion1eu.rI4 un1iu1ito 1teeuo inI.irg<text:footnotes-configuration text:citation-stylep”Footnote symbol”
text:tefault-stylep”Footnote”<<text:footnote-continuation-notice-forwart<” ..”</text:footnote-continuation-notice-forwart<<text:footnote-continuation-notice-forwart<”.. ”</text:footnote-continuation-notice-forwart<</text:footnotes-configuration<

148

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c6c Endnotes ConiigSrationn OpenOiiiiecorg doiSment iontains either none or one endnotes ioniigSration eaementc
rg i nt T<text:entnotes-configuration<

RrT 9To oT<!ELEMENT text:entnotes-configuration EMPTY<

Citation Te.t tyaes DeiaSat Endnote Paragraph tyaes Page
NSmber Format

asters Oiisets andee eition 4c6c0 ior desiriptions oi these attribStesc The appaiiation oi these attribStes to the endnote ioniigSration eaement is the same as ior the iootnote ioniigSration eaementc
o oT<!ATTLIST text:entnotes-configuration
text:citation-boty-style-name %styleName; tIMPLIEt
text:citation-style-name %string; tIMPLIEt
text:tefault-style-name %styleName; tIMPLIEt
text:page-master-name %styleName; tIMPLIEt
text:start-value %number; "0"style:num-format %string; tIMPLIEt
style:num-prefix %string; tIMPLIEt
style:num-suffix %string; tIMPLIEt<

4c6c4 Footnotes
The iootnote eaement iontains the iootnote iitation eaement and the eaements that make Sp the iootnote iontentc
OpenOiiiiecorg X L represents iootnotes in a simiaar iashion to X Lc n X Ls the iirst ihiad oi the iootnoteeaement iontains the iitation in the iorm oi an <fo:inline< eaementc OpenOiiiiecorg X L Sses the same
strSitSre bSt introdSies a text:footnote-citation eaementc The seiond ihiad iontains the iootnote bodys
jSst as in X Lc
dditionaaays OpenOiiiiecorg ieatSres the <text:footnotes-configuration< eaementc To aihiere asimiaar eiieit to the iootnote ioniigSration in X Ls erery iootnote and iootnote iitation eaement mSst be
iormatted appropriateayc
rg i nt T<text:footnote<RrT 9To oT<!ELEMENT text:footnote (text:footnote-citation,
text:footnote-botyy<

Footnote Citation
The <text:footnote-citation< eaement speiiiies the iormatted iootnote nSmber or iharaitersc
rg i nt T<text:footnote-citation<

RrT 9T

This eaement is iontained in the iootnote eaement i <text:footnote<o and it iontains theiormatted iootnote nSmber as te.tc

o oT<!ELEMENT text:footnote-citation (tPCtATAy<
Chapter 3 Text Content

149

Footnote Labea
Footnote iitation eaements ian be aabeaed or nSmberedc i they are nSmbereds the nSmber is ihosen aStomatiiaaay
aiiording to the iootnotes ioniigSration eaementc i they are aabeaeds the Sser mSst sSppay a aabea ior erery iootnote hesshe inserts into the doiSmentc This aabea is stored in the text:label attribSte oi the <text:
footnote-citation< eaementc
rg i nt T

text:label

RrT 9Ti this attribSte is not presents the iootnote is nSmbered aStomatiiaaayc

o oT<!ATTLIST text:footnote-citation text:label %string; tIMPLIEt<

Footnote eierenie D
The iootnote reierenie D is Ssed by reierenies to iootnotes to identiiy the iootnote that is reiereniedc
rg i nt T

text:itRrT 9T

This attribSte is Ssed by the <text:footnote< eaementc t iontains a raaSe oi type It,
there It is a predeiined X L attribSte typec

o oT<!ATTLIST text:footnote text:it It tIMPLIEt<

Footnote Body
The <text:footnote-boty< eaement iontains the aitSaa iontent oi the iootnotec t does not hare any attribStescrg i nt T<text:footnote-boty<

RrT 9To oT<!ELEMENT text:footnote-boty %inline-text;<

E 4 oT 9Ti nn 1n 9

150

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<text:p<This paragraph contains a footnote<text:footnote text:itp“ftn001“<<text:footnote-citation<
1</text:footnote-citation<<text:footnote-boty<<text:p<This footnote has a generatet sequence number</text:p<</text:footnote-boty<</text:footnote<.
</text:p<<text:p<This paragraph contains a footnote<text:footnote text:itp“ftn002“<<text:footnote-citation text:labelp"a"<a</text:footnote-citation<<text:footnote-boty<<text:p<This footnote has a fixet citation</text:p<</text:footnote-boty<</text:footnote<, too</text:p<

4c6c9 Endnotes
Endnotes are represented in the same tay as iootnotesc They iontain the endnote iitation eaement and the endnote
body eaement that makes Sp the endnote iontentc For a iSaa desiription oi the eaements and attribStes assoiiatedtith the <text:entnote< eaements paease reier to the prerioSs seitionc
rg i nt T<text:entnote<RrT 9To oT<!ELEMENT text:entnote(text:entnote-citation, text:entnote-botyy<<!ATTLIST text:entnote text:it It tIMPLIEt<

u u 4 un19T

X L does not sSpport endnotes bSt yoS ian Sse an X LT styaesheet to generate some other iaot
objeits to dispaay endnotesc

Endnote Citation
The <text:entnote-citation< eaement speiiiies the iormatted endnote nSmber or iharaitersc
rg i nt T<text:entnote-citation<

RrT 9To oT<!ELEMENT text:entnote-citation (tPCtATAy<<!ATTLIST text:entnote-citation text:label %string; tIMPLIEt<

Chapter 3 Text Content

151

Endnote Body
The <text:entnote-boty< eaement is deiined as ioaaots:
rg i nt T<text:entnote-boty<

RrT 9To oT<!ELEMENT text:entnote-boty %inline-text;<

4cm Fieads
OpenOiiiiecorg te.t doiSments or OpenOiiiiecorg te.t iontent embedded in other types oi doiSments ian iontainrariabae te.t eaements iaaaed iieadsc There are sereraa diiierent types oi iieads eaih oi thiih impaements adiiierent type oi rariabae te.t eaementc Fieads are most iommonay Ssed ior:•

Page nSmbers
page nSmber iiead dispaays the nSmber oi the page it appears onc This iiead is SseiSa ior iootersc For erery
page on thiih the iooter appearss the iiead assSmes the iSrrent page nSmber so that aaa pages are nSmberediorreitayc•

Creation dates
ireation date iiead dispaays the date on thiih the iSrrent doiSment tas ireatedc This iiead is SseiSa ior
doiSment tempaatesc Erery doiSment ireated Ssing the tempaate iontains the date then it tas ireatedc•

NSmber ranges
nSmber range iiead aaaots the Sser to nSmber iertain eaementss ior e.ampaes images or tabaesc nSmber
range iiead dispaays its otn position in reaation to the other nSmber range iieads ior the same rangec Thereiores
ii yoS more an image and its assoiiated nSmber range iiead tithin a doiSments the iieads are aStomatiiaaay
Spdated to reiaeit the net ordercThis seition desiribes hot OpenOiiiiecorg soittare represents iieads in the X L iiae iormatc

4cmc0 Common Charaiteristiis oi Fiead Eaements
Eaih iiead type is represented by a iorresponding eaement typec iiead in a doiSment is enioded as a singae
eaement oi the appropriate typec The iontent oi the eaement is the te.tSaa representation oi the iSrrent iiead raaSe
as it is dispaayed in the OpenOiiiiecorg Sser interiaiec Thereiores ignoring aaa iiead eaements and dispaaying onay
the te.tSaa iontent oi the eaements prorides an appro.imate te.t-onay rersion oi the doiSmentc
The raaSe oi a iiead is SsSaaay stored in an attribStec t is neiessary to store the raaSe so that the presentation oi theiiead ian be reiompSted ii neiessarys ior e.ampaes ii the Sser deiides to ihange the iormatting styae oi the iieadc t
is aaso neiessary to store the presentation styae oi the eaement iontents to iaiiaitate easy proiessing oi the X L
doiSmentc For e.ampaes ii iompaete proiessing oi a iiead is impossibae or Sndesirabaes the appaiiation ian ignore
the iiead and Sse onay the iontent in this sitSationc For string raaSess ii the raaSe is identiiaa to the presentations
the raaSe attribSte is omitted to aroid dSpaiiate storage oi iniormationc
For iieads that ian store diiierent types oi iontents ior e.ampaes nSmberss stringss or datess a raaSe type is storedin addition to the aitSaa raaSec The raaSe and raaSe type attribStes are e.paained aater in eition 4cmc94c i moreiniormation is needed to restore a iieads it is stored in additionaa attribStesc
The most iommon attribStes oi iiead eaements are:●152

Fi.ed iieads
any iieads hare a rariant there the iontent does not ihange aiter the initiaa raaSe is assignedc These iieads
are generaaay marked by the attribSte text:fixetc ee eition 4cmc94 ior more iniormation on thisOpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

attribStec●

Formatting styae
ereraa iiead typess partiiSaaray those representing nSmbers dates or time datas iontain a iormatting styaec n
OpenOiiiiecorg X Ls this iormatting styae is represented by a style:tata-style-name attribStec inie
the Sser ian ihange the presentation styae ior iieadss OpenOiiiiecorg mSst be abae to reiompSte a net representation oi the iiead iontent at any timec ee eition 4cmc94 ior more iniormation on this attribStec

4cmc DoiSment Fieads
OpenOiiiiecorg Driter iieads ian dispaay iniormation aboSt the iSrrent doiSment or aboSt a speiiiii part oi the
iSrrent doiSments sSih as the aSthors the iSrrent page nSmbers or the doiSment ireation datec These iieads are
ioaaeitireay reierred to as doiSment iieadsc
DoiSment iieads are oiten ii.edc iiead ian be marked ii.ed to indiiate that its iontent is preserreds rather thanre-eraaSateds then the doiSment is editedc For e.ampaes a date iiead shots the iSrrent datec i the date iiead ismarked ii.eds the raaSe oi the iiead is preserred dSring sSbseqSent edits and aatays reiaeits the originaa date on
thiih the iiead tas inserted into the doiSmentc i the iiead is not marked ii.eds its raaSe ihanges thenerer the
doiSment is editedc n the same tays the aSthor iiead ian shot the originaa aSthor or the aast aSthor oi a doiSments depending on thether the iiead is marked ii.ed or notc
The groSp oi doiSment iieads iniaSdes:●●

Date and time iieads
ender and aSthor iieads●

Page nSmber iieads●

Chapter iieads●

Fiae name iieads●

DoiSment tempaate iieads●

tatistiis iieads0

4cmc4 Date Fieads
Date iieads dispaay the iSrrent datec YoS ian adjSst the date to dispaay a date other than the iSrrent datec For
e.ampaes yoS ian ihange the date on a doiSment that tas edited aate at night so that it dispaays the date oi the
ioaaoting day or sereraa days aaterc
rg i nt T<text:tate<

RrT 9T

This eaement iontains the presentation oi the date iiead raaSes depending on the data styae
speiiiiedc The deiaSat date is the iSrrent datec YoS ian preserre the raaSe oi this eaement
Ssing the text:fixet attribSte desiribed in eition 4cmc94c

o oT<!ELEMENT text:tate (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:tate< eaement are:●Date raaSe●

Date adjSstment

0 These iieads are not iSrrentay part oi the OpenOiiiiecorg X L iiae iormatc
Chapter 3 Text Content

153

●

Fi.ed isee eition 4cmc94o●

Formatting styae isee eition 4cmc94oc The iormatting styae mSst be a date data styaes see eition c5c9 ior
more iniormationc

Date VaaSe
The text:tate-value attribSte speiiiies a partiiSaar date raaSec For e.ampaes ii the date iiead is marked
ii.eds yoS ian Sse this attribSte to speiiiy the date on thiih the iiead tas marked as ii.edc YoS ian aaso Sse this
attribSte to speiiiy a iStSre datec ome appaiiations sSpport date and time in addition to date-onay raaSess inaiiordanie tith O r620c
rg i nt T

text:tate-value

RrT 9TThe date raaSe shoSad ioniorm tith the e.tended date iormat desiribed in eition 5c c0c0
oi O r620c ee page 9 ior a pointer to O r620c i no raaSe is speiiiieds the iSrrent dateis assSmeds eren ii the iiead is marked ii.edc

o oT<!ATTLIST text:tate text:tate-value %timeInstance;tIMPLIEt<

Date djSstment
YoS ian adjSst the raaSe oi a date iiead by a iertain time periods thiih yoS speiiiy Ssing the text:tateatiust attribStec OpenOiiiiecorg Driter trSniates the speiiiied time period to a period oi iSaa days and adds itto the raaSe oi the date iieadc i the time period is negatires OpenOiiiiecorg Driter sSbtraits it irom the raaSe oi
the date iiead yieading a date beiore the iSrrent datec
rg i nt T

text:tate-atiust

RrT 9TThe raaSe oi this attribSte mSst ioniorm to the time period iormat desiribed in eition
5c5c4c oi O r620c ee page 9 ior a pointer to O r620c The raaSe ian be preieded by
an optionaa minSs sign to indiiate a negatire time dSrationc

o oT<!ATTLIST text:tate text:tate-atiust %c-turation;tIMPLIEt<

oT
1 4 un1iTu u4 un1T

CSrrentays OpenOiiiiecorg does not sSpport month or year dSrationsc

4cmc9 Time Fieads
Time iieads dispaay the iSrrent timec They are rery simiaar to the date iieads desiribed in the prerioSs seitions
sSpporting the same attribStes e.iept that ior time iieadss they are iaaaed text:time-value and text:
time-atiust attribStescrg i nt T<text:time<RrT 9T

This eaement iontains the presentation oi the time iiead raaSes depending on the data styae
speiiiiedc The deiaSat time is the iSrrent timec YoS ian preserre the raaSe oi this eaement
Ssing the text:fixet attribSte desiribed in eition 4cmc94c

o oT<!ELEMENT text:time (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:time< eaement are:●154

Time raaSe

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Time adjSstment●

Fi.ed isee eition 4cmc94o●

Formatting styae isee eition 4cmc94oc The iormatting styae mSst be a time data styaes see eition c5c5 ior
more iniormationc

Time VaaSe
The text:time-value attribSte reiords the time at thiih the doiSment tas aast editedc
rg i nt T

text:time-value

RrT 9TThe raaSe oi this attribSte mSst ioniorm tith the e.tended time iormat desiribed in eition
5c9c0 oi O r620c ee page 9 ior a pointer to O r620c i no raaSe is speiiiieds theiSrrent time is assSmeds eren ii the iiead is marked fixetc

o oT<!ATTLIST text:time text:time-value %time; tIMPLIEt<

Time djSstment
YoS ian adjSst the raaSe oi a time iiead by a iertain time periods thiih yoS speiiiy Ssing the text:timeatiust attribStec The OpenOiiiiecorg soittare trSniates the time period to a period oi iSaa minStes and adds itto theraaSe oi the time iieadc i the time period is negatires the OpenOiiiiecorg soittare sSbtraits it irom the raaSeoi the time iiead yieading a time in the pastc
rg i nt T

text:time-atiust

RrT 9TThe raaSe oi this attribSte mSst ioniorm to the time period iormat desiribed in eition
5c5c4c oi O r620c ee page 9 ior a pointer to O r620c The raaSe ian be preieded by
an optionaa minSs sign to indiiate a negatire time dSrationc Positire raaSes adjSst the time
to a time in the iStSres thiae negatire raaSes adjSst the time to a time in the pastc The dSra tion is trSniated to iSaa minStesco oT<!ATTLIST text:time text:time-atiust %c-turation;tIMPLIEt<

E 4 oT T u

i4tjr9 i4 Iu r 9i41ti r uIi ee o 9i the attribSte text:time-atiustp"PTM14"s the time iiead dispaays a time thiih is 05 minStes aater than
the aitSaa time speiiiied by the time iiead raaSec
i the attribSte text:time-atiustp"-PTm1"s the time iiead dispaays a time thiih is one hoSr beiore theaitSaa time speiiiied by the time iiead raaSec

4cmc5 Page NSmber Fieads
Page nSmber iieads dispaay the iSrrent page nSmberc These iieads are partiiSaaray SseiSa ior reiSrring iontentssSih as headers and iootersc i yoS insert a page nSmber iiead into a iooters the iSrrent page nSmber is dispaayedon erery page on thiih the iooter appearsc
rg i nt T<text:page-number<RrT 9Ti the text:page-atiust attribSte is Sseds the page nSmber oi the page at the speiiiied oiiset is dispaayeds ii it e.istsc

o oT<!ELEMENT text:page-number (tPCtATAy<
Chapter 3 Text Content

155

The attribStes that yoS ian assoiiate tith the <text:page-number< eaement are:●Page adjSstment●

Dispaay prerioSs or ioaaoting page nSmbers●

Fi.ed isee eition 4cmc94o●

Formatting styae isee eition 4cmc94o
Page nSmbers ian be iormatted aiiording to the nSmber iormat desiribed in eition c c i a nSmber styae is
not speiiiieds the page nSmbers are iormatted aiiording to the nSmber styae deiined in the iSrrent page styaec

Page djSstment
YoS ian adjSst the raaSe oi a page nSmber iiead by a speiiiied nSmbers aaaoting yoS to dispaay the page nSmbers
oi ioaaoting or preieding pagesc YoS speiiiy the adjSstment nSmber Ssing the text:page-atiust attribStec
Dhen yoS Sse this attribStes the appaiiation:
0c

dds the raaSe oi the attribSte to the iSrrent page nSmberc

c Cheiks to see ii the resSating page e.istsc
4c i the page e.istss the nSmber oi that page is dispaayedc
9c i the page does not e.ists the raaSe oi the page nSmber iiead remains empty and no nSmber is dispaayedc
rg i nt T

text:page-atiust

RrT 9To oT<!ATTLIST text:page-number text:page-atiust %integer;tIMPLIEt<

Dispaay PrerioSs or Foaaoting Page NSmbers
The text:select-page attribSte aaaots yoS to dispaay the nSmber oi the prerioSs or the ioaaoting pagerather than the nSmber oi the iSrrent pagec
rg i nt T

text:select-pageRrT 9TThe raaSe oi this attribSte ian be previouss currents or nextc

o oT<!ATTLIST text:page-number text:select-page ( previous |current | next y "current"<n T To dispaay the iSrrent page nSmber on aaa pages e.iept the iirst or aast pages yoS shoSad Sse a iombinationoi the text:select-page and text:page-atiust attribStesc
E 4 oT Tiou9oT4yu1.i r iorII 1 io4. i1r

Iin1i4TTio4. 9i o o i r ieuI9 io4.

<text:page-number text:select-pagep"previous" text:page-atiustp"1" text:
num-formatp"1"/<4cmc6 Page ContinSation Te.tn some pSbaiiationss a iontinSation reminder is printed at the bottom oi the page in addition to the page nSmberc
To iniaSde a iontinSation reminders Sse the <text:page-continuation< eaementc
156

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:page-continuation<

RrT 9To oT<!ELEMENT text:page-continuation (tPCtATAy<

The attribStes assoiiated tith the <text:page-continuation< eaement are:●●PrerioSs or ioaaoting pagetring raaSe

PrerioSs or Foaaoting Page
This attribSte speiiiies thether to iheik ior a prerioSs or ne.t page and ii the page e.istss the iontinSation te.t isprintedc
rg i nt T

text:select-pageRrT 9TThe raaSe oi this attribSte ian be previous or nextc

o oT<!ATTLIST text:page-continuation text:select-page( previous | next y teEt|IeEt<

tring VaaSe
This attribSte speiiiies the iontinSation te.t to dispaayc
rg i nt T

text:string-value

RrT 9Ti this attribSte is omitteds the eaement iontent is Ssedc

o oT<!ATTLIST text:page-continuation text:string-value CtATAtIMPLIEt<

4cmcm ender Fieads
There are sereraa iieads thiih iontain iniormation aboSt the sender oi the iSrrent doiSments ior e.ampaes nameand emaia addressc The iniormation aboSt the sender is taken irom the OpenOiiiiecorg Sser iniormation diaaogc ia sender iiead is marked ii.ed Ssing the text:fixet attribStes the originaa sender iniormation in the senderiieads is preserredc Othertises the iniormation is Spdated eaih time the iiae is editeds iaSsing the iieads to ihange
raaSe then the doiSment is edited by a diiierent Sserc

First Name
This eaement represents the iirst name oi the senderc
rg i nt T<text:senter-firstname<RrT 9To oT<!ELEMENT text:senter-firstname (tPCtATAy<<!ATTLIST text:senter-firstname text:fixet %boolean"true"<

Chapter 3 Text Content

157

Last Name
This eaement represents the aast name oi the senderc
rg i nt T<text:senter-lastname<RrT 9To oT<!ELEMENT text:senter-lastname (tPCtATAy<<!ATTLIST text:senter-lastname text:fixet %boolean "true"<

nitiaasThis eaement represents the initiaas oi the senderc
rg i nt T<text:senter-initials<

RrT 9To oT<!ELEMENT text:senter-initials (tPCtATAy<<!ATTLIST text:senter-initials text:fixet %boolean "true"<

Titae
This eaement represents the titae oi the senderc
rg i nt T<text:senter-title<RrT 9To oT<!ELEMENT text:senter-title (tPCtATAy<<!ATTLIST text:senter-title text:fixet %boolean; "true"<

Position
This eaement represents the position oi the senderc
rg i nt T<text:senter-position<

RrT 9To oT<!ELEMENT text:senter-position (tPCtATAy<<!ATTLIST text:senter-position text:fixet "true"<

Emaia ddressThis eaement represents the emaia address oi the senderc
rg i nt T<text:senter-email<RrT 9To oT

158<!ELEMENT text:senter-email (tPCtATAy<<!ATTLIST text:senter-email text:fixet "true"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Prirate Teaephone NSmber
This eaement represents the prirate teaephone nSmber oi the senderc
rg i nt T<text:senter-phone-private<

RrT 9To oT<!ELEMENT text:senter-phone-private (tPCtATAy<<!ATTLIST text:senter-phone-private text:fixet "true"<

Fa. NSmber
This eaement represents the iaisimiae nSmber oi the senderc
rg i nt T<text:senter-fax<

RrT 9To oT<!ELEMENT text:senter-fax (tPCtATAy<<!ATTLIST text:senter-fax text:fixet "true"<

Company Name
This eaement represents the name oi the iompany that empaoys the senderc
rg i nt T<text:senter-company<

RrT 9To oT<!ELEMENT text:senter-company (tPCtATAy<<!ATTLIST text:senter-company text:fixet "true"<

Oiiiie Teaephone NSmber
This eaement represents the oiiiie teaephone nSmber oi the senderc
rg i nt T<text:senter-phone-work<

RrT 9To oT<!ELEMENT text:senter-phone-work (tPCtATAy<<!ATTLIST text:senter-phone-work text:fixet "true"<

treetThis eaement represents the street name oi the address oi the senderc
rg i nt T<text:senter-street<RrT 9To oT<!ELEMENT text:senter-street (tPCtATAy<<!ATTLIST text:senter-street text:fixet "true"<

Chapter 3 Text Content

159

City
This eaement represents the iity name oi the address oi the senderc
rg i nt T<text:senter-city<

RrT 9T<!ELEMENT text:senter-city (tPCtATAy<<!ATTLIST text:senter-city text:fixet "true"<o oT

Postaa CodeThis eaement represents the postaa iode oi the address oi the senderc
rg i nt T<text:senter-postal-cote<

RrT 9T<!ELEMENT text:senter-postal-cote (tPCtATAy<<!ATTLIST text:senter-postal-cote text:fixet "true"<o oT

CoSntryThis eaement represents the ioSntry oi the address oi the senderc
rg i nt T<text:senter-country<

RrT 9T<!ELEMENT text:senter-country (tPCtATAy<<!ATTLIST text:senter-country text:fixet "true"<o oTtate or Prorinie
This eaement represents the state or prorinie oi the address oi the senders ii appaiiabaec
rg i nt T<text:senter-state-or-province<

RrT 9T
o oT

4cmcr<!ELEMENT text:senter-state-or-province (tPCtATAy<<!ATTLIST text:senter-state-or-province text:fixet true"<

Sthor Fieads

There are tto OpenOiiiiecorg X L eaements araiaabae to represent the aSthor oi a doiSmentc One eaement
dispaays the iSaa name oi the aSthor and the other eaement dispaays the initiaas oi the aSthorc
YoS ian ii. the raaSe oi aSthor iieads Ssing the text:fixet attribStec arking an aSthor iiead as ii.ed
preserres the originaa iiead iontentc Othertises the iiead iontent ihanges eaih time the doiSment is Spdateds toreiaeit the aast aSthor oi the doiSmentc

160

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Name oi the Sthor
This eaement represents the iSaa name oi the aSthorc
rg i nt T<text:author-name<RrT 9To oT<!ELEMENT text:author-name (tPCtATAy<<!ATTLIST text:author-name text:fixet "true"<

nitiaas oi the Sthor
This eaement represents the initiaas oi the aSthorc
rg i nt T<text:author-initials<

RrT 9To oT<!ELEMENT text:author-initials (tPCtATAy<<!ATTLIST text:author-initials text:fixet "true"<

4cmc Paaiehoaders
OpenOiiiiecorg Driter Sses paaiehoader iieads to indiiate aoiations in a doiSment there the Sser mSst iiaa insome iniormationc For e.ampae in a aetter tempaates yoS ian hare a seition oi the doiSment reserred ior theaddress oi the reiipientc paaiehoader iiead dispaays te.t iniorming the Sser aboSt the pSrpose oi the paaiehoader
and sometimes iniaSdes a desiriptionc Paaiehoader iieads ian represent diiierent te.t eaementss sSih as te.t or
tabaescrg i nt T<text:placeholter<

RrT 9T

This eaement iontains some briei te.t thiih is dispaayed tith the paaiehoaderco oT<!ELEMENT text:placeholter (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:placeholter< eaement are:●

Paaiehoader type●

Paaiehoader desiription

Paaiehoader Type
There are iire diiierent types oi paaiehoaders representing the iire possibae types oi iontent: te.ts tabaess te.tbo.ess imagess or objeitsc The text:placeholter-type attribSte represents the iontent typec
rg i nt T

text:placeholter-type

RrT 9T

This attribSte is mandatory and it indiiates thiih type oi te.t iontent the paaiehoader representsc The raaSe oi the attribSte ian be texts text-boxs images tables or obiectc

o oT<!ATTLIST text:placeholter text:placeholter-type ( text |table | text-box | image | obiect y teEt|IeEt<

Chapter 3 Text Content

161

Paaiehoader Desiription
n addition to the briei te.t stored in the eaement iontents yoS ian assoiiate a text:tescription attribSte
tith the paaiehoader eaementc This attribSte is optionaac The pSrpose oi the attribSte is to iontain a more eaaborate
desiription oi the pSrpose oi the paaiehoader than the desiription stored in the eaement iontentc ee eition
4cmc94 ior iniormation on Ssing the text:tescription attribSteco oT <!ATTLIST text:placeholter text:tescription %string; tIMPLIEt<

4cmc02 Database Fieads
OpenOiiiiecorg Driter doiSments ian ionneit to OpenOiiiiecorg Base databases and dispaay database iniormation as te.t iontentc To dispaay database iniormations OpenOiiiiecorg Driter Sses a groSp oi te.t iieadss ioaaeitireay iaaaed database iieadsc OpenOiiiiecorg Base ian Sse database tabaes irom oL serrerss thereiore yoS ian
Sse database iieads to aiiess any oL databases prorided that the appropriate drirers are araiaabaec
n OpenOiiiiecorg Bases a database iontains the ioaaoting iomponents:●

Tabaess thiih store the aitSaa datac●

oSeriess thiih e.trait a sSbset oi data irom one or more tabaesc●

Formss thiih present the datac●

eportss thiih sSmmarike the database iontentc

Database iorms and reports are not reaerant to X L te.t iontents thereiore they are not disiSssed in this ihapterc
From the point oi riet oi embedding database iniormation in OpenOiiiiecorg te.t doiSmentss qSeries and tabaes
are ionsidered the samec Thereiore ior the remainder oi this seitions the phrase database table reiers to both database tabaes and database qSeriesc
Erery database in OpenOiiiiecorg Base has a name and this name is Ssed by aaa oi the OpenOiiiiecorg iomponents to identiiy a databasec aa database iieads iontain a database name and most database iieads aaso iontain thename oi a database tabaes thiih mSst be stored in the named databasec n additionaa attribSte determines thether
the database tabae reiers to an oL tabaes an OpenOiiiiecorg qSerys or the resSat oi an oL iommandc
The ioaaoting entity is deiined ior database iieads:
rg i nt T%tatabase-table;

o oT<!ENTITY % tatabase-table"text:tatabase-name CtATA teEt|IeEt
text:table-name CtATA teEt|IeEt"
text:table-type (table|query|commantytIMPLIEt" <E 4 oT T<!ATTLIST tatabase-element %tatabase-table;<

Database iieads aaone do not retriere iniormation irom a databasec n addition to the database iieadss a set oi database rots is aaso added to the doiSmentc Dhen net data is added to the doiSments aaa database iieads beaonging
to the added database tabae are Spdatedc sing the OpenOiiiiecorg Sser interiaies yoS ian add database rots in
one oi the ioaaoting tays:●●

anSaaays Ssing the Beamer and the Data to Fieads iSnitionc
sing the Form Letter menS item on the Fiae menSc This menS item adds eaih rot in the ihosen data set into a
netay ireated iopy oi the iorm aetterc

To dispaay data irom a database tabae Sse the <text:tatabase-tisplay< eaementc sing the <text:
tatabase-select< and <text:tatabase-next< eaementss yoS ian determine thiih rot tithin the
162

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

iSrrent seaeition to dispaayc YoS ian dispaay the iSrrent rot nSmber ior a partiiSaar tabae Ssing the <text:
tatabase-row-number< eaementc Finaaays the <text:tatabase-name< iiead dispaays the name oi themost reientay Ssed databases thiih is the address book iiae database by deiaSatc

4cmc00 Dispaaying Database Content
The <text:tatabase-tisplay< eaement dispaays data irom a databasec Dhen a net data set is added to a
doiSments aaa iieads that dispaay data irom that database tabae Spdate their iontentc<text:tatabase-tisplay<rg i nt T
RrT 9T<!ELEMENT text:tatabase-tisplay (tPCtATAy<o oT

The attribStes that yoS ian assoiiate tith the <text:tatabase-tisplay< eaement are:●text:tatabase-names text:table-name and text:table-type
These attribStes speiiiy the database and database tabae that this iiead Ssesco oT●<!ATTLIST text:tatabase-tisplay %tatabase-table;<text:tatabase-column-nameee the seition holumn ame ior iniormation aboSt this attribStec●style:tata-style-namei the ioaSmn speiiiies a nSmeriis booaeans dates or time raaSes the data is iormatted aiiording to the appropriate data styaec i no data styae is speiiiieds the data styae assigned to this ioaSmn in OpenOiiiiecorg Base is
Ssedc ee eition 4cmc94 ior more iniormation aboSt Ssing this attribSteco oT<!ATTLIST text:tatabase-tisplay style:tata-style-name %style-name;<

CoaSmn Name
The text:column-name attribSte speiiiies the ioaSmn irom thiih to dispaay the datac
rg i nt T

text:column-name

RrT 9TThe raaSe oi this attribSte mSst be a ioaSmn iontained in the speiiiied data basec

o oT<!ATTLIST text:tatabase-tisplay text:column-name CtATA
teEt|IeEt<

4cmc0

eaeiting the Ne.t Database ot

The <text:tatabase-next< eaement ihanges the rot in the iSrrent seaeition thiih is Ssed ior dispaay in
aaa ioaaoting atext:tatabase-tisplay< iieadsc The ne.t rot irom the iSrrent seaeition is ihosen ii itsatisiies a giren ionditionc i the ne.t rot is tanted regardaess oi any ionditions the iondition may be omitted or
set to truec

Chapter 3 Text Content

163

rg i nt T

<text:tatabase-next<

RrT 9To oT<!ELEMENT text:tatabase-next EMPTY<

The attribStes that yoS ian attaih to the <text:tatabase-next< are:●text:tatabase-names text:table-name and text:table-type
These attribStes speiiiy the database and the database tabae that this iiead Ssesco oT●<!ATTLIST text:tatabase-next %tatabase-table;<text:contition
ee the seition hondition ior iniormation aboSt this attribStec

Condition
The text:contition attribSte speiiiies the iondition e.pressionc The e.pression is eraaSated and ii the resSat
interpreted as a booaean raaSe is trSes the ne.t rot is Ssed as the net iSrrent rotc Paease note that yoS ian Sse
database iiead raaSes in the e.pression by eniaosing in sqSare braiketss the database names the tabae names and the
ioaSmn names separated by dotsc
i the text:contition attribSte is not presents OpenOiiiiecorg assSmes the iormSaa trues meaning that thene.t rot is seaeited Snionditionaaayc
rg i nt T

text:contition

RrT 9To oT<!ATTLIST text:tatabase-next text:contition %formula;tIMPLIEt<

E 4 oT T
text:formulap'[attress book file.attress.FIeSTNAME] pp "Julie"'This e.ampae speiiiies a iondition that is trSe ii the iSrrent rot irom the OpenOiiiiecorg address book is theaddress ior a person named JSaiec i the iondition shotn in this e.ampae is Ssed in a <text:tatabasenext< eaements the ioaaoting happens:●

The <text:tatabase-tisplay< eaements dispaay the data irom the iirst rot oi the iSrrent seaeitionc●

i the FIeSTNAME ioaSmn oi the iSrrent rot reads Julies the iSrrent rot is ihangedc Othertises nothing
happensc●

i the iirst rot is Julies the ioaaoting <text:tatabase-tisplay< eaements dispaay data irom theseiond rotc Othertises they dispaay data irom the iirst rotc

ee eition 4cmc94 ior more iniormation on the iormSaa synta. oi a text:contition attribStes thiih is thesame as that oi the text:formula attribStec

4cmc04 eaeiting a ot NSmber
The <text:tatabase-row-select< eaement seaeits a speiiiii rot irom the iSrrent seaeitionc s tith the<text:tatabase-row-next< eaements yoS ian speiiiy a iondition so that the giren rot is onay seaeited ii

164

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

the iondition is truec
rg i nt T<text:tatabase-row-select<

RrT 9To oT<!ELEMENT text:tatabase-row-select EMPTY<

The attribStes that yoS ian assoiiate tith the <text:tatabase-row-select< are:●text:tatabase-names text:table-name and text:table-type
These attribStes determine the database and the database tabae that this iiead Ssesco oT●<!ATTLIST text:tatabase-row-select %tatabase-table;<text:contition
This attribSte speiiiies the iondition e.pressionc ee eition 4cmc0 ior a iSaa e.paanation oi hot to Sse this
attribSteco oT●<!ATTLIST text:tatabase-row-select text:contition %formula;tIMPLIEt<

text:row-number
ee the seition Telectinm tie noS umbee ior iniormation aboSt this attribStec

eaeiting the ot NSmber
This attribSte speiiiies the rot nSmber to seaeit then a iondition is truec
rg i nt T

text:row-number

RrT 9To oT<!ATTLIST text:tatabase-row-select text:row-number %integer; teEt|IeEt<

4cmc09 Dispaaying the ot NSmber
The <text:tatabase-row-number< eaement dispaays the iSrrent rot nSmber ior a giren tabaec Note thatthe eaement dispaays the aitSaa rot nSmber irom the database and not the rot nSmber oi the iSrrent seaeition thatis Ssed as an attribSte raaSe in the <text:tatabase-row-select< eaementc
rg i nt T<text:tatabase-row-number<RrT 9To oT<!ELEMENT text:tatabase-row-number (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:tatabase-row-number< are:●text:tatabase-names text:table-name and text:table-type
These attribStes determine the database and the database tabae that this iiead Ssesco oT<!ATTLIST text:tatabase-row-number %tatabase-table;
teEt|IeEt<

Chapter 3 Text Content

165

●

text:num-format and text:num-letter-sync
These attribStes determine hot the nSmber shoSad be iormattedc ee eition 4cmc0 ior more iniormation on
hot to Sse this attribSteco oT●<!ATTLIST text:tatabase-row-number %num-format; tIMPLIEt<

text:value
This attribSte speiiiies the iSrrent rot nSmberc The nSmber ihanges then net data is added to the iSrrent
doiSmentc
o oT<!ATTLIST text:tatabase-row-number text:value %integer;tIMPLIEt<

4cmc05 Dispaay CSrrent Database and Tabae
OpenOiiiiecorg keeps traik oi the aast database and tabae that tas Ssed in the doiSmentc n other tordss the tabae
that is Ssed by the aast iiead that tas inserted into the doiSmentc n the OpenOiiiiecorg Sser interiaies the database is dispaayed in the Beamerc The <text:tatabase-name< eaement dispaays the database and tabae nameoi the most reientay Ssed tabaec<text:tatabase-name<rg i nt T
RrT 9T<!ELEMENT text:tatabase-name (tPCtATAy<o oT

The attribStes that yoS ian assoiiate tith the <text:tatabase-name< eaement are:●text:tatabase-names text:table-name and text:table-type
These attribStes determine the database and the database tabae that this iiead Ssesco oT

4cmc06<!ATTLIST text:tatabase-name %tatabase-table;<etadata Fieads

etadata iieads dispaay meta iniormation aboSt the doiSments sSih ass the doiSment ireation date or the time atthiih the doiSment tas aast printedc The names oi the metadata iiead eaements iorrespond to the metadataeaements desiribed in Chapter caa metadata iiead eaements ian be marked as ii.ed Ssing the text:fixet attribStec
ereraa metadata iieads dispaay a date or a timec The eaements ior these iieads reqSire an assoiiated text:tate-value or a text:time-value attribStes and optionaaays they ian aaso hare a style:tatastyle-name attribStec ee eition 4cmc94 ior more iniormation on these attribStesc

nitiaa CreatorThis eaement represents the name oi the aSthor tho ireated the originaa doiSmentc
rg i nt T<text:initial-creator<

RrT 9T
166

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:initial-creator<o oT<!ELEMENT text:initial-creator (tPCtATAy<<!ATTLIST text:initial-creator text:fixet %boolean; "false"<

DoiSment Creation Date
This eaement represents the date on thiih the doiSment tas ireatedc
rg i nt T<text:creation-tate<

RrT 9To oT<!ELEMENT text:creation-tate (tPCtATAy<<!ATTLIST text:creation-tate
text:fixet %boolean; "false"
text:tate-value %tate; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

DoiSment Creation Time
This eaement represents the time at thiih the doiSment tas ireatedc
rg i nt T<text:creation-time<RrT 9To oT<!ELEMENT text:creation-time (tPCtATAy<<!ATTLIST text:creation-time
text:fixet %boolean; "false"
text:time-value %timeInstance; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

DoiSment Desiription
This eaement iontains a briei desiription oi the doiSmentc
rg i nt T<text:tescription<

RrT 9To oT<!ELEMENT text:tescription (tPCtATAy<<!ATTLIST text:tescription
text:fixet %boolean; "false"<

ser-Deiined DoiSment niormation
This groSp oi eaements iontains Sser-deiined iniormation aboSt the doiSmentc The iieads are not Ssed or interpreted by OpenOiiiiecorgs so the Sser may Sse these eaements ior any pSrposec
rg i nt T<text:user-tefinet<

RrT 9T

Chapter 3 Text Content

167

rg i nt T

<text:user-tefinet<o oT<!ELEMENT text:user-tefinet (tPCtATAy<<!ATTLIST text:user-tefinet
text:name %string; teEt|IeEt
text:fixet %boolean; "false"<

Print Time
This eaement represents the time at thiih the doiSment tas aast printedc
rg i nt T<text:print-time<RrT 9To oT<!ELEMENT text:print-time (tPCtATAy<<!ATTLIST text:print-time
text:fixet %boolean; "false"
text:time-value %timeInstance; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

Print Date
This eaement represents the date on thiih the doiSment tas aast printedc
rg i nt T<text:print-tate<

RrT 9To oT<!ELEMENT text:print-tate (tPCtATAy<<!ATTLIST text:print-tate
text:fixet %boolean; "false
text:tate-value %tate; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

Printed By
This eaement represents name oi the aast person tho printed the doiSmentc
rg i nt T<text:printet-by<

RrT 9To oT<!ELEMENT text:printet-by (tPCtATAy<<!ATTLIST text:printet-by
text:fixet %boolean; "false"<

DoiSment Titae
This eaement represents the titae oi the doiSmentc
rg i nt T<text:title<RrT 9T

168

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

o oT<!ELEMENT text:title (tPCtATAy<<!ATTLIST text:title
text:fixet %boolean; "false"<

DoiSment Sbjeit
This eaement represents the sSbjeit oi the doiSmentc
rg i nt T<text:subiect<RrT 9To oT<!ELEMENT text:subiect (tPCtATAy<<!ATTLIST text:subiect
text:fixet %boolean; "false"<

DoiSment 2eytords
This eaement iontains a aist oi keytords Ssed to desiribe the doiSmentc
rg i nt T<text:keyworts<

RrT 9To oT<!ELEMENT text:keyworts (tPCtATAy<<!ATTLIST text:keyworts
text:fixet %boolean; "false"<

DoiSment erision NSmber
This eaement iontains the doiSment rerision nSmberc Dhen the doiSment is ireateds the rerision nSmber is set to0c Eaih time the doiSment is sareds the doiSment rerision nSmber is inirementedc
rg i nt T<text:etiting-cycles<

RrT 9To oT<!ELEMENT text:etiting-cycles (tPCtATAy<<!ATTLIST text:etiting-cycles
text:fixet %boolean; "false"<n T inie the <text:etiting-cycles< iiead ian not be iormatteds the rerision nSmber ian be read irom
the eaement iontentc Thereiores no e.tra attribSte is neededc

DoiSment Edit DSration
Erery time a doiSment is editeds OpenOiiiiecorg reiords the dSration betteen the time the doiSment is opened
and the time the doiSment is iaosedc t then adds the dSration to an internaa ioSnters thereby keeping traik oi thetotaa time that has been spent editing the doiSmentc
rg i nt T<text:etiting-turation<

RrT 9T

Chapter 3 Text Content

169

rg i nt T

<text:etiting-turation<o oT<!ELEMENT text:etiting-turation (tPCtATAy<<!ATTLIST text:etiting-turation
text:fixet %boolean; "false"
text:turation %timeturation; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

DoiSment

odiiiiation Time

This eaement represents the time at thiih the doiSment tas aast modiiiedc
rg i nt T<text:motification-time<RrT 9To oT<!ELEMENT text:motification-time (tPCtATAy<<!ATTLIST text:motification-time
text:fixet %boolean; "false"
text:time-value %timeInstance; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

n TThis eaement dispaays the iniormation irom the <meta:tate< eaementc The
name tas ihosen to aroid ioniSsion tith <text:tate< iieadsc

DoiSment

odiiiiation Date

This eaement represents the date on thiih the doiSment tas aast modiiiedc
rg i nt T<text:motification-tate turation<

RrT 9To oT

DoiSment<!ELEMENT text:motification-tate (tPCtATAy<<!ATTLIST text:motification-tate
text:fixet %boolean; "false"
text:tate-value %tate; tIMPLIEt
style:tata-style-name %style-name; tIMPLIEt<

odiiied By

This eaement represents the name oi the person tho aast modiiied the doiSmentc
rg i nt T<text:creator<

RrT 9To oT<!ELEMENT text:creator (tPCtATAy<<!ATTLIST text:creator
text:fixet %boolean; "false"<

4cmc0m Conditionaa Te.t Fieads
Te.t iieads ian be Ssed to dispaay one te.t or anothers depending on the ionditionc Conditionaa te.t iieads are
giren a iondition and tto te.t stringsc i the iondition is trSes one oi the te.t strings is dispaayedc i the iondition
is iaases the other te.t string is dispaayedc
170

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:contitional-text<

RrT 9To oT<!ELEMENT text:contitional-text (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:contitional-text< eaement are:●Condition●

Te.t to dispaay ii the iondition is trSe●

Te.t to dispaay ii the iondition is iaase●

CSrrent iondition

The text:contition attribSte iontains a booaean e.pressionc Depending on the resSats the raaSe oi thetext:tisplay-if-true or text:tisplay-if-false attribSte is dispaayedc
rg i nt T

text:contition

RrT 9To oT<!ATTLIST text:contitional-text text:contition %formula; teEt|IeEt<

Te.t to Dispaay ii the Condition is TrSe
The text:string-value-if-true attribSte iontains the te.t string to dispaay ii the iondition is truec
rg i nt T

text:string-value-if-trueRrT 9Ti the iondition is trues the raaSe oi this attribSte is dispaayedc

o oT<!ATTLIST text:contitional-text text:string-valueif-true %string; teEt|IeEt<

Te.t to Dispaay ii the Condition is Faase
The text:string-value-if-false attribSte iontains the te.t string to dispaay ii the iondition is falsec
rg i nt T

text:string-value-if-false

RrT 9Ti the iondition eraaSates to falses the raaSe oi this attribSte is dispaayedc

o oT<!ATTLIST text:contitional-text text:string-valueif-false %string; teEt|IeEt<

CSrrent Condition
The text:current-value attribSte iontains the eraaSation resSat oi the iondition giren by the e.pression in
the text:contition attribStec E.paiiitay giring the resSat aaaots appaiiations to deaay eraaSating the resSat
Sntia neiessaryc This attribSte is raaSabae ior the ioaaoting reasons:●i the e.pression is iostay to eraaSates ior e.ampaes the e.pression iontains reierenies to sereraa databasesc●

To aaaot transiormations to iorreitay dispaay the state oi the doiSment tithoSt haring to parse and eraaSate
the ionditionc

Chapter 3 Text Content

171rg i nt T

text:current-value

RrT 9TThe raaSe oi this attribSte is orertritten tith a net raaSe as soon as the appaiiation eraaSates the e.pressionc

o oT<!ATTLIST text:contitional-text text:current-value%boolean; "false"<n T

This attribSte has no iSnition other than to ease transiormation or initiaaay
dispaay the doiSmentc

4cmc0r Oidden Te.t Fiead
The hidden te.t iiead is iaoseay reaated to the ionditionaa te.t iieadc t dispaays ii.ed te.ts e.iept then the iondition is true then it does not dispaay anythingc
rg i nt T<text:hitten-text<

RrT 9To oT<!ELEMENT text:hitten-text (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:hitten-text< eaement are:●Condition

●

Te.t

●

s hiddenCondition
The text:contition attribSte iontains a booaean e.pressionc i the e.pression eraaSates to trues the te.t ishiddencrg i nt T

text:contition

RrT 9To oT<!ATTLIST text:hitten-text text:contition %formula; teEt|IeEt<

Te.t
The text:string-value attribSte speiiiies the te.t to dispaay ii the iondition is falsec
rg i nt T

text:string-value

RrT 9TThe raaSe oi this attribSte is dispaayed ii the iondition eraaSates to falsec

o oT<!ATTLIST text:hitten-text text:string-value %formula; teEt|IeEt<

s Oidden
The text:is-hitten attribSte speiiiies thether or not the iiead is iSrrentay risibaec The pSrpose oi this
attribSte is simiaar to that oi the text:current-value attribSte in the text:contition iieadc eiording
172

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

the resSat aaaots transiormations to iorreitay represent the doiSment tithoSt haring to parse the ionditione.pression or eraaSate the iondition then aoading the doiSmentc
rg i nt T

text:is-hitten

RrT 9TThe raaSe oi this attribSte is orertritten tith a net raaSe as soon as the appaiiation eraaSates the e.pressionc

o oT<!ATTLIST text:hitten-text text:is-hitten %boolean; "false"<n T

This attribSte has no iSnition other than to ease transiormation or initiaaay
dispaay the doiSmentc

4cmc0 Oidden Paragraph Fieads
The hidden paragraph iiead has a simiaar iSnition to the hidden te.t iieadc Ooterers the hidden paragraph iiead
does not hare any iontentc t hides the paragraph in thiih it is iontainedc This aaaots yoS to hide or dispaay aparagraph oi iormatted te.ts depending on thether a iondition is true or falsec
Oidden paragraph iieads are oiten Ssed together tith iorm aettersc For e.ampaes ii a iondition depends on a database iieads a hidden paragraph iiead ian be Ssed to seaeitireay iniaSde paragraphs in the iorm aetter depending on
the database iontentc Satipae paragraph iieads ian be iontained one paragraphc The paragraph is dispaayed ii theiondition assoiiated tith at aeast one hidden paragraph iiead is falsec aternatireays yoS ian iombine the ionditions assoiiated tith sereraa hidden paragraph iieads into a singae iondition ior a singae iiead Ssing aogiiaa operations on the ionditionsc
rg i nt T<text:hitten-paragraph<

RrT 9To oT
n T<!ELEMENT text:hitten-paragraph EMPTY<
naike most iieadss this iiead does not dispaay te.ts bSt it aiieits the entire para graph in thiih it is iontainedc

The attribStes that yoS ian assoiiate tith the <text:hitten-paragraph< eaement are:●Condition●s hiddenCondition
The text:contition attribSte iontains a booaean e.pressionc
rg i nt T

text:contition

RrT 9Ti the iondition is trues the paragraph is hiddenc i the iondition is falses
the paragraph is dispaayedc

o oT<!ATTLIST text:hitten-paragraph text:contition %formula; teEt|IeEt<

s Oidden
The text:is-hitten attribSte reiords thether the paragraph is iSrrentay risibae or notc t has the same
pSrpose as the iorresponding attribSte oi the hidden te.t iieads nameay to aaaot iorreit dispaay oi the paragraph
Chapter 3 Text Content

173

tithoSt haring to eraaSate the iondition iirstc
rg i nt T

text:is-hitten

RrT 9TThe raaSe oi this attribSte is orertritten tith a net raaSe as soon as the appaiiation eraaSates the e.pressionc

o oT<!ATTLIST text:hitten-paragraph text:is-hitten %boolean; "false"<n T

This attribSte has no iSnition other than to ease transiormation or initiaaay
dispaay the doiSmentc

4cmc 2 Chapter Fieads
Chapter iieads dispaay one oi the ioaaoting:●

The name oi the iSrrent ihapter●

The nSmber oi the iSrrent ihapter●

Both the name and nSmber oi the iSrrent ihapter

i the ihapter iiead is paaied inside a header or iooters it dispaays the iSrrent ihapter name or nSmber on ererypagec
rg i nt T<text:chapter<

RrT 9To oT<!ELEMENT text:chapter (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:chapter< eaement are:●

Dispaay●

OStaine aerea

Dispaay
The text:tisplay attribSte speiiiies the iniormation that the ihapter iiead shoSad dispaayc
rg i nt T

text:tisplay

RrT 9To oT<!ATTLIST text:chapter text:tisplay ( name |number | number-ant-name | plain-number-ant-name |plain-number y "number-ant-name"<oT
1 4 un1
u u 4 un1Tn the iSrrent rersion oi the OpenOiiiiecorg Driter Sser interiaies plainnumber-ant-name ihapter iieads are not sSpportedc

E 4 oT T i the iSrrent ihapter nSmber is c9s the ihapter titae is Dorking tith Tabaess the preii. is ts and sSiii.
is Ts the possibae dispaay options and resSats are as ioaaots:

174

h4Tr ineiValVe of texi4 Iu r

u Ttion1 1 itu9oT4y t

number

t c9T

name

Dorking tith Tabaes

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

h4Tr ineiValVe of texi4 Iu r

u Ttion1 1 itu9oT4y t

number-ant-namet c9T Dorking tith Tabaes

plain-number

c9plain-number-ant-name

c9 Dorking tith Tabaes

OStaine Lerea
This attribSte aaaots yoS to speiiiy the oStaine aerea to Ssec The ihapter iiead dispaays the ihapter nSmber or titae
Sp to the speiiiied oStaine aereac
rg i nt T

text:outline-level

RrT 9To oT<!ATTLIST text:chapter text:outline-level %
integer; "1"<n T

OpenOiiiiecorg Driter iSrrentay sSpports Sp to ten oStaine aereasc

4cmc 0 Fiae Name Fieads
Fiae name iieads dispaay the name oi the iiae that is iSrrentay being editedc
rg i nt T<text:file-name<RrT 9To oT<!ELEMENT text:file-name (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:file-name< eaement are:●

Dispaay●

Fi.ed

Dispaay
The text:tisplay attribSte speiiiies hot mSih oi the iiae name to dispaayc YoS ian ihoose thether todispaay:●

The iSaa iiae name iniaSding the path and the e.tension●

The iiae path onay●

The iiae name onay●

The iiae name and the e.tension

rg i nt T

text:tisplay

RrT 9To oT<!ATTLIST text:file-name text:tisplay ( full |path | name | name-ant-extension y "full"<

Chapter 3 Text Content

175

Fi.ed Fiae Name Fieads
i a iiae name iiead is ii.eds its raaSe does not ihange then the iiae is editedc
rg i nt T

text:fixet

RrT 9T<!ATTLIST text:file-name text:fixet %boolean;"false"<

o oT

4cmc

DoiSment Tempaate Name Fieads

The doiSment tempaate name iiead dispaays iniormation aboSt the doiSment tempaate in Sses sSih as the tempaate
titae or the iiae namec
rg i nt T<text:template-name<RrT 9To oT<!ELEMENT text:template-name (tPCtATAy<

The attribSte that yoS ian assoiiate tith the <text:template-name< eaement is:●

Dispaay

DispaayThis attribSte speiiiies thiih iniormation aboSt the doiSment tempaate to dispaayc YoS ian ihoose to dispaay:●

The iSaa iiae name iniaSding the path and the e.tension●

The iiae path onay●

The iiae name onay●

The iiae name and the e.tension●

The titae●

The area oi the doiSment tempaate

The aatter tto raaSes are Ssed in the OpenOiiiiecorg Driter Sser interiaie doiSment tempaate diaaogc The dispaay
raaSes are a sSperset oi the dispaay raaSes araiaabae ior the <text:file-name< eaementc
rg i nt T

text:tisplay

RrT 9To oT<!ATTLIST text:template-name text:tisplay ( full |path | name | name-ant-extension | area | title y"full"<

4cmc 4 Page Variabae Fieads
Page rariabaes aaaot yoS to deiine an aaternatire page nSmbering sihemec There is onay one page rariabaes and it
is set by any set page rariabae iiead in the doiSmentc The raaSe oi the page rariabae is inireased on eaih pages in

176

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

the same tay as regSaar page nSmbersc

etting Page Variabae Fieads
To set a page rariabae iieads yoS Sse the <text:set-page-variable< eaementc
rg i nt T<text:set-page-variable<

RrT 9To oT<!ELEMENT text:set-page-variable EMPTY<

TSrning Page Variabaes On or Oii
t the beginning oi a doiSments the page rariabae is inaitirec YoS ian Sse the text:active attribSte todisabae a page rariabae aiter it tas Ssed in the doiSmentc
rg i nt T

text:active

RrT 9To oT<!ATTLIST text:set-page-variable text:active %boolean; "true"<

Page Variabae djSstment
The text:page-atiust attribSte determines the page adjSstmentc The raaSe oi the aitire page rariabae is theiSrrent page nSmber paSs the iaosest page adjSstment raaSe that tas prerioSsay setc
rg i nt T

text:page-atiust

RrT 9To oT<!ATTLIST text:set-page-variable text:page-atiust%integer; "0"<Dispaaying Page Variabae Fieads
The <text:get-page-variable< eaement dispaays the raaSe oi the page rariabaec The iiead ian be
iormatted in the same tay as regSaar page nSmber iieadsc
rg i nt T<text:get-page-variable<

RrT 9To oT<!ELEMENT text:get-page-variable (tPCtATAy<

The attribStes that yoS ian assoiiate tith the <text:get-page-variable< eaement are:●text:num-format and text:num-letter-sync
These attribStes determine hot the nSmber shoSad be iormattedc ee eition 4cmc0 ior more iniormation on
hot to Sse these attribStesco oT<!ATTLIST text:get-page-variable %num-format; tIMPLIEt<

Chapter 3 Text Content

177

4cmc 9airo Fieads

The mairo iiead iontains the name oi a mairo that is e.eiSted then the iiead is aitiratedc The iiead aaso iontains
a desiription that is dispaayed as the iiead iontentc
rg i nt T<text:execute-macro<

RrT 9To oT<!ELEMENT text:execute-macro (tPCtATAy<

The attribSte that yoS ian assoiiate tith the <text:execute-macro< eaement is:●airo nameairo Name
The text:name attribSte speiiiies the mairo to inroke then the iiead is aitiratedc
rg i nt T

text:nameRrT 9To oT<!ATTLIST text:execute-macro text:name %string;teEt|IeEt<

4cmc 5 DDE Conneitions
Dynamii Data E.ihange iDDEo ionneition ionsists oi the parameters ior the DDE target appaiiations a iiae
names and a iommand stringc DDE ionneition aaso takes a parameter that speiiiies thether it tiaa be Spdated
aStomatiiaaay or onay on the Sser's reqSestc Erery DDE ionneition mSst be namedc

Container ior DDE Conneition Deiaarations
The DDE ionneition deiaarations are iontained in one deiaarations eaementc
rg i nt T<text:tte-connection-tecls<

RrT 9To oT<!ELEMENT text:tte-connections-tecls (text:
tte-connection-teclya<

Deiaaring DDE Conneitions
Erery DDE ionneition is deiaared Ssing a deiaaration eaementc Satipae DDE iieads ian reier to one DDE
ionneition by Ssing the same namec The deiaaration eaement has no iontentc
rg i nt T<text:tte-connection-tecl<

RrT 9To oT<!ELEMENT text:tte-connections-tecl

EMPTY<

The attribStes that yoS ian assoiiate tith the <text:tte-connection-tecl< eaement are:178

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Conneition name●

DDE target appaiiation●

DDE target iiae name●

DDE iommand●

Stomatii Spdate iaag

Conneition Name
The text:name attribSte speiiiies the name by thiih the ionneition tiaa be reierredc
rg i nt T

text:nameRrT 9To oT<!ATTLIST text:tte-connection-tecl text:name %string; teEt|IeEt<

Target ppaiiation
The text:tte-application attribSte speiiiies the name oi the target appaiiation to Sse ior the DDE
ionneitionc
rg i nt T

text:tte-application

RrT 9To oT
n T<!ATTLIST text:tte-connection-tecl text:tteapplication %string; teEt|IeEt<
The target name ior OpenOiiiiecorg is sofficec Thereiores internaa DDE
ainks hare the attribSte text:tte-applicationp"soffice"cTarget Topii
The text:tte-topic attribSte speiiiies the name oi the topii to Sse ior the DDE ionneitionc
rg i nt T

text:tte-topic

RrT 9To oT<!ATTLIST text:tte-connection-tecl text:tte-topic%string; teEt|IeEt<n T

i the target appaiiation is OpenOiiiiecorgs it interprets the DDE topii as thename oi the iiaec

Target tem
The text:tte-item attribSte speiiiies thiih iniormation the target appaiiation shoSad deairerc
rg i nt T

text:tte-item

RrT 9T

Chapter 3 Text Content

179

o oT

<!ATTLIST text:tte-connection-tecl text:tte-item %string; teEt|IeEt<n T

i the target appaiiation ior the DDE ionneition is OpenOiiiiecorg Driters theitem represents the name oi a bookmarkc OpenOiiiiecorg deairers the iSrrent
te.t iontent to the reqSesting appaiiationc

Stomatii pdate
OpenOiiiiecorg Driter ian aStomatiiaaay Spdate DDE ainksc i preierreds yoS ian Sse the text:automaticuptate attribSte to speiiiy that the DDE ionneition ainks shoSad onay be Spdated at the reqSest oi the Sserc
rg i nt T

text:automatic-uptate

RrT 9Ti the raaSe oi this attribSte is trues the DDE ainks are aStomatiiaaay Spdatedc
i this raaSe oi this attribSte is falses the DDE ainks are Spdated on Sser
reqSest onayc

o oT<!ATTLIST text:tte-connection-tecl text:automaticuptate %boolean; "false"<

4cmc 6 DDE Conneition Fieads
DDE iiead aaaots yoS to dispaay iniormation irom a DDE ionneitionc The onay parameter reqSired ior the DDE
iiead is the name oi the DDE ionneition that sSppaies the data to this iieadc This DDE ionneition eaement speiiiies the aitSaa DDE iiead that appears in the te.t bodyc
rg i nt T<text:tte-connection<

RrT 9To oT<!ELEMENT text:tte-connection (tPCtATAy<

The attribSte that yoS ian assoiiate tith the <text:tte-connection< eaement is:●

DDE ionneition name

DDE Conneition Name
The text:name attribSte speiiiies the name oi the DDE ionneition to thiih the iiead reiersc
rg i nt T

text:nameRrT 9To oT

4cmc m<!ATTLIST text:tte-connection text:name %string;teEt|IeEt<

eierenie Fieads

OpenOiiiiecorg Driter Sses iire types oi reierenie iiead and eaih type is represented by its otn eaementc The
reierenie iiead types are based on the type oi eaement they reier to; iootnotess endnotess bookmarkss reiereniess
and seqSeniesc Erery reierenie iontains a reierenie iormat thiih determines that iniormation aboSt the reierenied target is dispaayedc For e.ampaes reierenies ian dispaay:

180

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●

The page nSmber oi the reierenied target●

The ihapter nSmber oi the reierenied target●

Dording indiiating thether the reierenied target is abore or beaot the reierenie iiead

n additions eaih reierenie iiead mSst identiiy its target thiih is SsSaaay done Ssing a name attribStec Bookmarks
and reierenies are identiiied by the name oi the respeitire bookmark or reiereniec Footnotess endnotess andseqSenies are identiiied by a name that is SsSaaay generated aStomatiiaaay then a doiSment is e.portedc
rg i nt T<text:reference-ref<<text:sequence-ref<<text:bookmark-ref<<text:footnote-ref<<text:entnote-ref<RrT 9To oT<!ELEMENT text:reference-ref (tPCtATAy<<!ELEMENT text:sequence-ref (tPCtATAy<<!ELEMENT text:bookmark-ref (tPCtATAy<<!ELEMENT text:footnote-ref (tPCtATAy<<!ELEMENT text:entnote-ref (tPCtATAy<

The attribStes that yoS ian assoiiate tith the reierenie iiead eaements are:●eierenie name●eierenie iormat

eierenie Name
The text:ref-name attribSte identiiies the reierenied eaementc inie bookmarks and reierenies hare a names
this name is Ssed by the respeitire reierenie iieadsc Footnotess endnotess and seqSenies are assigned names by theappaiiation Ssed to ireate the OpenOiiiiecorg X L iiae iormat then the doiSment is e.portedc
rg i nt T

text:ref-name

RrT 9To oT<!ATTLIST text:reference-ref text:ref-name %string; teEt|IeEt<

eierenie Format
The text:reference-format attribSte determines that iniormation aboSt the reierenie is dispaayedc
rg i nt T

text:reference-format

Chapter 3 Text Content

181

RrT 9T

aa types oi reierenie iieads sSpport the ioaaoting raaSes ior this attribSte
iormats:●

pages thiih dispaays the nSmber oi the page on thiih the reierenied
item appearsc●

chapters thiih dispaays the nSmber oi the ihapter in thiih the reierenied item appearsc●

tirections thiih dispaays thether the reierenied item is abore or
beaot the reierenie iieadc●

texts thiih dispaays the te.t oi the reierenied itemc

i the reierenie iormat is not speiiiieds the page iormat is Ssed as the deiaSatc
eierenies to seqSenie iieads sSpport the ioaaoting three additionaa raaSes:

o oT

●

category-ant-values thiih dispaays the name and raaSe oi theseqSeniec●

captions thiih dispaays the iaption in thiih the seqSenie is Ssedc●

values thiih dispaays the raaSe oi the seqSeniec<!ATTLIST text:reference-ref text:reference-format(page|chapter|text|tirectiony tIMPLIEt<<!ATTLIST text:footnote-ref text:reference-format(page|chapter|text|tirectiony tIMPLIEt<<!ATTLIST text:entnote-ref text:reference-format(page|chapter|text|tirectiony tIMPLIEt<<!ATTLIST text:bookmark-ref text:reference-format(page|chapter|text|tirectiony tIMPLIEt<<!ATTLIST text:sequence-ref text:reference-format(page|chapter|text|tirection|category-ant-value|
caption|valuey tIMPLIEt<

E 4 oT Tiouee I 1 iI e I 1o ienI 4 9i41titu9oT4y9
The ioaaoting tabae shots aaa possibae reierenie iormats and the resSating reierenie dispaay that ian be Ssed toreier to the tabae itseaic The aeit ioaSmn aists the raaSe oi the text:reference-format attribSte and theright ioaSmnTable 2T bla leE am lemele re mal aeE

182

R e I 1o ienI 4

R e I 1o itu9oT4y

page

0r

chapter

4cmc mtext

Tabae : E.ampaes oi reierenie iormats

tirection

abore

category-ant-value

Tabae 0

captionE.ampaes oi reierenie iormats

value

0

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4cmc r Variabae Fieads
OpenOiiiiecorg Driter doiSments ian iontain rariabaess thiih are proiessed or dispaayed Ssing rariabae iieadsc
rariabae is a namesraaSe pairc The rariabae name is Ssed throSghoSt the doiSment to identiiy a partiiSaar rariabaes and thereiore rariabae names iannot be reSsed ior diiierent types oi rariabaesc ost rariabae iieads sSpport
diiierent raaSe typess sSih as nSmberss datess stringss and so onc n the OpenOiiiiecorg X L iiae iormats a rariabae mSst be deiaared at the beginning oi a doiSmentc
There are three types oi rariabaes in OpenOiiiiecorg Driter:●

hu oT iv4Iu4 T 9
impae rariabaess SsSaaay iaaaed rariabaess ian take diiierent raaSes at diiierent positions throSghoSt a doiSmentc YoS set simpae rariabaes Ssing either setter or inpSt iieadsc etter iieads iontain an e.pressions thiih is
Ssed to iompSte the net raaSe oi the rariabaec npSt iieads prompt the Sser ior the net raaSec YoS ian Sse
simpae rariabaes to dispaay diiierent te.t in reiSrring eaementss sSih as headers or iootersc●

9 Iiv4Iu4 T 9
ser rariabaes hare the same raaSe throSghoSt a doiSmentc i a Sser rariabae is set anythere tithin the doiSments aaa iieads in the doiSment that dispaay the Sser rariabae hare the same raaSec n the OpenOiiiiecorg Sserinteriaies yoS ian set a Sser rariabae at any oiiSrrenie oi a Sser iieads or Ssing Sser rariabae inpSt iieadsc n
the OpenOiiiiecorg X L iiae iormats yoS ian onay set the raaSe oi the Sser rariabae aiter the rariabae isdeiaaredc●

h r 1o iv4Iu4 T 9
eqSenie rariabaes are Ssed to nSmber iertain items in an OpenOiiiiecorg Driter doiSments ior e.ampaes
images or tabaesc

E.pression and te.t inpSt iieads are aaso rariabae iieadss bSt they are not assoiiated tith any partiiSaar rariabaesc
inie their iSnitionaaity is iaoseay reaated to that oi the rariabae iieadss they are aaso desiribed in this seition oi
the manSaac
rg i nt T%variable-fielts;

RrT 9T<!ENTITY % variable-fielts"text:variable-set | text:variable-get | text:variableinput | text:user-fielt-get | text:user-fielt-input |text:sequence | text:expression | text:text-input" <o oT

YoS mSst deiaare rariabaes beiore yoS ian Sse themc The rariabae deiaarations are ioaaeited in iontainer eaements
ior the partiiSaar rariabae typec The OpenOiiiiecorg X L iode ior deiaaring rariabaes is desiribed in the
ioaaoting tabaec
rg i nt T%variable-teclarations;RrT 9T
o oT

4cmc<!ELEMENT text:variable-tecls "text:variable-tecla"<<!ELEMENT text:user-fielt-tecls "text:user-fielt-tecla"<<!ELEMENT text:sequence-tecls "text:sequence-tecla"<<!ENTITY % variable-teclarations "text:variable-tecl?, text:
user-fielt-tecl?, text:sequence-tecl?<

Deiaaring impae Variabaes

YoS deiaare simpae rariabaes Ssing <text:variable-tecl< eaementsc The deiaaration speiiiies the name
Chapter 3 Text Content

183

and the raaSe type oi the rariabaec
rg i nt T<text:variable-tecl<

RrT 9T

This eaement does not hare any iontentc

o oT<!ELEMENT text:variable-tecl EMPTY<

To speiiiy the name and raaSe type oi the simpae rariabaes yoS attaih the ioaaoting attribStes to the <text:
variable-tecl< eaement:●

text:name
The name oi the rariabae mSst be SniqSec The name iannot aaready be Ssed ior any other type oi rariabaec eeeition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-tecl text:name %variable-name;teEt|IeEt<

text:value-type
ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT<!ATTLIST text:variable-tecl %value-type-attlist;<

4cmc42 etting impae Variabaes
YoS ian set simpae rariabaes Ssing rariabae setter eaementsc
rg i nt T<text:variable-set<

RrT 9T

This eaement iontains the presentation oi the raaSe oi the rariabaes thiih ian be empty ii
the text:tisplay attribSte is set to noneco oT<!ELEMENT text:variable-set (tPCtATAy<

The attribStes that yoS ian attaih to the <text:variable-set< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae to setc t mSst matih the name oi a rariabae that has aareadybeen deiaaredc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-set text:name %variable-name;<

text:formulaThis attribSte iontains the iormSaa to iompSte the raaSe oi the rariabae iieadc i the iormSaa eqSaas the iontent
oi the iiead eaements yoS ian omit this attribStec ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-set text:formula %formula;<

text:value-type and the appropriate raaSe attribSte
ee eition 4cmc94 ior iniormation on Ssing these attribStescn T simpae rariabae shoSad not iontain diiierent raaSe types at diiierent paaies in a doiSmentc Ooterers
the iSrrent OpenOiiiiecorg soittare impaementation aaaots the Sse oi diiierent raaSe types ior diiierent
instanies oi the same rariabaec n the iase oi the nSmerii raaSe types floats percentage, andcurrencys the raaSe is aStomatiiaaay ionrerted to the diiierent raaSe typec For raaSe types that are stored

184

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

internaaay as nSmberss sSih as tates time, and boolean typess the raaSes are reinterpreted as nSmbers oi
the respeitire typesc i a rariabae is Ssed ior both string and non-string typess the beharior is Sndeiineds thereiore this praitiie is not reiommendedc
o oT●<!ATTLIST text:variable-set %value-attlist;<

text:tisplay
YoS ian Sse this attribSte to speiiiy thether or not to dispaay the raaSe oi the <text:variable-set<
eaementc i the text:tisplay attribSte is set to values the raaSe oi the rariabae is dispaayedc i theattribSte is set to nones the raaSe is not dispaayedc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-set text:tisplay ( value | none y"value"<style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT<!ATTLIST text:variable-set style:tata-style-name %stylename; tIMPLIEt<

4cmc40 Dispaaying impae Variabaes
The <text:variable-get< eaement reads and dispaays the raaSe oi a simpae rariabaec
rg i nt T<text:variable-get<RrT 9TThe raaSe oi this eaement is the raaSe oi the aast preieding <text:variable-set<
eaement tith an identiiaa text:name attribStec The eaement determines hot the raaSe oi
the rariabae is presenteds in aiiordanie tith the ihosen iormatting styaeco oT<!ELEMENT text:variable-get (tPCtATAy<

The attribStes that yoS ian attaih to the atext:variable-get< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae to dispaayc The name mSst matih the name oi a preieding<text:variable-tecl< eaementc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-get text:name %variable-name;teEt|IeEt<

text:tisplay
YoS ian Sse this attribSte to speiiiy thether to dispaay the iormSaa ior a simpae rariabae or the iompSted
raaSe oi the rariabaec ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-get text:tisplay ( value |formula y "value"<style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribStec

Chapter 3 Text Content

185

o oT

4cmc4

<!ATTLIST text:variable-get style:tata-style-name %style-name;tIMPLIEt<

impae Variabae npSt Fieads

s an aaternatire to setting simpae rariabaes Ssing iormSaas in rariabae setter iieadss the Sser ian be prompted ior
rariabae raaSesc To do thiss yoS Sse the <text:variable-input< eaementc
rg i nt T<text:variable-input<

RrT 9T

This eaement iontains the presentation oi the rariabae's raaSe aiiording to the ihosen
iormatting styaec
The presentation ian be empty ii the text:tisplay attribSte is set to nonec

n T<!ELEMENT text:variable-input (tPCtATAy<o oT

The attribStes that yoS ian attaih to the <text:variable-input< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae to dispaayc t mSst matih the name oi a rariabae that tas
aaready deiaaredc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-input text:name %variable-name;teEt|IeEt<

text:tescription
This optionaa attribSte iontains a briei message that is presented to Ssers then they are prompted ior inpStc
The message shoSad gire Ssers enoSgh iniormation aboSt the rariabae or the Sse oi the raaSe tithin the doiSment to enabae them to ihoose an appropriate raaSec ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-input text:tescription %string:tIMPLIEt<

text:value-type and the appropriate raaSe attribSte
ee eition 4cmc94 ior iniormation on Ssing these attribStesco oT●<!ATTLIST text:variable-input %value-attlist;<

text:tisplay
YoS ian Sse this attribSte to speiiiy thether to dispaay or hide the raaSe oi the rariabae throSgh the rariabae
inpSt iieadc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:variable-input text:tisplay ( value | none y"value"<style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribStec
o oT

186

<!ATTLIST text:variable-input style:tata-style-name %stylename; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4cmc44 Deiaaring ser Variabaes
ser rariabaes iontain raaSes that are dispaayed Ssing appropriate iieadsc naike simpae rariabaess Sser rariabaes
hare the same raaSe throSghoSt a doiSment beiaSse the raaSe oi the Sser rariabae is speiiiied in the rariabae
deiaarationc
rg i nt T<text:user-fielt-tecl<

RrT 9T

This eaement does not hare any iontentc

o oT<!ELEMENT text:user-fielt-tecl EMPTY<

The attribStes that yoS ian assoiiate tith the <text:user-fielt-tecl< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae that yoS tant to deiaarec The name mSst be SniqSec t iannot
aaready be Ssed ior any other type oi rariabae iniaSding simpae and seqSenie rariabaesc ee eition 4cmc94 ior
iniormation on Ssing this attribSteco oT●<!ATTLIST text:user-fielt-tecl text:name %variable-name;teEt|IeEt<

text:formulaThis attribSte iontains the iormSaa to iompSte the raaSe oi the Sser rariabae iieadc i the iormSaa is the same as
the iontent oi the iiead eaements yoS ian omit this attribStec ee eition 4cmc94 ior iniormation on Ssing this
attribSteco oT●<!ATTLIST text:user-fielt-tecl text:formula %formula;tIMPLIEt<

text:value-type and the appropriate raaSe attribSte
ee eition 4cmc94 ior iniormation on Ssing these attribStesco oT<!ATTLIST text:user-fielt-tecl %value-attlist;<

4cmc49 Dispaaying ser Variabaes
YoS ian dispaay the iontent oi Sser rariabaes Ssing <text:user-fielt-get< eaementsc<text:user-fielt-get<rg i nt T
RrT 9T<!ELEMENT text:user-fielt-get (tPCtATAy<o oT

The attribStes that yoS ian attaih to the <text:user-fielt-get< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae to dispaayc The name mSst matih the name oi a preieding<text:user-fielt-tecl< eaementc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:user-fielt-get text:name %variable-name;teEt|IeEt<

text:tisplay
Chapter 3 Text Content

187

YoS ian Sse this attribSte to speiiiy thether to:➢

Dispaay the iormSaa Ssed to iompSte the raaSe oi the Sser rariabaec➢

Dispaay the raaSe oi the Sser rariabaec➢

Oide the Sser rariabae iieadsc

ee eition 4cmc94 ior iniormation on Ssing this attribStecn T inie the OpenOiiiiecorg Driter Sser interiaie aaaots Ssers to edit a Sser iiead rariabae by iaiiking on
any Sser iieads a hidden <text:user-fielt-get< eaement ian be Ssed as an anihor to aaaot easy aiiess
to a partiiSaar Sser iiead rariabaec
o oT●<!ATTLIST text:user-fielt-get text:tisplay ( value | formula| none y "value"<style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT

4cmc45<!ATTLIST text:user-fielt-get style:tata-style-name %stylename;<ser Variabae npSt Fieads

n aaternatire method oi setting Sser rariabaes is to Sse inpSt iieadss simiaar to the inpSt iieads ior simpae rariabaesc YoS ian set a Sser rariabae in this tay Ssing the <text:user-fielt-input< eaementc inie theraaSe oi a Sser iiead rariabae is stored in the <text:user-fielt-tecl< eaements the atext:userfielt-input< eaement does not iontain the raaSe and raaSe type attribStes irom the atext:variableinput< iieadc
rg i nt T<text:user-fielt-input<

RrT 9T

This eaement determines hot the raaSe oi the Sser rariabae is dispaayeds in aiiordanie tith
the ihosen iormatting styaec
The presentation ian be empty ii the text:tisplay attribSte is set to nonec

n T<!ELEMENT text:user-fielt-input (tPCtATAy<o oT

The attribStes that yoS ian attaih to the <text:user-fielt-input< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae to setc t mSst matih the name oi a rariabae that has aareadybeen deiaaredc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:user-fielt-input text:name %variable-name;teEt|IeEt<

text:tescription
This optionaa attribSte iontains a briei message that is presented to Ssers then they are prompted ior inpStc
The message shoSad gire Ssers enoSgh iniormation aboSt the rariabae or the Sse oi the raaSe tithin the doiSments to enabae them to ihoose an appropriate raaSec ee eition 4cmc94 ior iniormation on Ssing this
attribStec

188

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

o oT

●

<!ATTLIST text:user-fielt-input text:tescription %string;tIMPLIEt<

style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT<!ATTLIST text:user-fielt-input style:tata-style-name %style-name; tIMPLIEt<

4cmc46 Deiaaring eqSenie Variabaes
eqSenie rariabaes are Ssed to nSmber items tithin an OpenOiiiiecorg Driter doiSmentc eqSenie rariabaes aremost iommonay Ssed ior seqSentiaa nSmberingc Ooterers yoS ian iniaSde e.pression iormSaas in seqSenie iieads
to sSpport more adranied seqSeniesc ee eition 4cmc4m ior more iniormation on Ssing seqSenie iieads and their
Ssesc
YoS deiaare seqSenie rariabaes Ssing the <text:sequence-tecl< eaementc
rg i nt T<text:sequence-tecl<

RrT 9T

This eaement does not hare any iontentc

o oT<!ELEMENT text:sequence-tecl EMPTY<

To iaiiaitate ihapter-speiiiii nSmberings yoS ian attaih attribStes ior the ihapter aerea and a separation iharaiter
to a seqSenie rariabaec The attribStes that yoS ian attaih to the <text:sequence-tecl< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae that yoS tant to deiaarec The name mSst be SniqSec t iannot
aaready be Ssed ior any other type oi rariabae iniaSding simpae and Sser rariabaesc ee eition 4cmc94 ior
iniormation on Ssing this attribSteco oT●<!ATTLIST text:sequence-tecl text:name %variable-name;teEt|IeEt<

text:tisplay-outline-level
ee the seition Sutline secel ior iniormation aboSt this attribStec●

text:separation-characteree the seition Tepaeation hiaeactee ior iniormation aboSt this attribStec

OStaine Lerea
YoS ian nSmber seqSenies by ihapterc To Sse this ieatSres Sse the text:tisplay-outline-level
attribSte to speiiiy an oStaine aerea that determines thiih ihapters to reierenie ior the ihapter-speiiiii
nSmberingc aa ihapters that are at or beaot the speiiiied oStaine aerea reset the raaSe oi the seqSenie to keros thedeiaSat raaSec asos the ihapter nSmber oi the aast ihapter at or beaot the speiiiied oStaine aerea is prepended tothe seqSenie nSmberc Choosing an oStaine aerea oi kero resSats in a straight seqSenie oi aaa seqSenie eaements iorthat seqSenie rariabaec
rg i nt T

text:tisplay-outline-level

Chapter 3 Text Content

189

The raaSe oi this attribSte mSst be an integer greater than or eqSaa to keroc

RrT 9T

OpenOiiiiecorg iSrrentay sSpports ten oStaine aereasc<!ATTLIST text:sequence-tecl text:tisplay-outline-level %
integer; "0"<o oTeparation Charaiteri yoS nSmber seqSenies by ihapters Sse this attribSte to ihoose a iharaiter to separate the ihapter nSmber irom
the seqSenie nSmberc
rg i nt T

text:separation-character

RrT 9Ti the raaSe oi the text:tisplay-outline-level attribSte is a non-kero raaSes yoS
mSst speiiiy a separation iharaiterc Othertises ii the raaSe oi text:tisplayoutline-level is keros yoS mSst omit this attribSteco oT<!ATTLIST text:sequence-tecl text:separation-character %character; "."<

E 4 oT Tih r 1o iv4Iu4 T
The seqSenie rariabae 4cmc46*5 tith a raaSe oi 4 is deiaared Ssing:
A Iu rh4Tr

text:tisplay-outline-level3

text:separation-charactert

4cmc4msing eqSenie Fieads

Onie a seqSenie rariabae is deiaareds yoS ian Sse it in seqSenie iieads throSghoSt the doiSmentc ost seqSenie
iieads simpay inirement and dispaay the seqSenie rariabaec Ooterers seqSenie iieads ian aaso assSme a net start
raaSe at any giren position in a doiSmentc This start raaSe is iompSted Ssing a iormSaa thiih is iontained in the
seqSenie iieadc i a seqSenie iiead tithoSt a start raaSe is added to the OpenOiiiiecorg Sser interiaies the
OpenOiiiiecorg soittare aStomatiiaaay inserts an e.pression oi the type variablet1c
eqSenie iieads are most iommonay Ssed ior simpae ioSnting seqSeniesc Ooterers the abiaity to proride arbitrarye.pressions sSpports more iompae. seqSeniesc To iorm a seqSenie oi eren nSmberss aaa seqSenie eaements iorthat partiiSaar rariabae need to iontain a iormSaa inirementing the raaSe by ttos ior e.ampaes variablet2c
seqSenie tith a starting raaSe oi 1 and aaa sSbseqSent eaements Ssing the iormSaa variablea2 yieads aaa
poters oi ttoc inie diiierent seqSenie eaements ior the same seqSenie rariabae may iontain diiierent iormSaass
iompae. seqSenies may be ionstrSitedc
rg i nt T<text:sequence<

RrT 9To oT<!ELEMENT text:sequence (tPCtATAy<

The attribStes that yoS ian attaih to the <text:sequence< eaement are:●text:name
This attribSte speiiiies the name oi the rariabae that the iiead is to dispaayc t mSst matih the name oi a
seqSenie rariabae that tas aaready deiaaredc ee eition 4cmc94 ior iniormation on Ssing this attribStec

190

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

o oT
●

<!ATTLIST text:sequence text:name %variable-name; teEt|IeEt<

text:formulaThis optionaa attribSte iontains a iormSaa to iompSte the raaSe oi the seqSenie iieadc i this attribSte isomitteds an e.pression iontaining the iontent oi the eaement is Ssedc ee eition 4cmc94 ior iniormation on
Ssing this attribSteco oT●<!ATTLIST text:sequence text:formula %formula; tIMPLIEt<

style:num-format and style:num-letter-sync
These attribStes speiiiy the nSmbering styae to Ssec i a nSmbering styae is not speiiiieds the nSmbering styae
is inherited irom the page styaec ee eition 4cmc94 ior iniormation on these attribStesco oT●<!ATTLIST text:page-number %num-format;<text:ref-nameee the ioaaoting seition nefeeence ame ior more iniormation aboSt this attribStec

eierenie NameeqSenie iieads ian be the target oi reiereniess as impaemented Ssing reierenie iieadsc ee eition 4cmc m ior
more iniormation aboSt reierenie iieadsc To enabae a reierenie iiead to identiiy a partiiSaar seqSenie iieads the
seqSenie iiead mSst iontain an additionaa attribSte iontaining a namec No tto seqSenie iieads ian hare the samereierenie namec
rg i nt T

text:ref-name

RrT 9Ti the seqSenie iiead is not the target oi a reierenies this attribSte ian beomittedc

o oT<!ATTLIST text:ref-name %string; tIMPLIEt<

4cmc4r E.pression Fieads
E.pression iieads iontain e.pressions that are eraaSated and the resSating raaSe is dispaayedc The raaSe oi thee.pression is iormatted aiiording to the ihosen iormatting styaec<text:expression<

rg i nt T
RrT 9T<!ELEMENT text:expression (tPCtATAy<o oT

The attribStes that yoS ian attaih to the <text:expression< eaement are:●text:formulaThis attribSte iontains the aitSaa e.pression Ssed to iompSte the raaSe oi the e.pression iieadc ee eition
4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:expression text:formula %formula; tIMPLIEt<

text:value-type and the appropriate raaSe attribSte
ee eition 4cmc94 ior iniormation on Ssing these attribStesc
Chapter 3 Text Content

191

<!ATTLIST text:expression %value-type;<o oT●

text:tisplay
se this attribSte to speiiiy one oi the ioaaoting:●

To dispaay the raaSe oi the iieadc●

To dispaay the iormSaa Ssed to iompSte the raaSec

ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT●<!ATTLIST text:expression text:tisplay ( value | formula y"value"<style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribSteco oT<!ATTLIST text:expression style:tata-style-name %style-name;tIMPLIEt<

4cmc4 Te.t npSt Fieads
te.t inpSt iiead is a rariabae iieadc From the point oi riet oi the OpenOiiiiecorg Sser interiaies a te.t inpSt iiead
is simiaar to the atext:variable-input< and atext:user-fielt-input< iieadsc Ooterers the te.t
inpSt iiead does not ihange the raaSe oi any rariabaesc
rg i nt T<text:text-input<

RrT 9To oT<!ELEMENT text:text-input (tPCtATAy<

The attribSte that yoS ian attaih to the <text:text-input< eaement is:●

text:tescription
This attribSte iontains a briei message that is presented to Ssers then they are prompted ior inpStc The
message shoSad gire Ssers enoSgh iniormation aboSt the pSrpose oi the iiead and hot it is Ssed tithin the
doiSments to enabae them to ihoose an appropriate raaSec ee eition 4cmc94 ior iniormation on Ssing this
attribSteco oT<!ATTLIST text:text-input text:tescription %string;tIMPLIEt<

4cmc92 iript Fieads
siript iiead stores siripts or seitions oi siriptscYoS ian Sse the iiead to store and edit siripts that are attaihed tothe doiSmentc The primary pSrpose oi this iiead is to proride an eqSiraaent to the <script< eaement in OT Ls
so that the iontent oi a <script< eaement in OT L ian be importeds editeds and e.ported Ssing the
OpenOiiiiecorg soittarec
The soSrie iode ior the siript ian be stored in one oi the ioaaoting tays:●

192

The <text:script< eaement iontains the soSrie iodec

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●The soSrie iode is stored in an e.ternaa iiaec se the text:href attribSte to speiiiy the aoiation oi thesoSrie iiaec

rg i nt T<text:script<

RrT 9T

The eaement shoSad hare either a text:href attribSte or iontents bSt not bothco oT<!ELEMENT text:script (tPCtATAy<

iript

L

The text:href attribSte speiiiies the aoiation oi the iiae that iontains the siript soSrie iodec
rg i nt T

text:href

RrT 9T

The siript iiead shoSad hare either ano oT<!ATTLIST text:script text:href CtATA<

L attribSte or iontents bSt not bothc

iript LangSage
The script:language attribSte speiiiies the aangSage in thiih the siript soSrie iode is trittens ior e.ampaes
Jara iriptc
script:language

rg i nt T
RrT 9T<!ATTLIST text:script script:language CtATA<o oT

4cmc90easSre Fieads

rnfoemation to be supplied.

4cmc9 Tabae FormSaa Fiead
The tabae iormSaa iiead is a aegaiy irom prerioSs rersion oi tarDriterc t shoSad not be Ssed in net doiSmentsc
t stores a iormSaa to eb Ssed in tabaess a iSnition that is better periormed by the tabae:iormSaa attribSte oi thetabae ieaac
rg i nt T<text:table-formula<RrT 9T

This eaement shoSad not be Ssed in net doiSmentso oT<!ELEMENT text:table-formula (tPCtATAy<

The tabae iormSaa iiead ian take the ioaaoting attribStes:●

text:formulaThis attribSte iontains the aitSaa e.pression Ssed to iompSte the raaSe oi the tabae iormSaa iieadc ee eition
4cmc94 ior iniormation on Ssing this attribSteco oT<!ATTLIST text:table-formula text:formula %formula;tIMPLIEt<
Chapter 3 Text Content

193

●

text:tisplay
se this attribSte to speiiiy one oi the ioaaoting:●

To dispaay the raaSe oi the iieadc●

To dispaay the iormSaa Ssed to iompSte the raaSec

ee eition 4cmc94 ior iniormation on Ssing this attribStec<!ATTLIST text:table-formula text:tisplay ( value |formula y "value"<

o oT

●

style:tata-style-nameThis attribSte speiiiies the data styae to Sse to iormat a nSmeriis booaeans or datestime rariabaec i a data styae
is not speiiiieds a standard data styae is Ssedc ee eition 4cmc94 ior iniormation on Ssing this attribStec<!ATTLIST text:table-formula style:tata-style-name %stylename; tIMPLIEt<

o oT

4cmc94 Common Fiead ttribStes
YoS ian Sse the attribStes desiribed in this seition tith sereraa iiead eaementsc

Variabae VaaSe Types and VaaSes
Variabaes and most rariabae iieads hare a iSrrent raaSec Erery rariabae has a raaSe type that mSst be speiiiied
then the iiead sSpports mSatipae raaSe typesc The raaSe type is speiiiied Ssing the text:value-typeattribStec
rg i nt T

text:value-type

RrT 9T

This attribSte mSst speiiiy one oi the ioaaoting raaSe types ior the rariabae: floats
percentages currencys tates times booleans or stringc

o oT<!ENTITY % value-type-attlist"text:value-type ( float | time | tate |percentage | currency | boolean | string yteEt|IeEt"<
This entity shoSad be Ssed tithin any <!ATTLIST< deiinitions ior text:value-typeattribStescn T

E 4 oT T<!ELEMENT some-element (tPCtATAy<<!ATTLIST some-element %value-type-attlist<
Depending on the raaSe types the raaSe itseai is tritten to diiierent raaSe attribStesc The sSpported raaSe typess
their respeitire raaSe attribStess and hot the raaSes are enioded are desiribed in the ioaaoting tabae:

194

h4Tr inei
ValVe et atVx ah4Tr iA Iu r

E1ont ti49iii

floats percentage

text:value

NSmerii raaSe

currency

text:value and text:
currency

NSmerii raaSe andiSrreniy symboa

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

h4Tr inei
ValVe et atVx ah4Tr iA Iu r

E1ont ti49iii

tate

text:tate-value

Desiribed in O
r620s b5c c0c0s
e.tended iormat

time

text:time-value

Desiribed in O
r620s b5c9c0 aos
e.tended iormat

booleantext:boolean-value

true or false
strings

stringtext:string-value

tringsThe OpenOiiiiecorg Driter ioniept oi iiead raaSes and raaSe types and their enioding in X L is modeaed on theiorresponding X L ior tabae ieaa attribStesc ee eition 9crc0 ior more detaiaed iniormation on these attribStesc
The deiinition oi the entity %value-attlist; is as ioaaots:
o oT<!ENTITY % value-attlist"%value-type-attlist;
text:value %float; tIMPLIEt
text:tate-value %tate; tIMPLIEt
text:time-value %time; tIMPLIEt
text:boolean-value %boolean; tIMPLIEt
text:string-value %string; tIMPLIEt
text:currency CtATA tIMPLIEt" <E 4 oT T<!ELEMENT some-element (tPCtATAy<<!ATTLIST some-element %value-attlist;<

This entity is SseiSa ior deiining aaa raaSe and raaSe type reaated attribStes ior any eaementc

Fi.ed
The text:fixet attribSte speiiiies thether or not the raaSe oi a iiead eaement is ii.edc i the raaSe oi a iiead isii.eds the originaa raaSe oi the iiead is preserredc i the raaSe oi the iiead is not ii.eds the raaSe oi the iiead is
repaaied by a net raaSe then the doiSment is editedc
This attribSte ian be Ssed tith:●

Date iieads●

Time iieads●

Page nSmber iieads●

aa sender iieads●

aa aSthor iieads

rg i nt T

text:fixet

RrT 9Ti the raaSe oi this attribSte is set to trues the raaSe oi the iiead eaement to thiih this
attribSte is attaihed is preserred in aaa iStSre edits oi the doiSmentc
i the raaSe oi this attribSte is set to falses the raaSe oi the iiead eaement is not preserred
and tiaa be repaaied tith net raaSes as appropriatec

h4 oT io oT<!ATTLIST text:author-name text:fixet %boolean; "true"<

Chapter 3 Text Content

195Variabae Namese the text:name attribSte to speiiiy the name oi a rariabae then yoS are deiaarings settings or dispaaying a
rariabaec YoS ian Sse this attribSte tith any oi the ioaaoting eaements:●<text:variable-tecl<●<text:variable-set<●<text:variable-get<●<text:variable-input<●<text:user-fielt-tecl<●<text:user-fielt-get<●<text:user-fielt-input<●<text:sequence-tecl<●<text:sequence<rg i nt T

text:nameRrT 9T

Dhen yoS are Ssing this attribSte to speiiiy the name oi a rariabae to dispaays a rariabae oi
the appropriate type tith the same name mSst aaready hare been deiaaredc

h4 oT io oT<!ATTLIST text:sequence text:name %variable-name;teEt|IeEt<

Desiription
The text:tescription attribSte iontains a briei message that is dispaayed then Ssers are prompted ior
inpStc YoS ian Sse this attribSte tith any oi the ioaaoting eaements:●<text:placeholter<●<text:variable-input<●<text:user-fielt-input<●<text:text-input<

rg i nt T

text:tescription

RrT 9T

The optionaa text:tescription attribSte may iontain a briei desiriptionc

h4 oT io oT<!ATTLIST text:text-input text:tescription %string;tIMPLIEt<

Dispaay
The text:tisplay attribSte sSpports Sp to three raaSes as ioaaots:

196

●

value
This raaSe dispaays the raaSe oi the iieadc ome iieads do not sSpport this raaSec n these iasess the text:
tisplay attribSte onay takes the raaSes value or nones and value or formulas respeitireayc●

formulaThis raaSe aaaots yoS to dispaay the iormSaa rather than the raaSe oi the iieadc ome iieads do not sSpport thisOpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

raaSec n these iasess the text:tisplay attribSte onay takes the raaSes value or nones and value or
formulas respeitireayc●

none
ereraa rariabae iieads sSpport this raaSes thiih hides the iiead iontentc This aaaots yoS to set rariabaes in one
part oi the doiSment and dispaay them in another part oi the doiSmentc

YoS ian Sse this attribSte tith any oi the ioaaoting eaements:●<text:variable-set<●<text:variable-get<●<text:variable-input<●<text:user-fielt-get<●<text:expression<

rg i nt T

text:tisplay

RrT 9Ti the raaSe oi this attribSte is values the raaSe oi the iiead is dispaayedc i the raaSe isformulas the iormSaa e.pression Ssed to iompSte the raaSe is dispaayedc Othertises theiiead is not be dispaayedc

h4 oT io oT<!ATTLIST text:user-fielt-get text:tisplay ( value |formula | none y "value"<

FormSaa
The text:formula attribSte iontains the iormSaa or e.pression Ssed to iompSte the raaSe oi the iieadc YoS
ian Sse this attribSte tith any oi the ioaaoting eaements:●<text:variable-set<●<text:user-fielt-tecl<●<text:sequence<●<text:expression<

rg i nt T

text:formula

RrT 9T
h4 oT io oT<!ATTLIST text:expression text:formula %formula;teEt|IeEt<

Formatting tyae
The style:tata-style-name attribSte reiers to the data styae Ssed to iormat the nSmerii raaSec For generaa
iniormation aboSt styaess see Chapter 0c For more iniormation aboSt data styaess see Chapter c
YoS ian Sse this attribSte tith any oi the ioaaoting eaements:●<text:tate<●<text:time<●<text:page-number<

Chapter 3 Text Content

197

●

<text:variable-set<●<text:variable-get<●<text:variable-input<●<text:user-fielt-get<●<text:user-fielt-input<●<text:expression<

rg i nt T

style:tata-style-name

RrT 9TFor string rariabaes yoS mSst omit this attribStec Othertises this attribSte is reqSiredc
The name mSst matih the name oi a data styaec<!ATTLIST text:expression style:tata-style-name %stylename; tIMPLIEt<

h4 oT io oT

NSmber Formatting tyae
YoS ian iormat nSmbers that are Ssed ior nSmber seqSenies sSih as page nSmbers or seqSenie iieads aiiording
to the nSmber styaes desiribed in Chapter c The nSmber styaes sSpported are as ioaaots:●

NSmerii: 0s s 4s ccc●

aphabetii: as bs is ccc or s Bs Cs ccc●

oman: is iis iiis irs ccc or s s

s Vscccrg i nt T

text:num-format

RrT 9TThe raaSe oi this attribSte ian be any oi the X L nSmber iormat keys 1s is Is as or Ac

h4 oT io oT<!ATTLIST some-element text:num-format CtATA tIMPLIEt<

aphabetii nSmber styaes need an additionaa attribSte to determine hot to dispaay nSmbers that iannot be represented by a singae aetterc The OpenOiiiiecorg soittare sSpports:●●ynihroniked aetter nSmberings there aetters are Ssed mSatipae timess ior e.ampae aas bbs iis and so onc
Non-synihroniked aetter nSmberings ior e.ampae aas abs ais and so onc
ee Chapter

rg i nt T

ior more iniormationc
text:num-letter-sync

RrT 9T
h4 oT io oT<!ATTLIST some-element text:num-letter-sync %boolean;"false"<

The ioaaoting entity aids the deiinition oi eaements that Sse nSmber iormats:198

rg i nt T%num-format;

h4 oT io oT<!ENTITY % num-format 'text:num-format CtATA tIMPLIEt
text:num-letter-sync %boolean; "false"'<E 4 oT T<!ELEMENT some-element %num-format;<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4cr Frames in Te.t DoiSments
irame anihor ionsists oi the ioaaoting tto parts:●

nihor typeThe anihor type speiiiies hot a irame is boSnd to the te.t doiSmentc●

nihor position
The anihor position is the point at thiih a irame is boSnd to a te.t doiSmentc For e.ampaes ii a irame is
boSnd to a pages the anihor position is the page nSmberc

4crc0

nihor TypeThe anihor type attribSte speiiiies hot a irame is boSnd to the te.t doiSmentc
rg i nt T

text:anchor-type

RrT 9T

This attribSte has to be attaihed to erery irame eaements ior e.ampaes erery <text:text-box<
that is iontained in a te.t doiSmentc t ian aaso be attaihed to graphii styaess in this iase it speii iies the deiaSat anihor type ior erery irame that is inserted into a doiSment Ssing the graphii
styaeco oT<!ATTLIST style:properties text:anchor-type (page|frame|
paragraph|char|as-chary tIMPLIEt<

4crc

nihor Position

The anihor position is the point at thiih a irame is boSnd to a te.t doiSmentc The anihor position depends on the
anihor type as e.paained in the ioaaoting tabaec
ei r iv4Tr inei r
ValVee valut
Vx ai4 Iu r iu9iiii

r i41ornIion9u un1iu9iii

r ieI4i T

1 i4oo 4I9iiii

n 9

page

The page that has the same
Either
The physiiaa page
physiiaa page nSmber as thenSmber is the nSmbert the start oi the doiSment assigned to the page ii
raaSe oi the text:anchor- ●bodys oStside any paragraph aaa pages in the doiSpage-number attribSte that is
or irames prorided ament are ioSnted
attaihed to the irame eaementc i
text:anchor-page- starting tith page 0c
no text:anchor-pagenumber attribSte is girenc
number attribSte is girens the
anihor position is the page atOrthiih the iharaiter behind theirame eaement appearsc●
nside any paragrapheaement that is not iontainedin a headers iooters iootnotesor te.t bo.s ii a text:

anchor-page-number
attribSte is not girenc

frame

The parent irame that the iSrrent n the eaement representing the CSrrentays irames ianirame eaement is iontained incirame to thiih the irame isonay be boSnd to te.t
boSndc For e.ampaes ii an image bo.esc
is boSnd to a te.t bo.s the irame
eaement is aoiated in the te.tbo. eaementc
Chapter 3 Text Content

199

ei r iv4Tr inei r
ValVee valut
Vx ai4 Iu r iu9iiii

r i41ornIion9u un1iu9iii

r ieI4i T

1 i4oo 4I9iiii

paragraph

The paragraph that the iSrrent
irame eaement is iontained inct the start oi the paragrapheaementc

char

The iharaiter aiter the irame
eaementc

JSst beiore the iharaiterc

as-charThere is no anihor positionc Thet the position there the iharirame behares aike a iharaiterc aiter appears in the doiSmentc

n 9

Oorikontaa and Vertiiaa aignment
The ioaaoting tabaes dispaay the possibae raaSes oi the attribStes style:horivontal-poss style:horivontal-rels style:vertical-poss and style:vertical-rels depending on the anihor type oi theiramec The possibae raaSes oi these aaignment attribStes are aisted in the iirst ioaSmn on the aeits and an aaignment
attribSte raaSesanihor type raaSe matih is indiiated by an Xc
h4Tr ineifVxtae
aluoel Vett lf
anyh4Tr ineifVxtae
aluoel Vettuat

h4Tr ineiValVee valutVx a
o4.

eI4

o4I4.I4or

or4I

X

X

X

X

h4Tr ineiValVee valutVx a
o4.

eI4

o4I4.I4or

or4I

page

X

X

X

page-iontent

X

X

X

page-start-margin

X

X

X

page-end-margin

X

X

X

paragraph

X

X

paragraph-iontent

XX

paragraph-start-margin

X

X

paragraph-end-margin

X

X

irame

X

irame-iontent

X

irame-start-margin

X

irame-end-margin

X

ihar

h4Tr ineifVxtae
auVovett lf
any

200

49-or4I

49-or4I

X

h4Tr ineiValVee valutVx a
o4.

eI4

o4I4.I4or

or4I

49-or4I

X

X

X

X

X

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

h4Tr ineifVxtae
auVovettuat

h4Tr ineiValVee valutVx apageparagraphcharparagraph

X

X

paragraph-iontent

X

X

page

X

page-iontent

X

frame

irame

X

irame-iontent

X

ihar

X

as-char

X

aine

X

baseaine

X

te.t

X

n T X L and OT L sSpport rery iet oi the iombinations oi anihor types rertiiaashorikontaa aaignments andtrap mode that OpenOiiiiecorg sSpportsc

4crc4

nihor Page NSmber

The text:anchor-page-number attribSte speiiiies the physiiaa page nSmber oi an anihor ii the irame is
boSnd to a pagec
rg i nt T

text:anchor-page-number

RrT 9To oT

4c<!ATTLIST style:properties text:anchor-page-number %number;tIMPLIEt<

Sby
Sby is additionaa te.t that is dispaayed abore or beaot some base te.tc The pSrpose oi rSby is to annotate thebase te.t or proride iniormation aboSt its pronSniiationc
rg i nt T<text:ruby<RrT 9T

This eaement ian be iontained anythere tithin a paragraphc t iontains to sSb eaementss one ior
the base and one ior the rSby te.tc

o oT<!ELEMENT text:ruby (text:ruby-base,text:ruby-texty<

The attribStes that yoS ian assoiiate tith the <text:ruby< eaement are:●Sby styae●

Sby te.t iormatting properties

There are tto eaements that ian be iontained in the <text:ruby< eaement:●

Sby base●

Sby te.t

Chapter 3 Text Content

201

Sby tyaerSby styae speiiiies hot the rSby te.t is dispaayed reaatire to the base te.tc t is represented by a <style:style< eaement those iamiay is rubyc The rSby styae is assigned to the rSby eaement Ssing a text:stylename attribStec
text:style-namerg i nt T
RrT 9T<!ATTLIST text:ruby text:style-name %styleName; tIMPLIEt<

o oT

Sby Te.t Formatting Properties
aa oi the rSby te.t is dispaayed Ssing the same iormatting propertiesc The style:style-name attribSte is
Ssed to speiiiy these propertiesc
rg i nt T

style:style-name

RrT 9T

This attribSte reierenies a te.t styae that is Ssed to dispaay the rSby te.tc

o oT<!ATTLIST text:ruby-text %styleName;<

Rr yi n9u un1
This property speiiiies the position oi the rSby te.t reaatire to the rSby basec
rg i nt T

style:ruby-position

RrT 9TThe raaSe oi this property ian be above or belowc

o oT<!ATTLIST style:properties style:ruby-position (above|belowy
tIMPLIEt<

Rr yiATu.1

1

This property speiiiies the aaignment oi the rSby te.t reaatire to the rSby basec
rg i nt T

style:ruby-alignRrT 9TThe raaSe oi this property ian be lefts centers rights tistribute-letters ortistribute-spacec

o oT<!ATTLIST style:properties style:ruby-align (left|center|right|tistribute-letter|tistribute-spacey tIMPLIEt<

4c c0

Sby Base

The <text:ruby-base< eaement iontains the te.t that is to be annotatedc

202

rg i nt T<text:ruby-base <RrT 9T

This eaement ian iontain any iontentc

o oT<!ELEMENT text:ruby-base (%inline-text;|tPCtATAy<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c c

Sby Te.t

The <text:ruby-text < eaement iontains the annotationc
rg i nt T<text:ruby-text <RrT 9To oT<!ELEMENT text:ruby-text (tPCtATAy<

4c02 Te.t Formatting Properties
YoS ian appay te.t iormatting properties to te.t portionss paragraphss and paragraph styaesc

4c02c0 Font Variant
se this property to stitih the option to dispaay te.t as smaaa iapitaaiked aetters on or oiic
rg i nt T

fo:font-variant iX L propertyo

RrT 9To oT<!ATTLIST style:properties fo:font-variant (normal|small-capsy
tIMPLIEt<

oT
1 4 un1
Tu u 4 un1Tt presents the fo:font-variant and fo:text-transform properties are mStSaaay
e.iaSsirec i both properties are attaihed to an item set eaement simSataneoSsays the resSat is Sndeiined e.iept that the fo:text-transform raaSe is none and the fo:font-variant
raaSe is normalc

4c02c Te.t Transiormations
se this property to desiribe te.t transiormations to Spperiases aoteriases and iapitaaikationc
rg i nt T

fo:text-transform iX L propertyo

RrT 9To oT<!ATTLIST style:properties fo:text-transform(none|lowercase|uppercase|capitalivey tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents the fo:font-variant and fo:text-transform properties are mStSaaay
e.iaSsirec i both properties are attaihed to an item set eaement simSataneoSsays the resSat is Sndeiined e.iept that the fo:text-transform raaSe is none and the fo:font-variant
raaSe is normalc

4c02c4 Coaor
se this property to speiiiy the ioregroSnd ioaor oi te.tc

Chapter 3 Text Content

203

rg i nt T

fo:color iX L propertyo

RrT 9To oT<!ENTITY % color "CtATA"<<!ATTLIST style:properties fo:color %color; tIMPLIEt<

4c02c9 Dindot Font Coaor
se this property to speiiiy thether or not the tindot ioregroSnd ioaor shoSad be as Ssed as the ioregroSnd
ioaor ior a aight baikgroSnd ioaor and thite ior a dark baikgroSnd ioaorc
rg i nt T

style:use-wintow-font-color

RrT 9To oT<!ATTLIST style:properties style:use-wintow-font-color %boolean; tIMPLIEt<

4c02c5 Te.t OStaine
se this property to speiiiy thether to dispaay an oStaine oi te.t or the te.t itseaic

rg i nt T

style:text-outline

RrT 9T

This attribSte ian hare a raaSe oi true or falsec

o oT<!ATTLIST style:properties style:text-outline %boolean;tIMPLIEt<

n T

X L does not hare a iorresponding propertyc

4c02c6 Crossing OSt
se this property to speiiiy the styae to Sse then irossing oSt te.tc
rg i nt T

style:text-crossing-out

RrT 9TThe raaSe oi this attribSte is the irossing oSt styae ior the te.tc

o oT<!ATTLIST style:properties style:text-crossing-out(none|single-line|touble-line|thick-line|slash|Xy
tIMPLIEt<

n T

X L does not sSpport this propertys bSt the raaSes none and single-line iorrespond to theraaSes none and unterline ior the X L fo:text-tecoration propertyc

4c02cm Te.t Position
se this iormatting property to speiiiy thether te.t is positioned abore or beaot the baseaine and to speiiiy thereaatire iont height that is Ssed ior this te.tc

204

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:text-position

RrT 9T

This attribSte ian hare one or tto raaSesc
The iirst raaSe mSst be present and speiiiies the rertiiaa te.t position as a perientage that reaates
to the iSrrent iont height or it takes one oi the raaSes sub or superc Negatire perientages or the
sub raaSe paaie the te.t beaot the baseainec Positire perientages or the super raaSe paaie thete.t abore the baseainec i sub or super is speiiiieds the appaiiation ian ihoose an appropriate
te.t positionc
The seiond raaSe is optionaa and speiiiies the iont height as a perientage that reaates to theiSrrent iont-heightc i this raaSe is not speiiiieds an appropriate iont height is Ssedc athoSgh thisraaSe may ihange the iont height that is dispaayeds it nerer ihanges the iSrrent iont height that is
Ssed ior additionaa iaaiSaationsc

o oT<!ATTLIST style:properties style:text-position CtATA tIMPLIEt<

n T

The eiieit oi Ssing this property is the same as the eiieit aihiered by Ssing the X L properties
fo:vertical-align and fo:font-sivec This representation is not appropriate beiaSse
the fo:font-sive property is Ssed to ihange the iont height tithoSt ihanging its positionc

4c02cr Font Namese these properties to assign a iont to the te.tc
rg i nt T

style:font-namestyle:font-name-asianstyle:font-name-complex

RrT 9TThe raaSes oi these attribStes iorm the name oi a iont that is deiaared by a <style:fonttecl< eaement tithin the <office:font-tecls< eaementc
The style:font-name-asian attribSte is eraaSated ior N CODE iharaiters that are CJ2iharaitersc
The style:font-name-complex attribSte is eraaSated ior N CODE iharaiters that areiompae. te.t aayoSt iCTLo iharaitersc
The style:font-name attribSte is eraaSated ior any other N CODE iharaiterc

o oT<!ATTLIST style:properties fo:font-name %string; tIMPLIEt<<!ATTLIST style:properties fo:font-name-asian %string;tIMPLIEt<<!ATTLIST style:properties fo:font-name-complex %string;tIMPLIEt<

4c02c Font Famiay
se these properties to speiiiy the iont iamiay ior the te.tc

Chapter 3 Text Content

205

rg i nt T

fo:font-family iX L propertyo
style:font-family-asianstyle:font-family-complex

RrT 9TYoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iont indiridSaaayc Ooterers it is adrisabae toSse the style:font-name attribStes
insteadc
ee eition 4c02cr ior iniormation aboSt then asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ATTLIST style:properties fo:font-family %string; tIMPLIEt<<!ATTLIST style:properties fo:font-family-asian %string;tIMPLIEt<<!ATTLIST style:properties fo:font-family-complex %string;tIMPLIEt<

4c02c02 Font Famiay Generii
se these properties to speiiiy a generii iont iamiay namec
rg i nt T

style:font-family-genericstyle:font-family-generic-asianstyle:font-family-generic-complex

RrT 9T

These properties are ignored ii there is no iorresponding fo:font-family property attaihed
to the same properties eaementc
YoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iontc Ooterers it is adrisabae to Sse the style:font-name attribSte insteadc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ENTITY % fontFamilyGeneric "(roman|swiss|motern|tecorative|
script|systemy"<<!ATTLIST style:properties style:font-family-generic%fontFamilyGeneric; tIMPLIEt<<!ATTLIST style:properties style:font-family-generic-asian%fontFamilyGeneric; tIMPLIEt<<!ATTLIST style:properties style:font-family-generic-complex%fontFamilyGeneric; tIMPLIEt<

4c02c00 Font tyaese these properties to speiiiy a iont styae namec

206

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:font-style-namestyle:font-style-name-asianstyle:font-style-name-complex

RrT 9T

These properties are ignored ii there is no iorresponding fo:font-family property attaihed
to the same properties eaementc
YoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iontc Ooterers it is adrisabae to Sse the style:font-name attribSte insteadc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ATTLIST style:properties style:font-style-name %string;tIMPLIEt<<!ATTLIST style:properties style:font-style-name-asian %string; tIMPLIEt<<!ATTLIST style:properties style:font-style-name-complex %string; tIMPLIEt<n T

X L does not sSpport this propertyc

4c02c0 Font Pitih
se these properties to speiiiy thether a iont has a ii.ed or rariabae tidthc
rg i nt T

style:font-pitch
style:font-pitchgv
style:font-pitch-complex

RrT 9T

These properties are ignored ii there is no iorresponding fo:font-family property attaihed
to the same properties eaementc
YoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iontc Ooterers it is adrisabae to Sse the style:font-name attribSte insteadc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT

n T

<!ENTITY % fontPitch "(fixet|variabley"<<!ATTLIST style:properties style:font-pitch %fontPitch;tIMPLIEt<<!ATTLIST style:properties style:font-pitch-asian %fontPitch;tIMPLIEt<<!ATTLIST style:properties style:font-pitch-complex %fontPitch; tIMPLIEt<
X L does not sSpport this propertyc

4c02c04 Font Charaiter etse these properties to speiiiy the iharaiter set oi a iontc

Chapter 3 Text Content

207

rg i nt T

style:font-charset
style:font-charset-asianstyle:font-charset-complex

RrT 9TThe raaSe oi these attribStes ian be x-symbol or the iharaiter enioding in the notation
desiribed in the X L reiommendation iChapter 9c4c4s Charaiter Enioding and Entitiess http:ss
tttct4corgsT s EC-.ma*ihareniodingoc i the raaSe is x-symbols aaa iharaiters that are
dispaayed Ssing this iont mSst be iontained in the N CODE iharaiter range 2.i222 to 2.i2iic
These properties are ignored ii there is no iorresponding fo:font-family property attaihed
to the same properties eaementc
YoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iontc Ooterers it is adrisabae to Sse the style:font-name attribSte insteadc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ATTLIST style:properties style:font-charset CtATA tIMPLIEt<<!ATTLIST style:properties style:font-charset-asian CtATAtIMPLIEt<<!ATTLIST style:properties style:font-charset-complex CtATAtIMPLIEt<

4c02c09 Font ike
se these properties to speiiiy the sike oi iontc
rg i nt T

fo:font-sive iX L propertyo
fo:font-sive-asian
fo:font-sive-complex

RrT 9TThe raaSe oi these property is either an absoaSte aength or a perientagec n iontrast to X Ls
perientage raaSes ian be Ssed tithin styaes onay and reaate to the iont height oi the parent styaerather than to the iont height oi the attribStes neighborhoodc bsoaSte iont heights sSih as
metiums larges x-larges and so ons and reaatire iont heights sSih as smallers andlarger are not sSpportedc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT

4c02c05<!ENTITY % length_or_percentage "CtATA"<<!ATTLIST style:properties fo:font-sive %length_or_percentage;tIMPLIEt<<!ATTLIST style:properties fo:font-sive-asian %length_or_percentage; tIMPLIEt<<!ATTLIST style:properties fo:font-sive-complex %length_or_percentage; tIMPLIEt<

eaatire Font ike

se these properties to speiiiy a reaatire iont sike ihangec

208

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:font-sive-rel
style:font-sive-rel-asianstyle:font-sive-rel-complex

RrT 9T

These properties speiiiy a reaatire iont sike ihange as a aength sSih as t1pts -3ptc t iannot be
Ssed tithin aStomatii styaesc The sike ihanges reaates to the iont sike setting that appaies to theparent styae oi the styaec
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ATTLIST style:properties fo:font-sive-rel %length; tIMPLIEt<<!ATTLIST style:properties fo:font-sive-rel-asian %length;tIMPLIEt<<!ATTLIST style:properties fo:font-sive-rel-complex %length;tIMPLIEt<

4c02c06 Letter paiing
se this property to speiiiy the amoSnt oi spaie betteen aettersc
rg i nt T

fo:letter-spacing iX L propertyo

RrT 9TThe raaSe oi this property ian be normal or it ian speiiiy a aengthc

o oT<!ATTLIST style:properties fo:letter-spacing CtATA tIMPLIEt<

4c02c0m LangSage
se this property to speiiiy the aangSage oi the te.tc
rg i nt T

fo:language iX L propertyo
fo:language-asian
fo:language-complex

RrT 9TThe raaSe oi these properties ian be any oi the
opencorgsiorersiso64 achtmaoc

O 64 aangSage iodes isee http:sstttcoasis-t presents these properties are ignored ii they are not speiiiied together tith the iorresponding

fo:country propertyc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc
o oT<!ATTLIST style:properties fo:language CtATA tIMPLIEt<<!ATTLIST style:properties fo:language-asian CtATA tIMPLIEt<<!ATTLIST style:properties fo:language-complex CtATA tIMPLIEt<

4c02c0r CoSntry
se this property tith the fo:language properties to speiiiy the ioSntry there aangSage oi the te.t is Ssedc

Chapter 3 Text Content

209

rg i nt T

fo:country iX L propertyo
fo:country-asian
fo:country-complex

RrT 9TThe raaSe oi these properties ian be any oi the
aipSbsiataaogsioSntrychtmaoc

O 4066 ioSntry iodes isee http:sstttcsiacorgs

t presents these properties are ignored ii they are not speiiiied together tith the iorresponding

fo:language propertyc
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc
o oT<!ATTLIST style:properties fo:country CtATA tIMPLIEt<<!ATTLIST style:properties fo:country-asian CtATA tIMPLIEt<<!ATTLIST style:properties fo:country-complex CtATA tIMPLIEt<

4c02c0 Font tyaese these properties to speiiiy thether to Sse normaa or itaaii iont iaiec
rg i nt T

fo:font-style iX L propertyo
fo:font-style-asian
fo:font-style-complex

RrT 9Tee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ENTITY % fontStyle "(normal|italic|obliquey"<<!ATTLIST style:properties fo:font-style %fontStyle; tIMPLIEt<<!ATTLIST style:properties fo:font-style-asian %fontStyle;tIMPLIEt<<!ATTLIST style:properties fo:font-style-complex %fontStyle;tIMPLIEt<

4c02c 2 Font eaiei
se this property to speiiiy thether the iont shoSad be embosseds engrareds or neitherc
rg i nt T

style:font-relief

RrT 9To oT<!ENTITY % fonteelief "(none|embosset|engravety"<<!ATTLIST style:properties style:font-relief %fonteelief;tIMPLIEt<

4c02c 0 Te.t hadot
se this property to speiiiy the te.t shadot styae to Ssec

210

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

fo:text-shatow iX L propertyo

rg i nt T
RrT 9To oT<!ATTLIST style:properties fo:text-shatow CtATA tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents OpenOiiiiecorg onay sSpports a deiaSat te.t shadot styaec Thereiores any raaSe otherthan none stitihes on this deiaSat shadot styaec

4c02c

nderaining

se this property to speiiiy ii and hot te.t is Snderainedc
rg i nt T

style:text-unterline

RrT 9TThe raaSe oi this property is the Snderaining styae ior the te.ts ior e.ampaes singles tottets
tashc

o oT

<!ATTLIST style:properties fo:text-unterline(none|single|touble|tottet|tash|long-tash|tot-tash|
tot-tot-tash|wave|bolt|bolt-tottet|bolt-tash|bolt-long-tash|
bolt-tot-tash|bolt-tot-tot-tash|bolt-wave|touble-wave|smallwavey tIMPLIEt<n T

X L does not sSpport this property bSt the raaSes none and single iorrespond to the raaSes
none and unterline in the X L fo:text-tecoration propertyc The fo:texttecoration property is aaso Ssed ior irossing oSt and bainking te.tc

4c02c 4nderaine Coaor

se this property to speiiiy the ioaor that is Ssed to Snderaine te.tc
rg i nt T

style:text-unterline-color

RrT 9TThe raaSe oi this property is either font-color or a ioaorc i the raaSe is font-colors theiSrrent te.t ioaor is Ssed ior Snderainingc

o oT<!ATTLIST style:properties fo:text-unterline-color CtATAtIMPLIEt<

n T

i yoS set this property tithin OpenOiiiiecorg tithoSt speiiiying a style:textunterline property ior the same styaes Snderaining is stitihed oiic

4c02c 9 Font Deightse these properties to speiiiy the teight oi the iontc

Chapter 3 Text Content

211

rg i nt T

fo:font-weight iX L propertyo
fo:font-weight-asian
fo:font-weight-complex

RrT 9TThe reaatire raaSes lighter or bolter are not sSpported and onay a iet distinit nSmeriiaa
raaSes are sSpportedc nsSpported nSmeriiaa raaSes are roSnded oii to the ne.t sSpported raaSec
ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are
eraaSatedc

o oT<!ATTLIST style:properties fo:font-weight CtATA tIMPLIEt<<!ATTLIST style:properties fo:font-weight-asian CtATAtIMPLIEt<<!ATTLIST style:properties fo:font-weight-complex CtATAtIMPLIEt<

4c02c 5 Te.t Deioration Dordodese this property to speiiiy thether irossing oSt and Snderaining is appaied to tords onay or to portions oi te.tc iirossing oSt and Snderaining is appaied to te.t portionss the spaies betteen tords and the tords are Snderained or
irossed oStc
rg i nt T

fo:score-spaces

RrT 9To oT
n 9T<!ATTLIST style:properties fo:score-spaces %boolean; tIMPLIEt<
X L does not sSpport this propertyc
n tarOiiiie 5c s this property tas iaaaed style:tecorate-worts-onlyc

4c02c 6 Letter 2erningse this property to enabae or disabae kerning betteen iharaitersc
rg i nt T

style:letter-kerning

RrT 9To oT
n T<!ATTLIST style:properties style:letter-kerning %boolean;tIMPLIEt<
X L does not sSpport this propertyc

4c02c m Te.t Bainking
se this property to speiiiy thether or not te.t bainksc

212

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:text-blinking

RrT 9To oT
n T<!ATTLIST style:properties style:text-blinking %boolean;tIMPLIEt<
X L does not sSpport this property bSt the raaSes false and true iorrespond to the raaSes
none and blink oi the X L fo:text-tecoration propertyc The X L fo:texttecoration ian be Ssed to represent this property bSt it is aaso Ssed ior Snderained anirossing oSt te.tc

4c02c r Te.t BaikgroSnd Coaor
se this property to speiiiy the baikgroSnd ioaor to appay to iharaitersc
rg i nt T

style:text-backgrount-color

RrT 9TThe raaSe oi this property ian be transparent or a ioaorc The property has the same raaSes as
the fo:backgrount-color propertyc

o oT<!ENTITY % transparent_or_color "CtATA"<<!ATTLIST style:properties style:text-backgrount-color%transparent_or_color; tIMPLIEt<

n T

4c02c

naike OpenOiiiiecorgs X L does not distingSish betteen iharaiter and paragraph baikgroSndscn OpenOiiiiecorgs ii a baikgroSnd is appaied to a baoik eaement iparagraphos it behares aike aparagraph baikgroSnd and ii it is appaied to an inaine eaement ia pieie oi te.t tithin a paragraphos
it behares aike a iharaiter baikgroSndc Thereiores this property ian be transiormed to an X L
fo:backgrount-color bSt an additionaa inaine eaement is reqSiredc

Te.t Combine

se this property to iombine iharaiters so that they are dispaayed tithin tto ainesc
rg i nt T

style:text-combine

RrT 9TThe raaSe oi this attribSte ian be nones letters or linesc
i the raaSe is liness aaa iharaiters tith this attribSte raaSe that immediateay ioaaot eaih otherare dispaayed tithin tto aines oi appro.imateay the same aengthc There ian be a aine break
betteen any tto iharaiters to meet this ionstraintc
i the raaSe oi the attribSte is letterss Sp to 5 iharaiters are iombined tithin tto ainesc ny
additionaa iharaiter is dispaayed as normaa te.tc

o oT
n T

<!ATTLIST style:properties style:text-combine (none|letters|linesy<ee http:sstttct4corgsT sDD-i0rn-iormatsrc

4c02c42 Te.t Combine tart and End Charaiters
se these tto properties to speiiiy a start and end iharaiter that is dispaayed beiore and aiter a portion oi te.tthose style:text-combine property has a raaSe oi linesc

Chapter 3 Text Content

213

rg i nt T

style:text-combine-start-charstyle:text-combine-ent-char

RrT 9To oT<!ATTLIST style:properties style:text-combine-start-char %character;<<!ATTLIST style:properties style:text-combine-ent-char %character;<

4c02c40 Te.t Emphasis
se this property to emphasike te.t in sian doiSmentsc
rg i nt T

style:text-emphasive

RrT 9TThe raaSe oi this attribSte ionsists oi tto spaie-separated raaSesc
The iirst raaSe represents the styae to Sse ior emphasis and it ian be nones accents tots
circles or tiscc
The seiond raaSe represents the position oi the emphasis and it ian be above or belowc i theiirst raaSe is nones this raaSe ian be omittedc

o oT
n T

<!ATTLIST style:properties style:text-emphasive CtATAtIMPLIEt<
OpenOiiiiecorg sSpports the ioaaoting iombined raaSes:
none
tot above
tot below
accent above
circle above
Dhen the doiSment is importeds tisc above is ihanged to tot aboves thiae any below
raaSe is ihanged to a tot below raaSec

4c02c4 Te.t Stospaie
se this property to speiiiy thether to add spaie betteen asians testerns and iompae. te.tc
rg i nt T

style:text-autospace

RrT 9TThe OpenOiiiiecorg soittare onay sSpports the raaSes none and iteograph-alphac

o oT<!ATTLIST style:properties style:text-autospace (none |iteograph-alphay tIMPLIEt<

4c02c44 Te.t iaae
se this property to deirease or inirease the tidth oi the te.tc To aihiere siaaings ihange the iont tidthc

214

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:text-scale

RrT 9To oT<!ATTLIST style:properties style:text-scale %percentage
tIMPLIEt<

4c02c49 Te.t otation ngae
se this property to speiiiy an angae to thiih to rotate the te.tc YoS ian rotate te.t to an angae oi 2 or m2
degreesc i this attribSte is speiiiied ior more than one iharaiters aaa te.t iontaining these iharaiters is rotatedc
rg i nt T

style:text-rotation-angle

RrT 9TThe raaSe oi this attribSte ian be 0s 90s or 2:0c
For any angae greater than 45 the remainder oi a dirision by 462 is Ssedc ny angae other than 2s
2 or m2 is roSnded to the nearest possibae raaSec

o oT<!ATTLIST style:properties style:text-rotation-angle %integer;tIMPLIEt<

4c02c45 Te.t otation iaae
i te.t is rotateds this property speiiiies thether the tidth oi the te.t shoSad be siaaed to iit into the iSrrent aineheight or the tidth oi the te.t shoSad remain ii.eds thereiore ihanging the iSrrent aine heightc
rg i nt T

style:text-rotation-scale

RrT 9To oT<!ATTLIST style:properties style:text-rotationscale (fixet|
line-heighty tIMPLIEt<

4c02c46 PSnitSation Drap
se this property to determine thether or not a pSnitSation marks ii one is presents ian be paaied in the marginarea at the end oi a iSaa aine oi te.tc This is a iommon setting in East sian typographyc
rg i nt T

style:punctuation-wrap

RrT 9To oT<!ATTLIST style:properties style:punctuation-wrap (simple |hangingy tIMPLIEt<

4c02c4m Line Breakse this property to seaeit the set oi aine breaking rSaes to Sse ior te.tc

Chapter 3 Text Content

215

rg i nt T

style:line-breakRrT 9To oT<!ATTLIST style:properties style:line-break (normal | strictytIMPLIEt<

4c00 Paragraph Formatting Properties
YoS ian appay paragraph iormatting properties to paragraphs and paragraph styaesc

4c00c0 Fi.ed Line Oeightse this property to speiiiy a ii.ed aine height either as a aength or a perientage that reaates to the highest iharaiter in a ainec speiiaa raaSe oi normal aitirates the deiaSat aine height iaaiSaationc t is aaso Ssed to deaitirate
the eiieits oi the style:line-height-at-least and style:line-spacing propertiesc
rg i nt T

fo:line-height iX L propertyo

RrT 9TThe raaSe oi this property ian be a aengths a perientages or a raaSe oi normalc

o oT<!ATTLIST style:properties fo:line-height(normal|%length;|%percentage;y tIMPLIEt<

n T

The fo:line-heights style:line-height-at-least and style:linespacing properties are mStSaaay e.iaSsire and ianiea eaih other oStc The resSat oi speiiiying
tto or more oi these properties tithin one item set eaement is Sndeiinedc
X L sSpports this property bSt it does not sSpport a nSmber property raaSec

4c00c

inimSm Line Oeightse this property to speiiiy a minimSm aine heightc
rg i nt T

style:line-height-at-least

RrT 9TThe raaSe oi this property is a aengthc There is no normal raaSe ior the propertyco oT<!ATTLIST style:properties style:line-height-at-least %length;tIMPLIEt<

n T

X L does not sSpport this propertyc
The fo:line-heights style:line-height-at-least and style:linespacing properties are mStSaaay e.iaSsire and ianiea eaih other oStc The resSat oi speiiiying
tto or more oi these properties tithin one item set eaements is Sndeiinedc

4c00c4 Line Distanie
se this property to speiiiy a ii.ed distanie betteen tto aines

216

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:line-spacing

RrT 9T

There is no normal raaSe ior this propertyco oT<!ATTLIST style:properties style:line-spacing %lengthtIMPLIEt<

n T

X L does not sSpport this propertyc
The fo:line-heights style:line-height-at-least and style:linespacing properties are mStSaaay e.iaSsire and ianiea eaih other oStc The resSat oi speiiiying
tto or more oi these properties tithin one item set eaement is Sndeiinedc

4c00c9 Te.t aign
se this property to speiiiy hot to aaign te.t in paragraphsc
rg i nt T

fo:text-align iX L propertyo

RrT 9TThe raaSe oi this property ian be starts ents centers or iustifyc
i there are no raaSes speiiiied ior the style:text-align-last and style:iustify-single-wort properties tithin the same item set eaements the raaSes oi theseproperties are set to left and false respeitireayc

o oT
n 9T

<!ATTLIST style:properties fo:text-align (start|ent|center|iustifyy tIMPLIEt<t presents the raaSes page-insite and page-outsite are not sSpportedc
n tarOiiiie 5c s the attribSte raaSe iustify tas iaaaed iustifietc

4c00c5 Te.t aign oi Last Linese this property to speiiiy hot to aaign the aast aine oi a jSstiiied paragraphc
rg i nt T

style:text-align-lastRrT 9TThe raaSe oi this property ian be starts centers or iustifyc
This property is ignored ii it not aiiompanied by an fo:text-align propertyc
i there are no raaSes speiiiied ior the fo:text-align and style:iustify-singlewort propertiess these raaSes oi these properties is set to left and false respeitireayc

o oT
n T

<!ATTLIST style:properties style:text-align-last(start|center|iustifyy tIMPLIEt<n tarOiiiie 5c s the attribSte raaSe iustify tas iaaaed iustifietc

4c00c6 JSstiiy ingae Dordi the aast aine in a paragraph is jSstiiieds Sse this property to speiiiy thether or not a singae tord shoSad be jSstiiiedc

Chapter 3 Text Content

217

rg i nt T

style:iustify-single-wort

RrT 9Ti there are no raaSes speiiiied ior the fo:text-align and style:text-align-lastpropertiess the raaSes oi these properties are set to leftc This means that speiiiying a style:iustify-single-wort property tithoSt speiiiying a style:text-align andstyle:text-align-last property has no eiieitc

o oT<!ATTLIST style:properties style:iustify-single-wort %boolean;tIMPLIEt<

n T

X L does not sSpport this propertyc

4c00cm Break nside
se this property to iontroa thether page or ioaSmn breaks are aaaoted tithin a paragraphc
rg i nt T

style:break-insite

RrT 9To oT
n T<!ATTLIST style:properties style:break-insite (auto|avoity
tIMPLIEt<
X L does not sSpport this propertyc

4c00cr Didots
se this property to speiiiy the minimSm nSmber oi aines aaaoted at the top oi a page to aroid paragraph
AutnA9crg i nt T

fo:witows iX L propertyo

RrT 9To oT
n T<!ATTLIST style:properties fo:witows %number; tIMPLIEt<
naike X Ls this property aiieits ioaSmn breaks and page breaksc

4c00c Orphansse this property to speiiiy the minimSm nSmber oi aines reqSired at the bottom oi a page to aroid paragraphnIor419c
rg i nt T

fo:orphans iX L propertyo

RrT 9To oT
n T<!ATTLIST style:properties fo:orphans %number; tIMPLIEt<
naike X Ls this property aiieits ioaSmn breaks and page breaksc

4c00c02 Tab tops
se the tab stop eaements to speiiiy tab stop deiinitionsc

218

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<style:tab-stops<

RrT 9T

Erery tab stop position is represented by a singae <style:tab-stop< eaement that isiontained in the <style:tab-stops< eaementc

o oT<!ELEMENT style:tab-stops (style:tab-stopya<<!ELEMENT style:tab-stop EMPTY<n T<style:tab-stop<

X L does not sSpport tab stopsc

The attribStes that yoS ian assoiiate tith the <style:tab-stops< and <style:tab-stop< eaements are:●Tab position●

Tab type●

Deaimiter iharaiter●

Leader iharaiter

Tab Position
The style:position attribSte speiiiies the position oi a tab stopc
rg i nt T

style:position

RrT 9T

This attribSte is assoiiated tith the <style:tab-stop< eaement and its raaSe is a aengthc

o oT<!ATTLIST style:tab-stop style:position %length; teEt|IeEt<

Tab Type
The style:type attribSte speiiiies the type oi tab stopc
rg i nt T

style:type

RrT 9T

This attribSte is assoiiated tith the <style:tab-stop< eaement and its raaSe ian be lefts
centers rights or charco oT<!ATTLIST style:tabtype style:type (left|center|right|chary"left"<

Deaimiter Charaiter
The style:char attribSte speiiiies the deaimiter iharaiter ior tab stops oi type charc
rg i nt T

style:char

RrT 9T

This attribSte is assoiiated tith the <style:tab-stop< eaement and it must be present ii the
raaSe oi the style:type attribSte is charc i the raaSe oi style:type attribSte is notchar, it is ignoredc
The raaSe oi the attribSte mSst be a singae N CODE iharaiterc

o oT<!ATTLIST style:tab-stop style:char %char; tIMPLIEt<

Chapter 3 Text Content

219

Leader Charaiter
The style:leater-char attribSte speiiiies the aeader iharaiter to Sse ior tab stopsc
rg i nt T

style:leater-char

RrT 9T

This attribSte is assoiiated tith the <style:tab-stop< eaement and its raaSe mSst be a
singae N CODE iharaiterc

o oT<!ATTLIST style:tab-stop style:leater-char %char; " "<4c00c00 Oyphenation
se this property to enabae or disabae aStomatii hyphenationc
rg i nt T

fo:hyphenate

RrT 9To oT<!ATTLIST style:properties fo:hyphenate %boolean; tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents ii yoS enabae hyphenations OpenOiiiiecorg X L sets the ioaaoting property raaSes
Snaess they are speiiiied tithin the same item set eaement:●

fo:hyphenation-keep to none●

fo:hyphenation-remain-char-count and fo:hyphenation-push-charcount to 0●

fo:hyphenation-latter-count to no-limit

4c00c0 Oyphenation 2eepse this property to enabae or disabae the hyphenation oi the aast tord on a pagec
rg i nt T

fo:hyphenation-keep

RrT 9To oT<!ATTLIST style:properties fo:hyphenation-keep(none|page|column|spreaty tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents this property is not sSpportedc i yoS enabae this propertys OpenOiiiiecorg X L sets
the ioaaoting property raaSes Snaess they are speiiiied tithin the same item set eaement:●

fo:hyphenate to false●

fo:hyphenation-remain-char-count and fo:hyphenation-push-charcount to 0●

fo:hyphenation-latter-count to no-limit

The raaSes none and page ian be setsbSt they tiaa nerer be eraaSatedc

4c00c04 Oyphenation emain Char CoSnt
se this property to speiiiy the nSmber oi iharaiters that mSst be present beiore a hyphenation iharaiterc

220

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

fo:hyphenation-remain-char-countRrT 9To oT<!ATTLIST style:properties fo:hyphenation-remain-char-count %number; tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents ii yoS enabae this propertys OpenOiiiiecorg X L sets the ioaaoting property raaSes
Snaess they are speiiiied tithin the same item set eaement:●

fo:hyphenate to false●

fo:hyphenation-keep to none●

fo:hyphenation-push-char-count to 0●

fo:hyphenation-latter-count to no-limit

4c00c09 Oyphenation PSsh Char CoSnt
se this property to speiiiy the minimSm nSmber oi iharaiters that are mored to the ne.t ainec
rg i nt T

fo:hyphenation-push-char-countRrT 9To oT<!ATTLIST style:properties fo:hyphenation-push-char-count %number; tIMPLIEt<oT
1 4 un1
Tu u 4 un1Tt presents ii yoS enabae this propertys OpenOiiiiecorg X L sets the ioaaoting property raaSes
Snaess they are speiiiied tithin the same item set eaement:

4c00c05●

fo:hyphenate property to false●

fo:hyphenation-keep to none●

fo:hyphenation-remain-char-count to 0●

fo:hyphenation-latter-count to no-limit

a.imSm Oyphensse this property to speiiiy the ma.imSm nSmber oi sSiiessire aines that ian iontain a hyphenated tordc
rg i nt T

fo:hyphenation-latter-countRrT 9To oTn ToT
1 4 un1
Tu u 4 un1T<!ATTLIST style:properties fo:hyphenation-latter-count (nolimit|%number;y tIMPLIEt<n tarOiiiie 5c s there tas a raaSe none instead oi no-limitc
t presents ii yoS enabae this propertys OpenOiiiiecorg X L sets the ioaaoting property raaSes
Snaess they are speiiiied tithin the same item set eaement:●

fo:hyphenate property to false●

fo:hyphenation-keep to none●

fo:hyphenation-remain-char-count and fo:hyphenation-push-charcount to 0
Chapter 3 Text Content

2214c00c06 Drop Caps
se the <style:trop-cap< eaement to speiiiy ii the iirst iharaiter or more oi a paragraph is dispaayed in aaarger iontc
rg i nt T<style:trop-cap<

RrT 9T

This eaement ian be iontained in a <style:properties< eaementc

o oT<!ELEMENT style:trop-cap EMPTY<

The attribStes that yoS ian assoiiate tith the <style:trop-cap< eaement are:●Length

●

Lines

●

Distanie●

Te.t styae

LengthThe style:length attribSte speiiiies the nSmber oi iharaiters that are droppedc
rg i nt T

style:length

RrT 9TThe raaSe oi this attribSte ian be a nSmber or worts thiih indiiates that the iirst tord shoSad be
droppedc

o oT<!ATTLIST style:trop-cap style:length (%number;|worty "1"<n T

X L does not sSpport drop iaps bSt a ionrersion to X L may ireate a iormatting objeit that
iontains the dropped iharaitersc

Lines
The style:lines attribSte speiiiies the nSmber oi aines that the dropped iharaiters shoSad eniiriaec
rg i nt T

style:lines

RrT 9Ti the raaSe oi this attribSte is 1 or 0s drop iaps is disabaedc

o oT<!ATTLIST style:trop-cap style:lines %number; "1"<Distanie
The style:tistance attribSte speiiiies the distanie betteen the aast dropped iharaiter and the iirst oi theremaining iharaiters oi eaih ainec

222

rg i nt T

style:tistanceRrT 9TThe raaSe oi this attribSte is a aengthc

o oT<!ATTLIST style:trop-cap style:tistance %length; "0cm"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Te.t tyae
The style:style-name attribSte speiiiies the te.t styae to appay to the dropped iharaitersc
rg i nt T

style:style-name

RrT 9To oT

4c00c0m<!ATTLIST style:trop-cap style:style-name CtATA tIMPLIEt<

egister TrSe

se the style:register-true property to ensSre that then yoS are Ssing tto-sided printings the printed
aines on both sides oi a page matihc t aaso ensSres that the te.t in page ioaSmns or te.t bo. ioaSmns is arranged
in sSih a tay that the te.t baseaines seem to rSn irom one ioaSmn to anotherc
rg i nt T

style:register-trueRrT 9To oT
n T<!ATTLIST style:properties style:register-true %boolean;tIMPLIEt<
X L does not sSpport this propertyc

4c00c0r NSmbering tyaeee Chapter

ior iniormation on the nSmber styae iormatting propertiesc

4c00c0 Leit and ight

arginsse these properties to speiiiy the aeit and right margins ior a paragraphc
rg i nt T

fo:margin-left and fo:margin-right iX L propertieso

RrT 9T

These tto properties mSst be attaihed to an item set eaement together tith the fo:textintent propertyc i any oi the properties is missings its raaSe is assSmed to be 2imc The raaSe
auto is not sSpportedc

o oT<!ATTLIST style:properties fo:margin-left (%number;|%
percantage;y tIMPLIEt<<!ATTLIST style:properties fo:margin-right (%number;|%
percantage;y tIMPLIEt<n T

naike X Ls perientage raaSes ior these attribStes ian be Ssed tithin paragraph styaes and reaate
to the margins oi the parent paragraph styae oi the tidth oi the attribSte neighborhoodc

4c00c 2 Te.t ndent
se this property to speiiiy an positire or negatire indent ior the iirst aine oi a paragraphc

Chapter 3 Text Content

223

rg i nt T

fo:text-intent iX L propertyo

RrT 9T

This property mSst be attaihed to an item set eaement together tith the fo:margin-left andfo:margin-right propertiesc i any oi these properties is missings its raaSe is assSmed to be
2imc

o oT

<!ATTLIST style:properties fo:text-intent %number; tIMPLIEt<

n T

4c00c 0naike X Ls perientage raaSes ian be Ssed tithin paragraph styaesc They perientages reaate to theparent paragraph styaec

Stomatii Te.t ndent

se this property to speiiiy that the iirst aine oi a paragraph is indented by a raaSe that is based on the iSrrent iont
sikec
rg i nt T

style:auto-text-intent

RrT 9T

This property mSst be attaihed to an item set eaement together tith the fo:margin-left andfo:margin-right propertiesc i any oi these properties is missings its raaSe is assSmed to be
2imc
i this property is attaihed to an item set eaement together tith a fo:text-intent property
that has a raaSe oi trues the fo:text-intent property is ignoredc

o oT
n T

4c00c

<!ATTLIST style:properties style:auto-text-intent %boolean;tIMPLIEt<
X L does not sSpport this propertyc

Top and Bottom

arginsse these properties to speiiiy the top and bottom margins ior paragraphsc
rg i nt T

fo:margin-top and fo:margin-bottom iX L propertieso

RrT 9T

These tto properties mSst be attaihed to an item set eaement simSataneoSsayc i one oi the properties is missings its raaSe is assSmed to be 2imc The raaSe auto is not sSpportedc

o oT<!ATTLIST style:properties fo:margin-top CtATA tIMPLIEt<<!ATTLIST style:properties fo:margin-bottom CtATA tIMPLIEt<n T

naike X Ls perientage raaSes ian Ssed tithin paragraph styaesc The perientages reaate to theparent paragraph styae instead oi the attribSte neighborhoodc

4c00c 4 Page eqSenie Entry Pointee Chapter 9 ior detaiaed iniormation on page seqSenie entry pointsc

4c00c 9 Break Beiore and Break iter
se these properties to insert a page or ioaSmn break beiore or aiter a paragraphc

224

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

fo:break-before and fo:break-after iX L propertieso

RrT 9T

These tto properties are mStSaaay e.iaSsirec i they are attaihed to an item set eaement simSataneoSsays the resSat is Sndeiinedc
The raaSes ott-page and even-page behare aike a page raaSec

o oT<!ATTLIST style:properties fo:break-before (auto|column|pageytIMPLIEt<<!ATTLIST style:properties fo:break-after (auto|column|pageytIMPLIEt<

4c00c 5 Paragraph BaikgroSnd Coaor
se this property to speiiiy the baikgroSnd ioaor oi a paragraphc
rg i nt T

fo:backgrount-color iX L propertyo

RrT 9TThe raaSe oi this attribSte ian be either transparent or it ian be a ioaorc i the raaSe istransparents it stitihes oii any baikgroSnd image that is speiiiied by a <style:backgrount-image< eaement tithin the same item set eaementc

o oT<!ATTLIST style:properties fo:backgrount-color %transparent_or_color tIMPLIEt<

4c00c 6 Paragraph BaikgroSnd magese this property to speiiiy a baikgroSnd image ior a paragraphc
The baikgroSnd image ian be stored in one oi the ioaaoting tays:●

The image data is stored in an e.ternaa iiaec se the Xaink attribStes to speiiiy the aoiation oi the imagec●

The image data is iontained in an <office:binary-tata< sSbeaement in B

rg i nt T<style:backgrount-image<RrT 9T

This eaement mSst be iontained tithin a properties eaementc

E69 eniodingc

The baikgroSnd image is onay dispaayed ii one oi the ioaaoting ionditions e.ist:●

There is an xlink:href attribSte attaihed to the eaementc●

There is an <office:binary-tata< eaement iontained in the eaementc

i the <style:backgrount-image< eaement is empty and ii there is no ioaor speiiiied byan fo:backgrount-color eaement in the same properties eaements OpenOiiiiecorg X L
sets the baikgroSnd ioaor to transparentc
o oT

n T

<!ELEMENT style:backgrount-image (office:binary-tata?y<<!ATTLIST style:backgrount-image xlink:type (simpley tIMPLIEt<<!ATTLIST style:backgrount-image xlink:show (embety tIMPLIEt<<!ATTLIST style:backgrount-image xlink:actuate (onLoatytIMPLIEt<
X L is not sSitabae ior dispaaying baikgroSnd images beiaSse it is not based on XLinkc

The attribStes that yoS ian assoiiate tith the <style:backgrount-image< eaement are:●epetition
Chapter 3 Text Content

225

●

Position●

Fiaterepetition
The style:repeat attribSte speiiiies thether a baikgroSnd image is repeated or stretihed in a paragraphc
rg i nt T

style:repeat

RrT 9T

This attribSte is attaihed to the <style:backgrount-image< eaement and its raaSe ian be
no-repeats repeats or stretchc

o oT<!ATTLIST style:backgrount-image style:repeat(no-repeat|repeat|stretchy "repeat"<n TThis attribSte is simiaar to the X L fo:backgrount-repeat propertys e.iept that X L
does not sSpport the stretch raaSe bSt sSpports the raaSes repeat-x and repeat-yinsteadc

Position
The style:position attribSte speiiiies there to position a baikgroSnd image in a paragraphc
rg i nt T

style:position

RrT 9T

This attribSte is attaihed to the <style:backgrount-image< eaement and its raaSe ian bea spaie separated iombination oi tops centers or bottom ior the rertiiaa position and lefts
centers or right ior the horikontaa positionc The rertiiaa and horikontaa positions ian be
speiiiied in any order and ii yoS tishs yoS ian speiiiy jSst one position in thiih iase the otherposition deiaSats to centerc

o oT<!ATTLIST style:backgrount-image style:repeat CtATA "center"<n TThis attribSte is simiaar to the X L io:baikgroSnd-position property e.iept that X L sSpports atider range oi raaSesc

Fiater
The style:filter-name attribSte speiiiies the internaa OpenOiiiiecorg iiater name that is Ssed to aoad theimage into the doiSmentc
rg i nt T

style:filter-name

RrT 9T

This attribSte is attaihed to the <style:backgrount-image< eaementc

o oT<!ATTLIST style:backgrount-image style:filter CtATA tIMPLIEt<

4c00c m Border
se the border properties to speiiiy the border properties ior paragraphsc

226

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

fo:borter
fo:borter-top
fo:borter-bottom
fo:borter-left
fo:borter-rightRrT 9T

The fo:borter property appaies to aaa ioSr sides oi a paragraph thiae the other properties
appay to one side onayc

o oT<!ATTLIST style:properties fo:borter CtATA tIMPLIEt<<!ATTLIST style:properties fo:borter-top CtATA tIMPLIEt<<!ATTLIST style:properties fo:borter-bottom CtATA tIMPLIEt<<!ATTLIST style:properties fo:borter-left CtATA tIMPLIEt<<!ATTLIST style:properties fo:borter-right CtATA tIMPLIEt<oT
1 4 un1
Tu u 4 un19Tt presents aaa ioSr borders mSst be set simSataneoSsay by Ssing either the fo:borter property
or by attaihing aaa ioSr oi the other border properties to an item set eaementc n the aatter iases ii
one or more oi the properties is missing their raaSes are assSmed to be nonec
The onay border styaes sSpported are none or hittens solits and toublec ny other borderstyae speiiiied is dispaayed as solitc Transparent borders are not sSpported and the bordertidths thins metiums and thick are mapped to aengthsc n additions onay some distinit bordertidths are sSpportedc nsSpported tidths are roSnded Sp to the ne.t sSpported tidthc
i there are no padding properties speiiiied tithin the same item set eaements a deiaSat padding is
Ssed ior sides that hare a borderc raaSe oi 2im is Ssed ior sides tithoSt a borderc

4c00c r Border Line Didthi the aine styae ior a border is toubles Sse the border aine properties to indiridSaaay speiiiy the tidth oi theinner and oSter aines and the distanie betteen themc
rg i nt T

style:borter-line-witth
style:borter-line-witth-top
style:borter-line-witth-bottom
style:borter-line-witth-leftstyle:borter-line-witth-rightRrT 9T

The style:borter-line-witth speiiiies the aine tidths oi aaa ioSr sidess thiae the otherattribStes speiiiy the aine tidths oi one side onayc
The raaSe oi the attribStes ian be a aist oi three spaie-separated aengthss as ioaaots:

o oT

●

The iirst raaSe speiiiies the tidth oi the inner aine●

The seiond raaSe speiiiied the distanie betteen the tto aines●

The third raaSe speiiiies the tidth oi the oSter aine<!ATTLIST style:properties style:borter-line-witth CtATAtIMPLIEt<<!ATTLIST style:properties style:borter-line-witth-top CtATAtIMPLIEt<<!ATTLIST style:properties style:borter-line-witth-bottom
CtATA tIMPLIEt<<!ATTLIST style:properties style:borter-line-witth-left CtATAtIMPLIEt<<!ATTLIST style:properties style:borter-line-witth-right CtATAtIMPLIEt<

Chapter 3 Text Content

227

oT
1 4 un1
Tu u 4 un19T

Onay a iet distinit tidth tripaes are sSpportedc nsSpported tidth tripaes are roSnded to asSpported tidth tripaec
The resSat oi speiiiying a border aine tidth tithoSt speiiiying a border tidth styae oi touble
ior the same border is Sndeiinedc
X L does not sSpport these border aine tidth propertiesc

n T

4c00c

Padding

se the padding properties to speiiiy the spaiing aroSnd a paragraphc
rg i nt T

fo:patting
fo:patting-top
fo:patting-bottom
fo:patting-left
fo:patting-rightRrT 9To oT<!ATTLIST style:properties fo:patting CtATA tIMPLIEt<<!ATTLIST style:properties fo:patting-top CtATA tIMPLIEt<<!ATTLIST style:properties fo:patting-bottom CtATA tIMPLIEt<<!ATTLIST style:properties fo:patting-left CtATA tIMPLIEt<<!ATTLIST style:properties fo:patting-right CtATA tIMPLIEt<oT
1 4 un1
Tu u 4 un19Tt presents the raaSe oi these properties ian be a non-kero raaSe ii there is a border at the sameside and the border is speiiiied tithin the same item set eaementc
The raaSe ian be kero ii there is no border at the same sidec
i an item set eaement iontains a padding speiiiiiation ior one bSt not aaa ioSr sidess a kero or a
deiaSat padding is assigned to these sides depending on thether or not there is a border at thatsidec
i yoS speiiiy a padding ior one or more sides tithoSt speiiiying borders tithin the same item set
eaements OpenOiiiiecorg X L stitihes oii aaa borders that are not setc

4c00c42 hadot
se the style:shatow property to speiiiy a shadot eiieit ior the paragraphc
rg i nt T

style:shatow

RrT 9TThe raaid raaSes ior this attribSte are the same as the raaSes ior the fo:text-shatow propertyc ee eition 4c02c 0 ior iniormationc

o oT<!ATTLIST style:properties style:shatow CtATA tIMPLIEt<oT
1 4 un1
Tu u 4 un19Tt presents onay one shadot eiieit is sSpported at a timec The absoaSte raaSes oi the rertiiaa andhorikontaa shadot positions mSst be the same and there is no baSr radiSscn T

X L does not sSpport this propertyc

4c00c40 2eep tith Ne.t
se the style:keep-with-next property to speiiiy thether or not to keep the iSrrent paragraph and the228

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

ne.t paragraph together on a page or in a ioaSmn aiter a break is insertedc
rg i nt T

style:keep-with-next

RrT 9To oT
n T<!ATTLIST style:properties style:keep-with-next %boolean;tIMPLIEt<
n tarOiiiie 5c s this attribSte tas iaaaed fo:keep-with-nextc

4c00c4 Line NSmbering
ee eition 4c5 ior detaiaed iniormation on aine nSmbering iormatting propertiesc

4c00c44 Te.t Stospaies PSnitSation Draps Line Breakee eitions 4c02c4 s 4c02c46 and 4c02c4m ior iniormation aboSt these propertiesc

4c00c49 Vertiiaa aignment
se the style:vertical-align property to determine the rertiiaa position oi a iharaiterc n this manSaas
iharaiters are aaigned aiiording to their baseaines thiih is the deiaSat ior most ESropean aangSagesc aternatireays yoS ian rertiiaaay aaign iharaiters as ioaaots:●

To the bottom oi the ainec●

To the top oi the ainec●

To the ienter oi the ainec●

Stomatiiaaays thiih sets the rertiiaa aaignment to sSit the te.t rotationc Te.t that is rotated 2 or 2 degrees isaaigned to the baseaines thiae te.t that is rotated m2 degrees is aaigned to the ienter oi the ainec

The ioaaoting graphii iaaSstrates the eiieit oi the rertiiaa aaignment property then it is set to baseaines tops
bottoms and ienterrespeitireayc

mgk mgk

rg i nt T

mgk mgk

mgk mgk

mgk mgk

style:vertical-alignRrT 9To oT
n T<!ATTLIST style:properties style:vertical-align (auto|
baseline|top|bottom|mittley "auto"<
This property is simiaar to the rertiiaa-aaign property in X Lc The property does not sSpport aaa oi
the X L raaSess and additionaaay sSpports aStomatii rertiiaa aaignmentc

Chapter 3 Text Content

229

4c0

eition Formatting Properties
YoS ian appay seition iormatting properties to seition desiriptionsc

4c0 c0 eition BaikgroSnd
The baikgroSnd iormatting properties ior seitions are the same as the baikgroSnd properties ior paragraphsc eeeition 4c00c 5 and 4c00c 6 ior iniormation on baikgroSnd iormatting properties ior paragraphsc

4c0 c CoaSmns
The <style:columns< eaement iontains the ioaSmn eaements ior a seitionc
rg i nt T<style:columns<

RrT 9T

This eaement ian iontain <style:column< eaements that speiiiy eaih ioaSmn indiridSaaay
isee eition 4c0 c4oc i these eaements are not presents aaa ioaSmns are assigned the same tidthc
The <style:columns< ian iontain a <style:column-sep< eaement that desiribes theseparator aine betteen ioaSmnsc ee eition 4c0 c9 ior iniormation on this eaementc

o oT<!ELEMENT style:columns (style:column-sep?,(style:column,
style:columnty?<

The attribStes that yoS ian assoiiate tith the <style:columns< eaement are:●CoaSmn ioSnt●

CoaSmn gap

CoaSmn CoSnt
The fo:columns-count attribSte speiiiies the nSmber oi ioaSmns in a seitionc
rg i nt T

fo:columns-countRrT 9T

This attribSte is essentiaaco oT<!ATTLIST style:columns fo:column-count %number teEt|IeEt<

n T

This attribSte has the same name as an X L property bSt it is attaihed to a diiierent eaementc

CoaSmn Gap
i the <style:columns< eaement does not iontain indiridSaa <style:column< eaementss yoS ian speiiiy
the gap betteen ioaSmns Ssing the fo:column-gap attribStec
rg i nt T

fo:column-gap

RrT 9Ti there are indiridSaa ioaSmn eaementss this attribSte is ignoredc

o oT<!ATTLIST style:columns fo:column-gap %length tIMPLIEt<

n T

230

This attribSte has the same name as an X L property bSt it is attaihed to a diiierent eaementc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

4c0 c4 CoaSmn peiiiiiation
The <style:column< eaement ian be iontained in a <style:columns< eaements to speiiiy detaias oi anindiridSaa ioaSmnc
rg i nt T<style:column<

RrT 9T

This eaement is iontained in the <styles:columns< eaementc There ian be either no ioaSmn
eaements or there ian be the same nSmber oi ioaSmn eaements as speiiiied by the fo:columncount attribSteco oT<!ELEMENT style:column EMPTY<n T

n X Ls it is not possibae to speiiiy ioaSmns indiridSaaayc

The attribStes that yoS ian assoiiate tith the <style:column< eaement are:●CoaSmn tidth●

CoaSmn aeits rights Sppers and aoter spaie

CoaSmn Didth
se the style:rel-witth attribSte to speiiiy the tidth oi a ioaSmnc
The ioaSmn tidth is not speiiiied in a perientage a aengths bSt rather in terms oi reaatire teightsc The totaa spaie
araiaabae ior the entire tabae is distribSted among its ioaSmns aiiording to its reaatire tidthsc For e.ampaes ii
three ioaSmns are assigned the reaatire tidths 0s and 4s then the iirst ioaSmn tiaa take Sp 0s6 oi the araiaabae
tidths the seiond tiaa take Sp 0s4s and the aast ioaSmn tiaa take Sp 0s oi the araiaabae spaiec To aihiere these
iigSress aaa giren reaatire tidths mSst be sSmmed Sp isi. in the e.ampaeos and then eaih ioaSmn tiaa get as mSih
spaie as the proportion oi its otn reaatire tidth to the sSm oi aaa reaatire tidths indiiates i4s6 0s ior the aast
ioaSmn in the e.ampaeoc
rg i nt T

style:rel-witth

RrT 9T

The ioaSmn tidths are speiiiied as nSmbers instead oi aengthsc To get the absoaSte ioaSmn tidths
the spaie that is araiaabae ior a ioaSmned area is distribSted among the ioaSmns proportionaa tothese nSmbersc

o oT<!ATTLIST style:column style:rel-witth %number; teEt|IeEt<

CoaSmn Leits ights ppers and Loter paie
For eaih ioaSmns yoS ian speiiiy the aeits rights Sppers and aoter spaiec The right spaie oi a ioaSmn together
tith the aeit spaie oi the ne.t ioaSmn iorresponds to the gap betteen tto ioaSmnsc i a ioaSmned area iontains aseparator aine betteen ioaSmnss the spaie that is oiiSpied by the aine is iontained tithin the aeit and right spaies
and thereiore is not added to themc

Chapter 3 Text Content

231

rg i nt T

For aeit and right spaies:

fo:start-intent
fo:ent-intent
For Spper and aoter spaies:

fo:space-before
fo:space-afterRrT 9To oT<!ATTLIST style:column fo:start-intent %length: "0cm"<<!ATTLIST style:column fo:ent-intent %length: "0cm"<<!ATTLIST style:column fo:space-before %length: "0cm"<<!ATTLIST style:column fo:space-after %length: "0cm"<

4c0 c9 CoaSmn eparator
The <style:column-sep< eaement speiiiies the separator aine to Sse betteen ioaSmnscrg i nt T<style:column-sep<

RrT 9T

This eaement ian be iontained in a <style:columns< eaement to speiiiy the type oi separator aine to Sse betteen ioaSmnsco oT<!ELEMENT style:column-sep EMPTY<n T

X L does not sSpport ioaSmn separatorsc

The attribStes that yoS ian assoiiate tith the <style:column-sep< eaement are:●Line styae●Line tidth●

Line height●

Vertiiaa aine aaignment●

Line ioaor

Line tyaese the style:style attribSte to speiiiy the aine styae oi the ioaSmn separator ainec
rg i nt T

style:style

RrT 9To oT<!ATTLIST style:column-sep style:style(none|solit|tottet|tashet|tot-tashety "solit"<

Line Didth
se the style:witth attribSte to speiiiy the tidth oi the ioaSmn separator ainec

232

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

style:witth

RrT 9To oT<!ATTLIST style:column-sep style:witth %length; teEt|IeEt<

Line Oeightse the style:height to speiiiy the height oi the ioaSmn separator ainec
rg i nt T

style:heightRrT 9TThe raaSe oi this attribSte is a perientage that reaates to the height oi the ioaSmned areaco oT<!ATTLIST style:column-sep style:height %percentage; "100%"<

Vertiiaa Line aignment
se the style:vertical-align attribSte to speiiiy hot to rertiiaaay aaign a aine that is aess than 022l oi
its height tithin the ioaSmned areac
rg i nt T

style:vertical-alignRrT 9TThe raaSe oi this attribSte ian be either tops mittles or bottomc

o oT<!ATTLIST style:column-sep style:vertical-align (top|mittle|
bottomy "top"<Line Coaor
se the style:color attribSte to speiiiy the ioaor oi the ioaSmn separator ainec
rg i nt T

style:color

RrT 9To oT<!ATTLIST style:column-sep style:color %color; "t000000"<

4c0 c5 Proteit
eitions marked tith the style:protect attribSte shoSad not be ihangedc The Sser interiaie shoSad prerent
the Sser irom manSaaay making any ihangesc
rg i nt T

style:protect

RrT 9T

The style:protect attribSte is set by deiaSat ior ainked seitions or inde.esc emoring theproteition makes these seitions aiiessibae to the Ssers bSt Spdating the ainks or the inde. tiaa notpreserre the ihangesc

o oT<!ATTLIST style:properties style:protect %boolean; "false"<

Chapter 3 Text Content

233

4c04 Change Traiking in Te.t DoiSments
This seition desiribes hot the OpenOiiiiecorg soittare traiks ihanges to te.t iontentc

4c04c0 Traiked Changes
aa traiked ihanges to te.t doiSments are stored in a aistc The aist iontains an eaement ior eaih ihange made to
the doiSmentc i the <text:tracket-changes< eaement is absents ihange traiking is not enabaedc
rg i nt T<text:tracket-changes<

RrT 9To oT<!ELEMENT text:tracket-changes (text:changet-regionyt<

Traik Changes
This attribSte determines thether or not ihange traiking is enabaedc
rg i nt T

text:track-changes

RrT 9To oT<!ATTLIST text:tracket-changes text:track-changes %boolean;"true"<

Proteition
The OpenOiiiiecorg soittare sSpports ihange traiking proteitionc i proteition is enabaeds a Sser ian not enabae
or disabae the traiking oi ihangess and aaso ian not aiiept or rejeit any ihangesc Proteition is enabaed bysSppaying a proteition keyc
rg i nt T

text:protection-key

RrT 9To oT<!ATTLIST text:tracket-changes text:protection-key CtATAtIMPLIEt<

4c04c Changed egions
For erery ihanged region oi a doiSments there is one entry in the aist oi traiked ihangesc This entry iontains a aistoi aaa ihanges that tere appaied to the regionc The start and end oi this region are marked by the start and end
eaements that are desiribed in the ne.t seitionc234

rg i nt T<text:changet-region<

RrT 9T

Erery eaement has an Dc The eaements that mark the start and end oi a region Sse this D to identiiy the region to thiih they beaongc

o oT<!ELEMENT text:changet-region (text:insertion|text:teletion|
text:format-changeyt<<ATTLIST text:changet-region text:it It teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

The <text:changet-region< eaement has an additionaa attribSte that modiiies the deiaSat beharior thenthe appaiiation shots deaeted redaines inaine in a doiSmentc By deiaSats the redaine is merged into the te.t so thatthe starting and ending paragraphs are iombined tith the sSrroSnding te.t to iorm merged paragraphsc To ihange
this behariors yoS ian sSrpress the aast paragraph by setting the text:merge-last-paragraph attribSte tofalsecrg i nt T

text:merge-last-paragraph

RrT 9To oT

4c04c4<ATTLIST text:changet-region text:merge-last-paragraph %boolean; "true"<egion tart and End

There are three eaements that mark the start and the end oi a ihanged regions as ioaaots:●●●

Change start eaement P <text:change-start<
This eaement marks the start oi a region tith iontent there te.t has been inserted or the iormat has beenihangedc
Change end eaement P <text:change-ent<
This eaement marks the end oi a region tith iontent there te.t has been inserted or the iormat has beenihangedc
Change position eaement P <text:change<
This eaement marks a position in an empty region there te.t has been deaetedc

rg i nt T<text:change-start<<text:change-ent<<text:change<

RrT 9Taa three eaements hare an attribSte that speiiiies the D oi the region to thiih they beaongc

o oT<!ELEMENT text:change-start EMPTY<<!ELEMENT text:change-ent EMPTY<<!ELEMENT text:change EMPTY<<!ATTLIST text:change-start text:region-it IteEF teEt|IeEt<<!ATTLIST text:change-ent text:region-it IteEF teEt|IeEt<<!ATTLIST text:chang text:region-it IteEF teEt|IeEt<

4c04c9 nsertion
The <text:insertion< eaement iontains the iniormation that is reqSired to identiiy any insertion oi iontentc
This iontent ian be a pieie oi te.t tithin a paragraphs a thoae paragraphs or a thoae tabaec The inserted iontent
is part oi the te.t doiSment itseai and is marked by a ihange start and a ihange end eaementc
rg i nt T<text:insertion<

RrT 9To oT<!ELEMENT text:insertion (office:change-infoy<

E 4 oT Ti 19 I un1inei

Chapter 3 Text Content

235

<text:tracket-changes<<text:changet-region text:itp”c001”<<text:insertion<<office:change-info office:chg-authorp”Michael Brauer”
office:chg-tatep”04/1-/99”
office:chg-timep”12:4::0:”/<</text:insertion<</text:changet-region<</text:tracket-changes<...
<text:p<This is the original text<text:change-start text:region-itp”c001”/<,
but this has been attet</text:change-ent text:region-itp”c001”/<.
</text:p<

4c04c5 Deaetion<text:teletion< eaement iontains iontent that tas deaeted thiae ihange traiking tas enabaedc The position there the te.t tas deaeted is marked by the ihange position eaement i<text:change<ocrg i nt T<text:teletion<

RrT 9Ti part oi a paragraph tas deaeteds the te.t that tas deaeted is iontained in this eaement as a para graph eaementc i the deaeted te.t is reinserted into the doiSments the paragraph is joined tith theparagraph there the deaetion took paaiec

o oT<!ELEMENT text:teletion (office:change-info,%text;y<E 4 oT Tio T un1inei<text:tracket-changes<<text:changet-region text:itp”c002”<<text:teletion<<office:change-info office:chg-authorp”Michael Brauer”
office:chg-tatep”04/1-/99”
office:chg-timep”12:4::0:”<<text:p<, but this has been teletet</text:p<</text:teletion<</text:changet-region<</text:tracket-changes<...
<text:p<This is the original text<text:change text:region-itp”c002”/<.
</text:p<This e.ampae shots:

236●

Deaeted te.t but this has been teletet
This te.t is iontained in the <text:p< eaement tithin the <text:teletion< eaementc●

CSrrent te.t This is the original text.
This te.t is iontained in the <text:p< eaement at the end oi the e.ampaec●

Originaa te.t beiore deaetion took paaie
teletet.

OpenOffice.org XML File Format Working Draft

This is the original text, but this has been

Technical Reference Manual Version 2

December 2ee2

4c04c6 Format Change
iormat ihange eaement represents any ihange in iormatting attribStesc The region there the ihange took paaie
is marked by a ihange start and a ihange end eaementc<text:format-change<

rg i nt T
RrT 9To oT<!ELEMENT text:format-change (office:change-infoy<

n T

iormat ihange eaement does not iontain the aitSaa ihanges that took paaiec

4c09 Optionaa niormation
YoS ian iniaSde the iniormation desiribed in this seition in an X L doiSment to improre its periormaniec
Ooterers it is not essentiaac

4c09c0Sto

ark Fiae ior aphabetiiaa ndiies

To ease the ireation oi aaphabetiiaa indiiess OpenOiiiiecorg aaaots yoS to assign a so-iaaaed aSto mark iiaec Thisiiae iontains a aist oi keytordss and Spon Spdate oi an aaphabetiiaa inde. erery oiiSrrenie oi sSih a keytord in
the doiSment is marked as an aaphabetiiaa inde. entrycThe aSto mark iiae eaement is an XLinks and the
L isgiren by the xlink:href attribStec
rg i nt T

xlink:href

RrT 9To oT<!ATTLIST text:alphabetical-intex-auto-mark-file xlink:href
CtATA teEt|IeEt<<!ATTLIST text:alphabetical-intex-auto-mark-file xlink:type(simpley fixet "simple"<

Chapter 3 Text Content

237

CHAPTER

9

4

Tabae Content
This ihapter desiribes the OpenOiiiiecorg X L representation oi tabae and spreadsheet iontentc t iontains the
ioaaoting seitions:●

Generaa ntrodSition to OpenOiiiiecorg Tabaes●

CaaiSaation ettings●

Change Traiking●

Tabaes●CoaSmns

●

ots

●

Ceaas

●

Tabae Ceaa Content Vaaidations●

Sbtabaes●

Labea anges●

Named E.pressions●

Fiaters●

Database anges●

Data Piaot Tabaes●

Consoaidation●

DDE Links●

Tabae Formatting Properties●

CoaSmn Formatting Properties●

Tabae ot Formatting Properties●

Tabae Ceaa Formatting Properties

9c0 Generaa ntrodSition to OpenOiiiiecorg Tabaes
OpenOiiiiecorg Driter and OpenOiiiiecorg Caai doiSments ian iniaSde tabaess bSt the internaa strSitSre oi thetabaes ireated Ssing these appaiiations is diiierentc The diiierenies betteen the tabae strSitSres in both appaiiations are as ioaaots:239

●The strSitSre oi OpenOiiiiecorg Caai tabaes is simiaar to the strSitSre oi Sn-nested OT L and X L tabaesc n
OpenOiiiiecorg Caai X L doiSment does not iontain any 9r 4 T 9sisometimes iaaaed nested tabaesc●

The strSitSre oi OpenOiiiiecorg Driter tabaes is simiaar to the strSitSre oi nested OT L or X L tabaes that
do not hare any rertiiaaay merged ieaasc n OpenOiiiiecorg Driter X L doiSment does not iontain rertiiaaay
merged ieaasc

i a doiSment that iontains either a sSbtabae or rertiiaaay merged ieaass or boths is ionrerted to X Ls the strSitSre oi the tabae may ihangec This does not aiieit hot the tabae appears then the doiSment is dispaayedc
There are sereraa reasons thy yoS need to preserre the internaa OpenOiiiiecorg Driter tabae strSitSre:
0c The OpenOiiiiecorg P and iormSaas aiiess tabae ieaas Ssing names that are derired irom the internaa tabae
strSitSrec
c Dithin an OpenOiiiiecorg Driter tabaes rots may hare a ii.ed height or baikgroSndc i the internaa
OpenOiiiiecorg Driter tabae strSitSre is not preserreds there ioSad be rots that do not hare a iorresponding
rot in the OT L or X L representation oi the tabaec This ioSad aead to a aoss oi iniormationc
4c The internaa ioaSmn tidths oi an OpenOiiiiecorg Driter tabae do not hare to be the same as the dispaayed
ioaSmn tidthsc
The representation oi tabaes is based on a grid oi rots and ioaSmnsc ots take preiedenie orer ioaSmnsc The
tabae is dirided into rots and the rots are dirided into ieaasc Eaih ioaSmn iniaSdes a ioaSmn desiriptions bSt thisdesiription does not iontain any ieaasc
ots and ioaSmns appear in InAi.Inro9 and onTr 1i.Inro9c These groSps speiiiy thether or not to repeat arot or ioaSmn on the ne.t pagec

9c

DoiSment Proteition
YoS ian proteit the strSitSre oi a spreadsheet doiSment so that Ssers ian not inserts deaetes more or rename thetabaes in the doiSmentc YoS ian Sse an optionaa passtord to prerent Ssers irom resetting the tabae proteition iaag
to aaaot editingc
rg i nt T

table:structure-protectet
table:protection-key

RrT 9To oT<!ATTLIST office:boty table:structure-protectet %boolean;"false"<<!ATTLIST office:boty table:protection-key CtATA tIMPLIEt<

9c4 CaaiSaation ettings
preadsheet doiSments iontain settings that aSSect the calculation oS Sormulast Sor exam le the null aate or iteration settings. These settings must be savea in the aocument in the <table:calculation-settings<
element.
rg i nt T<table:calculation-settings<

RrT 9To oT

240<!ELEMENT table:calculation-settings (table:null-tate?, table:
iteration?y<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

The attribStes that yoS ian assoiiate tith the <table:calculation-settings< eaement are:●Case sensitire●

Preiision as shotn●

earih iriteria mSst appay to thoae ieaa●

Automatic Sina labels●

Null year

Case ensitireThis attribSte speiiiies thether or not to distingSish betteen Spper and aoter iase in te.t then iomparing ieaa
iontents ior iaaiSaationsc
rg i nt T

table:case-sensitiveRrT 9To oT<!ATTLIST table:calculation-settings table:case-sensitive %boolean; "true"<

Preiision as hotn
This attribSte speiiiies thether to periorm a iaaiSaation Ssing the roSnded raaSes dispaayed in the spreadsheet or
Ssing aaa oi the digits in a nSmberc
rg i nt T

table:precision-as-shown

RrT 9Ti the raaSe oi this attribSte is trues OpenOiiiiecorg Caai periorms the iaaiSaation Ssing the
roSnded raaSes dispaayed in the spreadsheetc i the raaSe oi this attribSte is falses OpenOiiiiec
org Caai periorms the iaaiSaation Ssing aaa oi the digits in the nSmber bSt dispaays a roSnded

nSmber as the resSatc
o oT

earih Criteria<!ATTLIST table:calculation-settings table:precision-as-shown%boolean; "false"<

Sst ppay to Dhoae Ceaa

This attribSte speiiiies thether or not the speiiiied searih iriterias aiiording to the regSaar e.pression Sseds mSst
appay to the entire ieaa iontentsc
rg i nt T

table:search-criteria-must-apply-to-whole-cell

RrT 9To oT<!ATTLIST table:calculation-settings table:search-criteriamust-apply-to-whole-cell %boolean; "true"<

Stomatii Find Labeas
This attribSte speiiiies thether or not to aStomatiiaaay iind the aabeas oi rots and ioaSmnsc

Chapter 4 Table Content

241

rg i nt T

table:automatic-fint-labels

RrT 9T<!ATTLIST table:calculation-settings table:automatic-fintlabels %boolean; "true"<o oT

NSaa Year
This attribSte speiiiies the start year ior year raaSes that iontain onay tto digitsc
rg i nt T

table:null-year

RrT 9T<!ATTLIST table:calculation-settings table:null-year %positiveInteger; "1930"<

o oT

9c4c0 NSaa Date
This eaement speiiiies the nSaa datec
rg i nt T<table:null-tate<

RrT 9To oT<!ELEMENT table:null-tate EMPTY<oT
1 4 un1
Tu u 4 un1T

n tar Oiiiies there are onay three possibae nSaa dates as ioaaots; 12/30/1-99s 01/01/1900s
and 01/01/190:c

The attribStes that yoS ian assoiiate tith the atable:null-tate< eaement are:●VaaSe Type and Date VaaSe

VaaSe Type and Date VaaSe
rg i nt T

table:value-type
table:tate-value

RrT 9To oT

9c4c<!ATTLIST table:null-tate table:value-type %valueType; tFIXEt"tate"
table:tate-value %tate; "1-99-12-30"<

teration

The <table:iteration< eaement enabaes iormSaas tith iteratire reierenies to be iaaiSaated aiter a speiiiii
nSmber oi iterationsc FormSaas tith iteratire reierenies are repeated Sntia the probaem is soaredc i this eaement is
not enabaeds a iormSaa tith an iteratire reierenie in a tabae iaSses an error messagec

242

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<table:iteration<

RrT 9To oT<!ELEMENT table:iteration EMPTY<

The attribStes that yoS ian assoiiate tith the atable:iteration< eaement are:
●

tatSs

●

teps

●

a.imSm diiierenie

tatSs
This attribSte speiiiies thether or not the iteration is enabaedc
rg i nt T

table:status

RrT 9To oT<!ATTLIST table:iteration table:status (enable|tisabley"tisable"<teps
This attribSte speiiiies the ma.imSm nSmber oi iterations aaaotedc
rg i nt T

table:steps

RrT 9To oT<!ATTLIST table:iteration table:steps %positiveInteger; "100"<

a.imSm DiiierenieThis attribSte speiiiies the ma.imSm diiierenie aaaoted betteen tto iaaiSaation resSatsc The iteration is stopped
ii the resSat is aess than the raaSe oi this attribStec
rg i nt T

table:maximum-tifferenceRrT 9To oT<!ATTLIST table:iteration table:maximum-tifference %float;"0.001"<

9c9 Change Traiking in preadsheetsn OpenOiiiiecorg Driter doiSmentss yoS ian not traik ihanges to tabaesc n OpenOiiiiecorg Caai doiSmentss
yoS ian traik ihanges to tabaesc This seition desiribes hot OpenOiiiiecorg Caai traiks ihanges to tabae iontentc

Chapter 4 Table Content

2439c9c0 Traiked Changes
OpenOiiiiecorg Caai stores aaa oi the ihanges to a spreadsheet doiSment in a aistc The aist iontains an eaement ior
eaih ihange made to the doiSmentc To traik the ihanges to a spreadsheet doiSments the <table:tracketchanges< eaement mSst be presentc
rg i nt T<table:tracket-changes<

RrT 9To oT<!ELEMENT table:tracket-changes (table:cell-content-change |table:insertion | table:teletion | table:movement | table:
reiectiony<

Traik Changes
This attribSte speiiiies thether or not the ihange traiking is enabaedc
rg i nt T

table:track-changes

RrT 9To oT<!ATTLIST table:tracket-changes table:track-changes %boolean;"true"<

Proteition
This attribSte speiiiies that the ihange traiking data is proteiteds thiih prerents Ssers irom aiiepting or rejeiting
ihanges or disabaing the ihange traikingc i the ihange traiking is proteiteds a Sser ian stiaa make ihanges to theiontent oi the doiSmentc The proteition is assigned by the appaiiationc
rg i nt T

table:protection-key

RrT 9To oT<!ATTLIST table:tracket-changes table:protection-key CtATAtIMPLIEt<

9c9c Dependenies
The <table:tepentences< eaement iontains the iniormation thiih ihange to this ihange dependsc Ereryeaement oi the traiked-ihanges ian iontain a <table:tepentences< eaementc
rg i nt T<table:tepentences<

RrT 9To oT<!ELEMENT table:tepentences (table:tepentenceyt<

9c9c4 Dependenie
The <table:tepentence< eaement iontains the iniormation oi one ihange aition thiih the parent eaement
depends toc

244

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<table:tepentence<

RrT 9To oT<!ELEMENT table:tepentence EMPTY<

The attribStes that yoS ian assoiiate tith this eaement are:●D

9c9c9 Deaetions
The <table:teletions< eaement iontains aaa deaetions thiih are eiieited tith this ihangec
rg i nt T<table:teletions<RrT 9To oT<!ELEMENT table:teletions (table:cell-content-teletion |table:change-teletionyt<

9c9c5 Ceaa Content Deaetion
This eaement iontains the iontent oi a deaeted ieaac
rg i nt T<table:cell-content-teletion<

RrT 9To oT<!ELEMENT table:cell-content-teletion (table:cell-attress?,table:change-track-table-cell?y<The attribStes that yoS ian assoiiate tith this eaement are:●D

9c9c6 Change Deaetion
This eaement iontains the iniormation oi deaeted ihangesc
rg i nt T<table:change-teletion<

RrT 9To oT<!ELEMENT table:change-teletion EMPTY<

The attribStes that yoS ian assoiiate tith this eaement are:●D

Chapter 4 Table Content

245

9c9cm nsertion
The <table:insertion< eaement iontains the iniormation that is reqSired to identiiy any insertion oi
iontentc This iontent ian be one or more rotss one or more ioaSmnss or a tabaec
rg i nt T<table:insertion<

RrT 9To oT<!ELEMENT table:insertion (office:change-info, table:tepentences?, table:teletions?y<

The attribStes that yoS ian assoiiate tith this eaement are:●D●

iieptanie tate●ejeiting Change D

●

Type

●

Position

●

CoSnt

●

Tabae

Type
This attribSte speiiiies the type oi the insertionc
rg i nt T

table:type

RrT 9To oT<!ATTLIST table:insertion table:type (row | column | tableyteEt|IeEt<

Position
This attribSte speiiiies the position there the insertion tas made in the tabaec
rg i nt T

Table:position

RrT 9To oT<!ATTLIST table:insertion table:position %integer; teEt|IeEt<

CoSnt
This attribSte speiiiies the ioSnt oi inserted rots | ioaSmns | tabaesc
rg i nt T

table:countRrT 9To oT

246<!ATTLIST table:insertion table:count %positiveInteger; "1"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

TabaeThis attribSte speiiiies the tabae there the insertion isc This attribSte onay e.istss ii it is a ioaSmn or rot insertionc
rg i nt T

table:table

RrT 9To oT<!ATTLIST table:insertion table:table %Integer; tIMPLIEt<

E 4 oT Ti 19 I un1inei

iu1i4io TT<table:tracket-changes<<table:insertion table:itp"c001" table:acceptance-statep"penting" table:
typep"column" table:positionp"4"<<office:change-info office:chg-authorp”Sascha Ballach”
office:chg-tatep”04/1-/99”
office:chg-timep”12:4::0:”/<</table:insertion<</table:tracket-changes<

9c9cr Deaetion<table:teletion< eaement iontains iontent that tas deaeted thiae ihange traiking tas enabaedc
rg i nt T<table:teletion<

RrT 9Ti the iontent oi a ieaa tas deaeteds the deaeted ieaa is iontained in the <table:tepentences< eaementc i the ieaa iontent tas giren thiae ihange traiking tas enabaed theprerioSs ieaa is iontained in the <table:tepentence< eaementc i the iontent tas giren
thiae ihange traiking tas disabaed the prerioSs ieaa is iontained in the <table:cellcontent-teletion< eaementc

o oT<!ELEMENT table:teletion (office:change-info, table:tepentences?, table:teletions?, table:cut-offs?y <The attribStes that yoS ian assoiiate tith this eaement are:●D●

iieptanie tate●ejeiting Change D

●

Type

●

Position

●

Tabae

●

Sati Deaetion panned

TypeThis attribSte speiiiies the type oi the insertionc

Chapter 4 Table Content

247

rg i nt T

table:type

RrT 9To oT<!ATTLIST table:teletion table:type (row | column | tableyteEt|IeEt<

Position
This attribSte speiiiies the position there the deaetion tas made in the tabaec
rg i nt T

table:position

RrT 9To oT<!ATTLIST table:teletion table:position %integer; teEt|IeEt<

Tabae
This attribSte speiiiies the tabae there the deaetion isc This attribSte onay e.istss ii it is a ioaSmn or rot deaetionc
rg i nt T

table:table

RrT 9To oT<!ATTLIST table:teletion table:table %Integer; tIMPLIEt<

Sati Deaetion pannedThis attribSte speiiiies the ioSnt oi deaetions thiih tere done tith this deaetionc Onay the iirst deaetion iontains
this attribStec
rg i nt T

table:base-change-position

RrT 9To oT<!ATTLIST table:teletion table:multi-teletion-spannet %integer; tIMPLIEt<

9c9c CSt Oiis
<table:cut-offs< eaement iontains the iniormation aboSt iSt oiisc This means ecgc i deaete a ioaSmn ina range thiih tas mored thiae ihange traiking tas enabae this hare to storec This eaement iontains sSih iniormationsc
rg i nt T<table:cut-offs<

RrT 9To oT

248<!ELEMENT table:cut-offs (table:insertion-cut-off | table:
movement-cut-offt | (table:insertion-cut-off, table:movementcut-offtyy <OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c9c02 nsertion CSt Oii
This eaement iontains the iniormation there a insertion tas deaeted and thiihc
rg i nt T<table:insertion-cut-off<RrT 9To oT<!ELEMENT table:insertion-cut-off EMPTY <The attribStes that yoS ian assoiiate tith this eaement are:●D●

position

Position
This attribSte speiiiies the position there the insertion tas deaetedc
rg i nt T

table:position

RrT 9To oT

9c9c00<!ATTLIST table:insertion-cut-off table:position %integer;
teEt|IeEt<

orement CSt Oii

This eaement iontains the iniormation there a morement tas deaeted and thiihc
rg i nt T<table:movement-cut-off<RrT 9To oT<!ELEMENT table:movement-cut-off EMPTY <The attribStes that yoS ian assoiiate tith this eaement are:●D●

start positions end positions position

tart Positions End Positions Position
This attribSte speiiiies the position there in the morement tas deaetedc
rg i nt T

table:start-position; table:ent-position; table:position

RrT 9To oT<!ATTLIST table:movement-cut-off table:start-position %
integer; tIMPLIEt<<!ATTLIST table:movement-cut-off table:ent-position %integer;tIMPLIEt<<!ATTLIST table:movement-cut-off table:position %integer;tIMPLIEt<

Chapter 4 Table Content

249

E 4 oT Tio T un1ineii4ionTr 1iAruoritni1n ion1 4u1ion1 1<table:tracket-changes<<table:teletion table:itp”c002” table:acceptance-statep"penting" table:
typep"column" table:positionp"9"<<office:change-info office:chg-authorp”Sascha Ballach”
office:chg-tatep”04/1-/99”
office:chg-timep”12:4::0:”<</table:teletion<</table:tracket-changes<

9c9c0

orement<table:movement< eaement iontains the iniormation that is reqSired to identiiy any morement oi iontentc
This iontent ian be a ieaa iontent or a ieaa range iontentc
rg i nt T<table:movement<

RrT 9To oT<!ELEMENT table:movement (table:source-range-attress, table:
target-range-attress, office:change-info, table:tepentences?,
table:teletions?y<

The attribStes that yoS ian assoiiate tith this eaement are:●D●

iieptanie tate●ejeiting Change D

9c9c04 Target ange ddresss oSrie ange ddress
These eaements iontains a ieaa address or a ieaa range addressc
rg i nt T

table:target-range-attresstable:source-range-attressRrT 9To oT<!ELEMENT table:target-range-attress EMPTY<<!ELEMENT table:source-range-attress EMPTY<

The attribStes that yoS ian assoiiate tith these eaements are:●●CoaSmns ots and Tabae
tart ioaSmns End ioaSmns tart rots End rots tart tabaes and End tabae

CoaSmns ots and Tabaei the range address is a ieaa address these three attribStes are neiessaryc

250

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:column
table:row
table:table

RrT 9To oT<!ATTLIST table:target-range-attress table:column %Integer;tIMPLIEt<<!ATTLIST table:target-range-attress table:row %Integer;tIMPLIEt<<!ATTLIST table:target-range-attress table:table %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:column %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:row %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:table %Integer;tIMPLIEt<

tart CoaSmns End CoaSmns tart ots End ots tart Tabaes and End Tabaei the range address is a range address instead oi a ieaa addresss these attribStes are neiessaryc
rg i nt T

table:start-column
table:ent-column
table:start-row
table:ent-row
table:start-table
table:ent-table

RrT 9To oT<!ATTLIST table:target-range-attress table:start-column %Integer; tIMPLIEt<<!ATTLIST table:target-range-attress table:start-row %Integer;tIMPLIEt<<!ATTLIST table:target-range-attress table:start-table %Integer; tIMPLIEt<<!ATTLIST table:target-range-attress table:ent-column %Integer; tIMPLIEt<<!ATTLIST table:target-range-attress table:ent-row %Integer;tIMPLIEt<<!ATTLIST table:target-range-attress table:ent-table %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:start-column %Integer; tIMPLIEt<<!ATTLIST table:source-range-attress table:start-row %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:start-table %Integer; tIMPLIEt<<!ATTLIST table:source-range-attress table:ent-column %Integer; tIMPLIEt<<!ATTLIST table:source-range-attress table:ent-row %Integer;tIMPLIEt<<!ATTLIST table:source-range-attress table:ent-table %Integer;tIMPLIEt<

Chapter 4 Table Content

251E 4 oT Tignvu1.i4io TT<table:tracket-changes<<table:changet-region table:itp”c003”<<table:moving<<office:change-info office:chg-authorp”Sascha Ballach”
office:chg-tatep”04/1-/99”
office:chg-timep”12:4::0:”/<</table:moving<</table:changet-region<</table:tracket-changes<...
<table:table-cell ...<
<table:change-start table:region-itp”c003”/<<text:p<This is the original text, but this has been attet.
</text:p<<table:change-ent table:region-itp”c003”/<</table:table-cell<...
<table:table-cell ...<
<table:change table:region-itp”c003”/<</table:table-cell<

9c9c09 Change Traik Ceaa
<table:change-track-table-cell< eaement iontains aaa iniormation oi a <table:table-cell<thiih are needed in the ihange traikc t iontains some additionaa iniormations thiih are onay in the ihange traik
neededc
rg i nt T<table:change-track-table-cell<RrT 9To oT<!ELEMENT table:change-track-table-cell (text:pay<

Ceaa ddress
i the ieaa is a iormSaa ieaa a ieaa address attribSte is neiessaryc
rg i nt T

table:cell-attressRrT 9T

This attribSte is onay eraaSated ior ieaas thiih are in the traiked ihanges and a iormSaa ieaac

o oT<!ATTLIST table:change-track-table-cell table:cell-attress %cellattress; tIMPLIEt<

atri. Coreredi the ieaa is a matri. ieaa and not the base oi the matri. this attribSte is neiessaryc252

rg i nt T

table:matrix-coveret

RrT 9T

This attribSte is onay eraaSated ior ieaas thiih are in the traiked ihanges and a iormSaa ieaac

o oT<!ATTLIST table:change-track-table-cell table:matrix-coveret (true| falsey “false”<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c9c05 Ceaa Content Change<table:cell-content-change< eaement iontains the iniormation that is reqSired to identiiy any
ihange oi the ieaa iontentc
rg i nt T<table:cell-content-change<

RrT 9To oT<!ELEMENT table:cell-content-change (table:cell-attress,
office:change-info, table:tepentences?, table:teletions?,
table:previousy<

The attribStes that yoS ian assoiiate tith this eaement are:●D●

iieptanie tate●ejeiting Change D

9c9c06 Ceaa ddressThis eaement iontains a ieaa addressc There is a attribSte speiiiied thiih iontains the same iniormationc BSt
need this eaement beiaSse in a ihange traik the raaSes ian be negatire or greater than the tabae rangec
rg i nt T

table:cell-attressRrT 9To oT<!ELEMENT table:cell-attress EMPTY<

The attribStes that yoS ian assoiiate tith this eaement are:●CoaSmns ots and Tabae

CoaSmns ots and Tabae
rg i nt T

table:column, table:row, table:table

RrT 9To oT<!ATTLIST table:cell-attress table:column %Integer; tIMPLIEt<<!ATTLIST table:cell-attress table:row %Integer; tIMPLIEt<<!ATTLIST table:cell-attress table:table %Integer; tIMPLIEt<

9c9c0m PrerioSs
This eaement iontains the prerioSs ieaa thiih is orertritten tith this ihangec
rg i nt T

table:previous

RrT 9To oT<!ELEMENT table:previous table:change-track-table-cell<

Chapter 4 Table Content

253

The attribStes that yoS ian assoiiate tith this eaement are:D●

9c9c0rejeition<table:cell-content-change< eaement iontains the iniormation that is reqSired to identiiy any
ihange oi the ieaa iontentc
rg i nt T<table:cell-content-change<

RrT 9To oT<!ELEMENT table:reiection (office:change-info, table:tepentences?, table:teletions?y<

The attribStes that yoS ian assoiiate tith this eaement are:●D●

iieptanie tate●ejeiting Change D

9c9c0 Common Change Traiking ttribStes
YoS ian Sse the attribStes desiribed in this seition tith the ioaaoting ihange traiking eaements:

D
This attribSte speiiiies the D that OpenOiiiiecorg Caai assigns to the ihange aitionc
rg i nt T

table:itRrT 9TThe raaSe oi this attribSte mSst be SniqSec

o oT<!ATTLIST table:reiection table:it CtATA teEt|IeEt<

iieptanie tateThis attribSte speiiiies thether the ihange is aiiepteds rejeiteds or pendingc
rg i nt T

table:acceptance-state

RrT 9To oT<!ATTLIST table:reiection table:acceptance-state (acceptet |reiectet | penting y "penting"<

ejeiting Change Di a ihange is rejeiteds this attribSte speiiiies the D that OpenOiiiiecorg Caai assigns to the rejeited ihange
aitionc

254

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

table:reiecting-change-it

rg i nt T
RrT 9T<!ATTLIST table:reiection table:reiecting-change-it %positiveInteger; tIMPLIEt<

o oT

9c5 Tabaes
9c5c0 Tabae
The tabae eaement desiribes a tabaec
rg i nt T<table:table<

RrT 9T

The iontent oi a tabae eaement is one or more groSps oi ioaSmns and rotsc

o oT<!ENTITY % table-columns "( table:table-columns | ( table:tablecolumn | table:table-column-group yt y"<<!ENTITY % table-heater-columns "table:table—heater-columns"<<!ENTITY % table-rows "( table:table-rows | ( table:table-rowt |table:table-row-group y y"<<!ENTITY % table-heater-rows "table:table-heater-rows"<<!ENTITY % table-column-groups "( (%table-heater-columns;?, %table-columns;y |(%table-columns;, %table-heater-columns;, %table-columns;?y y"<<!ENTITY % table-row-groups "( (%table-heater-rows;?, %tablerows;y | (%table-rows;, %table-heater-rows;, %table-rows;?y y"<<!ELEMENT table:table (table:view-settings, table:table-source?,table:scenario?, table:shapes?, %table-column-groups;,%tablerow-groups;y<Tabae Name
The table:name attribSte speiiiies the name oi a tabaec
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:table table:name CtATA teEt|IeEt<

Tabae tyae
The table:style-name attribSte desiribes the iormatting properties oi a tabaes sSih as tidth and baikgroSnd ioaorc The tabae styae ian be either an aStomatii or iommon styaec

Chapter 4 Table Content

255

rg i nt T

table:style-name

RrT 9TYoS deiine a tabae styae Ssing a <style:style< eaement and a iamiay attribSte raaSe oi
tablec The <table:table< eaement iniaSdes a table:style-name attribSte that reierenies the styae by the style:name attribSteco oT<!ATTLIST table:table table:style-name %style-name teEt|IeEt<

E 4 oT Ti 4 T ih yT<style:style style:namep"Table 1" style:familyp"table"<<style:properties fo:witthp"12cm"
fo:backgrount-colorp"light-grey"/<</style:style<<table:table table:namep"Table 1" table:style-namep"Table 1"<...
</table:table<

DDE Conneition
rnfoemation to be supplied.
rg i nt T

office:tte-source
office:tte-commant
office:tte-moteRrT 9To oT<!ATTLIST table:table office:tte-source CtATA tIMPLIEt<<!ATTLIST table:table office:tte-commant CtATA tIMPLIEt<<!ATTLIST table:table office:tte-mote CtATA tIMPLIEt<

Proteited
The table:protectet attribSte speiiiies thether or not a tabae is proteited irom editingc i the tabae is
proteiteds the table:protection-key attribSte ian speiiiy a passtord to prerent a Sser irom resetting theproteition iaag to enabae editingc i a tabae is proteiteds aaa oi the tabae eaements and the ieaa eaements tith astyle:cell-protect attribSte set to true are proteitedc
rg i nt T

table:protectet and table:protection-key

RrT 9T

These attribStes ian be attaihed to the <table:table< eaementc

o oT<!ATTLIST table:table table:protectet %boolean; "false"<<!ATTLIST table:table table:protection-key CtATA tIMPLIEt<

Print anges
The table:print-ranges attribSte speiiiies the print ranges oi the tabaec t iontains a aist oi ieaa addresses
or ieaa range addressesc

256

rg i nt T

table:print-ranges

RrT 9T

This attribSte ian be assoiiated tith the <table:table< eaementc

o oT<!ATTLIST table:table table:print-ranges %cell-range-attresslist; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c5c Tabae oSrie
i a tabae is ainked to an originaa tabaes the originaa tabae is represented by a tabae soSrie eaementc
rg i nt T<table:table-source<

RrT 9T<!ELEMENT table:table-source EMPTY<o oT

The attribStes that yoS ian assoiiate tith the atable:table-source< eaement are:
●

ode

●

L

●

Fiater name●

Tabae name●

Fiater options●

eiresh deaayode
The table:mote attribSte speiiiies hot data shoSad be iopied betteen the ainked tabae and the originaa tabaec
rg i nt T

table:moteRrT 9T

This attribSte is mandatoryc

o oT<!ATTLIST table:table-source table:mote ( "copy-all" | "copyresults-only" y "copy-all"<L
The XLink attribStes speiiiy therg i nt T

L oi the doiSment iontaining the originaa tabaec

xlink:types xlink:actuates and xlink:href

RrT 9To oT<!ATTLIST table:table-source xlink:type (simpley tFIXEt"simple"<<!ATTLIST table:table-source xlink:actuate (oneequesty"oneequest"<<!ATTLIST table:table-source xlink:href %url; teEt|IeEt<

Fiater Name
The table:filter-name attribSte speiiiies the iiae type oi the doiSment iontaining the originaa tabaec
rg i nt T

table:filter-name

RrT 9TThe raaSe oi this attribSte is appaiiation-speiiiiico oT<!ATTLIST table:table-source table:filter-name CtATA tIMPLIEt<

Chapter 4 Table Content

257

Fiater Options
The table:filter-options attribSte speiiiies optionaa settings aboSt the iiae typec
rg i nt T

table:filter-options

RrT 9TThe raaSe oi this attribSte is appaiiation-speiiiiico oT<!ATTLIST table:table-source table:filter-options CtATAtIMPLIEt<

Tabae Name
The table:table-name attribSte speiiiies the name oi the tabae in the originaa tabae doiSmentc i the tabae
name is not speiiiieds the appaiiation Sses the iirst tabae in the doiSmentc
rg i nt T

table:table-name

RrT 9To oT<!ATTLIST table:table-source table:table-name CtATA tIMPLIEt<

eiresh Deaay
The table:refresh-telay attribSte speiiiies the time deaay betteen reiresh aitionsc
rg i nt T

table:refresh-telay

RrT 9T

This attribSte ian be assoiiated tith the <table:tatabase-range< eaementc

o oT<!ATTLIST table:table-source table:refresh-telay
timeturation; tIMPLIEt <%9c5c4 ienario Tabae
The <table:scenario< eaement represents a sienario tabaec The name oi the tabae and the name oi thesienario are the samec The sienario is dispaayed in the regSaar tabae preieeding the sienario tabaec Onay one
sienario tabae ian be aitire at one timec
rg i nt T<table:scenario<

RrT 9To oT<!ELEMENT table:scenario EMPTY<

The attribStes that yoS ian assoiiate tith this eaement are:258●

Dispaay Border●

Border Coaor●

Copy Baik●

Copy tyaes●

Copy FormSaas●s itireOpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●●

ienario anges
Comment

Dispaay Border
The table:tisplay-borter attribSte speiiiies thether or not to dispaay the border oi the sienarioc
rg i nt T

table:tisplay-borterRrT 9To oT<!ATTLIST table:scenario table:tisplay-borter %boolean;"true"<

Border Coaor
The table:borter-color attribSte speiiiies the ioaor oi the borderc
rg i nt T

table:borter-color

RrT 9To oT<!ATTLIST table:scenario table:borter-color %color; tIMPLIEt<

Copy BaikThe table:copy-back attribSte speiiiies thether or not data is iopied baik into the aitire sienario tabae ii
another sienario is aitiratedc
rg i nt T

table:copy-backRrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is trues yoS ian direitay edit

the data ior eaih sienario in the sienario tabaec
o oT<!ATTLIST table:scenario table:copy-back %boolean; "true"<

Copy tyaes
The table:copy-styles attribSte speiiiies thether or not to iopy the ieaa styaes tith the datac
rg i nt T

table:copy-styles

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST table:scenario table:copy-styles %boolean; "true"<

Copy FormSaas
The table:copy-formulas attribSte speiiiies thether or not to iopy the iormSaasc

Chapter 4 Table Content

259

rg i nt T

table:copy-formulas

RrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is trues the iormSaas are iopiedc
i the raaSe is falses onay the raaSes resSating irom the iormSaas are iopiedc

o oT<!ATTLIST table:scenario table:copy-formulas %boolean; "true"<s itireThe table:is-active attribSte speiiiies thether or not the iSrrent sienario is aitirec
rg i nt T

table:is-active

RrT 9To oT<!ATTLIST table:scenario table:is-active %boolean; teEt|IeEt<

ienario anges
The table:scenario-ranges attribSte speiiiies the range oi this sienarioc
rg i nt T

table:scenario-ranges

RrT 9TThe raaSe oi this attribSte is a aist oi ieaa range addressesc

o oT<!ATTLIST table:scenario table:scenario-ranges %cell-rangeattress-list; teEt|IeEt<

Comment
The table:comment attribSte iontains a iomment aboSt the sienarioc
rg i nt T

table:comment

RrT 9To oT<!ATTLIST table:scenario table:comment CtATA tIMPLIEt<

9c5c9 hapes
This eaement iontains aaa shapes tith an anihor on a tabaec This is a iontainer eaement and does not hare any
assoiiated attribStescrg i nt T<table:shapes<

RrT 9T
o oT

260<!ELEMENT table:shapes ANY<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c6 CoaSmns
9c6c0 GroSping
CoaSmns ian be groSpedc Erery groSp ian iontain a net groSps ioaSmnss and ioaSmn headersc Erery groSp ian
be risibae or hiddenc
The <table:table-column-heaters< shoSad onay be separated by atable:table-columngroup< eaementss so that ii the table:table-column-group does not e.ist there is onay one <table:table-heater-columns< eaementc
rg i nt T<table:table-column-group<

RrT 9T

There ian onay be one <table:table-heater-columns< eaement in this eaementc

o oT<!ELEMENT table:table-column-group “( table:table-heater-columns |table:table-column | table:table-column-groupyt” <The attribStes that yoS ian assoiiate tith this eaement are:●

Dispaay

DispaayThis attribSte speiiiies thether or not the groSp is risibaec
rg i nt T

table:tisplay

RrT 9To oT<!ATTLIST table:table-column-group table:tisplay %boolean; “true”<

9c6c CoaSmn GroSps
There are tto types oi ioaSmn groSpss as ioaaots:●

H 4t Ii.Inro9
header groSp is a groSp oi ioaSmns that repeat on eaih page ii the tabae e.tends orer sereraa pagesc●

Bntyi.Inro9
body groSp is a groSp oi ioaSmns that do not repeat aiross pagesc Typiiaaays a body groSp iontains theiontent oi the tabae that is not part oi the headerc

Chapter 4 Table Content

261

rg i nt T

<table:table-heater-columns<<table:table-columns<

RrT 9T

The tabae header ioaSmn eaement represents a header ioaSmnc The tabae ioaSmn eaement represents a body ioaSmnc
YoS ian omit the <table:table-columns< eaements in the same tay that yoS ian omit
the<TBOtY< tag in OT Lc tabae mSst iontain at aeast one ioaSmn groSps bSt onay one header
groSpc body groSp mSst not ioaaot another body groSpc

o oT<!ELEMENT table:table-heater-columns ( table:table-column | table:table-column-group yt<<!ELEMENT table:table-columns ( table:table-column | table:tablecolumn-group yt<

n 9T

ppaiiations may sSpport ioaSmn header groSpss bSt this is not essentiaac i a Sser agent does not
sSpport header groSpss it mSst proiess header groSps as body groSpsc
There are no ioaSmn groSps in X Lc

9c6c4 CoaSmn Desiription
Erery ioaSmn in a tabae has a ioaSmn desiription eaementc i tto or more ioaSmns are adjoining and hare thesame propertiess yoS ian desiribe them Ssing a singae <table:table-column< eaementc
rg i nt T<table:table-column<

RrT 9To oT
n 9T<!ELEMENT table:table-column EMPTY<
The <table:table-column< eaement is simiaar to the X L <fo:table-column<
eaementc

NSmber oi CoaSmns epeated
The table:number-columns-repeatet attribSte speiiiies the nSmber oi ioaSmns to thiih a ioaSmn
desiription appaiesc
rg i nt T
RrT 9T

table:number-columns-repeatet
i tto or more ioaSmns are adjoinings and hare the same propertiess yoS ian Sse a singae<table:table-column< eaement to desiribe themcn this iases yoS Sse a table:number-columns-repeatet attribSte to speiiiy thenSmber oi sSiiessire ioaSmns to thiih the desiription appaiesc YoS speiiiy this attribSte tiththe <table:table-column< eaementc

o oT<!ATTLIST table:table-column
table:number-columns-repeatet %number; "1"<

CoaSmn tyaetabae styae stores the iormatting properties oi a tabae ioaSmns sSih as tidth and baikgroSnd ioaorc The tabae
styae ian be either an aStomatii or a iommon styaec YoS speiiiy the styae oi a ioaSmn Ssing a tabae styaec

262

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:style-name

RrT 9T

To deiine the styae oi the ioaSmns yoS Sse a <style:style< eaement and a iamiay attribSte
raaSe oi tablec The <table:table-column< eaement iniaSdes a table:stylename attribSte that reierenies the styae by the style:name attribSteco oT<!ATTLIST table:style-name %style-name; teEt|IeEt;<

Visibiaity
The table:visibility attribSte speiiiies thether the ioaSmn is risibaes iiatereds or ioaaapsedc
rg i nt T

table:visibility

RrT 9T

This attribSte is assoiiated tith the <table:table-column< eaementc
i the raaSe oi this attribSte is filters the ioaSmn is aaso ioaaapsedc

o oT<!ATTLIST table:table-column table:visibility ( visible |collapse | filter y "visible"<

DeiaSat Ceaa tyae
The table:tefault-cell-style-name attribSte speiiiies the deiaSat ieaa styaec Ceaas tithoSt a styae Sse
this styae then there is no deiaSat ieaa styae speiiiied ior the iSrrent ioaSmnc
rg i nt T

table:tefault-cell-style-name

RrT 9T

This attribSte is assoiiated tith the <table:table-column< eaementc

o oT<!ATTLIST table:table-column table:tefault-cell-style-namestyle-name; tIMPLIEt<%

E 4 oT Ti 4 T iAu ri rI ionTr 19
This e.ampae shots the OpenOiiiiecorg X L iode ior a tabae tith three ioaSmnsc<style:style style:namep"Table 1" style:familyp"table"<<style:properties fo:witthp"12cm"
fo:backgrount-colorp"light-grey"/<</style:style<<style:style style:namep"Col1" style:familyp"table-column"<<style:properties fo:witthp"2cm"/<</style:style<<style:style style:namep"Col2" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"Col3" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<table:table table:namep"Table 1" table:style-namep"Table 1"<<table:table-columns<<table:table-column table:style-namep"Col1"/<<table:table-column table:style-namep"Col2"/<<table:table-column table:style-namep"Col3"/<</table:table-columns<...
</table:table<
Chapter 4 Table Content

263

9cm

ots
9cmc0 GroSpingots ian be groSpedc Erery groSp ian iontain a net groSps rotss and rot-headersc Erery groSp ian be risibae
or hiddenc
The table:table-row-heaters eaement ian onay be separated by table:table-row-groupeaementss so that ii table:table-row-group does not e.ist there is onay one table:table-heaterrows eaementc
rg i nt T<table:table-row-group<

RrT 9T

There ian onay be one table:table-heater-rows eaement in this eaementc

o oT<!ELEMENT table:table-row-group “( table:table-heater-rows |table:table-row | table:table-row-groupyt” <n 9TThe attribStes that yoS ian assoiiate tith this eaement are:●

Dispaay

DispaayThis attribSte speiiiies thether or not the groSp is risibaec
rg i nt T

table:tisplay

RrT 9T<!ATTLIST table:table-row-group table:tisplay %boolean; “true”<

o oT

9cmc

ot GroSps

There are tto types oi rot groSpss as ioaaots:●

H 4t Ii.Inroheader groSp is a groSp oi rots that repeat on eaih page ii the tabae e.tends orer sereraa pagesc●

Bntyi.Inrobody groSp is a groSp oi rots that do not repeat aiross pagesc Typiiaaays a body groSp iontains the iontent
oi the tabae that is not part oi the headerc

264

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<table:table-heater-rows<<table:table-rows<

RrT 9T

The tabae header rots eaement represents a header rotc The tabae rot eaement represents a bodyrotc
YoS ian omit the <table:table-rows< eaements in the same tay that yoS ian omit
the<TBOtY< tag in OT Lc tabae mSst iontain at aeast one rot groSps bSt onay one header
groSpc body groSp mSst not ioaaot another body groSpc<!ELEMENT table:table-heater-rows ( table:table-row | table:tablerow-group yt<<!ELEMENT table:table-rows ( table:table-row | table:table-rowgroup yt<

o oT

ppaiiations may sSpport rot header groSpss bSt this is not essentiaac i a Sser agent does not
sSpport header groSpss it mSst proiess header groSps as body groSpsc

n 9T

9cmc4

ot

The <table:table-row< eaement iontsins other eaements that speiiiy the iontent oi the tabae rotc
rg i nt T<table:table-row<

RrT 9To oT<!ENTITY % table-cell"(table:table-cell|table:coveret-table-celly"<<!ELEMENT table:table-row %table-cell;t<n 9T

The <table:table-row< eaement is simiaar to the X L <fo:table-row< eaementc

NSmber oi ots epeated
The table:number-rows-repeatet attribSte speiiiies the nSmber oi rots to thiih a rot eaement appaiesc
i tto or more rots are adjoinings and hare the same iontent and propertiess yoS ian Sse a singae <table:table-row< eaement to desiribe themc
rg i nt T

table:number-rows-repeatet

RrT 9TYoS speiiiy this attribSte tith the <table:table-row< eaementc

o oT<!ATTLIST table:table-row
table:number-rows-repeatet %number; "1"<n 9T

YoS ian not repeat a rot that iontains a rertiiaaay merged ieaac

ot tyaetabae styae stores the iormatting properties oi a tabae rots sSih as height and baikgroSnd ioaorc The tabae styae
ian be either an aStomatii or a iommon styaec YoS speiiiy the styae oi a rot Ssing a tabae styaec

Chapter 4 Table Content

265

rg i nt T

table:style-name

RrT 9T

To deiine the styae oi the rots yoS Sse a <style:style< eaement and a iamiay attribSte raaSeoi tablec The <table:table-row< eaement iniaSdes a table:style-name attribStethat reierenies the styae by the style:name attribSteco oT<!ATTLIST table:table-row
table:style-name %style-name; tIMPLIEt;<

n 9T

The tabae rot styae attribSte is simiaar to the X L <fo:table-row< eaementc

Visibiaity
The table:visibility attribSte speiiiies thether the rot is risibaes iiatereds or ioaaapsedc
rg i nt T

table:visibility

RrT 9T

This attribSte is assoiiated tith the <table:table-row< eaementc
i the raaSe oi this attribSte is filters the rot aaso ioaaapsedc

o oT<!ATTLIST table:table-row table:visibility ( visible |collapse | filter y "visible"<

DeiaSat Ceaa tyae
The table:tefault-cell-style-name attribSte speiiiies the deiaSat ieaa styaec Ceaas tithoSt an indiridSaa styae Sse the deiaSat styaec
rg i nt T

table:tefault-cell-style-name

RrT 9T

This attribSte is assoiiated tith the <table:table-row< eaementc

o oT<!ATTLIST table:table-row table:tefault-cell-style-namestyle-name; tIMPLIEt<

E 4 oT Ti 4 T iAu ri rI iInA9i41ti rI ionTr 19

266

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2%

This e.ampae shots the OpenOiiiiecorg X L iode ior a tabae tith three rots and three ioaSmnsc The iirst tto
rots oi the tabae hare a baSe baikgroSndc<style:style style:namep"Table 1" style:familyp"table"<<style:properties fo:witthp"12cm"
fo:backgrount-colorp"light-grey"/<</style:style<<style:style style:namep"Col1" style:familyp"table-column"<<style:properties fo:witthp"2cm"/<</style:style<<style:style style:namep"Col2" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"Col3" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"eow1" style:familyp"table-row"<<style:properties fo:backgrount-colorp"blue"/<</style:style<<table:table table:namep"Table 1" table:style-namep"Table 1"<<table:table-columns<<table:table-column table:style-namep"Col1"/<<table:table-column table:style-namep"Col2"/<<table:table-column table:style-namep"Col3"/<</table:table-columns<<table:table-rows<<table:table-row table:style-namep"eow1"<...
</table:table-row<<table:table-row table:style-namep"eow1"<...
</table:table-row<<table:table-row<...
</table:table-row<<table:table-rows<</table:table<

9cr Ceaas
9crc0 Tabae Ceaa
The <table:table-cell< eaement speiiiies the iontent oi a tabae ieaac The <table:table-cell<eaements are iontained in tabae rot eaementsc

Chapter 4 Table Content

267

rg i nt T

<table:table-cell<<table:coveret-table-cell<RrT 9T

The <table:table-cell< eaement ian iontain:●●

Paragraphs and other te.t iontents orsSbtabae

Dhen tabae ieaas merge horikontaaay and rertiiaaays the <table:coveret-table-cell<eaement represents ieaas that are iorered by other ieaasc The <table:table-cell< eaement
represents aaa other ieaasc
o oT<!ENTITY % cell-content "(table:cell-range-source?, office:annotation?,(table:subtable|%text-wo-table;yy"<<!ELEMENT table:table-cell %cell-content;<<!ELEMENT table:coveret-table-cell %cell-content;<

n 9T

There is a diiierenie betteen the representation oi ieaas that span sereraa rots or ioaSmns in
OpenOiiiiecorg X Ls and their representation in OT L and X Lc
Dhen a ieaa merges tith other ieaass the ieaas that the iirst ieaa iorers do not appear in the OT L
or X L representation oi the tabaec OpenOiiiiecorg X L represents these iorered ieaas as<table:coveret-table-cell< eaementsc The reasons ior this are as ioaaots:●n spreadsheetss there ian be some iontent in the iorered ieaasc●

i a rot does not iniaSde iorered ieaass it is rery diiiiiSat to identiiy the ioaSmn that iontains
a partiiSaar ieaac t means that yoS mSst proiess aaa preieding ieaas to identiiy the ioaSmnc
dentiiying the ioaSmn that iontains a partiiSaar ieaa is rery important ior transiormations toother X L aangSagess beiaSse this iniormation is essentiaa to iaaiSaate the tidth oi a ieaac

part irom thiss the tabae ieaa eaement is simiaar to the X L <fo:table-cell< eaement andthe OT L <tt< and <th< tagsc

NSmber oi Ceaas epeated
The table:number-columns-repeatet attribSte speiiiies the nSmber oi sSiiessire ioaSmns in thiih a
ieaa is repeatedc
rg i nt T

table:number-columns-repeatet

RrT 9TYoS ian Sse a singae <table:table-cell< eaement to desiribe tto or more adjoining
ieaass ii they meet the ioaaoting ionditions:●

The ieaas iontain the same iontent and propertiesc●

The ieaas are not merged horikontaaay or rertiiaaayc

n this iases yoS Sse a table:number-columns-repeatet attribSte to speiiiy thenSmber oi sSiiessire ioaSmns in thiih the ieaa is repeatedc YoS speiiiy this attribSte tith either
the <table:table-cell< eaement or the <table:coveret-table-cell< eaementc
o oT

268

<!ATTLIST table:table-celltable:number-columns-repeatet %number; "1"<<!ATTLIST table:coveret-table-celltable:number-columns-repeatet %number; "1"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

NSmber oi ots and CoaSmns panned
These attribStes speiiiy the nSmber oi rots and ioaSmns that a ieaa spansc YoS speiiiy these attribStes tith the<table:table-cell< eaementc
rg i nt T

table:number-rows-spannet
table:number-columns-spannet

RrT 9To oT<!ATTLIST table:table-celltable:number-rows-spannet %number; "1"<<!ATTLIST table:table-celltable:number-columns-spannet %number; "1"<n 9T

Dhen a ieaa iorers another ieaas a <table:coveret-table-cell< eaement mSst appear
in the tabae to represent the iorered ieaac

Ceaa tyaetabae styae stores the iormatting properties oi a ieaas sSih as the ioaaoting:●

BaikgroSnd ioaor●

NSmber iormat●

Vertiiaa aaignment●

Borders

The tabae styae ian be either an aStomatii or a iommon styaec YoS speiiiy the styae oi a ieaa Ssing a tabae styaec i
a ieaa does not hare a styaes the appaiiation iheiks ii a the iSrrent rot has a deiaSat ieaa styaec i the iSrrent rot
does not hare a deiaSat ieaa styaes the appaiiation iheiks ii the iSrrent ioaSmn has a deiaSat ieaa styaec
rg i nt T

table:style-name

RrT 9TThe raaSe oi this attribSte mSst be the name oi a <style:style< eaement that beaongs to thetable-cell styae iamiayc

o oT<!ATTLIST table:table-cell table:style-name %style-name; tIMPLIEt<<!ATTLIST table:coveret-table-cell table:style-name %style-name;tIMPLIEt<

Ceaa Content Vaaidation
The table:content-valitation-name attribSte speiiiies ii a ieaa iontains a valiaity check.
rg i nt T

table:content-valitation-name

RrT 9TThe raaSe oi this attribSte is the name oi a <table:cell-content-valitation< eaementc

o oT<!ATTLIST table:table-cell table:content-valitation-name CtATAtIMPLIEt<<!ATTLIST table:coveret-table-cell table:content-valitation-name
CtATA tIMPLIEt<

ee eition 4.9 Sor more inSormation on cell content valiaation ana the <table:cell-content-valitation< element.

Chapter 4 Table Content

269FormSaa
FormSaas aaaot yoS to periorm iaaiSaations tithin tabae ieaasc Erery iormSaa begins tith an eqSaa i o signc
FormSaas ian iniaSde the ioaaoting iomponents:●

NSmbersc

●

Te.tc

●

Named rangesc●

Operatorsc●

Logiiaa operatorsc●

FSnition iaaasc●

ddresses oi ieaas that iontain nSmbersc The addresses ian be reaatire or absoaStes see eition 9crcmc
ddresses in iormSaas start tith a ete and end tith a eTrc ee eitions 9crcmand 9crcr ior iniormation aboSt
hot to address a ieaa or ieaa rangec

The ioaaoting is an e.ampae oi a simpae iormSaa:
psum([.A1:.A4]yThis iormSaa iaaiSaates the sSm oi the raaSes oi aaa ieaas in the range e.A1:.A4rc The iSnition is esumrc The
parameters are marked by a e(e at the start and a eyr at the endc i a iSnition iontains more than one parameters
the parameters are separated by a e;rc
The ioaaoting is a rariation oi the iormSaa shotn abore:psum([.A1];[.A2];[.A3];[.A:];[.A4]y
The resSat oi this iormSaa is the samec The iomponents that yoS Sse in the iormSaa depend on the appaiiation thatyoS are Ssingc
The table:formula attribSte iontains a iormSaa ior a tabae ieaac
rg i nt T

table:formula

RrT 9Tee aboreco oT<!ATTLIST table:table-cell table:formula CtATA tIMPLIEt<<!ATTLIST table:coveret-table-cell table:formula CtATA tIMPLIEt<

n 9T

One oi the ioaaoting attribStes represents the iSrrent raaSe oi the ieaa:
●
●
●
●
●

table:value
table:tate-value
table:time-value
table:boolean-value
table:string-value

atri.
Dhen an appaiiation is periorming spreadsheet iaaiSaationss a ionneited range oi ieaas that iontains raaSes isiaaaed a matri.c i the ieaa range iontains m rots and n ioaSmnss the matri. is iaaaed an m e n matri.c The smaaaest
possibae matri. is a W e or e W matri. tith tto adjaient ieaasc i yoS tant to Sse a matri. in a iormSaas yoS
mSst iniaSde the ieaa range address oi the matri. in the iormSaac n a matri. iormSaas onay speiiaa matri. operations are possibaec
The nSmber oi rots and ioaSmns that a matri. spans are represented by the table:number-matrix-rows270

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

spannet and table:number-matrix-columns-spannet attribStess thiih are attaihed to the ieaa
eaementsc
rg i nt T

table:number-matrix-rows-spannet
table:number-matrix-columns-spannet

RrT 9T

These attribStes are attaihed to the ieaa eaement in the iirst rot and the iirst ioaSmn oi the matri.co oT<!ATTLIST table:coveret-table-celltable:number-matrix-rows-spannet %number; tIMPLIEt<<!ATTLIST table:table-celltable:number-matrix-rows-spannet %number; tIMPLIEt<<!ATTLIST table:coveret-table-celltable:number-matrix-columns-spannet %number; tIMPLIEt<<!ATTLIST table:table-celltable:number-matrix-columns-spannet %number; tIMPLIEt<

VaaSe Typei
The table:value-type attribSte speiiiies the type oi raaSe that ian appear in a ieaac
rg i nt T

table:value-type

RrT 9T

The table:cell-type may iontain one oi the ioaaoting raaSes:
●

float

●

time
tate
percentage
currency

●
●
●
●
●

o oT

booleanstring<!ATTLIST table:table-cell table:value-type("float"|"time"|"tate"|"percentage"|"currency"|"boolean"|"string"y "string"<<!ATTLIST table:coveret-table-cell table:value-type("float"|"time"|"tate"|"percentage"|"currency"|"boolean"|"string"y "string"<

Ceaa CSrrent NSmerii VaaSe
The table:value attribSte speiiiies the iSrrent nSmerii raaSe oi a ieaac
rg i nt T

table:value

RrT 9T

This attribSte is onay eraaSated ior ieaas that iontain the ioaaoting data types:
●
●
●

o oT

float
percentage
currency<!ENTITY % float CtATA<<!ATTLIST table:table-cell table:value %float; tIMPLIEt<<!ATTLIST table:coveret-table-cell table:value %float; tIMPLIEt<

Chapter 4 Table Content

271

Ceaa CSrrent Date VaaSe
The table:tate-value attribSte speiiiies the iSrrent date raaSe oi a ieaac
rg i nt T

table:tate-value

RrT 9T

This attribSte is onay eraaSated ior ieaas those data type is tatec

o oT<!ATTLIST table:table-cell table:tate-value %tate; tIMPLIEt<<!ATTLIST table:coveret-table-cell table:tate-value %tate;
tIMPLIEt<

Ceaa CSrrent Time VaaSe
The table:time-value attribSte speiiiies the iSrrent time raaSe oi a ieaac
rg i nt T

table:time-value

RrT 9T

This attribSte is onay eraaSated ior ieaas those data type is timec

o oT<!ATTLIST table:table-cell table:time-value %time; tIMPLIEt<<!ATTLIST table:coveret-table-cell table:time-value %time;tIMPLIEt<

Ceaa CSrrent Booaean VaaSe
The table:boolean-value attribSte speiiiies the iSrrent Booaean raaSe oi a ieaac
rg i nt T

table:boolean-value

RrT 9T

This attribSte is onay eraaSated ior ieaas those data type is booleanco oT<!ATTLIST table:table-cell table:boolean-value %boolean; tIMPLIEt<<!ATTLIST table:coveret-table-cell table:boolean-value %boolean;tIMPLIEt<

Ceaa CSrrent tring VaaSe
The table:string-value attribSte speiiiies the iSrrent string raaSe oi a ieaac
rg i nt T

table:string-value

RrT 9T

This attribSte is onay eraaSated ior ieaas those data type is stringco oT<!ATTLIST table:table-cell table:string-value CtATA tIMPLIEt<<!ATTLIST table:coveret-table-cell table:string-value CtATAtIMPLIEt<n 9T

i the table:string-value attribSte does not e.ists the raaSe oi the ieaa is the te.t iontent
oi the ieaac

Ceaa CSrrent CSrreniy VaaSe
The table:currency attribSte speiiiies the iSrrent iSrreniy raaSe oi a ieaac The raaSe oi this attribSte is
SsSaaay iSrreniy iniormation sSih as DE or E c

272

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:currency

RrT 9T

This attribSte is onay eraaSated ior ieaas those data type is currencyc

o oT<!ATTLIST table:table-cell table:currency CtATA tIMPLIEt<<!ATTLIST table:coveret-table-cell table:currency CtATA tIMPLIEt<

Tabae Ceaa Proteition iOpenOiiiiecorg Driter onayo
The table:protectet attribSte proteits the tabae ieaas iontained in OpenOiiiiecorg Driter doiSmentsc sers
ian not edit the iontent oi a ieaa that is marked as proteitedc
rg i nt T

table:protectet

RrT 9T

This attribSte shoSad onay be Ssed in OpenOiiiiecorg Driter tabaesco oT<!ATTLIST table:table-cell table:protectet %boolean; "false"<

OpenOiiiiecorg Caai sSpports more sophistiiated proteition iSnitionaaity ior spreadsheet doiSmentss as
desiribed in eition 9c 0c06c

9crc Ceaa ange oSriei a ieaa is ainked to a database range or named range oi another iiaes the originaa database range or named range isrepresented by a <table:cell-range-source< eaementc
rg i nt T<table:cell-range-source<

RrT 9T<!ELEMENT table:cell-range-source EMPTY<o oT

The attribStes that yoS ian assoiiate tith this eaement are:
●

Name

●

L

●

Fiater name●

Fiater options●

Last sike●eiresh deaay

Name
The table:name attribSte speiiiies the name oi the database range or named rangec
rg i nt T

table:nameRrT 9T

This attribSte is mandatoryc

o oT<!ATTLIST table:cell-range-source table:name CtATA teEt|IeEt<

Chapter 4 Table Content

273

LThe XLink attribStes speiiiy therg i nt T

L oi the ainked tabae doiSmentc

xlink:types xlink:actuates and xlink:href

RrT 9To oT<!ATTLIST table:cell-range-source xlink:type (simpley tFIXEt"simple"<<!ATTLIST table:cell-range-source xlink:actuate (oneequesty
tFIXEt "oneequest"<<!ATTLIST table:cell-range-source xlink:href %url; teEt|IeEt<

Fiater Name
The table:filter-name attribSte speiiiies the iiae type oi the ainked tabae doiSmentc
rg i nt T

table:filter-name

RrT 9TThe raaSe oi this attribSte is appaiiation-speiiiiico oT<!ATTLIST table:cell-range-source table:filter-name CtATA
teEt|IeEt<

Fiater Options
The table:filter-options attribSte speiiiies optionaa settings aboSt the iiae typec
rg i nt T

table:filter-options

RrT 9TThe raaSe oi this attribSte is appaiiation-speiiiiico oT<!ATTLIST table:cell-range-source table:filter-options CtATAtIMPLIEt<

Last ike
The table:last-column-spannet and table:last-row-spannet attribStes speiiiy the aast knotn
sike oi the rangec i the sike oi the range is ihanged sinie the aast operations the raaSes oi these attribStes areiniorreitc
rg i nt T

table:last-column-spannet
table:last-row-spannet

RrT 9T

These attribStes are mandatoryc

o oT<!ATTLIST table:cell-range-source table:last-column-spannet %positiveInteger; teEt|IeEt<<!ATTLIST table:cell-range-source table:last-row-spannet %positiveInteger; teEt|IeEt<

eiresh Deaay
The table:refresh-telay attribSte speiiiies the time deaay betteen reiresh aitionsc

274

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:refresh-telay

RrT 9T<!ATTLIST table:cell-range-source table:refresh-telay %timeturation; tIMPLIEt<

o oT

9crc4

nnotation

The <office:annotation< eaement speiiiies an OpenOiiiiecorg annotationc
rg i nt T<office:annotation<

RrT 9To oT<!ELEMENT office:annotation (text:pya<

The attribStes assoiiated tith the <office:annotation< eaement are:
●

Sthor

●

Creation date●

DispaaySthor
The office:author attribSte speiiiies the aSthor oi the annotationc
rg i nt T

office:author

RrT 9T

This attribSte is mandatoryc

o oT<!ATTLIST office:author CtATA; tIMPLIEt<

Creation Date
The office:create-tate attribSte speiiiies the ireation date and time oi the annotationc i the appaiiation
onay has a date string and iannot parse this strings it mSst trite the string to the office:create-tatestring attribStec
rg i nt T

office:create-tate

RrT 9T

This attribSte is mandatoryc

o oT<!ATTLIST office:create-tate %tate-time; tIMPLIEt<<!ATTLIST office:create-tate-string %string; tIMPLIEt<

Dispaay
The office:tisplay attribSte speiiiies thether or not the annotation is risibaec

Chapter 4 Table Content

275

rg i nt T

office:tisplay

RrT 9T

This attribSte is optionaa and ian hare a true or false raaSec

o oT<!ATTLIST office:tisplay %boolean; "false"<

9crc9 Deteitire
The <table:tetective< eaement aaaots yoS to dispaay ainks betteen the iSrrent iormSaa ieaas and the ieaas
in the spreadsheet doiSmentc This makes is easy to iheik iormSaa deiinitions and make any neiessary iorreitionsc
rg i nt T<table:tetective<RrT 9To oT<!ELEMENT table:tetective (table:highlightet-rangea, table:operationay<

The eaements that ian be iontained in the <table:tetective< eaement are:●

Oighaighted range●

Operation

9crc5 Oighaighted ange
The atable:highlightet-range< eaement speiiiies a range ieaa address ior a range thiih iontains
dependents or preiendents and thether or not the range iontains an errorc aso it ian speiiiy that the iontaining
ieaa is marked inraaidc The table:market-invalit attribSte shoSad be aatays aaone and shoSad not be there
ii another attribSte is therect represents the risibae marks ireated by deteitirec t is not girens that the representation is reaaay trSec o it ispossibaes that the ieaa is not inraaids bSt at the time the operation tas done the ieaa tas inraaidc o it is aaso
possibaes that the dependentsspreiendents are no aonger in the giren rangesc
rg i nt T<table:highlightet-range<

RrT 9To oT<!ELEMENT table:highlightet-range EMPTY<

The attribStes that yoS ian assoiiate tith the atable:highlightet-range< eaement are:●Ceaa ange ddress●

Direition●

Contains Error●

arked nraaid

Ceaa ange ddress
The table:cell-range-attress attribSte speiiiies the ieaa range address oi the highaighted rangec

276

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:cell-range-attressRrT 9To oT<!ATTLIST table:highlightet-range table:cell-range-attress %cellrange-attress; tIMPLIEt<

Direition
The table:tirection attribSte speiiiies the direition oi the arrot betteen this ieaa and the highaighted
rangecrg i nt T

table:tirection

RrT 9To oT<!ATTLIST table:highlightet-range table:tirection (from-anothertable | to-another-table | from-same-tabley tIMPLIEt<

Contains Error
The table:contains-error attribSte speiiiies thether or not the ieaa range iontains an errorc
rg i nt T

table:contains-error

RrT 9To oT<!ATTLIST table:highlightet-range table:contains-error %boolean;tIMPLIEt<

arked nraaid
The table:market-invalit attribSte speiiiies thether or not the ieaa is marked inraaidc
rg i nt T

table:market-invalit

RrT 9To oT<!ATTLIST table:highlightet-range table:market-invalit %boolean;tIMPLIEt<

9crc6 Operation
The <table:operation< eaement iontains the operation and its inde.c sing the inde.s the appaiiation ian
restore the order oi the operations oi aaa ieaasc
rg i nt T<table:operation<

RrT 9To oT<!ELEMENT table:operation EMPTY<

The attribStes assoiiated tith the <table:operation< eaement are:
●

Name

●

nde.
Chapter 4 Table Content

277

Name
The table:name attribSte speiiiies the name oi the operationc Possibae names are trace-tepentents s
remove-tepententss trace-precetentss remove-precetentss and trace-errorsc
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:operation table:name (trace-tepentents|removetepentents|trace-precetents|remove-precetents|trace-errorsy
teEt|IeEt<

nde.
The table:intex attribSte speiiiies the inde. in the order oi the operations oi aaa ieaasc
rg i nt T

table:intex

RrT 9To oT<!ATTLIST table:operation table:intex %nonNegativeInteger;
teEt|IeEt<

9crcm Ceaa ddress Entity
speiiaa data type e.ists ior the address oi a ieaac

ieaa address entity desiribes a ieaa addressc

The strSitSre oi a ieaa address is as ioaaots:
0c The name oi the tabaeccdot icoc

4cn aaphabetii raaSe representing the ioaSmnc The aetter represents ioaSmn 0s B represents ioaSmn s and so
onc
represents ioaSmn ms B represents ioaSmn rs and so onc

9c

nSmerii raaSe representing the rotc The nSmber 0 represents the iirst rots the nSmberseiond rots and so onc
0 represents the ieaa in ioaSmn 0 and rot 0c B0 represents the ieaa in ioaSmn
ieaa in ioaSmn 0 and rot c

and rot 0c

represents therepresents the

For e.ampaes ii yoS hare a tabae tith the name SampleTable and yoS tant to address the ieaa in ioaSmn 49
and rot 06s the address is SampleTable.Am1:c n some iases it is not neiessary to proride the name oi thetabaec Ooterers the dot mSst be presentc Dhen the tabae name is not reqSireds the address in the prerioSs e.ampae
is .Am1:c
The strSitSre oi the address oi a ieaa in a sSbtabae is as ioaaots:
0c The address oi the ieaa that iontains the sSbtabaeccdot icoc

4c The address oi the ieaa in the sSbtabaec
For e.ampaes to reierenie the ieaa in ioaSmn 0 and rot 0 in a sSbtabae that is iaaaed Subtables and that is in
ioaSmn 49 and rot 06 oi the tabae SampleTables the address is SampleTable.Am1:.A1c i the name oi
the tabae iontains a baank the name shoSad be betteen tto qSotation marksc This qSotation marks shoSad be
278

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

qSotedc
A 9nTr i41tiI T4 uv io TTi4ttI 99u1.
YoS ian reierenie ieaas in tto tayss Ssing absoaSte addresses or reaatire addressesc Dhen yoS periorm an operation on a tabae ieaas ior e.ampae then yoS iopy a iormSaas absoaSte ieaa reierenies do not ihange; reaatire ieaa
reierenies do ihangec The prerioSs e.ampae Sses reaatire addressingc
To ireate an absoaSte addresss paaie a doaaar sign i$o beiore eaih tabae names ioaSmn reierenies and rot reiereniec For e.ampaes the absoaSte address oi the prerioSs e.ampae is TSampleTable.TAmT1:c YoS ian
iombine absoaSte and reaatire reierenies in a ieaa addressc For e.ampaes yoS ian Sse SampleTable.AmT1: toreier to a reaatire tabae and ioaSmns and an absoaSte rotc bsoaSte addresses mSst iontain a tabae namec The
disirimination betteen absoaSte and reaatire addressing is onay neiessary in some speiiaa iasesc Othertises a ieaa
reierenie tithoSt the doaaar signs is Ssedc
rg i nt T

cell-attressRrT 9To oT<!ENTITY % cell-attress CtATA<

9crcr Ceaa ange ddress Entity
ieaa range is a nSmber oi adjaient ieaas iorming a reitangSaar shapec The reitangae stretihes irom the ieaa on the
top aeit to the ieaa on the bottom rightc
The range address oi ieaas has a speiiaa data typec To speiiiy a ieaa range addresss yoS Sse an entityc To reierenie
a range oi adjaient ieaass ionstrSit the address as ioaaotss in the speiiiied order:
0c The address oi the ieaa at the top aeit oi the range yoS tant to reierenieccioaon i:oc

4c The address oi the ieaa at the bottom right oi the range yoS tant to reiereniec
For e.ampaes yoS Sse the address .A1:.B2 to reierenie the range oi ieaas irom ioaSmn 0 and rot 0 to ioaSmn
and rot c The smaaaest range yoS ian speiiiy is a singae ieaac n this iases the range address is the same as theieaa addressc
rg i nt T

cell-range-attressRrT 9To oT<!ENTITY % cell-range-attress CtATA<

9crc Ceaa ange ddress List Entity
ieaa range address aist is a aist oi ieaa ranges or ieaa addresses s or bothc Eaih item in the aist is separated by aspaiecrg i nt T

cell-range-attress-list

RrT 9To oT<!ENTITY % cell-range-attress-list CtATA<

Chapter 4 Table Content

279

9c

Tabae Ceaa Content Vaaidations
The <table:content-valitations< eaement iontains aaa oi the ieaa iontent raaidationsc
rg i nt T<table:content-valitations<RrT 9To oT<!ELEMENT table:content-valitations (table:content-valitationya<

9c c0 Tabae Ceaa Content Vaaidation
The <table:content-valitation< eaement speiiiies the raaidation oi the iontent oi the ieaa tith thisstyaecrg i nt T<table:content-valitation<

RrT 9Ti this eaement is not presents the ieaa ian iontain any iontentc

o oT<!ELEMENT table:content-valitation (table:help-message?,(table:error-message | table:error-macroy?y<The attribStes that yoS ian assoiiate tith the <table:content-valitation< eaement are:
●

Name

●

Condition●

Base ieaa address●

aaot empty ieaa

Name
The table:name attribSte speiiiies the name oi the iontent raaidationc The name is ireated aStomatiiaaay by
the appaiiationc
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:content-valitation table:name CtATA teEt|IeEt<

Condition
The table:contition attribSte speiiiies the iondition thiih ieaa iontent is aaaotedc
rg i nt T

280

table:contition

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

RrT 9T

The raaSe oi this attribSte is a Booaean e.pressionc The synta. oi the e.pression is simiaar to the
XPath synta.c The ioaaoting are raaid ionditions:●Contition ::p ExtentetTrueContition | TrueFunction 'ant'
TrueContition●

TrueFunction ::p cell-content-is-whole-number(y | cellcontent-is-tecimal-number(y | cell-content-is-tate(y | cellcontent-is-time(y●ExtentetTrueContition ::p ExtentetGetFunction | cellcontent-text-length(y Operator "alue●

TrueContition ::p GetFunction | cell-content(y Operator
"alue

●

GetFunction ::p cell-content-is-between("alue, "aluey |cell-content-is-not-between("alue, "aluey●

ExtentetGetFunction ::p cell-content-text-length-is-between("alue, "aluey | cell-content-text-length-is-not-between("alue, "aluey●

Operator ::p '<' | '<' | '<p' | '<p' | 'p' | '!p'●"alue ::p Number"alue | String | Formula
Formula is a iormSaa tithoSt an eqSaas i o sign at the beginningc ee eition 9crc0 ior
more iniormationc
String iomprises one or more iharaiters sSrroSnded by qSotation marksc
Number"alue is a thoae or deiimaa nSmberc
YoS mSst iniaSde an Operatorc
The nSmber in a Number"alue or Formula iannot iontain iomma separators ior nSmbersoi 0222 or greaterc

o oT<!ATTLIST table:content-valitation table:contition CtATAtIMPLIEt<

Base Ceaa ddress
The table:base-cell-attress attribSte speiiiies the address oi the base ieaa ior reaatire addresses in
iormSaasc
rg i nt T

table:base-cell-attressRrT 9T

This attribSte is onay neiessary then the iondition iontains a iormSaac The raaSe oi this attribSte
mSst be an absoaSte ieaa address tith a tabae namec

o oT<!ATTLIST table:content-valitation table:base-cell-attress %cell-attress; tIMPLIEt<

aaot Empty Ceaa
The table:allow-empty-cell attribSte speiiiies thether or not a ieaa ian be emptyc

Chapter 4 Table Content

281

rg i nt T

table:allow-empty-cell

RrT 9To oT

9c c Oeap<!ATTLIST table:content-valitation table:allow-empty-cell %boolean; tIMPLIEt<

essageThe <table:help-message< eaement speiiiies a message to dispaay ii a Sser seaeits the ieaac
rg i nt T<table:help-message<

RrT 9To oT<!ELEMENT table:help-message (text:pay<

The attribStes that yoS ian assoiiate tith the <table:help-message< eaement are:
●

Titae

●

Dispaay

Titae
The table:title attribSte speiiiies the titae oi the heap messagec
rg i nt T

table:title

RrT 9To oT<!ATTLIST table:help-message table:title CtATA tIMPLIEt<

Dispaay
The table:tisplay attribSte speiiiies thether or not to dispaay the messagec
rg i nt T

table:tisplay

RrT 9To oT

9c c4 Error<!ATTLIST table:help-message table:tisplay %boolean; tIMPLIEt<

essageThe <table:error-message< eaement speiiiies a message to dispaay ii a Sser tries to iniaSde Snaiieptabae
iontent in a ieaac
rg i nt T<table:error-message<

RrT 9To oT<!ELEMENT table:error-message (text:pay<

The attribStes that yoS ian assoiiate tith the <table:error-message< eaement are:
●

282

Titae

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●●essage Type
Dispaay

Titae
The table:title attribSte speiiiies the titae oi the error messagec
rg i nt T

table:title

RrT 9To oT<!ATTLIST table:error-message table:title CtATA tIMPLIEt<

essage TypeThe table:message-type attribSte speiiiies the type oi error messagec
rg i nt T

table:message-type

RrT 9TThe raaSe oi this attribSte ian be stops warnings or informationc

o oT<!ATTLIST table:error-message table:message-type ( stop |warning | information y tIMPLIEt<

Dispaay
The table:tisplay attribSte speiiiies thether or not to dispaay the messagec
rg i nt T

table:tisplay

RrT 9To oT

9c c9 Error<!ATTLIST table:error-message table:tisplay %boolean;tIMPLIEt<

airo

The <table:error-macro< eaement speiiiies a mairo that is e.eiSted then a Sser tries to iniaSded Snaiieptabae iontent in a ieaac
rg i nt T<table:error-macro<

RrT 9To oT<!ELEMENT table:error-macro EMPTY<

The attribStes that yoS ian assoiiate tith the <table:error-macro< eaement are:
●

Name

●

E.eiSte

Chapter 4 Table Content

283

Name
The table:name attribSte speiiiies the name oi the mairoc
table:namerg i nt T
RrT 9T<!ATTLIST table:error-macro table:name CtATA tIMPLIEt<

o oT

E.eiSte
The table:execute attribSte speiiiies thether or not to e.eiSte the mairoc
rg i nt T

table:execute

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST table:error-macro table:execute %boolean; tIMPLIEt<

9c02 SbtabaessSbtabae is a tabae tithin another tabaec t oiiSpies one ieaa and no other iontent ian appear in this ieaac i atabae ieaa iontains a sSbtabaes it iannot iontain any paragraphsc
rg i nt T<table:sub-table<

RrT 9T

The borders oi a sSbtabae merge tith the borders oi the ieaa that it resides inc sSbtabae does notiontain any iormatting propertiesc sSbtabae is essentiaaay a iontainer ior some additionaa tabae
rots that integrate seamaessay tith the parent tabaec

o oT<!ELEMENT table:sub-table(%table-column-groups;,%table-row-groups;y<There is a diiierenie betteen a sSbtabae and a OT L tabae that is nested tithin another OT L
tabaec nested OT L tabae appears as a tabae tithin a tabaes that iss it has borders distinit irom
those oi the parent ieaa and respeits the padding oi the parent ieaac

n 9T

E 4 oT ineiR oI 9 1 4 un1ineihr 4 T
OpenOiiiiecorgirg io41iI oI 9 1 i ru9i 4 T iu1i u r Iinei r iA4y9it 4uT tiu1ih4 oT i i41tih4 oT i1i
A

B
B c0c0B c c0B c0c

Tample W
OpenOiiiiecorg X L ian desiribe the preieding tabae as ioaaots:

284

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<style:style style:namep"Table 1" style:familyp"table"<<style:properties fo:witthp"12cm" fo:backgrount-colorp"light-grey"/<</style:style<<style:style style:namep"Col1" style:familyp"table-column"<<style:properties fo:witthp"2cm"/<</style:style<<style:style style:namep"Col2" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"Col3" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"eow1" style:familyp"table-row"<<style:properties fo:backgrount-colorp"grey"/<</style:style<<style:style style:namep"Cell1" style:familyp"table-cell"<<style:properties fo:backgrount-colorp"grey"/<</style:style<<table:table table:namep"Table 1" table:style-namep"Table 1"<<table:table-columns<<table:table-column table:style-namep"Col1"/<<table:table-column table:style-namep"Col2"/<<table:table-column table:style-namep"Col3"/<</table:table-columns<<table:table-heater-rows<<table:table-row table:style-namep"eow1"<<table:table-cell<<text:p text:stylep"Table Caption"<
A1</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Caption"<
B1</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Caption"<
C1</text:p<</table:table-cell<</table:table-row<</table:table-heater-rows<

Chapter 4 Table Content

285

<table:table-rows<<table:table-row<<table:table-cell table:number-rows-spannetp"2" table:style-namep"Cell1"<<text:p text:stylep"Table Boty"<
A2</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Boty"<
B2.1.1</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Boty"<
B2.2.1</text:p<</table:table-cell<</table:table-row<<table:table-row<<table:coveret-table-cell/<<table:table-cell table:number-columns-spannetp"2"<<text:p text:stylep"Table Boty"<
B2.1.2</text:p<</table:table-cell<<table:coveret-table-cell/<</table:table-row<</table:table-rows<</table:table<

TampleThis sampae ignores the borders oi the tabaec OpenOiiiiecorg X L ian desiribe the preieding tabae as ioaaots:

286

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<style:style style:namep"Table 1" style:familyp"table"<<style:properties fo:witthp"12cm" fo:backgrount-colorp"light-grey"/<</style:style<<style:style style:namep"Col1" style:familyp"table-column"<<style:properties fo:witthp"2cm"/<</style:style<<style:style style:namep"Col2" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"Col3" style:familyp"table-column"<<style:properties fo:witthp":cm"/<</style:style<<style:style style:namep"eow1" style:familyp"table-row"<<style:properties fo:backgrount-colorp"grey"/<</style:style<<style:style style:namep"Cell1" style:familyp"table-cell"<<style:properties fo:backgrount-colorp"grey"/<</style:style<<table:table table:namep"Table 1" table:style-namep"Table 1"<<table:table-columns<<table:table-column table:style-namep"Col1"/<<table:table-column table:style-namep"Col2"/<<table:table-column table:style-namep"Col3"/<</table:table-columns<<table:table-heater-rows<<table:table-row table:style-namep"eow1"<<table:table-cell<<text:p text:stylep"Table Caption"<
A1</text:p<</table:table.cell<<table:table-cell<<text:p text:stylep"Table Caption"<
B1</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Caption"<
C1</text:p<</table:table-cell<</table:table-row<</table:table-heater-rows<<table:table-rows<<table:table-row<<table:table-cell table:style-namep"Cell1"<<text:p text:stylep"Table Boty"<
A2</text:p<</table:table-cell<<table:table-cell table:number-columns-spannetp"2"<

Chapter 4 Table Content287

<table:subtable<<table:table-columns<<table:table-column table:style-namep"Col2"/<<table:table-column table:style-namep"Col3"/<</table:table-columns<<table:table-cell<<text:p text:stylep"Table Boty"<
B2.1.1</text:p<</table:table-cell<<table:table-cell<<text:p text:stylep"Table Boty"<
B2.2.1</text:p<</table:table-cell<</table:table-row<<table:table-row<<table:table-cell table:number-columns-spannetp"2"<<text:p text:stylep"Table Boty"<
B2.1.2</text:p<</table:table-cell<<table:coveret-table-cell/<</table:table-row<</table:table-rows<</table:subtable<</table:table-cell<<table:coveret-table-cell/<</table:table-row<</table:table-rows<</table:table<

9c00 Labea anges
The aabea ranges eaement iontains a ioaaeition oi aabea rangesc
rg i nt T<table:label-ranges<

RrT 9To oT<!ELEMENT table:label-ranges (table:label-rangeya <9c00c0 Labea ange
The aabea range eaement speiiiies a ieaa range thiih iontain the aabeas and a ieaa ranges thiih iontains the datac
There are tto types oi aabea rangesc●

One ior ioaSmns●

One ior rotsc

The range oi the data shoSad hare either the same height and rertiiaa position aike the aabea range oi rots or thesame tidth and horikontaa position aike the aabea range oi ioaSmnsc For iniormation on deiining a ieaa ranges see
eition 9crc9c

288

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<table:label-range<

RrT 9To oT<!ELEMENT table:label-range EMPTY<

The attribStes that yoS ian assoiiate tith the aabea range eaement are:●Labea ieaa range address●

Data ieaa range address●

Orientation

Labea Ceaa ange ddressThis attribSte speiiiies the ieaa range address oi the aabeasc
rg i nt T

table:label-cell-range-attressRrT 9To oT<!ATTLIST table:label-range table:label-cell-range-attress %cell-range-attress; teEt|IeEt<

Data Ceaa ange ddressThis attribSte speiiiies the ieaa range address oi the datac
rg i nt T

table:tata-cell-range-attressRrT 9To oT<!ATTLIST table:label-range table:tata-cell-range-attress %cell-range-attress; teEt|IeEt<

Orientation
This attribSte speiiiies the orientation oi the aabea rangec
rg i nt T

table:orientation

RrT 9T

This attribSte ian hare a raaSe oi column or rowc

o oT<!ATTLIST table:range table:orientation (column|rowy
teEt|IeEt<

9c0 Named E.pressions
The named e.pressions eaement iontains a ioaaeition oi e.pressions tith namess thiih yoS ian Sse to reier to thee.pressionc

Chapter 4 Table Content

289

rg i nt T

<table:namet-expressions<RrT 9To oT<!ELEMENT table:namet-expressions (table:namet-range|table:
namet-expressionya <n e.pression eaement ian be Ssed to represent:●●

named ieaa rangec
Other e.pressionss ior e.ampaes part oi a iormSaac

9c0 c0 Named ange
The named range eaement speiiiies a ieaa range tith a namec For iniormation on deiining a ieaa ranges see eition
9crc9crg i nt T<table:namet-range<

RrT 9Ti the ieaa range address is reaatires the table:base-cell-attress attribSte mSst be
attaihed to this eaementc
i the named e.pression is a ieaa range a attribSte that iontains the ieaa area is neiessaryc

o oT
n T

<!ELEMENT table:namet-range EMPTY<
Named ange is one iase there a disirimination betteen absoaSte and reaatire addresses ispossibaec

The attribStes that yoS ian assoiiate tith the named range eaement are:
●

Name

●

Ceaa range address●

Base ieaa address●ange Ssabae as

Namerg i nt T

table:nameRrT 9T

This attribSte ian be attaihed to the <table:namet-range< and <table:nametexpression< eaementsc

o oT<!ATTLIST table:namet-range table:name CtATA teEt|IeEt<

Ceaa ange ddressThis attribSte speiiiies the ieaa range addressc

290

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:cell-range-attressRrT 9T

This attribSte ian be attaihed to the <table:namet-range< eaementc

o oT<!ATTLIST table:namet-range table:cell-range-attress %cellrange-attress; teEt|IeEt<

Base Ceaa ddressThis attribSte speiiiies the base ieaa address ii the ieaa address or the ieaa range address in the named range is reaatirec
rg i nt T

table:base-cell-attressRrT 9T

This attribSte ian be attaihed to the <table:namet-range< eaementc

o oT<!ATTLIST table:namet-range table:base-cell-attress %cellattress; tIMPLIEt<

n T

Disirimination betteen absoaSte and reaatire addressese is not possibaec Thereiore a tabae name in
the address tiaa needed and doaaar signs tiaa ignoredc

ange Ssabae asThis attribSte speiiiies the possibae Ssage oi the named rangec The named range ian be Ssed as a Print anges a
Fiaters a epeat ots or a epeat CoaSmnc
rg i nt T

table:range-usable-as

RrT 9T

This attribSte ian be attaihed to the <table:namet-range< eaementc
The raaSe oi this attribSte ian be either:
●

none

or
●

o oT

a spaie-separated aist that ionsists oi any oi the raaSes print-ranges filters repeatrow or repeat-columnc<!ATTLIST table:namet-range table:range-usable-as CtATA"none"<

9c0 c Named E.pression
The named e.pression eaement iontains an e.pression tith a names ior e.ampaes part oi a iormSaac
rg i nt T<table:namet-expression<

RrT 9T

E.pressions do not sSpport the eqSaa i o sign as the iirst iharaiterc
i the eaement iontains a named range or another named e.pressions the named range or named
e.pression mSst be speiiiied iirsts beiore the iontaining e.pressionc

o oT<!ELEMENT table:namet-expression EMPTY<

The attribStes that yoS ian assoiiate tith the named e.pression eaement are:●Name ithe Ssage oi this attribSte is the same as ior the <table:namet-range< eaements see eition
Chapter 4 Table Content

291

9c0 c0co●E.pression●

Base ieaa address ithe Ssage oi this attribSte is the same as ior the <table:namet-range< eaements see
eition 9c0 c0coE.pression
rg i nt T

table:expression

RrT 9T

This attribSte ian be attaihed to the <table:namet-expression< eaementc

o oT<!ATTLIST table:namet-expression table:expression CtATA
teEt|IeEt<

E 4 oT Ti 4

ti oI 99un19i T

1 iAu ri4i14

tiI41. i41ti4i14

ti oI 99un1<table:namet-expressions<<table:namet-range table:namep"sample1" table:cell-range-attressp".C:"
table:base-cell-attressp"sampletable.F1" table:area-typep"none"/<<table:namet-range table:namep"sample2" table:cell-range-attressp".TtT3:.
T T-" table:area-typep"print-range filter"/<<table:namet-expression table:namep"sample3" table:expressionp"sum([.A1:.
B3]y"/<</table:namet-expressions<

9c04 Fiaters
9c04c0 Tabae Fiater
The tabae iiater eaement desiribes hot to iiater the data in a database range or datapiaot tabaesc
rg i nt T<table:filter<

RrT 9To oT<!ELEMENT table:filter( table:filter-contition | table:filter-ant | table:filter-or y <Target ange ddressThis attribSte speiiiies there the resSat oi the iiater is oStpStc
rg i nt T

table:target-range-attressRrT 9T

This attribSte ian be attaihed to the <table:filter< and <table:sort< eaementsc i theattribSte is not presents the data is oStpSt in the soSrie rangec

o oT<!ATTLIST table:filter table:target-range-attress %cell-rangeattress; tIMPLIEt <

n T

292

Disirimination betteen absoaSte and reaatire addresses is not possibaec Thereiores yoS mSst
speiiiy a tabae name in the address and doaaar signs are ignoredc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Condition oSrie ange ddressThis attribSte speiiiies the ieaa range irom thiih the iiater iondition ian get its datac
rg i nt T

table:contition-source-range-attressRrT 9T

This attribSte ian be attaihed to the <table:filter< eaementc

o oT<!ATTLIST table:filter table:contition-source-range-attress %cell-range-attress; tIMPLIEt<

Condition oSrie
This attribSte speiiiies the soSrie aoiation irom there the appaiiation gets the iiater ionditionc
rg i nt T

table:contition-source

RrT 9T

This attribSte ian hare one oi the ioaaoting raaSes:

o oT

●

self
The appaiiation gets the iiater iondition irom the <table:filter< eaementc●

cell-range
The appaiiation gets the iiater iondition irom the ieaa range speiiiied by the table:
contition-source-range-attress attribStec<!ATTLIST table:filter table:contition-source ("self" | "cellrange"y "self"yDispaay DSpaiiates
dispaay dSpaiiates attribSte speiiiies thether or not to dispaay dSpaiiate matihes in the resSatc
rg i nt T

table:tisplay-tuplicatesRrT 9To oT<!ATTLIST table:filter
table:tisplay-tuplicates %boolean; "true"<

9c04c Fiater nd
The filter-ant eaement speiiiies thether the aogiiaa operator ND is Ssed in a iiaterc
rg i nt T<table:filter-ant<

RrT 9To oT<!ELEMENT table:filter-ant( table:filter-or | table:filter-contition yt <9c04c4 Fiater Or
The filter-or eaement speiiiies thether the aogiiaa operator O is Ssed in a iiaterc

Chapter 4 Table Content

293rg i nt T

<table:filter-or<

RrT 9To oT<!ELEMENT table:filter-or( table:filter-ant | table:filter-contition yt <9c04c9 Fiater Condition
The tabae iiater iondition eaement desiribes a iondition to appay in a iiater operationc
rg i nt T<table:filter-contition<

RrT 9To oT<!ELEMENT table:filter-contition EMPTY <Fiead NSmber
iiead nSmber attribSte speiiiies thiih iiead to Sse ior the ionditionc n e.ampae oi a iiead nSmber is a rot or
ioaSmn nSmbers the iondition being the orientation oi the tabaec
rg i nt T

table:fielt-number

RrT 9To oT<!ATTLIST table:filter-contition table:fielt-number CtATA
teEt|IeEt<

Case ensitireiase sensitire attribSte determines thether a iiater iondition is iase sensitirec
rg i nt T

table:case-sensitiveRrT 9To oT<!ATTLIST table:filter-contition table:case-sensitive %boolean;"false"<Data Typedata type attribSte speiiiies that data type to Sse ior the iiater ionditionc
rg i nt T

table:tata-type

RrT 9To oT<!ATTLIST table:filter-contition table:tata-type ("text" |"number"y "text"<

VaaSe
raaSe attribSte speiiiies a raaSe ior the iiater ionditionc

294

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:value

RrT 9To oT<!ATTLIST table:filter-contition table:value CtATA teEt|IeEt<

Operatorn operator attribSte speiiiies that operator to Sse in the iiater ionditionc
rg i nt T

table:operator

RrT 9T

The possibae raaSes ior the operator attribSte depend on thether the iondition Sses a regSaar
e.pressionc i the iondition iniaSdes a regSaar e.pression there are onay tto possibae raaSes:●

match imatiheso●!match idoes not matiho

i the iondition does not iniaSde a regSaar e.pressions the possibae raaSes are the ioaaoting
ionrentionaa reaationaa operators:●

iEqSaa too●! iNot eqSaa too●

a iLess thano●< iGreater thano●a iLess than or eqSaa too●< iGreater than or eqSaa too

n additions yoS ian Sse non-ionrentionaa operators sSih as eemptyr and e!emptyrs ebottom
raaSesrs etop raaSesrs ebottom perientrs and etop perientrc For e.ampaes yoS ian Sse the aattertto operators to iiater the aotest and highest perientage oi entriesc
o oT<!ATTLIST table:filter-contition
table:operator CtATA teEt|IeEt<

E 4 oT TR oI 9 1 4 un1inei4ieuT I<filter<<filter-or<<filter-ant<<filter-contition table:fielt-numberp1 table:operatorp"p" table:valuep"toe"/<<filter-contition table:fielt-numberp2 table:operatorp"p" table:
valuep"John"/<</filter-ant<<filter-ant<<filter-contition table:fielt-numberp1 table:operatorp"p" table:
valuep"Burns"/<<filter-contition table:fielt-numberp2 table:operatorp"p" table:
valuep"Michael"/<</filter-ant<</filter-or<</filter<

Chapter 4 Table Content

295

9c09 Database anges
The Database anges eaement iontains a ioaaeition oi Database angesc
rg i nt T<table:tatabase-ranges<

RrT 9To oT<!ELEMENT table:tatabase-ranges (table:tatabase-rangeya <9c09c0 Database ange
database range is a named area in a tabae there yoS ian periorm database operationsc
rg i nt T<table:tatabase-range<

RrT 9To oT<!ELEMENT table:tatabase-range ((table:tatabase-source-sql| table:tatabase-source-table| table:tatabase-source-queryy?, table:
filter?, table:sort?, table:subtotal-rules?y<Database ange Name
The table:name attribSte speiiiies the name oi the database range on thiih to periorm operationsc Onay one
database range ian be tithoSt a namec This database range is SsSaaay ireated by the appaiiation and is Ssed toiiater or sort data in a ieaa range tithoSt the Sser ireating a database rangec
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:tatabase-range table:name CtATA tIMPLIEt<s eaeition
The table:is-selection attribSte speiiiies thether the database range iniaSdes the iompaete databases ora seaeition oi reiords irom the databasec
rg i nt T

table:is-selection

RrT 9To oT<!ATTLIST table:tatabase-range table:is-selection %boolean;"false"<On pdate 2eep tyaes
The table:on-uptate-keep-styles attribSte speiiiies the beharior oi the ieaa styaes ii the data in thedata soSrie ihangesc

296

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:on-uptate-keep-styles

RrT 9Ti the attribSte raaSe is trSes the styae oi the net ieaas in the database range is the same as theother ieaas in the ioaSmnc
i the attribSte raaSe is iaases the styae oi the net ieaas in the database range is the standard styae
oi the doiSmentc

o oT<!ATTLIST table:tatabase-range table:on-uptate-keep-styles %boolean; "false"<

On pdate 2eep ike
The table:on-uptate-keep-sive attribSte speiiiies the beharior oi the database range ii the sike oi thedata in the data soSrie ihangesc
rg i nt T

table:on-uptate-keep-sive

RrT 9Ti the attribSte raaSe is trSes the range retains its sikec
i the attribSte raaSe is iaases the range does not retain its sikec

o oT<!ATTLIST table:tatabase-range table:on-uptate-keep-sive %boolean;"true"<Oas Persistent Data
The table:has-persistent-tata attribSte speiiiies thether or not to store the data in a database rangec
rg i nt T

table:has-persistent-tata

RrT 9To oT<!ATTLIST table:tatabase-range table:has-persistent-tata %boolean;"true"<

Orientation
The table:orientation attribSte speiiiies the orientation oi the database rangec
rg i nt T

table:orientation

RrT 9T

The orientation oi a database range ian be by rot or by ioaSmnc The onay possibae raaSes ior this
attribSte are row and columnc

o oT<!ATTLIST table:tatabase-range table:orientation ( "row" |"column" y "row"<

Contains Oeader
The table:contains-heater attribSte speiiiies thether or not the database range iontains a headerc
rg i nt T

table:contains-heater

RrT 9To oT<!ATTLIST table:tatabase-range table:contains-heater %boolean;"true"<
Chapter 4 Table Content

297Dispaay Fiater BSttons
The table:tisplay-filter-buttons bSttons attribSte speiiiies thether or not to dispaay iiater bSttonsc
rg i nt T

table:tisplay-filter-buttons

RrT 9To oT<!ATTLIST table:tatabase-range table:tisplay-filter-buttons %boolean; "false"<

Target ange ddress
The table:target-range-attress attribSte speiiiies the ieaa range address oi the database rangec
rg i nt T

table:target-range-attressRrT 9T

This attribSte ian be attaihed to the <table:tatabase-range< eaementc

o oT<!ATTLIST table:tatabase-range table:target-range-attress %cell-range-attress; teEt|IEeEt <n TDisirimination betteen absoaSte and reaatire addresses is not possibaec Thereiores a tabae namemSst be speiiiied in the address and doaaar signs are ignoredc

eiresh Deaay
The table:refresh-telay attribSte speiiiies the time deaay betteen reiresh aitionsc
rg i nt T

table:refresh-telay

RrT 9T

This attribSte ian be assoiiated tith the <table:tatabase-range< eaementc

o oT<!ATTLIST table:tatabase-range table:refresh-telay
timeturation; tIMPLIEt <%9c09c Database oSrie oLThis eaement desiribes an oL database that integrates tith the tabaec
rg i nt T<table:tatabase-source-sql<

RrT 9To oT<!ELEMENT table:tatabase-source-sql EMPTY?<

Database Name
database name attribSte speiiiies the name oi the oL database that the data is imported iromc
rg i nt T

table:tatabase-name

RrT 9To oT

298<!ATTLIST table:tatabase-source-sql table:tatabase-name CtATA
teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

oL tatementn oL statement attribSte speiiiies the oL statement to Sse then importing data irom an oL databasec
rg i nt T

table:sql-statement

RrT 9To oT<!ATTLIST table:tatabase-source-sql table:sql-statement CtATA
teEt|IeEt<

Parse oL tatement
parse oL statement attribSte speiiiies thether or not the appaiiation tiaa parse oL statementsc
rg i nt T

table:parse-sql-statement

RrT 9To oT<!ATTLIST table:tatabase-source-sql table:parse-sql-statement %boolean; "false"<

9c09c4 Database oSrie Tabae
The database soSrie tabae eaement iontains the iniormation aboSt the iniaSded database and the tabaec
rg i nt T<table:tatabase-source-table<

RrT 9To oT<!ELEMENT table:tatabase-source-table EMPTY?<

Database Name
database name attribSte speiiiies the name oi the database that data is imported iromc
rg i nt T

table:tatabase-name

RrT 9To oT<!ATTLIST table:tatabase-source-table table:tatabase-name CtATA
teEt|IeEt<

Tabae Nametabae name attribSte speiiiies the tabae that data is imported iromc
rg i nt T

table:table-name

RrT 9To oT<!ATTLIST table:tatabase-source-table table:table-name CtATA
teEt|IeEt<

Chapter 4 Table Content

299

9c09c9 Database oSrie oSery
The database soSrie qSery eaement iontains the iniormation aboSt the iniaSded database and the qSerycrg i nt T<table:tatabase-source-query<

RrT 9To oT<!ELEMENT table:tatabase-source-query EMPTY?<

Database Name
database name attribSte speiiiies a database that data is imported iromc
rg i nt T

table:tatabase-name

RrT 9To oT<!ATTLIST table:tatabase-source-query table:tatabase-name CtATA
teEt|IeEt<

oSery Name
qSery name attribSte speiiiies the qSery to periorm on the database those data is being importedc
rg i nt T

table:query-name

RrT 9To oT<!ATTLIST table:tatabase-source-query table:query-name CtATA
teEt|IeEt<

9c09c5 ort
The sort eaement desiribes the sort keys in a database rangec
rg i nt T<table:sort<

RrT 9To oT<!ELEMENT table:sort (table:sort-byyt <Bind tyaes to Content
The table:bint-styles-to-content attribSte speiiiies thether or not ieaas retain their styae attribStes
aiter a sort operationc
rg i nt T

table:bint-styles-to-content

RrT 9T
o oT

300<!ATTLIST table:sort table:bint-styles-to-content %boolean;"true"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Target ange ddressThis attribSte speiiiies there the resSat oi the sort is pStc The attribSte is Ssed tith the <table:sort< eaementin the same tay as it is Ssed tith the <table:filter< eaementc ee eition 9c04c0 ior iniormation aboSt
Ssing this attribStec

Case ensitire
The table:case-sensitive attribSte speiiiies thether or not the sort operation is iase sensitirec
rg i nt T

table:case-sensitiveRrT 9To oT<!ATTLIST table:sort table:case-sensitive %boolean; "false"<

LangSage
The table:language attribSte speiiiies the aangSage oi the iompare operatorc
rg i nt T

table:language

RrT 9To oT<!ATTLIST table:sort table:language CtATA tIMPLIEt<

CoSntryThis attribSte speiiiies the ioSntry ior the iompare operatorc
rg i nt T

table:country

RrT 9To oT<!ATTLIST table:sort table:country CtATA tIMPLIEt<

agorithm
This attribSte speiiiies the aagorithm ior the iompare operatorc
rg i nt T

table:algorithm

RrT 9To oT<!ATTLIST table:sort table:algorithm CtATA tIMPLIEt<

9c09c6 ort By
The sort by eaement speiiiies thiih iiead to sorts the data type oi this iieads and hot to sort itc
rg i nt T<table:sort-by<

RrT 9To oT<!ELEMENT table:sort-by EMPTY <Chapter 4 Table Content

301

Fiead NSmber
iiead nSmber attribSte speiiiies the rot or ioaSmn nSmber to sort byc
rg i nt T

table:fielt-number

RrT 9To oT<!ATTLIST table:sort-by table:fielt-number CtATA teEt|IeEt<

Data Typedata type attribSte speiiiies the data type oi the iiead to be sortedc
rg i nt T

table:tata-type

RrT 9Ti the attribSte raaSe is automatics the appaiiation mSst determine that type oi data is in theiieadc i the iiead iontains a Sser-deiined data types the attribSte raaSe is the name oi this data
typec

o oT

<!ATTLIST table:sort-by table:tata-type("text" | "number" | "automatic" | qname-but-not-ncname y "automatic" <Ordern order attribSte speiiiies thether to sort the data in asiending or desiending orderc
rg i nt T

table:orterRrT 9To oT<!ATTLIST table:sort-bytable:orter ( "ascenting" | "tescenting" y "ascenting" <9c09cm Sbtotaa Saes
The sSbtotaa rSaes eaement contains the Sollowing inSormatione●

The rovisional result oS a Siela in a aatabase ranget Sor exam let a column.

●

The Sunction usea to calculate the rovisional result.

The element consists oS generatea grou s oS Sielas in the aatabase range. For exam let all cells with the samecontent in the same Siela Sorm a grou .
rg i nt T<table:subtotal-rules<

RrT 9To oT<!ELEMENT table:subtotal-rules( table:sort-groups? | table:subtotal-ruleay <Bind tyaes To Content
bind styae to iontent attribSte speiiiies thether or not ieaas retain their styae ieatSres aiter a sSbtotaa operationc
302

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:bint-styles-to-content

RrT 9T

This attribSte is onay eraaSated ii the table:sort-groups eaement is presentc

o oT<!ATTLIST table:subtotal-rules table:bint-styles-to-content %boolean; "true"<

Case ensitireiase sensitire attribSte speiiiies thether or not the iase oi iharaiters is important then iomparing entriess ior
e.ampaes then sorting groSpsc
rg i nt T

table:case-sensitiveRrT 9T

This attribSte onay eraaSates ii the table:sort-groups eaement is presentc

o oT<!ATTLIST table:subtotal-rules
table:case-sensitive %boolean; "false"<

Page Breaks On GroSp Change
page breaks on groSp ihange attribSte speiiiies thether or not to insert a page break aiter the sSbtotaa ior eaih
groSpcrg i nt T

table:page-breaks-on-group-change

RrT 9T

This attribSte onay eraaSates ii the table:sort-groups eaement is presentc

o oT<!ATTLIST table:subtotal-rules table:page-breaks-on-group-change %boolean; "false"<

9c09cr ort GroSps
The sort groSps eaement speiiiies thether to sort ioaSmn groSps or rot groSpss and hot to sort themc t beaongs
to the sSbtotaa rSaes eaements see the prerioSs seitionc
rg i nt T<table:sort-groups<

RrT 9To oT<!ELEMENT table:sort-groups EMPTY <Data Typedata type attribSte speiiiies the data type oi the ioaSmn groSp or rot groSp to sortc
rg i nt T

table:tata-type

RrT 9Ti the attribSte raaSe is automatics the appaiiation mSst determine that type oi data is in the
groSpc i the groSp iontains a Sser-deiined data types the attribSte raaSe is the name oi this data
typec

o oT

<!ATTLIST table:sort-groups table:tata-type("text" | "number" | "automatic" | qname-but-not-ncname y "automatic" <Chapter 4 Table Content

303

Ordern order attribSte speiiiies thether to sort the groSp data in asiending or desiending orderc
table:orterrg i nt T
RrT 9T<!ATTLIST table:sort-groups table:orter ( "ascenting" |"tescenting" y "ascenting" <

o oT

9c09c

Sbtotaa Sae

The sSbtotaa rSae eaement iontains a rSae ior one iieads ior e.ampaes a ioaSmnc The rSae iontains the groSp iiead
nSmbers thiih speiiiies the ioaSmn groSp ior thiih the rSae is Sseds and one or more sSbtotaa iieadss thiih
speiiiy a iiead and the iSnition oi the iieadc n sSmmarys the rSae desiribes hot to iaaiSaate the sSbtotaac
rg i nt T<table:subtotal-rule<RrT 9To oT<!ELEMENT table:subtotal-rule (table:subtotal-fieltya <GroSp By Fiead NSmbergroSp by iiead nSmber attribSte speiiiies the iieads ior e.ampaes a ioaSmns that is to be groSpedc
rg i nt T

table:group-by-fielt-number

RrT 9T

This attribSte ian be Ssed tith the <table:subtotal-rule< eaementc

o oT<!ATTLIST table:subtotal-ruletable:group-by-fielt-number CtATA teEt|IeEt <9c09c02 Sbtotaa Fiead
The sSbtotaa iiead eaement iontains the iiead nSmber and the iSnition that is Ssed to iaaiSaate a prorisionaa resSatc
n e.ampae oi a iiead is a ioaSmnc
rg i nt T<table:subtotal-fielt<

RrT 9To oT<!ELEMENT table:subtotal-fielt EMPTY <Fiead NSmber
iiead nSmber attribSte speiiiies the inde. nSmber oi the iieadc
rg i nt T

table:fielt-number

RrT 9T
o oT

304<!ATTLIST table:subtotal-fielt table:fielt-number CtATA teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

FSnition
iSnition attribSte speiiiies that kind oi sSbtotaas to iaaiSaatec The ioaaoting are possibae raaSes ior this
attribSte: autos averages counts countnumss maxs mins protucts sttevs sttevps sums var andvarp.
rg i nt T

table:function

RrT 9To oT<!ATTLIST table:subtotal-fielt table:function CtATA teEt|IeEt<

E 4 oT Tihr n 4Tieu Tt<table:tatabase-range table:range-positionp"sampletable.A1:sampletable.G20"
table:namep"sample"<<table:tatabase-source-table table:tatabase-namep"sampletB" table:tablenamep"sampleTable"/<<table:filter ...<⋮</table:filter<<table:sort<<table:sort-by table:fielt-numberp1<</table:sort<<table:subtotal-rules<<table:sort-groups/<<table:subtotal-rule table:column-group "3"<<table:subtotal-fielt table:fielt-numberp"1" table:functionp"sum"/<</table:subtotal-rule<</table:subtotal-rules<</table:tatabase-range<

9c05 Data Piaot Tabaes
Data piaot tabaes aaaot yoS to anaayke and eraaSate yoSr datac The data piaot tabaes eaement ian iontain sereraa
data piaot tabaesc
rg i nt T<table:tata-pilot-tables<

RrT 9To oT<!ELEMENT table:tata-pilot-tables (table:tata-pilot-tableya <9c05c0 Data Piaot Tabae

Chapter 4 Table Content

305

rg i nt T

<table:tata-pilot-table<

RrT 9T

This eaement ian iontain one oi the ioaaoting eaements:

o oT

●

<table:tatabase-source-sql< isee eition 9c09c o●<table:tatabase-source-table< isee eition 9c09c4o●<table:tatabase-source-query< isee eition 9c09c9o●<table:source-service< isee eition 9c05c o●<table:source-cell-range< isee eition 9c05c4o<!ELEMENT table:tata-pilot-table ((table:tatabase-source-sql |table:tatabase-source-table | table:tatabase-source-query |table:source-service | table:source-cell-rangey, table:tatapilot-fieltty<

The attribStes assoiiated tith the data piaot tabae eaement are:●●Data piaot tabae nameppaiiation data●

Grand totaa●

gnore empty rots●

dentiiy iategories●

Target range address

Data Piaot Tabae Name
This attribSte speiiiies the name oi the data piaot tabaec
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:tata-pilot-table table:name CtATA teEt|IeEt<

ppaiiation Data
This attribSte speiiiies e.tra iniormation aboSt the data piaot tabaes thiih ian be Ssed by the appaiiationc
rg i nt T

table:application-tata

RrT 9To oT<!ATTLIST table:tata-pilot-table table:application-tata CtATAtIMPLIEt<

Grand Totaa
This attribSte speiiiies ii a ioaSmns rots or both hare a grand totaa or ii there is a grand totaa at aaac

306

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:grant-total

RrT 9To oT<!ATTLIST table:tata-pilot-table table:grant-total ( "no" |"row" | "column" | "both" y "both" <gnore Empty ots
This attribSte speiiiies thether or not empty rots in the soSrie range shoSad be ignoredc
rg i nt T

table:ignore-empty-rows

RrT 9To oT<!ATTLIST table:tata-pilot-table table:ignore-empty-rows %boolean; "false"<

dentiiy Categories
This attribSte speiiiies thether or not the appaiiation orders rots tithoSt aabeas to the ne.t higher iategory speiiiied by a rot aabeac
rg i nt T

table:itentify-categories

RrT 9To oT<!ATTLIST table:tata-pilot-table table:itentify-categories %boolean; "false"<

Target ange ddressThis attribSte speiiiies there the target range oi the data piaot tabae oStpStc
rg i nt T

table:target-range-attressRrT 9To oT
n T<!ATTLIST table:tata-pilot-table table:target-range-attress %cell-range-attress; teEt|IeEt <Disirimination betteen absoaSte and reaatire addresses is not possibaec Thereiores yoS mSst
speiiiy a tabae name in the address and doaaar signs are ignoredc

BSttons
This attribSte speiiiies aaa ieaas thiih are a bSttonc This is a aist oi ieaa-addressesc
rg i nt T

table:buttons

RrT 9To oT<!ATTLIST table:tata-pilot-table table:buttons %cell-rangeattress-list; teEt|IeEt <n TDisirimination betteen absoaSte and reaatire addresses is not possibaec Thereiores yoS mSst
speiiiy a tabae name in the address and doaaar signs are ignoredc

Chapter 4 Table Content

307

9c05coSrie erriie

soSrie serriie eaement iontains iniormation aboSt the serriie thiih is Ssed to ireate the data piaot tabaec
rg i nt T<table:source-service<

RrT 9To oT<!ELEMENT table:source-service EMPTY <The attribStes that yoS ian assoiiate tith this eaement are:●erriie name●oSrie name●Objeit name●oSrie Ssername●

oSrie passtorderriie Name
This attribSte speiiiies the name oi the serriiec
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:source-service table:name CtATA teEt|IeEt <oSrie Name
This attribSte speiiiies the soSrie oi the serriiec
rg i nt T

table:source-name

RrT 9To oT<!ATTLIST table:source-service table:source-name CtATA
teEt|IeEt <Objeit Name
This attribSte speiiiies the name oi the objeit in the soSrie thiih iontains the datac
rg i nt T

table:obiect-name

RrT 9To oT<!ATTLIST table:source-service table:obiect-name CtATA
teEt|IeEt <oSrie sernameThis attribSte speiiiies the Ssername reqSired to aiiess the soSriec
308

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:username

RrT 9To oT<!ATTLIST table:source-service table:username CtATA tIMPLIEt <oSrie Passtord
This attribSte speiiiies the passtord reqSired to aiiess the soSriec
rg i nt T

table:passwort

RrT 9To oT<!ATTLIST table:source-service table:passwort CtATA tIMPLIEt <9c05c4 oSrie Ceaa ange
soSrie ieaa range eaement iontains iniormation aboSt the ieaa range and hot the data piaot tabae gets the datairom the rangec YoS ian aiqSire the data tith or tithoSt a qSerycrg i nt T<table:source-cell-range<

RrT 9To oT<!ELEMENT table:source-cell-range (table:filtery? <The attribStes that yoS ian assoiiate tith the soSrie ieaa range eaement is:●

Ceaa range address

Ceaa ange ddressThis attribSte speiiiies the ieaa range iontaining the soSrie datac
rg i nt T

table:cell-range-attressRrT 9To oT<!ATTLIST table:source-cell-range table:cell-range-attress %cell-range-attress; teEt|IeEt <n TDisirimination betteen absoaSte and reaatire addresses is not possibaec Thereiores yoS mSst
speiiiy a tabae name in the address and doaaar signs are ignoredc

9c05c9 Fiater
ee eition 9c04c0 ior iniormation on iiatering in tabaesc

9c05c5 Data Piaot Fiead

Chapter 4 Table Content

309

rg i nt T

<table:tata-pilot-fielt<

RrT 9To oT<!ELEMENT table:tata-pilot-fielt ( table:tata-pilot-level y ?
<The attribStes that yoS ian assoiiate tith the data piaot iiead eaement are:●oSrie iiead name●s data aayoSt iiead●

FSnition●

Orientation●

sed hierarihy

oSrie Fiead Name
This attribSte speiiiies the name oi the soSrie iieadc There ian be mSatipae <table:tata-pilot-fielt<
eaements tith the same raaSe ior this attribStec
rg i nt T

table:source-fielt-name

RrT 9To oT<!ATTLIST table:tata-pilot-fielt table:source-fielt-name CtATA
teEt|IeEt <s Data LayoSt Fiead
This attribSte speiiiies thether or not the soSrie iiead is a data aayoSt iieadc
rg i nt T

table:is-tata-layout-fielt

RrT 9To oT<!ATTLIST table:tata-pilot-fielt table:is-tata-layout-fielt %boolean; "false" <FSnition
This attribSte speiiiies the iSnition thiih is Ssed ior the soSrie iieadc Possibae raaSes ior this attribSte are:averages counts countnumss maxs mins protucts sttevs sttevps sums var and varpc
rg i nt T

table:function

RrT 9T

This attribSte is onay eraaSated ii the raaSe oi the table:orientation attribSte is tata.

o oT<!ATTLIST table:tata-pilot-fielt table:function CtATA
teEt|IeEt <Orientation
This attribSte speiiiies the orientation oi the soSrie iieadc The orientation ian be by rots by ioaSmns by datas by
310

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

pages or hiddenc
rg i nt T

table:orientation

RrT 9To oT<!ATTLIST table:tata-pilot-fielt table:orientation ( "row" |"column" | "tata" | "page" | "hitten" y teEt|IeEt<

sed Oierarihy
This attribSte speiiiies the Ssed hierarihy oi the soSrie iieadc
rg i nt T

table:uset-hierarchy

RrT 9To oT<!ATTLIST table:tata-pilot-fielt table:uset-hierarchy CtATA"1" <9c05c6 Data Piaot Lerea
The data piaot aerea eaement iontains iniormation aboSt the aerea oi a data piaot tabaec
rg i nt T<table:tata-pilot-level<

RrT 9To oT<!ELEMENT table:tata-pilot-level (table:tata-pilot-subtotals?,
table:tata-pilot-members?y <The attribSte that yoS ian assoiiate tith the data piaot aerea eaement is:●

hot empty

hot Empty
This attribSte speiiiies thether or not empty iieads shoSad be dispaayedc i this attribSte is not presents the appaiiation ian determine the deiaSat setting tith the heap oi the soSriec
rg i nt T

table:show-empty

RrT 9To oT<!ATTLIST table:tata-pilot-level table:show-empty %boolean;tIMPLIEt <9c05cm Data Piaot Sbtotaas
The data piaot sSbtotaas eaement iontains iniormation aboSt the rovisional result oS a Siela in a aata ilot tableana the Sunction usea to calculate the result. mS the element is not resentt the a lication can aetermine the subtotals with the hel oS the source.

Chapter 4 Table Content

311

rg i nt T

<table:tata-pilot-subtotals<

RrT 9T

This eaement ian iontain the data piaot sSbtotaa eaementsc

o oT<!ELEMENT table:tata-pilot-subtotals ( table:tata-pilotsubtotal ya <9c05cr Data Piaot Sbtotaa
Thedata piaot sSbtotaa eaement iontains the iSnition thiih is Ssed to iaaiSaate the sSbtotaac
rg i nt T<table:tata-pilot-subtotal<

RrT 9To oT<!ELEMENT table:tata-pilot-subtotal EMPTY <The attribSte that yoS ian assoiiate tith the data piaot sSbtotaa eaement is:●

FSnition

FSnition
This attribSte speiiiies the iSnition Ssed ior the sSbtotaac Possibae iSnitions are autos averages counts
countnumss maxs mins protucts sttevs sttevps sums var and varpc
rg i nt T

table:function

RrT 9To oT<!ATTLIST table:tata-pilot-subtotal table:function CtATA
teEt|IeEt <9c05c Data Piaot

embersThe data piaot members eaement iontains iniormation aboSt the members oi the data piaot soSriec This eaement
ian iontain data piaot member eaementsc
rg i nt T<table:tata-pilot-members<

RrT 9To oT<!ELEMENT table:tata-pilot-members ( table:tata-pilot-member ya <9c05c02 Data Piaot

ember

The data piaot member eaement iontains iniormation aboSt a member oi the data piaot tabaec
rg i nt T<table:tata-pilot-member<RrT 9To oT<!ELEMENT table:tata-pilot-member EMPTY <The attribStes that yoS ian assoiiate tith the data piaot member eaement are:
312

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●●●ember name
Dispaay
hot detaias

ember Name
This attribSte speiiiies the name oi the data piaot memberc
rg i nt T

table:nameRrT 9To oT<!ATTLIST table:tata-pilot-member table:name CtATA teEt|IeEt<

DispaayThis attribSte speiiiies thether or not a data piaot member is risibaec mS this attribute is not resentt the acan aetermine the aeSault setting with the hel oS the source.
rg i nt T

licationtable:tisplay

RrT 9To oT<!ATTLIST table:tata-pilot-member table:tisplay %boolean;tIMPLIEt <hot Detaias
This attribSte speiiiies thether or not the detaias aboSt a data piaot member are dispaayedc mS this attribute is notresentt the a lication can aetermine the aeSault setting with the hel oS the source.
rg i nt T

table:show-tetails

RrT 9To oT<!ATTLIST table:tata-pilot-member table:show-tetails %boolean;tIMPLIEt <9c06 Consoaidation
se this iSnition to iombine data irom sereraa independent tabae areascmathematiiaa iSnition and based on those areasc
rg i nt T

net area is iaaiSaated ria a seaeited<table:consolitation<

RrT 9To oT<!ELEMENT table:consolitation EMPTY <The attribStes that yoS ian assoiiate tith this eaement are:●●FSnitionoSrie ieaa range addresses

Chapter 4 Table Content

313

●
●
●

Target ieaa address
se aabea
Link to soSrie data

FSnition
This attribSte iontains the iSnition thiih is Ssed to ionsoaidate the datac Possibae iSnitions are autos
averages counts countnumss maxs mins protucts sttevs sttevps sums var and varpc
rg i nt T

table:function

RrT 9To oT<!ATTLIST table:consolitation table:function CtATA teEt|IeEt <oSrie Ceaa ange ddresses
This attribSte iontains a aist oi ieaa range addressesc These are the soSrie ieaa rangesc
rg i nt T

table:source-cell-range-attresses

RrT 9To oT<!ATTLIST table:consolitation table:source-cell-rangeattresses %cell-range-attress-list; teEt|IeEt <Target Ceaa ddressThis attribSte iontains the target ieaa addressc
rg i nt T

table:target-cell-attressRrT 9To oT<!ATTLIST table:consolitation table:target-cell-attress %cellattress; teEt|IeEt <se Labea
This attribSte speiiiies thether or not aabeas shoSad be Ssed by the ionsoaidation and ii Sseds thiih onesc
Possibae raaSes are nones columns row and bothc
rg i nt T

table:use-label

RrT 9To oT<!ATTLIST table:consolitation table:use-label (none | column |row | bothy "none" <Link to oSrie Data
This attribSte speiiiies thether to aink the data in the ionsoaidation area to the soSrie datas and thether or not toaStomatiiaaay Spdate the resSats oi the ionsoaidation ii any ihanges are made to the originaa datac
314

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:link-to-source-tata

RrT 9To oT<!ATTLIST table:consolitation table:link-to-source-tata %boolean; "false" <9c0m DDE Links
The <table:tte-links< iontainer eaement stores aaa DDE ainksc Erery aink iontains the DDE oSrie andthe data oi the aast ionneitionc
rg i nt T<table:tte-links<

RrT 9To oT<!ELEMENT table:tte-links (table:tte-linkyt <9c0mc0 DDE Link
This <table:tte-link< eaement iontains the DDE soSrie and a simpae tabae eaementc
rg i nt T<table:tte-link<

RrT 9T

The tabae does not need a namec
The eaements in the tabae do not hare styaes or other iniormationc Onay the data in the ieaa attribStes is Ssedc
The ieaa does not iontain paragraphsc
The data is stored in the raaSe attribStesc
The tabae mSst iontain at aeast one ieaac

o oT<!ELEMENT table:tte-link (table:tte-source, table:tabley <9c0mc DDE oSrie
The DDE soSrie oi the <table:tte-link< eaement onay sSpports the raaSe true ior the office:automatic-uptate attribStec
dditionaaays the DDE soSrie has a net attribSte table:conversion-motec

Conrersion

odeThis attribSte speiiiies the method by thiih the DDE serrer ionrerts its data into nSmbersc There are threepossibae raaSesc
rg i nt T

table:conversion-moteRrT 9To oT<!ATTLIST table:tte-link table:conversion-mote (into-tefaultstyle-tata-style|into-english-number|let-texty "into-tefaultstyle-tata-style" <Chapter 4 Table Content

3159c0r Tabae Formatting Properties
The ioaaoting seitions detaia the iormatting properties that ian be appaied to tabaesc

9c0rc0 Tabae Didth
Erery tabae mSst hare a ii.ed tidthc YoS speiiiy this tidth as a ii.ed aengthc
YoS ian aaso speiiiy the tidth oi a tabae reaatire to the tidth oi the area that the tabae is inc n this iases yoS
speiiiy the tidth as a perientagec ser agents that sSpport speiiiying the reaatire tidth oi a tabae ian speiiiytidths in this tays bSt it is not essentiaac
rg i nt T

style:witth
style:rel-witth

RrT 9To oT

n 9T<!ATTLIST style:properties style:witth %length; tIMPLIEt<<!ATTLIST style:properties
style:rel-witth %percentage; tIMPLIEt<
The reasons thy erery tabae mSst hare a ii.ed tidth and reaatire tidths are onay an option are as
ioaaots:●peiiiying the tidth oi a tabae by a perientage is SseiSa ior iSrrent teb brotsers and otherappaiiations there the perientage is reaatire to the tidth oi a tindotc BSt it may iaSse probaems ii the perientage reaates to a ii.ed paper tidthc●

eaatire tidths ian aaso iaSse probaems ior appaiiations sSih as spreadsheet appaiiationss
there there is no reqSirement ior a tabae to iit on a pagec

Ooterers ii an appaiiation sSpports reaatire tidthss it is reaatireay easy to program the appaiiation
to iaaiSaate a ii.ed tabae tidths based on a perientagec

9c0rc Tabae aignmenttabae aaignment property speiiiies the horikontaa aaignment oi a tabaec
rg i nt T

table:alignRrT 9T

The options ior a tabae aaignment property are as ioaaots:
●
●
●
●

o oT
n 9T

left e The tabae aaigns to the aeitc
center e The tabae aaigns to the ienterc
right e The tabae aaigns to the rightc
margins e The tabae iiaas aaa the spaie betteen the aeit and right marginsc<!ATTLIST style:properties
table:align (left|center|right|marginsy teEt|IeEt<
ser agents that do not sSpport the margins raaSes may treat this raaSe as leftc

9c0rc4 Tabae Leit and ight

argin

These properties speiiiy the distanie oi the tabae irom the aeit and right marginsc ee Chapter 4 ior a iSaa e.paanation oi aeit and right margin propertiesc
316

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T
RrT 9T

fo:margin-left
fo:margin-rightn appaiiation may reiognike tabae marginss bSt this is not essentiaac
Tabaes that aaign to the aeit or to the ienter ignore right marginss and tabaes aaign to the right or to
the ienter ignore aeit marginsc

9c0rc9 Tabae Top and Bottom

argin

These properties speiiiy the distanie oi the tabae irom the top and bottom marginss fo:margin-top and fo:
margin-bottomc ee Chapter 4 ior a iSaa e.paanation oi top and bottom margin propertiesc

9c0rc5 Page eqSenie Entry Point
ee ? ior iniormation on this attribSte style:page-sequence-namec

9c0rc6 Break Beiore and Break iter
These properties insert a page or ioaSmn break beiore or aiter a tabaes fo:break-before and fo:breakafterc ee eition 4c00c 9 ior a iSaa e.paanation oi these propertiesc

9c0rcm Tabae BaikgroSnd and BaikgroSnd mage
These properties speiiiy the baikgroSnd ioaor and image oi a tabae Ssing the attribSte fo:backgrountcolor and the eaement <style:backgrount-image<c ee eition 4c00c 5 and 4c00c 6 ior a iSaa e.paanation oi these propertiesc

9c0rcr Tabae hadot
The tabae shadot property speiiiies that a shadot risSaa eiieit appears on a tabaes Ssing the attribSte style:shatowc ee eition 4c00c42 ior a iSaa e.paanation oi this propertyc

9c0rc 2eep tith Ne.t
The keep tith ne.t property speiiiies that a tabae stays tith the paragraph that ioaaots its Ssing the attribSte fo:
keep-with-nextc ee eition 4c00c40 ior a iSaa e.paanation oi this propertyc

9c0rc02

ay Break Betteen ots

This property speiiiies that a page break may oiiSr inside a tabaec

Chapter 4 Table Content

317

rg i nt T

style:may-break-between-rows

RrT 9To oT<!ATTLIST style:properties
style:may-break-between-rows %boolean; tIMPLIEt<

9c0rc00 Borderodea Property

The table:borter-motel property speiiiies that border modea to Sse then ireating a tabae tith a borderc
There are tto types oi border modeas as ioaaots:●

nTT4o9u1.i nIt Ii nt T
Dhen tto adjaient ieaas hare diiierent borderss the tider border appears as the border betteen the ieaasc Eaih
ieaa reieires haai oi the tidth oi the borderc●

h o4I4 u1.i nIt Ii nt T
Borders appear tithin the ieaa that speiiiies the borderc

Both border modeas are rery simiaar to the ioaaapsing and separating border modeas oi X L and hh1c They
diiier in hot border tidths reaate to rot and ioaSmn tidthsc
n OpenOiiiiecorgs a rot height or ioaSmn tidth iniaSdes any spaie reqSired to dispaay borders or paddingc Thismeans thats thiae the tidth and height oi the iontent area is aess than the ioaSmn tidth and rot heights the sSmoi the tidths oi aaa ioaSmns is eqSaa to the totaa tidth oi the tabaecn X L and C
s a ioaSmn tidth or rot height speiiiies the tidth or height oi the iontent area oi a ieaac Thismeans that the sSm oi the tidths oi aaa ioaSmns is aess than the tidth oi the tabaec
rg i nt T

table:borter-motel

RrT 9To oT<!ATTLIST style:properties
table:borter-motel (collapsing|separatingy tIMPLIEt<

9c0rc0 Page tyaeThis attribSte speiiiies the name oi the page styaec
rg i nt T

table:page-style-name

RrT 9To oT<!ATTLIST style:properties table:page-style-name %styleName;tIMPLIEt<

9c0rc04 Dispaay
This attribSte speiiiies thether or not a tabae is dispaayedc

318

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

table:tisplay

RrT 9To oT<!ATTLIST style:properties table:tisplay %boolean; tIMPLIEt<

9c0 CoaSmn Formatting Properties
The ioaaoting seitions detaia the iormatting properties that yoS ian appay to tabae ioaSmnsc

9c0 c0 CoaSmn Didth
Erery tabae ioaSmn mSst hare a ii.ed tidthc YoS speiiiy this tidth as a ii.ed aengthc
YoS ian aaso speiiiy the tidth oi a ioaSmn reaatire to the other ioaSmn tidthsc ppaiiations that sSpport speiiiying the reaatire tidth oi a ioaSmn ian speiiiy tidths in this tays bSt it is not essentiaac
eS infoemation to be supplied.
rg i nt T

style:column-witth
style:rel-column-witth

RrT 9T

To speiiiy a ii.ed tidths Sse the style:column-witth propertyc To speiiiy a reaatire
tidths Sse the style:rel-column-witth propertys ioaaoted by a nSmber signiiying thetidth yoS reqSirec

o oT<!ENTITY % rel-number "CtATA"<<!ATTLIST style:properties style:column-witth %length; tIMPLIEt<<!ATTLIST style:properties style:rel-column-witth %rel-number;tIMPLIEt<

n 9T

The reaatire tidth oi a tabae is the sSm oi aaa oi the reaatire tidths oi the ioaSmns in the tabaecn T

n X L and C

s a ioaSmn tidth does not iniaSde any border tidths or paddingc

Break Beiore and Break iter
The break beiore ifo:break-beforeo and break aiter ifo:break-aftero attribStes ian be Ssed to iormat
tabaes in a simiaar tay to the tay they are Ssed to iormat paragraphsc For tabaess the onay raaSes yoS ian set ior
these attribStes are "auto" or "page"c ee eition 4c00c 9 ior more iniormation aboSt Ssing these attribStesc

9c 2 Tabae ot Formatting Properties
The ioaaoting seitions detaia the iormatting properties that yoS ian appay to tabae rotsc

9c 2c0ot Oeight

This property speiiiies the height oi a tabae rotc By deiaSats rot height is the height oi the taaaest item in the rotc
YoS ian aaso speiiiy a minimSm height or a ii.ed heightc

Chapter 4 Table Content

319

rg i nt T

style:row-heightstyle:min-row-heightRrT 9T

To speiiiy a ii.ed heights Sse the style:row-height propertyc To speiiiy a minimSm
heights Sse the style:min-row-height propertyco oT<!ATTLIST style:properties style:row-height %length; tIMPLIEt<<!ATTLIST style:properties style:min-row-height %length; tIMPLIEt<

n T

n X L and C

s a rot height does not iniaSde border tidths or paddingc

ot BaikgroSnd
To appay a baikgroSnd ioaor or a baikgroSnd image to a tabae rots Sse the baikgroSnd and baikgroSnd ioaor
paragraph iormatting propertiesc ee eitions 4c00c 5 and 4c00c 6 ior a iSaa e.paanation oi the baikgroSnd andbaikgroSnd ioaor propertiesc

9c 2c Break Beiore and Break iter
The break beiore ifo:break-beforeo and break aiter ifo:break-aftero attribStes ian be Ssed to iormat
tabae rots in a simiaar tay to the tay they are Ssed to iormat paragraphsc For tabae rotss the onay raaSes yoS ian
set ior these attribStes are "auto" or "page"c ee eition 4c00c 9 ior more iniormation aboSt Ssing these attribStesc

9c 0 Tabae Ceaa Formatting Properties
The ioaaoting seitions detaia the iormatting properties that yoS ian appay to tabae ieaasc

9c 0c0 Vertiiaa aignment
The rertiiaa aaignment property aaaots yoS to speiiiy the rertiiaa aaignment oi te.t in a tabae ieaac
rg i nt T

fo:vertical-alignRrT 9To oT
n 9T<!ATTLIST style:properties
fo:vertical-align (top|mittle|bottom|automaticy tIMPLIEt<
The options ior the rertiiaa aaignment property are as ioaaots:●●●●u u 4 un19T

top e aigns te.t rertiiaaay tith the top oi the ieaac
mittle e aigns te.t rertiiaaay tith the middae oi the ieaac
bottom e aigns te.t rertiiaaay tith the bottom oi the ieaac
Stomatii l The appaiiation deiide hot to aaign the te.tc

There is no X L property that speiiiies the rertiiaa aaignment oi a tabae ieaac This appears to be anorersight rather than deaiberatec

9c 0c Te.t aignee Chapter 4 ior iniormation on Ssing this property to iormat tabae ieaasc
320

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c 0c4 Te.t aign oSrie
This property speiiiies the soSrie oi the te.t-aaign propertyc
rg i nt T

style:text-align-source

RrT 9Ti the raaSe oi this attribSte is "fix"s onay the fo:text-align property is Ssedc i the raaSe is"value-type"s the te.t aaignment is ae enaent on the value-type oi the ieaac

o oT<!ATTLIST style:properties style:text-align-source (fix|valuetypey tIMPLIEt<

9c 0c9 Te.t OStaineee Chapter 4 ior iniormation on Ssing this property to iormat tabae ieaasc

9c 0c5 Direition
This property speiiiies the direition oi iharaiters in a ieaac The most iommon direition is aeit to right iltroc The
other direition is top to bottom ittbos there the iharaiters in the ieaa are staiked bSt not rotatedc
rg i nt T

fo:tirection

RrT 9To oT<!ATTLIST style:properties fo:tirection ( "ltr" | "ttb" ytIMPLIEt<

9c 0c6 Vertiiaa Gayph Orientation
This property speiiiies the rertiiaa gayph orientationc The property speiiiies an angae or aStomatii modec The
onay possibae angae is 2s thiih disabaes this ieatSrec
rg i nt T

fo:glyph-orientation-vertical

RrT 9To oT<!ATTLIST style:properties style:glyph-orientation-vertical ( auto
| 0 y tIMPLIEt<

9c 0cm Te.t hadot
To speiiiy a te.t shadot tithin a tabae ieaas Sse the fo:text-shatow iormatting propertyc ee Chapter 4 ior a
iSaa e.paanation oi the te.t shadot propertyc

9c 0cr Ceaa hadot
To speiiiy a ieaa shadot in a tabae ieaas Sse the style:shatow iormatting propertyc ee Chapter 4 ior a iSaa
e.paanation oi the shadot propertyc

Chapter 4 Table Content

3219c 0c Ceaa BaikgroSnd
To appay a baikgroSnd ioaor or a baikgroSnd image to a tabae ieaas Sse the baikgroSnd and baikgroSnd ioaor
paragraph iormatting propertiesc ee Chapte 4 ior a iSaa e.paanation oi the baikgroSnd and baikgroSnd ioaor
propertiesc

9c 0c02 Ceaa Borders and Border Line Didth
To appay a border to a tabae ieaa and speiiiy the tidth oi the borders Sse the border and border aine tidth paragraph iormatting propertiesc ee eitions 4c00c m and 4c00c r ior a iSaa e.paanation oi the border and border aine
tidth propertiesc

9c 0c00 Padding
To appay padding to a tabae ieaas Sse the padding paragraph iormatting propertyc ee Chapter 4 ior a iSaa e.paanation oi the padding propertyc

9c 0c0 Leitargin

To speiiiy a aeit margin in a tabae ieaas Sse the aeit margin paragraph iormatting propertyc ee Chapter 4 ior a iSaa
e.paanation oi the aeit margin propertyc

9c 0c04 Drap Option
This property is aike speiiiied in X Lc n addition the X L property fo:overflow is neiessaryc The deiaSat is
not trap aike in X Ls bSt the deiaSat is no-trapc
rg i nt T

fo:wrap-option
fo:overflow

RrT 9To oT

9c 0c09<!ATTLIST style:properties fo:wrap-option (no-wrap|wrapy tIMPLIEt<<!ATTLIST style:properties fo:overflow (autoy tFIXEt<

otation ngae

This property speiiiies the raaSe oi a rotation angae in degreesc
rg i nt T

style:rotation-angle

RrT 9T
o oT

322<!ATTLIST style:properties style:rotation-angle %number tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

9c 0c05

otation aignThis property speiiiies hot the edge oi the te.t in a ieaa is aaigned aiter a rotationc There are ioSr aaignment
options:
ATu.1

1i

iu9iiii

Nonec

otatedc

Bottom oi the ieaac

otated and may oreraap tithother ieaas ii the te.t is aonger
than the aength oi the ieaac

Top oi the ieaac

BnIt I9i41ti 4o .Inr1ti4I iii
nihangedc
Positioned paraaaea to the te.ts thereby
the Spper or aoter edge is dratn at theoriginaa position oi the ieaac

Center oi the ieaac

The OpenOiiiiecorg X L iode ior the rotation aaign attribSte is desiribed in the ioaaoting tabaec
rg i nt T

style:rotation-alignRrT 9TThe raaSe oi this attribSte ian be "none"s "bottom"s "top"s or "center"co oT<!ATTLIST style:properties style:rotation-align ( "none" |"bottom" | "top" | "center"y tIMPLIEt<

9c 0c06 Ceaa Proteit
This property speiiiies hot a ieaa is proteitedc
rg i nt T

style:cell-protect

RrT 9T

This attribSte is onay eraaSated ii the iSrrent tabae is proteited isee 9c5c0oc The raaSe oi theattribSte ian be "none"s "hitten-ant-protectet"s or a spaie-separated aist iontaining the
raaSes "protectet" or "formula-hitten"co oT<!ATTLIST style:properties style:cell-protect CtATA tIMPLIEt <9c 0c0m Print Content
This property speiiiies thether or not the ieaa iontent ian be printedc
rg i nt T

style:print-content

RrT 9To oT<!ATTLIST style:properties style:print-content %boolean;tIMPLIEt <9c 0c0r Data tyaeThis property iontains the name oi a data styae to Sse as the data styae ior the ieaac The data styae is represented by
one oi the styae eaements desiribed in Chapter c The styae ian be reierenied by a namec

Chapter 4 Table Content

323

rg i nt T

style:tata-style-name

RrT 9To oT

324<!ATTLIST style:properties style:tata-style-name %style-name;teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CHAPTER

55Graphii Content
This ihapter prorides the OpenOiiiiecorgirg i9o oueuo4 un1ienIi r ionI i T
1 9inei r ito 1teeuo inI.
graphiis 4ooTuo4 un19 ito 1teeuo inI.ioI4Ai41tito 1teeuo inI.i oI 99ii ion1 4u19i r ienTTnAu1.
9 o un19Ti●

aster Pages●

Drating Pages●

Drating hapes●

Presentation hapes●

4D hapes●

Graphii tyae Eaements●

troke Properties●

Fiaa Properties●

Te.t nimation Properties●

Te.t Properties●

Graphii Properties●

hadot Properties●

Conneitor Properties●

easSre Properties●

Caption Properties●

4D Geometry Properties●

4D Lighting Properties●

4D Te.tSre Properties

●

4D

●

4D hadot Properties●

Layer ets●

GaSe Points●

Presentation Page LayoSts●

Presentation Page ttribStes

ateriaa Properties

325

●

Presentation ettings●

Presentation nimations
onI 41 i n

OpenOiiiiecorgioI4Aiu9i4i9r 9 ineito 1teeuo inI.i oI 99ii r ito 1teeuo inI.ioI4Ai4ooTuo4 un1itn 9
1n i9roonI ioI 9 1 4 un1ie 4 rI 9ii 1i ru9ior4o I i r 9 ie 4 rI 9i4I iu1tuo4 tir9u1.i r iorI49 iO nIioI 91 4 un19in1TyOi

5c0

aster Pages
YoS Sse 49 Iio4. 9 as iommon baikgroSnds ior tI4Au1.io4. 9c YoS assign master pages Ssing the<styles:master-page< eaementc
rg i nt Ti
RrT 9Ti<style:master-page<
aster pages are stored in the <office:styles< eaementc
YoS mSst hare one master page eaementc
Eaih drating page is ainked to one master pages thiih is yoS speiiiy Ssing the style:parent-style-name attribSte oi the drating pages styaeco o<!ELEMENT style:master-page ( (style:heater, style:heaterleft?y?, (style:footer, style:footer-left?y?, office:forms?,
style:stylea, (%shapes;ya, presentation:notes? y<

The attribStes that yoS ian assoiiate tith the <style:master-page< eaement are:●Page name●

Page master●

Page styae●

Ne.t styae name

The eaements that yoS ian iniaSde in the <style:master-page< eaement are:●Presentation notes

●

hapes

●

FramesPage Name
The style:name attribSte speiiiies the name oi a master pagec Eaih master page is reierenied Ssing the page
namec

326

rg i nt Ti

style:nameRrT 9Ti

This attribSte is reqSired and the name speiiiied mSst be SniqSec

o oT<!ATTLIST style:master-page style:name %styleName;
teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Page

aster

The style:page-master-name attribSte speiiiies the sikes borders and orientation oi a master pagec Thesesettings are ioaaeitireay iaaaed the page masterc
rg i nt Ti

style:page-master-name

RrT 9Ti

This attribSte is reqSiredc

o oT<!ATTLIST style:master-page style:page-master-name %styleName; teEt|IeEt<

Page tyae
YoS ian assign additionaa page styae attribStes to a drating page Ssing the traw:style-name attribStec
rg i nt Ti

traw:style-name

RrT 9Ti

This attribSte is optionaac
The ii.ed iamiay ior page styaes is trawing-pagec

o oT<!ATTLIST traw:page traw:style-name %styleName; tIMPLIEt <Ne.t tyae Namei the appaiiation sSpports aStomatiiaaay generated pagess the traw:next-style-name attribSte identiiies
the master page that is Ssed as a tempaate ior the ne.t pagec
rg i nt Ti

traw:next-style-name

RrT 9Ti

This attribSte is optionaac
The raaSe oi this attribSte mSst be the name oi another style:master-page eaementc

o oT<!ATTLIST style:master-page style:next-style-name %styleName; tIMPLIEt<

5c0c0 OandoSt

aster

For appaiiations that sSpport printing handoSt pagess this eaement is a tempaate ior aStomatiiaaay generating thehandoSt pagesc This eaement ian iontain any type oi shapec The most SseiSa shape is the <traw:pagethumbnail<s thiih is repaaied by aitSaa drating pages irom the doiSmentc
rg i nt Ti<style:hantout-master<RrT 9Ti

YoS ian onay hare one <style:hantout-master< eaement and it is stored in the<office:styles< eaementc

o o<!ELEMENT style:hantout-master (%shapes;ya<

The attribStes that yoS ian assoiiate tith the <style:hantout-master< eaement are:●Presentation Page LayoSt

Chapter 5 Graphic Content

327

Presentation Page LayoSt
This attribSte ainks to a <style:presentation-page-layout< eaementc ee eition 5c 4 ior iniormation on the presentation page aayoSt eaementrg i nt Ti

presentation:presentation-page-layout-name

RrT 9Ti

This attribSte is optionaaco oT<!ATTLIST style:hantout-master presentation:presentationpage-layout-name %styleName; tIMPLIEt<

5c0c Presentation Notes
Eaih drating page in a presentation ian hare an additionaa presentation notes pages thiih iontains:●preriet oi the drating page●

dditionaa graphii shapes

The <presentation:notes< eaement iontains the presentation notesc
rg i nt Ti<presentation:notes<

RrT 9Tio oT
n 9Ti<!ELEMENT presentation:notes (%shapes;ya<
For presentations onayc

E 4 oT Tig49 Iio4.
<office:styles<...
<style:master-page style:namep"home" style:page-masterp"tefault"<<style:style style:namep"title" style:familyp"presentation"<<style:properties fo:font-stylep"italic"/<</style:style<<style:style style:namep"subtitle" style:familyp"presentation"style:parent-style-namep"title"<<style:properties style:text-outlinep"true"/<</style:style<<traw:rectangle .../<<presentation:notes<<traw:text ...<this is a note</traw:text<</presentation:notes<</style:master-page<...
</office:styles<

5c

Drating Pages
drating page is a iontainer ior iontent in a drating or presentation doiSmentc Drating pages are Ssed ior the
ioaaoting:
●
●

328

Dratings
aides ior presentations

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<traw:page<RrT 9Ti

YoS mSst assign a master page to eaih drating pagec

o oT<!ELEMENT traw:page (office:forms?,(%shapes;ya,presentation:
animations?,presentation:notes?y<The attribStes that yoS ian assoiiate tith the <traw:page< eaement are:●Page name●

Page styae●

aster page●

Presentation page aayoSt●

Presentation page properties

The eaements that yoS ian iniaSde in the <traw:page< eaement are:
●

hapes

●

Frames●Presentation notes

●

Forms

●

nimationsPage Name
The traw:name attribSte speiiiies the name oi a drating pagec
rg i nt Ti

traw:nameRrT 9Ti

This attribSte is optionaac
i yoS Sse this attribStes the name mSst be SniqSec
i yoS do not Sse this attribStes the appaiiation generates a SniqSe namec

o oT<!ATTLIST traw:page traw:name %styleName; tIMPLIEt <Page tyae
YoS ian assign additionaa iormatting attribStes to a drating page by assigning a page styaec
rg i nt Ti

traw:style-name

RrT 9Ti

This attribSte is optionaac
The ii.ed iamiay ior page styaes is trawing-pagec

o oT<!ATTLIST traw:page traw:style-name %styleName; tIMPLIEt <aster Page
Eaih drating page mSst hare one master page assigned to itc The master page:
Chapter 5 Graphic Content

329

●
●

Deiines properties sSih as the sike and borders oi the drating pageerres as a iontainer ior shapes that are Ssed as a iommon baikgroSnd

The traw:master-page-name attribSte speiiiies the name oi the master page assigned to the drating pagec
rg i nt Ti

traw:master-page-name

RrT 9Ti

This attribSte is reqSiredc

o oT<!ATTLIST traw:page traw:master-page-name %styleName;
teEt|IeEt<

Presentation Page LayoSt
This attribSte ainks to a <style:presentation-page-layout< eaementc ee eition 5c 4 ior iniormation on the presentation page aayoSt eaementrg i nt Ti

presentation:presentation-page-layout-name

RrT 9Ti

This attribSte is optionaaco oT<!ATTLIST traw:page presentation:presentation-page-layoutname %styleName; tIMPLIEt<

Presentation Page Properties
Eaih drating page ian hare optionaa presentation propertiess ior e.ampaes the dSration ior thiih a page isdispaayed or a iade eiieitc For iniormation on the attribStes Ssed to represent these propertiess see eition 5c 9c
n T These attribStes are ior presentations onayc

5c c0 BaikgroSnd tyae Properties
drating page ian hare an optionaa baikgroSnd that deiines the baikgroSnd appearanie oi the pagec i yoS set
an optionaa baikgroSnds it orerrides the baikgroSnd oi the assigned master pages bSt not the shapes that are on
the pagec YoS ian aater the baikgroSnd oi the assigned master page by Ssing one oi the ioaaoting eaements in thestyae eaement oi the page:●<style:backgrount-image< - see Chapter 4●<fo:backgrount-color< - see Chapter 4●<traw:hatch< - see eition 5c6c●

<traw:gratient< - see eition 5c6c0

5c c Presentation Notes
Eaih drating page in a presentation ian hare an additionaa presentation notes pages thiih iontains a preriet oi
the iorresponding drating page and additionaa graphii shapesc YoS ian iniaSde the <presentation:notes< eaement in the <traw:page< eaementc ee eition 5c0c ior more iniormation aboSt this eaementc
E 4 oT TioI4Au1.io4.

330

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<office:automatic-styles<<style:style style:namep"gg3:3:" style:familyp"trawing-page"<<style:properties presentation:page-turationp"4s"<</style:style<<style:style style:namep"titletia"
style:familyp"presentation-page-layout"<<presentation:placeholter presentation:obiectp"title"
svg:xp"20%" svg:yp"10%"svg:witthp"-0%" svg:heightp"10%" /<<presentation:placeholter presentation:obiectp"subtitle"
svg:xp"20%" svg:yp"30%"
svg:witthp"-0%" svg:heightp":0%" /<</style:style<<office:automatic-styles<<office:boty<<traw:page office:namep"Page 1"
traw:style-namep"gg3:3:"
traw:master-page-namep"home"presentation:page-layout-namep"titeltia"<<traw:rect .../<<presentation:notes<<traw:text ...<this is a note</traw:text<</presentation:notes<</traw:page<<office:boty<

5c4 Drating hapes
5c4c0

eitangae

The <traw:rect< eaement represents a reitangSaar drating shapec
rg i nt Ti<traw:rect<

RrT 9Tio oT<!ELEMENT traw:rect ( office:events?, (traw:glue-pointya, %traw-text; y<<!ATTLIST traw:rect %traw-position;%traw-sive;%traw-style-name;%traw-transform;%traw-ent-position;%table-backgrount;%traw-layer;%traw-v-intex;%traw-it;%text-anchor;%traw-layer;<

The attribStes that yoS ian assoiiate tith the <traw:rect< eaement are:●

Positions ikes tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Te.t anihor●

Tabae baikgroSnd
Chapter 5 Graphic Content

331

●
●

Drat end position
oSnd iorners

oSnd Corners
This attribSte speiiiies the radiSs oi the iiriae Ssed to roSnd oii the iorners oi the reitangaec
rg i nt Ti

traw:corner-ratius

RrT 9Tio oT<!ATTLIST traw:rect traw:corner-ratius %nonNegativeLength;tIMPLIEt<

E 4 oT TiR o 41.rT4IitI4Au1.i9r4o<traw:rect svg:xp"2cm" svg:yp"3cm" svg:witthp"10cm" svg:heightp"20cm" svg:
transformp"rotate(:4y" traw:style-namep"obiect-with-shatow"<

5c4c LineThe <traw:line< eaement represents a ainec
rg i nt Ti<traw:line<

RrT 9Tio oT<!ELEMENT traw:line ( office:events?, (traw:glue-pointya, %traw-text; y<<!ATTLIST traw:line
svg:x1%coortinate; tIMPLIEt
svg:y1%coortinate; tIMPLIEt
svg:x2%coortinate; tIMPLIEt
svg:y2%coortinate; tIMPLIEt%traw-style-name;%traw-transform;%traw-ent-position;%table-backgrount;%traw-layer;%traw-v-intex;%text-anchor;%traw-it;

The attribStes that yoS ian assoiiate tith the <traw:line< eaement are:●332

tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Te.t anihor●

Tabae baikgroSnd●

Drat end position●

tart point●

End point

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

tart Point
The start point attribStes speiiiy the start ioordinates oi the ainec
rg i nt Ti

svg:x1
svg:y1RrT 9Tiee aboreco oT

End Point
The end point attribStes speiiiy the end ioordinates oi the ainec
rg i nt Ti

svg:x2
svg:y2RrT 9Tiee aboreco oT

5c4c4 Poayaine
The <traw:polyline< eaement represents a poayaine drating shapec
rg i nt Ti<traw:polyline<

RrT 9Tio oT<!ELEMENT traw:polyline ( office:events?, (traw:glue-pointy
a, %traw-text; y<<!ATTLIST traw:polyline %traw-position;%traw-sive;%traw-viewbox;%traw-style-name;%traw-transform;%traw-layer%traw-v-intex%traw-ent-position;%table-backgrount;%text-anchor;%traw-it<oT
1 4 un1
Tu u 4 un1T

The OpenOiiiiecorg drating iore iSrrentay ignores the sike attribStes bSt trites oSt a iorreit
onec The sike oi a shape is determined e.iaSsireay irom the shape data iicec poaygon rertiiesoc

The attribStes that yoS ian assoiiate tith the <traw:polyline< eaement are:●

Positions ikes VietBo.s tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Te.t anihor●

Tabae baikgroSnd●

Drat end position●

Points

Chapter 5 Graphic Content

333Points
The svg:points attribSte stores a seqSenie oi pointss thiih are ionneited by straight ainesc Eaih point
ionsists oi tto ioordinatesc The ioordinates are separated by a iomma and the points are separated by thitespaiescrg i nt Ti

svg:points

RrT 9Tio oT<!ATTLIST traw:polyline svg:points %points; teEt|IeEt<

5c4c9 Poaygon
The <traw:polygon< eaement represents a poaygonc
rg i nt Ti

poaygon is a iaosed set oi straight ainesc<traw:polygon<

RrT 9Tio oT<!ELEMENT traw:polygon ( office:events?, (traw:glue-pointya,%traw-text; y<<!ATTLIST traw:polygon %traw-position;%traw-sive;%traw-viewbox;
svg:points %Points; teEt|IeEt%traw-style-name;%traw-transform;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<oT
1 4 un1
Tu u 4 un1T

The OpenOiiiiecorg drating iore iSrrentay ignores the sike attribStes bSt trites oSt a iorreit
onec The sike oi a shape is determined e.iaSsireay irom the shape data iicec poaygon rertiiesoc

The attribStes that yoS ian assoiiate tith the <traw:polygon< eaement are:●

Positions ikes VietBo.s tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Te.t anihor●

Tabae baikgroSnd●

Drat end position●

Points l see eition 5c4c4

5c4c5 Path
The <traw:path< eaement represents a pathc
Ssing mSatipae drating aitions sSih as:334●

moceto < set a net iSrrent point●

lineto < drat a straight aine

OpenOffice.org XML File Format Working Draft

path is a shape tith a Sser-deiined oStainec The shape is bSiat

Technical Reference Manual Version 2

December 2ee2

●cueceto < drat a iSrre Ssing a iSbii bekier●

aec l drat an eaaiptiiaa or iiriSaar ari●

closepati < iaose the iSrrent shape by drating a aine to the aast moceto

CompoSnd paths are paths tith sSbpathss eaih sSbpath ionsisting oi a singae moceto ioaaoted by one or moreaine or iSrre operationsc CompoSnd paths ian be Ssed ior eiieits sSih as hoaes in objeitsc
rg i nt Ti<traw:path<

RrT 9Tio oT<!ELEMENT traw:path ( office:events?, (traw:glue-pointya, %traw-text; y<<!ATTLIST traw:path %traw-position;%traw-sive;%traw-viewbox;%traw-style-name;%traw-transform;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<oT
1 4 un1
Tu u 4 un1T

The OpenOiiiiecorg drating iore iSrrentay ignores the sike attribStes bSt trites oSt a iorreit
onec The sike oi a shape is determined e.iaSsireay irom the shape data iicec poaygon rertiiesoc

The attribStes that yoS ian assoiiate tith the <traw:path< eaement are:●

Positions ikes VietBo.s tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09c●

Te.t anihor●

Tabae baikgroSnd●

Drat end position●

Path data

Path Data
The synta. ior this attribSte is doiSmented in Chapter r oi the Tcalable xectoe heapiics bTxh W.d Tpecification
Thh Toetinm oeaft. ee the Preiaie ior a pointer to this doiSmentc
rg i nt Ti

svg:t

RrT 9Tio oT<!ATTLIST svg:path t %Pathtata; teEt|IeEt<oT
1 4 un1
Tu u 4 un1T

The iSrrent OpenOiiiiecorg drating iore onay sSpports path shapes thiih hare either open or
iaosed iSrresc mi. oi open and iaosed iSrres ior one shape is not sSpportedc The eaaiptiiaa
ari iommand is aaso not sSpported yetc

5c4c6 Ciriae
The <traw:circle< eaement represents a iiriSaar drating shapec
Chapter 5 Graphic Content

335

rg i nt Ti<traw:circle<

RrT 9Tio oT<!ELEMENT traw:circle ( office:events?, (traw:glue-pointya,%traw-text; y<<!ATTLIST traw:circle svg:cx %coortinate; tIMPLIEt
svg:cy %coortinate; tIMPLIEt
svg:r %length; tIMPLIEt%traw-style-name;%traw-transform;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<

The attribStes that yoS ian assoiiate tith the <traw:circle< eaement are:●tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Te.t anihor●

Tabae baikgroSnd●

Drat end position●

Center point

●
●

adiSs
2ind

●

tart angae●

End angae

Center Point
The ienter point attribStes speiiiy the ioordinates oi the ienter point oi the iiriaec
rg i nt Ti

svg:cxsvg:cyRrT 9Tio oT<!ATTLIST traw:circle svg:cx %coortinate; tIMPLIEt
svg:cy %coortinate; tIMPLIEt<

adiSs
The radiSs attribSte speiiiies the radiSs oi the iiriaec
rg i nt Ti

svg:r

RrT 9Ti
o oT

336<!ATTLIST traw:circle svg:r %length; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

2ind
The traw:kint attribSte speiiiies the appearanie oi the iiriaec
rg i nt Ti

traw:kint

RrT 9Tio oT<!ATTLIST traw:circle traw:kint (full|section|cut|arcy"full"<

tart ngae
For iiriaes there the traw:kint attribSte raaSe is sections cut or arcs the traw:start-angle
attribSte speiiiies the start angae oi the seitions iSts or aricrg i nt Ti

svg:start-angle

RrT 9Tio oT<!ATTLIST traw:circle traw:start-angle %nonNegativeInteger;tIMPLIEt<

End ngae
For iiriaes there the traw:kint attribSte raaSe is sections cut or arcs the traw:ent-angle attribSte
speiiiies the end angae oi the seitions iSts or aricrg i nt Ti

svg:ent-angle

RrT 9Tio oT<!ATTLIST traw:circle traw:ent-angle %nonNegativeInteger;tIMPLIEt<

5c4cm Eaaipse
The <traw:ellipse< eaement represents an eaaipsec
rg i nt Ti<traw:ellipse<

RrT 9Tio oT<!ELEMENT traw:ellipse ( office:events?, (traw:glue-pointya,%traw-text; y<<!ATTLIST traw:ellipse svg:cx %coortinate; tIMPLIEt
svg:cy %coortinate; tIMPLIEt
svg:rx %length; tIMPLIEt
svg:ry %length; tIMPLIEt%traw-style-name;%traw-transform;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<
Chapter 5 Graphic Content

337

The attribStes that yoS ian assoiiate tith the <traw:ellipse< eaement are:●tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Center points 2inds tart angaes End angaes adiSs l see eition 5c4c6●

Te.t anihor●

Tabae baikgroSnd●

Drat end position

5c4cr Conneitor
The <traw:connector< eaement represents a series oi aines that ionneit to gaSe points on tto other shapesc
rg i nt Ti<traw:connector<

RrT 9Tio oT<!ELEMENT traw:connector ( office:events?, (traw:glue-pointy
a, %traw-text; y<<!ATTLIST traw:connector%traw-style-name;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<

The attribStes that yoS ian assoiiate tith the <traw:connector< eaement are:●●tyaes Layers 1- nde. and D l see eition 5c4c09
Type●tart position●

tart shape●tart gaSe point●

End position●

End shape●

End gaSe point●

Line shot●

Te.t anihor●

Tabae baikgroSnd●

Drat end position

Type
The traw:type attribSte speiiiies hot the ionneition betteen tto points is renderedc
338

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

traw:typeRrT 9Ti

The raaSe oi this attribSte ian be stantarts liness lines or curvec

o oT<!ATTLIST traw:connector
traw:type (stantart|lines|line|curvey "stantart"<

tart Position
The start position attribStes speiiiy the start position oi a ionneitorc
rg i nt Ti

svg:x1
svg:y1RrT 9Ti

i the start position is ionneited to a shapes these attribStes are optionaa beiaSse the start posi tion deiaSats to the iorresponding gaSe point on the target shapec

o oT<!ATTLIST traw:connector
svg:x1 %coortinate; tIMPLIEt
svg:y1 %coortinate; tIMPLIEt<

tart hape
The traw:start-shape attribSte identiiies the drating shape to thiih the start oi this ionneitor isionneitedc
rg i nt Ti

traw:start-shapeRrT 9Ti

i a shape is ionneited to the start oi a ionneitors the start position deiaSats to the iorre sponding gaSe point on the target shapec

o oT<!ATTLIST traw:connector
traw:start-shape %shapeIt; tIMPLIEt<

tart GaSe Point
The traw:start-glue-point attribSte identiiies the gaSe point in the start shape oi the ionneitorc
rg i nt Ti

traw:start-glue-pointRrT 9Ti

i this attribSte is not set and the start oi the ionneitor is ionneited to a shapes the appaiiationihooses the gaSe pointc i the start oi the ionneitor is not ionneited to a shapes this attribSte isignoredc

o oT<!ATTLIST traw:connector
traw:start-glue-point %integer; tIMPLIEt<

End Position
The end position attribStes speiiiy the end position oi a ionneitorc

Chapter 5 Graphic Content

339

rg i nt Ti

svg:x2
svg:y2RrT 9Ti

i the end position is ionneited to a shapes these attribStes are optionaa beiaSse the end posi tion deiaSats to the iorresponding gaSe point on the target shapec

o oT<!ATTLIST traw:connector
svg:x2 %coortinate; tIMPLIEt
svg:y2 %coortinate; tIMPLIEt<

End hape
The traw:ent-shape attribSte identiiies the drating shape to thiih the end oi the ionneitor is ionneitedc
rg i nt Ti

traw:ent-shapeRrT 9Ti

i a shape is ionneited to the end oi a ionneitors the end position deiaSats to the iorresponding
gaSe point on the target shapec

o oT<!ATTLIST traw:connector
traw:ent-shape %shapeIt; tIMPLIEt<

End GaSe Point
The traw:ent-glue-point attribSte identiiies the gaSe point in the end shape oi the ionneitorc
rg i nt Ti

traw:ent-glue-pointRrT 9Ti

i this attribSte is not set and the end oi the ionneitor is ionneited to a shapes the appaiiationihooses the gaSe pointc i the end oi the ionneitor is not ionneited to a shapes this attribSte isignoredc

o oT<!ATTLIST traw:connector
traw:ent-glue-point %integer; tIMPLIEt<

Line ket
The traw:line-skew attribSte iontroas the generation oi the aines that ionneit the start and end pointsc
Depending on the type oi ionneitors this ian rary irom one to three distanies that more the ionneitor aines reaatire to their normaa positionc
rg i nt Ti

traw:line-skew

RrT 9Tio oT<!ATTLIST traw:connector
traw:line-skew CtATA tIMPLIEt<

5c4c Caption
The <traw:caption< eaement represents a reitangSaar drating shape tith an additionaa set oi ainesc t ian be
Ssed as a desiription ior a ii.ed point inside a dratingc

340

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<traw:caption<

RrT 9Tio oT<!ELEMENT traw:caption ( office:events?, (traw:glue-pointya,%traw-text; y<<!ATTLIST traw:caption%traw-position;%traw-sive;%traw-style-name;%traw-transform;%traw-layer;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<

The attribStes that yoS ian assoiiate tith the <traw:caption< eaement are:●

Positions ikes tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

Caption point●

oSnd iorners●

Te.t anihor●

Tabae baikgroSnd●

Drat end position

Caption Point
The iaption point attribStes speiiiy the position oi the point that is iaptionedc
iaption areac
rg i nt Ti

set oi aines are rendered irom the

traw:caption-point-x
traw:caption-point-y

RrT 9Tio oT<!ATTLIST traw:caption
traw:caption-point-x %coortinate; tIMPLIEt
traw:caption-point-y %coortinate; tIMPLIEt <oSnd Corners
The traw:corner-ratius attribSte speiiiies the radiSs oi the iiriae Ssed to roSnd oii the iorners oi theiaptionc
rg i nt Ti

traw:corner-ratius

RrT 9Tio oT<!ATTLIST traw:caption traw:corner-ratius %length; tIMPLIEt<

Chapter 5 Graphic Content

341

5c4c02

easSreThe <traw:measure< eaement represents a shape that is Ssed to measSre distanies in dratingsc
rg i nt Ti<traw:measure<RrT 9Tio oT<!ELEMENT traw:measure ( office:events?, (traw:glue-pointya,%traw-text; y<<!ATTLIST traw:measure%traw-style-name;%traw-transform;%traw-ent-position;%table-backgrount;%text-anchor;%traw-layer;%traw-v-intex;%traw-it;<

The attribStes that yoS ian assoiiate tith the <traw:measure< eaement are:●tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09●

tart position●

End position●

Te.t anihor●

Tabae baikgroSnd●●

tart position
Drat end position

tart Position
These attribStes speiiiy the start point oi the measSred distaniec
rg i nt Ti

svg:x1
svg:y1RrT 9Tio oT<!ATTLIST traw:measure svg:x1 %coortinate; teEt|IeEt<<!ATTLIST traw:measure svg:y1 %coortinate; teEt|IeEt<

Drat End Position
These attribStes speiiiy the end point oi the measSred distaniec
rg i nt Ti

svg:x2
svg:y2RrT 9Ti
o oT

342<!ATTLIST traw:measure svg:x2 %coortinate; teEt|IeEt<<!ATTLIST traw:measure svg:y2 %coortinate; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5c4c00 Controa
The <traw:control< eaement represents a shape that is ainked to a iontroa inside an <office:forms<
eaementc
rg i nt Ti<traw:control<RrT 9Tio oT<!ELEMENT traw:control EMPTY<<!ATTLIST traw:control%traw-position;%traw-sive;%traw-style-name;%traw-layer;%control-it;%traw-v-intex;%traw-ent-position;%table-backgrount;%text-anchor;%traw-it;<

The attribStes that yoS ian assoiiate tith the <traw:control< eaement are:•

Positions ikes tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09c•

Controa Ds see the doiSmentation ior iormsc●

Te.t anihor●

Tabae baikgroSnd●

Drat end position

5c4c0 Page ThSmbnaia
The <traw:page-thumbnail< eaement represents a reitangSaar area that dispaays the thSmbnaia oi adrating pagec
rg i nt Ti<traw:page-thumbnail<RrT 9Tio oT<!ELEMENT traw:page-thumbnail EMPTY<<!ATTLIST traw:page-thumbnail%traw-position;%traw-sive;%presentation-class;%traw-ent-position;%table-backgrount;%text-anchor;%traw-layer;%traw-v-intex;%traw-it<

The attribStes that yoS ian assoiiate tith the <traw:page-thumbnail< eaement are:•

Positions ikes tyaes Layers 1- nde.s Ds and Transiormation l see eition 5c4c09c•

Presentation iaass l see eition 5c9c0

Chapter 5 Graphic Content

343

•

Controa Ds see the doiSmentation ior iormsc●

Te.t anihor●

Tabae baikgroSnd●

Page nSmber

Page NSmber
The traw:page-number attribSte speiiiies the nSmber oi the page that is dispaayed as a thSmbnaiac
rg i nt Ti

traw:page-number

RrT 9Ti

For thSmbnaias on notes pagess the raaSe oi this attribSte is ii.ed to the drating page oi thenotes pagec
For thimbnaias on handoSt master pagess the raaSe oi this attribSte is reaatire and speiiiiesin thiih order the pages are prerieted on the handoStc

o oT<!ATTLIST traw:page-thumbnail traw:page-number %positiveInteger; tIMPLIEt<

5c4c04 GroSping
The <traw:g< eaement represents a groSp oi drating shapesc
rg i nt Ti<traw:g<RrT 9Tio oT<!ELEMENT traw:g ( office:events?, (%shapes;ya y <<!ATTLIST traw:g%traw-v-intex%traw-it<

5c4c09 Common Drating hape ttribStes
The attribStes desiribed in this seition are iommon to aaa drating shapesc

Position
The position attribStes speiiiy the x and y ioordinates oi the start postion oi the drating shapec
rg i nt Ti

svg:x and svg:yRrT 9Ti
o oT

344<!ENTITY % Coortinate "CtATA"<<!ENTITY % traw-position "svg:x %coortinate; tIMPLIEt
svg:y %coortinate; tIMPLIEt"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

ike
The sike attribStes speiiiy the tidth and height oi the drating shapec
rg i nt Ti

svg:witth and svg:heightRrT 9Ti
o oT<!ENTITY % traw-sive "svg:witth %coortinate; tIMPLIEt
svg:height %coortinate; tIMPLIEt<

End Position
YoS onay need to speiiiy the end position oi a shape then the shape is iniaSded in a spreadsheet doiSment andthe anihor oi the shape is in a ieaac YoS speiiiy the end position Ssing the ieaa address oi the ieaa in thiih the end
position is aoiateds and the x and y ioordinates oi the end position reaatire to the top aeit edge oi the ieaac
rg i nt Ti

table:ent-cell-attresstable:ent-x
table:ent-y

RrT 9Ti
o oT<!ENTITY % traw-ent-position"table:ent-cell-attress %Cell-Attress; tIMPLIEt
table:ent-x %coortinate; tIMPLIEt
table:ent-y %coortinate; tIMPLIEt"<

Tabae BaikgroSnd
The table:table-backgrount attribSte speiiiies thether or not the shape is in the tabae baikgroSnd thena shape is iniaSded in a spreadsheet doiSmentc i the styae does not iontain this attribSte the shape is not iniaSded
in the baikgroSnd oi the tabaec
rg i nt Ti

table:table-backgrountRrT 9Ti
o oT<!ENTITY % table-backgrount"table:table-backgrount (true | false y tIMPLIEt"<

Transiormation
The traw:transform attribSte speiiiies a aist oi transiormations that ian be appaied to a drating shapec

Chapter 5 Graphic Content

345

rg i nt Ti

traw:transform

RrT 9Ti

The raaSe oi this attribSte is a aist oi transiorm deiinitionss thiih are appaied to the drating
shape in the order in thiih they are aistedc The transiorm deiinitions in the aist mSst be sepa rated by a thite spaie andsor a iommac The types oi transiorm deiinitions araiaabae iniaSde:

o oT

●

matrix(<a< <b< <c< <t< <e< <f<ys thiih speiiiies a transiormation in the iormoi a transiormation matri. oi si. raaSesc matrix(a,b,c,t,e,fy is the eqSiraaent oi
appaying the transiormation matri. [a b c t e f]c●translate(<tx< [<ty<]ys thiih speiiiies a transaation by tx and tyc●

scale(<sx< [<sy<]ys thiih speiiiies a siaae operation by sx and syc i <sy< is not
prorideds it is assSmed to be eqSaa to <sx<c●rotate(<rotate-angle<ys thiih speiiiies a rotation by <rotate-angle< aboSt
the origin oi the shapes ioordinate systemc●

skewX(<skew-angle<ys thiih speiiiies a sket transiormation aaong the X a.isc●

skewY(<skew-angle<ys thiih speiiiies a sket transiormation aaong the Y a.isc<!ENTITY % transform-list; CtATA<<!ENTITY % traw-transform "traw:transform %TransformList;
tIMPLIEt"<

VietBo.
The svg:viewbox attribSte estabaishes a Sser ioordinate system inside the physiiaa ioordinate system oi theshape speiiiied by the position and sike attribStesc This Sser ioordinate system is Ssed by the svg:points
attribSte and the <svg:path< eaementc
rg i nt Ti

svg:viewbox

RrT 9Ti

The synta. ior Ssing this attribSte is the same as the VG synta.c The raaSe oi the attribSte
is ioSr nSmbers seperated by thite spaiess thiih deiine the aeits tops rights and bottom
dimensions oi the Sser ioordinate systemc

o oT<!ENTITY %traw-viewbox "svg:viewbox CtATA teEt|IeEt"<oT
1 4 un1
Tu u 4 un1T

The OpenOiiiiecorg drating iore iSrrentay ignores the rietbo. attribStes bSt trites oSt aiorreit onec The impaied ioordinate system has its origin at the aeits top iorner oi the shapes
tithoSt any siaaing reaatire to the shapec

tyae
The traw:style-name attribSte speiiiies a styae ior the drating shapec The attribStes oi the speiiiied styae
and its optionaa parent styaes are Ssed to iormat the shapec346

rg i nt Ti

traw:style-name

RrT 9Ti

The raaSe oi this attribSte ian be a <style:style< eaement tith a styae iamiay raaSe oi
graphic.

o oT<!ENTITY % traw-style-name "traw:style-name %styleName;
teEt|IeEt"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

LayerEaih shape ian be assigned to a aayerc The traw:layer attribSte speiiiies the aayer to thiih a shape isassignedc
rg i nt Ti

traw:layer

RrT 9Ti

The raaSe oi this attribSte mSst be the name oi a aayer inside the aayer-set oi the doiSmentc

o oT<!ENTITY % traw-layer "traw:layer %layerName; tIMPLIEt"<

D
YoS ian Sse the traw:it attribSte to assign a SniqSe D to eaih drating shape that is iontained in a doiSmentc
YoS ian reierenie the drating shape Ssing the SniqSe Dc The raaSe oi the attribSte is onay e.ported ii the shapeis reiereniedc
rg i nt Ti

traw:itRrT 9Ti

This attribSte is optionaac

o oT<!ENTITY % traw-it "traw:it %shapeIt; tIMPLIEt"<

1- nde.
Drating shapes are rendered in a speiiiii orderc n generaas the shapes are rendered in the order in thiih they
appear in the X L doiSmentc To ihange the orders Sse the traw:v-intex attribStec
rg i nt Ti

traw:v-intex

RrT 9Ti

This attribSte is optionaac

o oT<!ENTITY % traw-v-intex"traw:v-intex %nonNegativeInteger;tIMPLIEt"<

5c9 Presentation hapes
Presentation shapes are speiiaa shapes iontained in a presentationc Presentation shapes Sse styaes tith a styae
iamiay raaSe oi presentations Snaike drating shapes thiih Sse styaes tith a styae iamiay raaSe oigraphicc
Presentation shapes ian be emptys aiting onay as paaiehoadersc
tandard drating shapes ian aaso be Ssed in presentationsc The presentation:class attribSte distingSishespresentation shapes irom drating shapesc

5c9c0 Common Presentation hape ttribStes
The attribStes desiribed in this seition are iommon to aaa presentation shapesc

tyae
Presentation shapes ian hare styaes irom the styae iamiay presentation assigned to themc YoS ian distingSish
a presentation shape irom a drating shape by iheiking the styae attribSte Ssedc drating shape Sses a traw:
Chapter 5 Graphic Content347style-name attribSte tith a styae irom the graphics iamiays thiae a presentation shape Sses a presentation:style-name attribSte tith a styae irom the presentation iamiayc This name ainks to a <style:style< eaement tith the iamiay presentationc The attribStes in this styae and its optionaa parent styaes are
Ssed to iormat this shapec
rg i nt T

presentation:style-name

RrT 9To oT<!ENTITY % presentation-style-name "presentation:style-name %styleName; tIMPLIEt"<

Caass
The presentation:class attribSte speiiiies the iaass to thiih the presentation beaongsc The presentation:placeholter attribSte deiines ii this is a paaiehoader or a presentation objeit tith aitSaa iontentc The
presentation:user-transformet attribSte speiiiies thether the sike and position oi the shape is set by
the Sser or is set by the iorresponding presentation shape on the master pagec
rg - nt T

presentation:classpresentation:placeholter
presentation:user-transformet

RrT 9To oT<!ENTITY % presentation-classes "(title|outline|subtitle|
text|graphic|obiect|chart|table|orgchart|page|notesy" <<!ENTITY % presentation-class "presentation:class %presentation-classes; tIMPLIEt presentation:placeholter(true|falsey tIMPLIEt presentation:user-transformet (true|
falsey tIMPLIEt"<

5c9c Titae
Titaes are standard te.t shapes c The iaass name ior this presentation shape is presentation-titlec

5c9c4 OStaine
OStaines are standard te.t shapesc The iaass name ior this presentation shape is presentation-outlinec

5c9c9 Sbtitae
Sbtitaes are standard te.t shapesc The iaass name ior this presentation shape is presentation-subtitlec

5c9c5 Te.t
Presentation te.ts are standard te.t shapesc The iaass name ior this presentation shape is presentationtextc

348

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5c9c6 Graphii
Presentation graphiis are standard graphii shapes c The iaass name ior this presentation shape is presentation-textc

5c9cm Objeit
Presentation objeits are standard OLE shapesc The iaass name ior this presentation shape is presentationobiectc

5c9cr Chart
Presentation iharts are standard OLE shapesc The iaass name ior this presentation shape is presentationchartc

5c9c Tabae
Presentation tabaes are standard OLE shapesc The iaass name ior this presentation shape is presentationtablec

5c9c02 Orgiharts
Presentation organikation iharts are standard OLE shapesc The iaass name ior this presentation shape is presentation-orgchart.
n T CSrrentays orgiharts are not impaemented in OpenOiiiiecorgi

5c9c00 Pages
Presentation pages are Ssed on notes pagesc The iaass name ior this presentation shape is pagec

5c9c0 Notes
Presentation notes are Ssed on notes pagesc The iaass name ior this presentation shape is notesc

5c5 4D hapes
5c5c0 iene
The <tr3t:scene< eaement is the onay eaement that ian iontain three-dimensionaa shapesc siene is aike a
groSps bSt it aaso deiines the projeitions aightings and other render detaias ior the shapes inside the sienec

Chapter 5 Graphic Content

349

rg i nt Ti<tr3t:scene<

RrT 9Ti
o oT<!ENTITY % shapes3t "(tr3t:scene|tr3t:extrute|tr3t:sphere|
tr3t:rotate|tr3t:cubey"<<!ELEMENT tr3t:scene (tr3t:lighta,(%shapes3t;yay<<!ATTLIST tr3t:scene%traw-position;%traw-sive;%tr3t-transform;%traw-style-name;%traw-layer;%traw-v-intex;%traw-it;%traw-layer;<

The attribStes that yoS ian assoiiate tith the <tr3t:scene< eaement are:●tyaes Layers 1- nde.s and D l see eition 5c4c09●

Camera reitors●

Projeition●

Distanie●

Foiaa aength●

hadot saant●hade mode●mbient ioaor●

Lighting mode

Camera Veitors
The iamera reitors deiine a rieting roaSmec The tr3t:vrp attribSte speiiiies the origins the tr3t:vpn
attribSte points totards the projeited objeitss and the tr3t:vup attribSte deiines the Sp reitorc
rg i nt Ti

tr3t:vrp
tr3t:vpn
tr3t:vup

RrT 9Tio oT<!ATTLIST tr3t:scene tr3t:vrp %vector3t; tIMPLIEt<<!ATTLIST tr3t:scene tr3t:vpn %vector3t; tIMPLIEt<<!ATTLIST tr3t:scene tr3t:vup %vector3t; tIMPLIEt<

Projeition
The tr3t:proiection attribSte speiiiies the projeitionc The projeition ian be perspeitire or paraaaeac nperspeitire modes objeits beiome smaaaer in the distaniec

350

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

tr3t:proiection

RrT 9Ti<!ATTLIST tr3t:scene
tr3t:proiection (parallel|perspectivedrtIMPLIEt<o oTDistanie
The tr3t:tistance attribSte speiiiies the distanie betteen the iamera and the objeitc
rg i nt Ti

tr3t:tistanceRrT 9Ti<!ATTLIST tr3t:scene tr3t:tistance %length; tIMPLIEt<

o oT

Foiaa Length
The tr3t:focal-length attribSte speiiiies the aength oi the ioiSs ior the rirtSaa iamera oi this sienec
rg i nt Ti

tr3t:focal-length

RrT 9Ti<!ATTLIST tr3t:scene tr3t:focal-length %length; tIMPLIEt<o oT

hadot aantrg i nt Ti

tr3t:shatow-slant

RrT 9Ti<!ATTLIST tr3t:scene tr3t:shatow-slant %nonNegativeInteger;tIMPLIEt<

o oT

hade

ode

rg i nt Ti

tr3t:shatow-moteRrT 9Tio oT<!ATTLIST tr3t:scene
tr3t:shate-mote (flat|phong|gouraut|trafty tIMPLIEt<

mbient Coaor

Chapter 5 Graphic Content

351

rg i nt Ti

tr3t:ambient-color

RrT 9Ti<!ATTLIST tr3t:scene tr3t:ambient-color %color; tIMPLIEt<

o oTLightingode

rg i nt Ti

tr3t:lighting-moteRrT 9Tio oT<!ATTLIST tr3t:scene tr3t:lighting-mote %boolean; tIMPLIEt<

5c5c Light
The <tr3t:light< eaement represents a aight inside a sienec
rg i nt Ti<tr3t:light<

RrT 9Ti

This eaement mSst be the iirst eaement iontained in a <tr2t:scene< eaementc The
OpenOiiiiecorg soittare iSrrentay sSpports Sp to r aights per sienec

o oT<!ELEMENT tr3t:light EMPTY<<!ATTLIST tr3t:light
tr3t:tiffuse-color %color; tIMPLIEt
tr3t:tirection %vector3t; teEt|IeEt
tr3t:enablet %boolean; tIMPLIEt
tr3t:specular %boolean; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <tr3t:light< eaement are:●DiiiSse ioaor●

Direition●

Enabaed●peiSaarDiiiSse Coaor
The tr3t:tiffuse-color attribSte speiiiies the base ioaor that the aight is emittingc
rg i nt Ti

tr3t:tiffuse-color

RrT 9Tio oT<!ATTLIST tr3t:light tr3t:tiffuse-color %color; tIMPLIEt<

Direition
The tr3t:tirection attribSte speiiiies the direition in thiih the aight is emittedc

352

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

tr3t:tirection

RrT 9Tio oT<!ATTLIST tr3t:light tr3t:tirection %vector3t; teEt|IeEt<

Enabaed
The tr3t:enablet attribSte speiiiies thether or not the aight is enabaedc i a aight is not enabaeds it does notemit any aightc
rg i nt Ti

tr3t:enablet

RrT 9Tio oT<!ATTLIST tr3t:light tr3t:enablet %boolean; tIMPLIEt<

peiSaar
The tr3t:specular attribSte speiiiies thether or not thes aight iaSses a speiSaar reiaeition on the objeitsc
rg i nt Ti

tr3t:specular

RrT 9Ti

CSrrentays this attribSte ian onay be appaied to the iirst aight in a sienec

o oT<!ATTLIST tr3t:light tr3t:specular %boolean; tIMPLIEt<

5c5c4 CSbe
The <tr3t:cube< eaement represents a three-dimensionaa iSbe shapec
rg i nt Ti<tr3t:cube<

RrT 9Tio oT<!ELEMENT tr3t:cube EMPTY<<!ATTLIST tr3t:cube
tr3t:min-etge %vector3t; tIMPLIEt
tr3t:max-etge %vector3t; tIMPLIEt%tr3t-transform;%traw-style-name;%traw-layer;%traw-v-intex;%traw-it;%traw-layer;<

The attribStes that yoS ian assoiiate tith the <tr3t:cube< eaement are:●●●tyaes Layers 1- nde. and D l see eition 5c4c09
Projeitions Distanies Foiaa aengths hadot saants hade modes mbient ioaors Lighting mode l see eition
5c5c0
inimSm anda.imSm Edge

Chapter 5 Graphic Content

353

inimSm anda.imSm Edge

These attribStes speiiiy the minimSm and ma.imSm edge oi the iSbe in a 4D spaiec
rg i nt Ti

tr3t:min-etge
tr3t:max-etge

RrT 9Tio oT<!ATTLIST tr3t:cube
tr3t:min-etge %vector3t; tIMPLIEt
tr3t:max-etge %vector3t; tIMPLIEt<

5c5c9 phere
The <tr3t:sphere< eaement represents a three-dimensionaa sphere shapec
rg i nt Ti<tr3t:sphere<

RrT 9Tio oT<!ELEMENT tr3t:sphere EMPTY<<!ATTLIST tr3t:spheretr3t:center %vector3t; tIMPLIEt
tr3t:sive %vector3t; tIMPLIEt%tr3t-transform;%traw-style-name;%traw-layer;%traw-v-intex;%traw-it;%traw-layer;<

The attribStes that yoS ian assoiiate tith the <tr3t:sphere< eaement are:●tyaes Layers 1- nde.s and D l see eition 5c4c09●

Projeitions Distanies Foiaa aengths hadot saants hade modes mbient ioaors Lighting mode l see eition
5c5c0

●

Center●ike

Center
The tr3t:center attribSte deiines the ienter oi the sphere in a three-dimensionaa spaiec
rg i nt Ti

tr3t:center

RrT 9Tio oT<!ATTLIST tr3t:spheretr3t:center %vector3t; tIMPLIEt<

ike
The tr3t:sive attribSte deiines the sike oi the sphere in a three-dimensionaa spaiec
354

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

tr3t:siveRrT 9Ti<!ATTLIST tr3t:spheretr3t:sive %vector3t; tIMPLIEt<

o oT

5c5c5 E.trSde
The <tr3t:extrute< eaement represents a three-dimensionaa e.trSde based on a poaygonc
rg i nt Ti<tr3t:extrute<

RrT 9Ti<!ELEMENT tr3t:extrute EMPTY<<!ATTLIST tr3t:extrute
svg:t %pathtata; teEt|IeEt%traw-viewbox;%tr3t-transform;%traw-style-name;%traw-layer;%traw-v-intex;%traw-it;%traw-layer;<o oTThe attribStes that yoS ian assoiiate tith the <tr3t:extrute< eaement are:●Vietbo.s tyaes Layers 1- nde.s and D l see eition 5c4c09●

Projeitions Distanies Foiaa aengths hadot saants hade modes mbient ioaors Lighting mode l see eition
5c5c0c●Path Data l see eition 5c4c5

5c5c6

otate

The <tr3t:rotate< eaement represents a three-dimensionaa rotation shape based on a poaygonc
rg i nt Ti<tr3t:rotate<

RrT 9Tio oT<!ELEMENT tr3t:rotate EMPTY<<!ATTLIST tr3t:rotate
svg:t %pathtata; teEt|IeEt%traw-viewbox;%tr3t-transform;%traw-style-name;%traw-layer;%traw-v-intex;%traw-it;%traw-layer;<

The attribStes that yoS ian assoiiate tith the <tr3t:rotate< eaement are:●Vietbo.s tyaes Layers 1- nde.s and D l see eition 5c4c09●

Projeitions Distanies Foiaa aengths hadot saants hade modes mbient ioaors Lighting mode l see eition
Chapter 5 Graphic Content

355

5c5c0c●

Path Data l see eition 5c4c5

5c6 Graphii tyae Eaements
The eaements desiribed in this seition are aoiated in the <office:styles< seition oi a doiSment and arereiered to by a SniqSe namec The ioaaoting styaes ior iiaaing graphii objeits are araiaabae:●

Gradient

●

Oatih

●

mage

●

Transpareniy

●
●

arker
Dash

5c6c0 GradientThis eaement deiines a gradient ior iiaaing a drating objeitc
rg i nt Ti<traw:gratient<RrT 9Ti

This eaement mSst be aoiated inside the <office:styles< eaementsc

o oT<!ELEMENT traw:gratient EMPTY<

The attribStes that yoS ian assoiiate tith the gradient eaement are:
●

Name

●

Gradient styae●

Gradient ienter●

Coaors●ntensity

●

ngae

●

BorderNameThis attribSte SniqSeay identiiies a gradient inside an <office:styles< eaementc
rg i nt Ti

traw:nameRrT 9Ti
o oT

356<!ATTLIST traw:gratient traw:name %styleName; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Gradient tyaeThis attribSte speiiiies the styae oi the gradientc
rg i nt Ti

traw:style

RrT 9Ti

The gradient styaes that OpenOiiiiecorg iSrrentay sSpports are linears axials ratials
ellipsoits squares and rectangularc

o oT<!ENTITY % gratient-style "(linear|axial|ratial|ellipsoit|
square|rectangulary"<<!ATTLIST traw:gratient traw:style %gratient-style;teEt|IeEt<

Gradient Centeri the gradient styae is ratials ellipsoits squares or rectangulars the gradient ienter attribSte speiiiies the ienter oi the geometry that is Ssed ior the gradientc
rg i nt Ti

traw:cx and traw:cy

RrT 9Ti

The raaSes oi these attribStes are aatays perientage raaSesc

o oT<!ATTLIST traw:gratient traw:cx %coortinate; tIMPLIEt
traw:cy %coortinate; tIMPLIEt<

CoaorsThe gradient interpoaates betteen a start ioaor and an end ioaors thiih are speiiiied Ssing the ioaaoting attribStescrg i nt Ti

traw:start-color and traw:ent-color

RrT 9Tio oT<!ATTLIST traw:gratient traw:start-color %color; teEt|IeEt<<!ATTLIST traw:gratient traw:ent-color %color; teEt|IeEt<

ntensity
The intensity attribStes aaaot yoS to Sse base ioaors ior interpoaation and to modiiy the start and end ioaor intensity Ssing perientage raaSesc n OpenOiiiiecorgs this iSnitionaaity is onay Ssed there a iommon ioaor is Ssed ior
the Sser interiaie and it ian be modiiied Ssing a diiierent intensity raaSec
rg i nt Ti

traw:start-intensity and traw:ent-intensity

RrT 9Ti

These attribStes are optionaac i the attribStes are not speiiiieds the ioaors are Ssed as they aresthat is at 022l intensityc

o oT<!ATTLIST traw:gratient traw:start-intensity %percentage;tIMPLIEt<<!ATTLIST traw:gratient traw:ent-intensity %percentage;tIMPLIEt<

Chapter 5 Graphic Content

357

ngae
The angae attribSte speiiiies an angae that rotates the a.is at thiih the gradient raaSes are interpoaatedc
rg i nt Ti

traw:angle

RrT 9Ti

This attribSte is ignored ior radiaa styae gradientsc

o oT<!ATTLIST traw:gratient traw:angle %angle; tIMPLIEt<

BorderDepending on the styae oi the gradients the border attribSte speiiiies a perientage raaSe thiih is Ssed to siaae aborder thiih is iiaaed by the start or end ioaor onayc
rg i nt Ti

traw:borterRrT 9Tio oT<!ATTLIST traw:gratient traw:borter %percentage; tIMPLIEt<

5c6c Oatih
This eaement deiines a hatih ior iiaaing graphii objeitsc
repeated in the iiaa areac

hatih is a simpae pattern oi straight aines that is

rg i nt Ti<traw:hatch<

RrT 9Ti

These eaements mSst be aoiated inside the <office:styles< eaementsc

o oT<!ELEMENT traw:hatch EMPTY<

The attribStes that yoS ian assoiiate tith the hatih eaement are:
●

Name

●

tyae

●

Coaor

●

Distanie

●

ngae

●

BaikgroSnd

Name
This attribSte SniqSeay identiiies a hatih inside an <office:styles< eaementc
rg i nt Ti

traw:nameRrT 9Ti
o oT

358<!ATTLIST traw:hatch traw:name %styleName; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

tyae
The styae attribSte speiiiies the styae oi the hatihc
rg i nt Ti

traw:style

RrT 9Ti

The hatih ian hare one oi three styaes: singles toubles or triplec

o oT<!ATTLIST traw:hatch traw:style "(single|touble|tripley"tIMPLIEt<

Coaor
The ioaor attribSte speiiiies the ioaor oi the hatih ainesc
rg i nt Ti

traw:color

RrT 9Tio oT<!ATTLIST traw:hatch traw:color %color; tIMPLIEt<

Distanie
The distanie attribSte speiiiies the distanie betteen tto hatih ainesc
rg i nt Ti

traw:tistanceRrT 9Tio oT<!ATTLIST traw:hatch traw:tistance %length; tIMPLIEt<

ngae
The angae attribSte speiiiied the rotation angae oi the hatih ainesc
rg i nt Ti

traw:rotation

RrT 9Tio oT<!ATTLIST traw:hatch traw:rotation %angle; tIMPLIEt<

5c6c4 mageThis eaement speiiiies a aink to a bitmap resoSries ior e.ampaes a cJPG iiaec This eaement ioaaots the Xaink speiiiiiationc
rg i nt Ti<traw:fill-image<RrT 9Ti

These eaements mSst be aoiated inside the <office:styles< eaementsc

o oT<!ELEMENT traw:fill-image EMPTY<<!ATTLIST traw:fill-image xlink:href %uri; teEt|IeEt
xlink:type (simpley tIMPLIEt
xlink:show (parsety tIMPLIEt
xlink:actuate (onLoaty tIMPLIEt<

Chapter 5 Graphic Content

359

The attribStes that yoS ian assoiiate tith the iiaa image eaement are:
●

Name

●

ike

Name
This attribSte SniqSeay identiiies a iiaa image inside an <office:styles< eaementc
rg i nt Ti

traw:nameRrT 9Tio oT<!ATTLIST traw:fill-image traw:name %styleName; teEt|IeEt<

ike
These optionaa attribStes speiiiy the sike oi the ainked imagec
rg i nt Ti

svg:witth
svg:heightRrT 9Ti

These raaSes are optionaa and are orerridden by the physiiaa sike oi the ainked image resoSriec
They ian be Ssed to get the sike oi an image beiore it is aoadedc

o oT<!ATTLIST traw:fill-image svg:witth %length tIMPLIEt
svg:height %length tIMPLIEt<

5c6c9 Transpareniy Gradient
To speiiiy a transpareniy gradient ior a graphii objeits yoS ian deiine a transpareniy that torks in a simiaar
iashion to a gradients e.iept that the transpareniy is interpoaated instead oi the ioaorc
rg i nt Ti<traw:transparency<

RrT 9Ti
o oT<!ENTITY % gratient-style "(linear|axial|ratial|ellipsoit|
square|rectangulary"<<!ELEMENT traw:transparency EMPTY<<!ATTLIST traw:transparency
traw:name %styleName; teEt|IeEt
traw:style %gratient-style; teEt|IeEt
traw:cx %coortinate; tIMPLIEt
traw:cy %coortinate; tIMPLIEt
traw:gratient-angle %angle; tIMPLIEt
traw:gratient-borter %percentage; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <traw:transparency< eaement are:

360

●

Name

●

tyae

●

Transpareniy ienter●Transpareniy

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●

ngae

●

BorderNameThis attribSte is the same as the name attribSte assoiiated tith the gradient eaementc ee eition 5c6c0 ior iniormationc

tyaeThis attribSte is the same as the styae attribSte assoiiated tith the gradient eaementc ee eition 5c6c0 ior iniormationc

Transpareniy Center
This attribSte is the same as the gradient ienter attribSte assoiiated tith the gradient eaementc ee eition 5c6c0
ior iniormationc

Transpareniy
The transpareniy interpoaates betteen a start and an end raaSec
rg i nt Ti

traw:start
traw:ent

RrT 9Ti

The raaSes oi these attribStes are perientages there 2l is iSaay transparent and 022l is iSaay
opaqSeco oT<!ATTLIST traw:transparency
traw:start %percentage; tIMPLIEt
traw:ent %percentage; tIMPLIEt<

ngaeThis angae rotates the a.is at thiih the transpareniy raaSes are interpoaatedc t is the same as the angae attribSte
assoiiated tith the gradient eaementc ee eition 5c6c0 ior more iniormationc

BorderDepending on the styae oi the transpareniys the border attribSte speiiiies a perientage raaSe thiih is Ssed to siaae
a border thiih is onay the start or end transpareniy Ssedc This attribSte is the same as the border attribSte assoiiated tith the gradient eaementc ee eition 5c6c0 ior more iniormationc

5c6c5

arker

The marker eaement represents markerss thiih are Ssed to drat poaygons at the start and end points oi strokesc

Chapter 5 Graphic Content

361

rg i nt Ti<traw:marker<

RrT 9Ti

These eaements mSst be aoiated inside the <office:styles< eaementsc

o oT<!ELEMENT traw:marker svg:patha<<!ATTLIST traw:marker
traw:name %styleName; tIMPLIEt%traw-viewbox;
svg:t %Pathtata; teEt|IeEt<oT
1 4 un1
Tu u 4 un1T

CSrrentays markers onay store the marker geometryc

ee eitions 5c4c9 and 5c4c09 ior iniormation on the Path Data and VietBo. attribStes that yoS ian assoiiate
tith the <traw:marker< eaementc

5c6c6 Dash
The dash eaement represents a dash styae that ian be Ssed to render strokes oi shapesc
rg i nt Ti<traw:stroke-tash<

RrT 9Ti

These eaements mSst be aoiated inside the <office:styles< eaementsc

o oT<!ELEMENT traw:stroke-tash EMPTY<
traw:name %styleName; teEt|IeEt
traw:style (rect|rounty tIMPLIEt
traw:tots1 %integer; tIMPLIEt
traw:tots1-length %length; tIMPLIEt
traw:tots2 %integer; tIMPLIEt
traw:tots2-length %length; tIMPLIEt
traw:tistance %length; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <traw:stroke-tash< eaement are:
●

Name

●

tyae

●

Dots

●

Distanie

Name
This attribSte SniqSeay identiiies a dash inside an <office:styles< eaementc
rg i nt Ti

traw:nameRrT 9Tio oT<!ATTLIST traw:stroke-tash traw:name %styleName; teEt|IeEt<

tyaeThis attribSte speiiiies thether the points oi a dash are roSnd or reitangaSaarc

362

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

traw:style

RrT 9Tio oT<!ATTLIST traw:stroke-tash traw:style (rect|rounty tIMPLIEt<

Dots
These attribStes deiine a repeating seqSenie oi dots that are Ssed to render the dashc There are tto sets oi attribStes thiih are Ssed in an aaternating seqSeniec For eaih seqSenies yoS ian speiiiy the nSmber oi dots to drat
and the aength oi eaih dotc
rg i nt Ti

traw:tots1
traw:tots1-length
traw:tots2
traw:tots2-length

RrT 9Tio oT<!ATTLIST traw:stroke-tash
traw:tots1 %integer; tIMPLIEt
traw:tots1-length %length; tIMPLIEt
traw:tots2 %integer; tIMPLIEt
traw:tots2-length %length; tIMPLIEt<

Distanie
The traw:tistance attribSte speiiiies the distanie betteen the dots oi a dashc
rg i nt Ti

traw:tistanceRrT 9Ti
o oT

5cm<!ATTLIST traw:stroke-tash traw:tistance %length; tIMPLIEt<

troke PropertiesYoS Sse the ioaaoting 9 In ioIno I u 9 to deiine drating objeit aine iharaiteristiis in aaa OpenOiiiiecorgitnor1 9Ti
●

tyae

●

Dash

●

Didth

●

Coaor

●

tart marker●

End marker●

tart marker tidth●

End marker tidth●

tart marker ienter

Chapter 5 Graphic Content

363

●

End marker ienter●Transpareniy

●

Joint

5cmc0 tyaeThis attribSte speiiiies the styae oi the stroke on the iSrrent objeitc
rg i nt Ti

traw:stroke

RrT 9Tio oT<!ATTLISTtIMPLIEt<

style:properties traw:stroke (none|tash|solity

5cmc DashThis attribSte speiiiies the dash styae that is Ssed ior the strokec
rg i nt Ti

svg:stroke-tash

RrT 9Tio oT<!ATTLIST style:properties traw:stroke-tash %styleName;tIMPLIEt<

5cmc4 Didth
This attribSte speiiiies the tidth oi the stroke on the iSrrent objeit in either Snits oi aength or as a perientagec
rg i nt Ti

svg:stroke-witth

RrT 9Tio oT<!ATTLIST style:properties svg:stroke-witth %length;tIMPLIEt<

5cmc9 Coaor
This attribSte speiiiies the ioaor oi the stroke on the iSrrent objeitc
rg i nt Ti

svg:stroke-color

RrT 9Ti
o oT

364<!ATTLIST style:properties svg:stroke-color %color;tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5cmc5 tart

arker

This attribSte speiiiies a aine start markers thiih is a path that ian be ionneited to the start oi a strokec
rg i nt Ti

traw:marker-startRrT 9Tio oT<!ATTLIST style:properties traw:marker-start %styleName;tIMPLIEt<

5cmc6 End

arker

This attribSte speiiiies a stroke end markers thiih is a path that ian be ionneited to the end oi a strokec
rg i nt Ti

traw:marker-ent

RrT 9Tio oT<!ATTLIST style:properties traw:marker-ent %styleName;tIMPLIEt<

5cmcm tartarker Didth

This attribSte speiiiies the tidth oi the marker at the start oi the strokec
rg i nt Ti

traw:marker-start-witth

RrT 9Tio oT<!ATTLIST style:properties traw:marker-start-witth %length;tIMPLIEt<

5cmcr Endarker Didth

This attribSte speiiiies the tidth oi the marker at the end oi thestrokec
rg i nt Ti

traw:marker-ent-witth

RrT 9Ti<!ATTLIST style:properties traw:marker-ent-witth %length;tIMPLIEt<

o oT

5cmc

tart

arker Center

This attribSte speiiiies thether or not a start marker is ientered at the start oi a strokec
rg i nt Ti

traw:marker-start-center

RrT 9Tio oT<!ATTLIST style:properties traw:marker-start-center %boolean; tIMPLIEt<
Chapter 5 Graphic Content

365

5cmc02 Endarker Center

This attribSte speiiiies thether or not an end marker is ientered at the end oi a strokec
rg i nt Ti

traw:marker-ent-center

RrT 9Tio oT<!ATTLIST style:properties traw:marker-ent-center %boolean;tIMPLIEt<

5cmc00 Opaiity
This attribSte speiiiies the opaiity oi a strokec
rg i nt Ti

svg:stroke-opacity

RrT 9Ti

The raaSe oi this attribSte ian be a nSmber betteen 2 iiSaay transparento and 0 iiSaay opaqSeo orin a perientagec

o oT<!ATTLIST style:properties svg:stroke-opacity (%floatOrPercentage; tIMPLIEt<

5cmc0 Joint
This attribSte speiiiies the shape at the iorners oi paths or other reitor shapess then they are strokedc
rg i nt Ti

svg:stroke-lineioin

RrT 9Tio oT<!ATTLIST style:properties svg:stroke-linejoin (miter|round|bevel|middle|none|inherit)#IMPLIED>

5cr Fiaa Properties
r ieuTTioIno I u 9ir9 tiu1iOpenOiiiiecorgioI4Ai41tito 1teeuo inI.i
●

tyae

●

Coaor

●

Gradient●

Gradient step ioSnt

●

Oatih

●

366

oI 99i4I i49ienTTnA9Ti

oaid hatih●

Bitmap●Transpareniy

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5crc0 tyaeThis attribSte speiiiies the iiaa styae ior a graphii objeitc Graphii objeits that are not iaoseds sSih as a pathtithoSt a iaosepath at the ends tiaa not be iiaaedc The iiaa operation does not aStomatiiaaay iaose aaa open sSbpaths
by ionneiting the aast point oi the sSbpath tith the iirst point oi the sSbpath beiore painting the iiaac
rg i nt Ti

traw:fill

RrT 9Tio oT<!ATTLIST style:properties traw:fill (none|solit|bitmap|
gratient|hatchy tIMPLIEt<

5crc Coaor
This attribute speiiiies the ioaor oi the iiaa ior a graphii objeitc
rg i nt Ti

traw:fill-color

RrT 9Tio oT<!ATTLIST style:properties traw:fill-color %color; tIMPLIEt<

5crc4 GradientThis attribSte speiiiies a gradient styae that is Ssed ior iiaaing graphii objeitsc
rg i nt T

traw:fill-gratient-name

RrT 9To oT<!ATTLIST style:properties traw:fill-gratient-name %styleName;tIMPLIEt<

5crc9 Gradient tep CoSnt
i a gradient is Ssed ior iiaaings yoS ian set the gradient step ioSnt oi the ioaor interpoaation to be a ii.ed raaSec
rg i nt Ti

traw:gratient-step-countRrT 9Ti

By deiaSats the step ioSnt is aStomatiiaaay iaaiSaated based on the sike and resoaStion oi theiiaaed areaco oT<!ATTLIST style:properties traw:gratient-step-count (auto|%
value;y tIMPLIEt<

5crc5 Oatih
This attribSte speiiiies a hatih styae that is Ssed ior iiaaingc
rg i nt T

traw:fill-hatch-name

RrT 9T

Chapter 5 Graphic Content

367

rg i nt T

traw:fill-hatch-nameo oT<!ATTLIST style:properties traw:fill-hatch-name %styleName;tIMPLIEt<

5crc6 oaid Oatih
This attribSte speiiiies thether the baikgroSnd oi a hatih iiaaing is soaid or transparentc
rg i nt T

traw:fill-hatch-solit

RrT 9To oT<!ATTLIST style:properties traw:fill-hatch-solit %boolean;tIMPLIEt<

5crcm Bitmap
The ioaaoting attribStes are Ssed then an area is to be iiaaed tith a bitmapc

mage
The iiaa image attribSte speiiiies arg i nt Ti

L that ainks to a <traw:fill-image< eaementc

traw:fill-image-name

RrT 9Tio oT<!ATTLIST style:properties traw:fill-image-name %styleName;tIMPLIEt<

endering tyae
bitmap image ian either be rendered in the giren sikes stretihed to the iiaaed areas or tiaed orer the areac The
styae repeat attribSte speiiiies hot the bitmap image shoSad be treatedc
rg i nt Ti

style:repeat

RrT 9Ti

The raaSe oi this attribSte ian be no-repeats repeats or stretchc

o oT<!ATTLIST style:properties style:repeat (no-repeat|repeat|
stretchy tIMPLIEt<

ike
These optionaa sike attribStes ian be Ssed to orerride the aogiiaa sike oi the soSrie image datac368

rg i nt Ti

traw:fill-image-witth and traw:fill-image-heightRrT 9Ti

i the raaSe oi the style:repeat attribSte is stretchs these attribStes are ignoredc

o oT<!ATTLIST style:properties
traw:fill-image-witth %lengthOrPercentage; tIMPLIEt
traw:fill-image-height %lengthOrPercentage; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Tiae eierenie Point
These reierenie point attribStes speiiiy the point inside the soSrie image that is Ssed as the top aeit starting point
ior tiaingc
rg i nt Ti

traw:refX and traw:refY

RrT 9Ti

These attribStes are onay interpreted ii the raaSe oi the iSrrent style:repeat attribSte isrepeatco oT<!ATTLIST style:properties traw:refX %percentage; tIMPLIEt
traw:refY %percentage; tIMPLIEt<

Tiae Transaation
This attribSte deiines the transaation oi eaih tiae in reaation to the prerioSs tiaec
rg i nt Ti

traw:tile-repeat-offset

RrT 9Ti

This attribSte is onay interpreted ii the raaSe oi the iSrrent style:repeat attribSte istiletc The raaSe oi this attribSte is a perientage raaSe representing the tiaes repeat oiiset reaatire to the tiaes height or tidths ioaaoted by either the tord horivontal or verticalc

o oT<!ENTITY % tile-repeat-offset "CtATA"<<!ATTLIST style:properties traw:tile-repeat-offset %tilerepeat-offset; tIMPLIEt<

E 4 oT Ti uT i I419T4 un1<style:properties traw:tile-repeat-offsetp"40% horivontal"/<5crcr Transpareniy
The iiaa area oi a graphii objeit ian either hare nones ainears or gradient transpareniyc None and ainear transpareniy is seaeited Ssing the traw:transparency attribStes thiae gradient transpareniy is seaeited Ssing the
traw:transparency-name attribStec

None and Linear Transpareniy
The traw:transparency attribSte disabaes transpareniy or sets a ainear transpareniy ior the iiaa area oi agraphii objeitc
rg i nt Ti

traw:transparency

RrT 9Tio oT<!ATTLIST style:properties
traw:transparency %transparency; tIMPLIEt<

Gradient Transpareniy
The traw:transparency-name attribSte speiiiies a transpareniy gradient that deiines the transpareniy ior
the iiaa area oi a graphii objeitc Dhen appaying a transpareniy gradients the transpareniy is interpoaated as
deiined in the reierenied transpareniy gradient styaec This iiaa styae is rendered independentay irom other iiaa
Chapter 5 Graphic Content

369

styaes aike gradients images and hatihc

5c

rg i nt Ti

traw:transparency-name

RrT 9Ti

The raaSe oi this attribSte orerides the traw:transparency attribSteco oT<!ATTLIST style:properties traw:transparency-name %styleName; tIMPLIEt<

Te.t nimation Properties
Drating objeits that iontain te.t and te.t irames ian hare optionaa animation propertiesc These properties aatays
animate the iompaete te.t oi a drating objeit or te.t iramec The ioaaoting attribStes deiine the te.t animation:●

nimation●nimation direition●

nimation start inside●

nimation stop inside●

nimation repeat●

nimation deaay

nimation
This attribSte speiiiies the type oi animation that is Ssed ior the te.tc
rg i nt Ti

text:animation

RrT 9Ti

The raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

•

nones disabaes the te.t animationc•

scrolls siroaas the te.t irom one side to anotherc•

alternates siroaas the te.t irom one side to another and baikc•

slites siroaas the te.t irom one side to the originaa te.t position and stops therec<!ATTLIST style:properties text:animation(none|scroll|alternate|slitey tIMPLIEt<

nimation Direition
This attribSte speiiiies the siroaa direition oi animated te.tc
rg i nt Ti

text:animation-tirection

RrT 9Ti
o oT

370<!ATTLIST style:properties text:animation-tirection(left|right|up|towny tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

nimation tart nsideThis attribSte speiiiies thether or not te.t animation starts at the originaa position oi the te.tc
rg i nt Ti

text:animation-start-insite

RrT 9Tio oT<!ATTLIST style:properties text:animation-start-insite%boolean; tIMPLIEt<

nimation top nsideThis attribSte speiiiies thether or not te.t animation stops at the originaa position oi the te.tc
rg i nt Ti

text:animation-stop-insite

RrT 9Tio oT<!ATTLIST style:properties text:animation-stop-insite%boolean; tIMPLIEt<

nimation epeat
This attribSte speiiiies the nSmber oi times the animation is repeatedc i the raaSe oi the attribSte is 0s the animation is repeated indeiiniteayc
rg i nt Ti

text:animation-repeat

RrT 9Tio oT<!ATTLIST style:properties text:animation-repeat%integer; tIMPLIEt<

nimation Deaay
This attribSte speiiiies a deaay beiore the animation is startedc
rg i nt Ti

text:animation-telay

RrT 9Ti

To ioniorm tith O r620s the iormat oi the raaSe oi this attribSte is PnYnMntTnmnMnS.
ee eition 5c5c4c oi O r620 ior more detaiaed iniormation on this time iormatc ee thePreiaie ior a pointer to O r620c

o oT<!ATTLIST style:properties text:animation-telay%timeturation; tIMPLIEt<

Chapter 5 Graphic Content

371

5c02 Te.t Properties
5c02c0Sto Grot Didth and Oeight

These attribStes speiiiy thether or not to aStomatiiaaay inirease the tidth and height oi the te.t ii te.t is added toa drating objeitc
rg i nt Ti

traw:auto-grow-witth
traw:auto-grow-heightRrT 9Tio oT<!ATTLIST style:properties
traw:auto-grow-witth %boolean; tIMPLIEt
traw:auto-grow-height %boolean; tIMPLIEt<

5c02c Fit To ike
This attribSte speiiiies thether or not to stretih the te.t iontent oi a drating objeit to iiaa the entire objeitc i the
raaSe oi the attribSte is trues the te.t iontent is stretihedc
rg i nt Ti

traw:fit-to-sive

RrT 9Tio oT<!ATTLIST style:properties
traw:fit-to-sive %boolean tIMPLIEt<

5c02c4 Te.t rea Vertiiaa aignThis attribSte speiiiies the rertiiaa aaignment oi the te.t area inside a shapec
rg i nt Ti

traw:textarea-vertical-alignRrT 9Tio oT<!ATTLIST style:properties
traw:textarea-vertical-align(top|mittle|bottom|iustifyy tIMPLIEt<

5c02c9 Te.t rea Oorikontaa aignThis attribSte speiiiies the horikontaa aaignment oi the te.t area inside a shapec
rg i nt Ti

traw:textarea-horivontal-alignRrT 9Ti
o oT

372<!ATTLIST style:properties
traw:textarea-horivontal-align(left|center|right|iustifyy tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5c00 Graphii Properties
5c00c0 Coaorode

The ioaor mode styae aiieits the oStpSt oi ioaors irom a soSrie bitmap or raster graphiic
rg i nt Ti

traw:color-moteRrT 9Ti
o oT<!ENTITY % color-mote ; (greyscale|mono|watermark|stantarty<<!ATTLIST style:properties traw:color-mote %color-mote;tIMPLIEt<

5c00c Coaor nrersion
The ioaor inrersion attribSte speiiiies thether or not the ioaors in the graphii shape shoSad be inrertedc
rg i nt Ti

traw:color-inversion

RrT 9Tio oT

5c00c4<!ATTLIST style:properties traw:color-inversion %boolean;tIMPLIEt<

djSst LSminanie

The aSminanie attribSte speiiiies a signed perientage raaSe that aiieits the oStpSt aSminanie oi a bitmap or rastergraphiic
rg i nt Ti

traw:luminanceRrT 9Tio oT

5c00c9<!ATTLIST style:properties traw:luminance %signet-percent;tIMPLIEt<

djSst Contrast

The iontrast attribSte speiiiies a signed perientage raaSe that aiieits the oStpSt iontrast oi a bitmap or rastergraphiic
rg i nt Ti

traw:contrast

RrT 9Tio oT<!ATTLIST style:properties traw:contrast %signet-percent;tIMPLIEt<

Chapter 5 Graphic Content

373

5c00c5

djSst Gamma

The gamma attribSte speiiiies a raaSe that aiieits the oStpSt gamma oi a bitmap or raster graphiic
rg i nt Ti

traw:gamma

RrT 9Tio oT

5c00c6<!ATTLIST style:properties traw:gamma %signet-percent;tIMPLIEt<

djSst ed

The red attribSte speiiiies a signed perientage raaSe that aiieits the oStpSt oi the red ioaor spaie oi a bitmap orraster graphiic
rg i nt Ti

traw:ret

RrT 9Tio oT

5c00cm<!ATTLIST style:properties traw:ret %signet-percent;tIMPLIEt<

djSst GreenThe green attribSte speiiiies a signed perientage raaSe that aiieits the oStpSt oi the green ioaor spaie oi a bitmap
or raster graphiic
rg i nt Ti

traw:green

RrT 9Tio oT

5c00cr<!ATTLIST style:properties traw:green %signet-percent;tIMPLIEt<

djSst BaSe

The baSe attribSte speiiiies a signed perientage raaSe that aiieits the oStpSt oi the baSe ioaor spaie oi a bitmap orraster graphiic
rg i nt Ti

traw:blue

RrT 9Ti
o oT

5c00c

<!ATTLIST style:properties traw:blue %signet-percent;tIMPLIEt<

djSst TranspareniyThis attribSte adjSsts the transpareniy oi an imagec

374

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5c0

rg i nt Ti

traw:transparency

RrT 9Ti

The raaSe oi this attribSte ian be an integer in the range irom -022 to 022c

o oT

<ENTITY % transparency "CtATA"<<!ATTLIST style:properties traw:transparency %transparency;tIMPLIEt<

hadot Properties
ost drating objeits ian hare a shadotc The ioaaoting attribStes speiiiy hot the shadot is renderedc

hadotThis attribSte enabaes or disabaes the risibiaity oi a shadotc
rg i nt Ti

traw:shatow

RrT 9Tio oT<!ATTLIST style:properties traw:shatow (visible|hitteny
tIMPLIEt<

OiisetTo render a shadots a iopy oi the shape is rendered in the singae shadot ioaor behind the shapec The oiiset
attribStes speiiiy the oiiset betteen the top aeit edge oi the shape and the top aeit edge oi the border crg i nt Ti

traw:shatow-tistance-x and traw:shatow-tistance-y

RrT 9Tio oT<!ATTLIST style:properties
traw:shatow-offset-x %length; tIMPLIEt
traw:shatow-offset-y %length; tIMPLIEt<

Coaor
The shadot ioaor attribSte speiiiies the ioaor in thiih the shadot is renderedc
rg i nt Ti

traw:shatow-color

RrT 9Tio oT<!ATTLIST style:properties
traw:shatow-color %color; tIMPLIEt<

Transpareniy
The shadot transpareniy attribSte speiiiies the transpareniy in thiih the shadot is renderedc

Chapter 5 Graphic Content

375

rg i nt Ti

traw:shatow-transparency

RrT 9Ti

The raaSe oi this attribSte is a perientage raaSec

o oT<!ATTLIST style:properties
traw:shatow-transparency %percent; tIMPLIEt<

5c04 Conneitor Properties
tart Line paiing
The start aine spaiing attribStes modiiy the aine spaiing at the start point oi a ionneitor shapec
rg i nt Ti

traw:start-line-spacing-horivontal
traw:start-line-spacing-vertical

RrT 9Tio oT<!ATTLIST style:properties
traw:start-line-spacing-horivontal %tistance; tIMPLIEt
traw:start-line-spacing-vertical %tistance; tIMPLIEt<

End Line paiing
The end aine spaiing raaSes modiiy the aine spaiing at the end point oi a ionneitor shapec
rg i nt Ti

traw:ent-line-spacing-horivontal
traw:ent-line-spacing-vertical

RrT 9Tio oT

5c09<!ATTLIST style:properties
traw:ent-line-spacing-horivontal %tistance; tIMPLIEt
traw:ent-line-spacing-vertical %tistance; tIMPLIEt<

easSre Properties
Line Distanie
The traw:line-tistance attribSte speiiiies the distanie irom the reierenie points to the measSre ainec
rg i nt Ti

traw:line-tistanceRrT 9Tio oT<!ATTLIST style:properties
traw:line-tistance %tistance; tIMPLIEt<

GSide Orerhang
The gSides are the tto aines irom the reierenie points to the measSre ainec The traw:guite-overhang
attribSte speiiiies the distanie that the gSides are dratn aiter they iross the measSre ainec
376

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

traw:guite-overhang

RrT 9Tio oT<!ATTLIST style:properties
traw:guite-overhang %tistance; tIMPLIEt<

GSide Distanie
The traw:guite-tistance attribSte speiiiies the distanie betteen the reierenie points and the measSre
aine there the drating oi the gSides startsc
rg i nt Ti

traw:guite-tistanceRrT 9Tio oT<!ATTLIST style:properties
traw:guite-tistance %tistance; tIMPLIEt<

tart GSide
The traw:start-guite attribSte speiiiies the oiiset to the start oi the gSide irom the iirst reierenie point to
the measSre ainec
rg i nt Ti

traw:start-guite

RrT 9Tio oT<!ATTLIST style:properties
traw:start-guite %tistance; tIMPLIEt<

End GSideThe traw:ent-guite attribSte speiiiies the oiiset to the start oi the gSide irom the aast reierenie point to themeasSre ainec
rg i nt Ti

traw:ent-guite

RrT 9Tio oT<!ATTLIST style:properties
traw:ent-guite %tistance; tIMPLIEt<

Paaiing
The traw:placing attribSte speiiiies thether the measSre aine is rendered beaot or abore the edge deiinedby the tto reierenie pointsc
rg i nt Ti

traw:placing

RrT 9Ti

The raaSe oi this attribSte ian be below or abovec

o oT<!ATTLIST style:properties
traw:placing (below|abovey tIMPLIEt<

Chapter 5 Graphic Content

377

Paraaaea
The traw:parallel attribStes toggaes ii the te.t is paraaaea to the measSre aine or perpendiiSaarc
rg i nt Ti

traw:parallelRrT 9Tio oT<!ATTLIST style:properties
traw:parallel %boolean; tIMPLIEt<

Te.t aignment
These attribStes determine the te.t aaignment reaatire to the measSre ainec
rg i nt Ti

traw:measure-aligntraw:measure-vertical-alignRrT 9Ti

i raaSe oi this attribSte is automatics the appaiiation ihooses the best positionc

o oT<!ATTLIST style:properties
traw:measure-align(automatic|left-outsite|insite|right-outsiteytIMPLIEt
traw:measure-vertical-align(automatic|above|below|centery tIMPLIEt<

nit
This attribSte speiiiies the Snit Ssed in the te.tSaa presentation oi a measSre shapec
rg i nt Ti

traw:unit

RrT 9Tio oT<!ATTLIST style:properties
traw:unit(automatic|mm|cm|m|km|pt|pc|inch|ft|miy tIMPLIEt<

hot nitThis attribSte toggaes the dispaay oi the Snit in the te.tSaa presentation oi a measSre shapec
rg i nt Ti

traw:show-unit

RrT 9Tio oT<!ATTLIST style:properties
show-unit %boolean; tIMPLIEt<

Deiimaa Paaies
This attribSte speiiiies the nSmber oi deiimaa paaies that are Ssed ior the measSre te.tc

378

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

traw:tecimal-places

RrT 9Tio oT<!ATTLIST style:properties
tecimal-places %nonNegativeLength; tIMPLIEt<

5c05 Caption Properties
The ioaaoting attribStes ian be Ssed in the styaes ior iaption shapesc
●

Type

●

ngae type

●

ngae

●

Gap

●

Esiape direition●

Esiape●Line aength●

Fit aine aength

TypeThis attribSte speiiiies the geometry oi the aine oi a iaptionc
rg i nt Ti

traw:caption-type

RrT 9Tio oT<!ATTLIST style:properties traw:caption-type (straight-line|
anglet-line|anglet-connector-liney tIMPLIEt<

ngae Type
This attribSte speiiiies ii the esiape angae oi the aine oi a iaption is ii.ed or ireec i this is set to free the appaiiation ian ihoose the best possibae angaec
rg i nt Ti

caption-angle-type

RrT 9Tio oT<!ATTLIST style:properties
traw:caption-angle-type (fixet|freey tIMPLIEt<

ngaeThis attribSte speiiiies the esiape angae oi the aine oi a iaptionc

Chapter 5 Graphic Content

379

rg i nt Ti

traw:caption-angle

RrT 9Tio oT<!ATTLIST style:properties
traw:caption-angle %nonNegativeInteger; tIMPLIEt<

Gap
This attribSte speiiiies the distanie betteen the te.t area oi the iaption and the start oi the ainec
rg i nt Ti

traw:caption-gap

RrT 9Tio oT<!ATTLIST style:properties
traw:caption-gap %tistance; tIMPLIEt<

Esiape Direition
This attribSte speiiiies the esiape direition ior the aine oi a iaptionc
rg i nt Ti

traw:caption-escape-tirection

RrT 9Tio oT<!ATTLIST style:properties traw:caption-escape-tirection(horivontal|vertical|autoy tIMPLIEt<

EsiapeThis attribSte speiiiies the esiape distanie ior the aine oi a iaptionc
rg i nt Ti

traw:caption-escapeRrT 9Tio oT<!ATTLIST style:properties
traw:caption-escape %lengthOrPercentage; tIMPLIEt<

Line Length
This attribSte speiiiies the aength oi the iaption ainec
rg i nt Ti

traw:caption-line-length

RrT 9Tio oT<!ATTLIST style:properties
traw:caption-line-length %tistance; tIMPLIEt<

Fit Line Lengthi this attribSte is trSes the appaiiation determines the best possibae aength ior the iaption ainec

380

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

traw:caption-fit-line-length

RrT 9Tio oT<!ATTLIST style:properties
traw:caption-fit-line-length %boolean; tIMPLIEt<

5c06 4D Geometry Properties
Oorikontaa egments
i the geometry oi a 4D objeit is generated dSring rSn-times yoS ian ihoose the nSmber oi horikontaa segmentsthat are Ssed to generate the geometry Ssing the tr3t:horivontal-segments attribStec
rg i nt Ti

tr3t:horivontal-segments

RrT 9Ti

VaaSes betteeno oT<!ATTLIST style:properties
tr3t:horivontal-segements %nonNegativeNumber;tIMPLIEt<

and 56 are iSrrentay sSpportedc

Vertiiaa egments
i the geometry oi a 4D objeit is generated dSring rSn-times yoS ian ihoose the nSmber oi rertiiaa segments thatare Ssed to generate the geometryc
rg i nt Ti

tr3t:vertical-segments

RrT 9Ti

VaaSes betteeno oT<!ATTLIST style:properties
tr3t:vertical-segements %nonNegativeNumber; tIMPLIEt<

and 56 are iSrrentay sSpportedc

Edge oSnding
i the geometry oi a 4D objeit is generated dSring rSn-times yoS ian ihoose the sike oi an area at the edge oi thegeometry that is Ssed ior roSnding the edgesc
rg i nt Ti

tr3t:etge-rounting

RrT 9Tio oT

Edge oSnding<!ATTLIST style:properties
tr3t:etge-rounting %percentage; tIMPLIEt<

ode

The tr3t:etge-rounting-mote attribSte speiiiies hot to generate roSnded edgesc

Chapter 5 Graphic Content

381

rg i nt Ti

tr3t:etge-rounting-moteRrT 9Ti

The raaSe oi this attribSte ian be correct or numberc i the raaSe is corrects a mathematiiaaay iorreit method is Ssedc i the raaSe is attractives a method thiih preserres the
risSaa appearanie oi the te.t is Ssedc

o oT<!ATTLIST style:properties
tr3t:etge-rounting-mote (correct|attractivey tIMPLIEt<

Baik iaae
The tr3t:back-scale attribSte speiiiies the proportion oi the baikgroSnd geometry ior aathe and e.trSde
objeitsc
rg i nt Ti

tr3t:back-scale

RrT 9Tio oT<!ATTLIST style:properties
tr3t:back-scale %percentage; tIMPLIEt<

Depth
The tr3t:tepth attribSte speiiiies the e.trSsion depth ior e.trSde objeitsc
rg i nt Ti

tr3t:tepth

RrT 9Tio oT<!ATTLIST style:properties
tr3t:tepth %length; tIMPLIEt<

Baikiaie CSaaing
The tr3t:backface-culling attribSte enabaes or disabaes baikiaie iSaaingc
rg i nt Ti

tr3t:backface-cullingRrT 9Tio oT<!ATTLIST style:properties
tr3t:backface-culling (enablet|tisablety tIMPLIEt<

5c0m 4D Lighting Propertiesode
The tr3t:lighting-mote attribSte determines the aighting aagorithm Ssed to render the iorresponding 4D
objeitc

382

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

tr3t:lighting-moteRrT 9Ti

The raaSe oi this attribSte ian be stantart or touble-sitetc i the raaSe is toublesitets the rererse sides oi the objeits are aaso aightedc

o oT<!ATTLIST style:properties
tr3t:lighting-mote (stantart|touble-sitety tIMPLIEt<

Normaas 2ind
The tr3t:tepth attribSte speiiiies hot the normaa settings ior aighting are generatedc
rg i nt Ti

tr3t:tepth

RrT 9Tio oT<!ATTLIST style:properties
tr3t:normals-kint (obiect|flat|spherey tIMPLIEt<

Normaas Direition
The tr3t:normals-tirection attribSte aaaots yoS to inrerse the generated normaa aighting settingsc
rg i nt Ti

tr3t:normals-tirection

RrT 9Tio oT<!ATTLIST style:properties
tr3t:normals-tirection (normal|inversey tIMPLIEt<

5c0r 4D Te.tSre Properties
Generation

ode

These attribStes speiiiy hot the te.tSre ioordinates are generatedc
rg i nt Ti

tr3t:texture-generation-mote-x
tr3t:texture-generation-mote-y

RrT 9Tio oT<!ATTLIST style:properties
tr3t:texture-generation-mote-x(obiect|parallel|spherey tIMPLIEt
tr3t:texture-generation-mote-y(obiect|parallel|spherey tIMPLIEt<

2ind
The tr3t:texture-kint attribSte aaaots yoS to seaeit thether the te.tSre ihanges the aSminanies intensitys
or ioaor oi the shapec

Chapter 5 Graphic Content

383

rg i nt Ti

tr3t:texture-kint

RrT 9Ti<!ATTLIST style:properties
tr3t:texture-kint (luminance|intesity|colory tIMPLIEt<o oT

Fiater
The tr3t:texture-filter attribSte aaaots yoS to enabae or disabae te.tSre iiateringc
rg i nt Ti

tr3t:texture-filter

RrT 9Ti<!ATTLIST style:properties tr3t:texture-filter(enablet|tisablety tIMPLIEt<

o oT

ode
The tr3t:normals-tirection attribSte aaaots yoS to speiiiy hot the te.tSre is modSaatedc
rg i nt Ti

tr3t:normals-tirection

RrT 9Ti<!ATTLIST style:properties
tr3t:normals-tirection (normal|inversey tIMPLIEt<

o oT

5c0 4D

ateriaa Properties

Coaors
These attribStes speiiiy the ioSr ioaors that deiine a materiaac
rg i nt Ti

tr3t:ambient-color
tr3t:emissive-color
tr3t:specular-color
tr3t:tiffuse-color

RrT 9Tio oT<!ATTLIST style:properties
tr3t:ambient-color %color; tIMPLIEt
tr3t:emissive-color %color; tIMPLIEt
tr3t:specular-color %color; tIMPLIEt
tr3t:tiffuse-color %color; tIMPLIEt<

hininess
The tr3t:shininess attribSte speiiiies the shine oi the Ssed materiaac

384

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

tr3t:shininessRrT 9Ti<!ATTLIST style:properties
tr3t:shininess %percentage; tIMPLIEt<o oT

5c 2 4D hadot Properties
The tr3t:shatow attribSte enabaes or disabaes a three-dimensionaa shadot ior a three-demensionaa objeitc
rg i nt T

tr3t:shatow

RrT 9T<!ATTLIST style:properties
tr3t:shatow (visible|hitteny tIMPLIEt<o oT

5c 0 Layer ets
Layer sets deiine a set oi aayersc
rg i nt Ti<traw:layer-set<

RrT 9Ti

CSrrentay there ian onay be one aayer set ior a Drat or mpress doiSmentc

o oT<!ELEMENT traw:layer-set (traw:layeray<5c 0c0 Layer
Eaih aayer is deiined and reierenied by a namec Eaih drating objeit inside a drating or impress doiSment ian
be assigned to a aayerc Layers rirtSaaay groSp the shapesc Eaih shape that is assigned to a aayer inherits the settingsoi the aayerc
rg i nt Ti<traw:layer<

RrT 9Tio oT

5c<!ELEMENT traw:layer EMPTY<<!ATTLIST traw:layer traw:name %layerName; teEt|IeEt<

GaSe Points
GaSe points are designated points on the area oi a drating objeit to thiih a ionneitor shape ian ionneitc ost
drating objeits hare ioSr standard gaSe points at the ioSr edges oi the objeitc YoS ian add yoSr otn iSstom gaSe
points to a drating objeit by inserting one or more oi the ioaaoting eaements inside a drating objeit eaementc

5c

c0 GaSe Point

The gaSe point eaement ireates a singae Sser-deiined gaSe point ii paaied inside a drating objeit eaements ior
e.ampaes a <traw:rectangle< eaementc
Chapter 5 Graphic Content

385

rg i nt Ti<traw:glue-point<

RrT 9Tio oT<!ELEMENT traw:glue-point EMPTY<<!ATTLIST traw:glue-point
traw:it %integer; teEt|IeEt
svg:x %coortinateOrPercentage; teEt|IeEt
svg:y %coortinateOrPercentage; teEt|IeEt<

aign
The traw:align attribSte speiiiies the aaignment beharior oi the gaSe point ii the drating objeit is resikedc
rg i nt Ti

traw:alignRrT 9Tio oT<!ATTLIST traw:glue-point traw:align (top-left|top|topright|left|center|right|bottom-left|bottom-righty tIMPLIEt<

Esiape Direition
The traw:escape-tirection attribSte speiiiies the direition in thiih the ionneition aine esiapes irom thedrating objeit ii a ionneitor ionneits to the gaSe pointc
rg i nt Ti

traw:escape-tirection

RrT 9Tio oT<!ATTLIST traw:glue-point traw:escape-tirection (auto|left|right|up|town|horivontal|verticaly tIMPLIEt<

5c 4 Presentation Page LayoSts
presentation page aayoSt is a iontainer ior paaiehoaderss thiih deiine a set oi empty presentation objeitss ior
e.ampaes a titae or oStainec These paaiehoaders are Ssed as tempaates ior ireating net presentation objeits and to
mark the sike and position oi an objeit ii the presentation page aayoSt oi a drating page is ihangedc
rg i nt Ti<style:presentation-page-layout<

RrT 9Tio oT

n Ti<!ELEMENT style:presentation-page-layout presentation:
placeholtera<<!ATTLIST style:presentation-page-layoutstyle:name %styleName; teEt|IeEt<
For presentations onayc

5c 4c0 Presentation Paaiehoader
The presentation paaiehoader eaement speiiiies a paaiehoader ior presentation objeitss ior e.ampaes a titae oroStainec

386

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<presentation:placeholter<

RrT 9Ti
o oT<!ENTITY % presentation-obiect "(title|outline|subtitle|
text|graphic|obiect|chart|orgchart|table|page|notes|
hantouty" <<!ELEMENT presentation:placeholter EMPTY<<!ATTLIST presentation:placeholter presentation:obiect %presentation-obiect; teEt|IeEt<<!ATTLIST presentation:placeholter svg:x %coortinateOrPercentage; teEt|IeEt<<!ATTLIST presentation:placeholter svg:y %coortinateOrPercentage; teEt|IeEt<<!ATTLIST presentation:placeholter svg:witth %lengthOrPercentage; teEt|IeEt<<!ATTLIST presentation:placeholter svg:height %lengthOrPercentage; teEt|IeEt<

5c 9 Presentation Page ttribStes
YoS ian add transitions iades and aSdio eiieits to eaih presentation page Ssing the ioaaoting optionaa presentation
attribStes:●

Transition Type●Transition tyae●

Transition peed●

Page DSration●

Page Visibiaity

●

oSnd

●

BaikgroSnd ike●

BaikgroSnd Objeits Visibae●

BaikgroSnd Visibae

The transition attribStes are iontained in the styae eaement oi the pagec

5c 9c0 Transition TypeYoS ian set the mode oi transitions ior e.ampae manSaas Ssing the transitiontyperg i nt Ti

attribStec

presentation:transition-type

RrT 9Ti
o oT

n Ti<!ENTITY % transition-type ; (manual|automatic|semiautomaticy<<!ATTLIST style:properties presentation:transition-type %transition-type; "manual"<
For presentations onayc

Chapter 5 Graphic Content

387

5c 9c Transition tyae
The transitionstyleattribSte speiiiies the tay that eaih presentation page repaaies the prerioSs presentation pages ior e.ampae aeit-to-right repaaiements or iadingc
rg i nt Ti

presentation:transition-style

RrT 9Ti
o oT

n Ti<!ENTITY % page-transition "(none|fate-from-left|fate-fromtop|fate-from-right|fate-from-bottom|fate-to-center|fatefrom-center|move-from-left|move-from-top|move-from-right|
move-from-bottom|roll-from-left|roll-from-right|roll-frombottom|vertical-stripes|horivontal-stripes|clockwise|
counterclockwise|fate-from-upperleft|fate-from-upperright|
fate-from-lowerleft|fate-from-lowerright|close-vertical|
close-horivontal|open-vertical|open-horivontal|spiralinleft|spiralin-right|spiralout-left|spiralout-right|tissolve|
wavyline-from-left|wavyline-from-top|wavyline-from-right|
wavyline-from-bottom|rantom|stretch-from-left|stretch-fromtop|stretch-from-right|stretch-from-bottom|vertical-lines|
horivontal-lines|move-from-upperleft|move-from-upperright|
move-from-lowerright|move-from-lowerleft|uncover-to-left|
uncover-to-upperleft|uncover-to-top|uncover-to-upperright|
uncover-to-right|uncover-to-lowerright|uncover-to-bottom|
uncover-to-lowerleft|vertical-checkerboart|horivontalcheckerboarty"<<!ATTLIST style:properties presentation:transition-style %page-transition; "none"<For presentations onayc

5c 9c4 Transition peed
The transition-speed attribSte iontroas the speed at thiih a presentation page is remored irom dispaays
and repaaied by a net presentation pagec
rg i nt Ti

presentation:transition-speet

RrT 9Ti
o oT

n Ti<!ENTITY % speet (slow|metium|fasty<<!ATTLIST style:properties presentation:transition-speet %speet; "metium"<
For presentations onayc

5c 9c9 Page DSration
The page-duration attribSte iontroas the amoSnt oi time that the presentation page is dispaayedc T

388

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

presentation:page-turation

RrT 9Tio oT
n Ti<!ATTLIST style:properties presentation:page-turation %timeturation; tIMPLIEt<
For presentations onayc

5c 9c5 Page Visibiaity
YoS ian mark a drating page as hidden dSring a presentation by Ssing the visibility
attribStec
marked tith this attribSte is onay shotn thiae editing the doiSment bSt not dSring the presentationc
rg i nt Ti

pagepresentation:visibility

RrT 9Ti
o oT

n Ti<!ENTITY %visibility (visible|hitteny<<!ATTLIST style:properties presentation:visibility (visible|
hitteny "visible"<
For presentations onayc

5c 9c6 oSnd
YoS ian add soSnd eiieits to yoSr presentation pages Ssing the sound eaementc
rg i nt Ti

presentation:sountRrT 9Tio oT

n Ti<!ELEMENT presentation:sount EMPTY<<!ATTLIST presentation:sount xlink:href %url; tIMPLIEt
xlink:type (simpley tFIXEt "simple"
xlink:show (embety "embet"
xlink:actuate (onLoaty "onLoat"<
For presentations onayc

5c 9cm BaikgroSnd ike
This attribSte speiiiies thether the baikgroSnd oi a page is rendered on the iSaa page or onay inside the borders oi
the pagec
rg i nt Ti

traw:backgrount-sive

RrT 9Tio oT<!ATTLIST style:properties
traw:backgrount-sive (full|bortery tIMPLIEt<

5c 9cr BaikgroSnd Objeits Visibae
This attribSte speiiiies thether or not to hide objeits on the baikgroSnd oi the master page then dispaaying theChapter 5 Graphic Content

389

presentation pagec
rg i nt Ti

presentation:backgrount-obiects-visible

RrT 9Tio oT
n Ti<!ATTLIST style:properties presentation:backgrount-obiectsvisible %boolean; tIMPLIEt<
For presentations onayc

5c 9c BaikgroSnd Visibae
This attribSte speiiiies thether or not to hide the baikgroSnd oi the master page then dispaaying the presentation
pagec
rg i nt Ti

presentation:backgrount-visible

RrT 9Tio oT
n Ti<!ATTLIST style:properties presentation:backgrount-visible %boolean; tIMPLIEt<
For presentations onayc

5c 5 Presentation ettings
5c 5c0 Presentation
The settings ior a presentation are stored in a <presentation:settings< eaement inside an <office:boty< eaementc These settings aiieit the beharioSr ii the doiSment is dispaayed in a presentationc
rg i nt Ti<presentation:settings<

RrT 9Tio oT
n Ti<!ELEMENT presentation:settings (presentation:showya<
For presentations onayc

The attribStes that yoS ian assoiiate tith the <presentation:settings< eaement are:390●

tart page

●

hot

●

FSaa sireen●

Endaess

●

PaSse

●

hot aogo●

Forie manSaa●

oSse risibae

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●oSse as pen●

tart tith narigator●aaot animation●

Transition on iaiik●

tay on top

tart page
This attribSte speiiiies the name oi the page on thiih the presentation startsc
rg i nt Ti

presentation:start-pageRrT 9Ti

i this attribSte is sets it orerides the presentation:show attribSteco oT<!ATTLIST presentation:settings
presentation:start-page %styleName tIMPLIEt<

n Ti

For presentations onayc

hotThis attribSte speiiiies the name oi a shot that is Ssed ior the presentationc
rg i nt Ti

presentation:show

RrT 9Ti

i the presentation:start-page attribSte is sets it orerides the raaSe oi this
attribSteco oT<!ATTLIST presentation:settings
presentation:show %styleName tIMPLIEt<

n Ti

For presentations onayc

FSaa ireen
This attribSte determines thether the presentation is dispaayed in iSaa sireen mode or in a tindotc
rg i nt Ti

presentation:full-screen

RrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:full-screen %boolean; "true"<
For presentations onayc

Endaess
This attribSte stitihes indeiinite repetition oi a presentation on and oiic

Chapter 5 Graphic Content

391

rg i nt Ti

presentation:entless

RrT 9Ti<!ATTLIST presentation:settings
presentation:entless %boolean; "false"<

o oT
n Ti

For presentations onayc

PaSse
i a presentation is repeated indeiiniteays this attribSte speiiiies a time dSration ior dispaaying a paSse sireen
beiore the presentation is paayed againc i this attribSte is not set or has a raaSe oi 2s a paSse sireen is notdispaayed in endaess modec
rg i nt Ti

presentation:pause

RrT 9Ti<!ATTLIST presentation:settings
presentation:pause %timeturation; tIMPLIEt<

o oT
n Ti

For presentations onayc

hot LogoThis attribSte speiiiies thether or not a presentation appaiiation shots its aogo on the paSse sireenc
rg i nt Ti

presentation:show-logo

RrT 9Ti<!ATTLIST presentation:settings
presentation:show-logo %boolean; "false"<

o oT
n Ti

Forie

For presentations onayc

anSaa

i sets this attribSte orerides the attribSte presentation:transition-type and sets it to manualc
rg i nt Ti

presentation:force-manualRrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:force-manual %boolean; "false"<
For presentations onayc

oSse Visibae
This attribSte speiiiies thether or not the moSse pointer is risibae dSring a presentationc

392

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

presentation:mouse-visible

RrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:mouse-visible %boolean; "true"<
For presentations onayc

oSse s Pen
This attribSte speiiiies ii the moSse pointer is dispaayed as a pen or a pointerc i the moSse is dispaayed as a pen
the Sser ian drat sketihes on the pages dSring a presentationc
rg i nt Ti

presentation:mouse-as-pen

RrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:mouse-as-pen %boolean; "false"<
For presentations onayc

tart Dith Narigator
This attribSte speiiiies thether or not the narigator tindot is initiaaay dispaayed dSring a presentationc
rg i nt Ti

presentation:start-with-navigator

RrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:start-with-navigator %boolean; "false"<
For presentations onayc

nimationsThis attribSte enabaes or disabaes the paaybaik oi bitmap animations dSring a presentationc
rg i nt Ti

presentation:animations

RrT 9Tio oT
n Ti<!ATTLIST presentation:settings
presentation:animations (enablet|tisablety "enablet"<
For presentations onayc

Transition On Caiik
This attribSte enabaes or disabaes a manSaa transition by a moSse iaiik on the saide dSring a presentationc

Chapter 5 Graphic Content

393

rg i nt Ti

presentation:transition-on-clickRrT 9Ti<!ATTLIST presentation:settings
presentation:transition-on-click (enablet|tisablety"enablet"<

o oT

n Ti

For presentations onayc

tay On Topi this attribSte is set to trues the presentation tindot is dispaayed on top oi other tindots dSring a presentationc
rg i nt Ti

presentation:stay-on-top

RrT 9Ti<!ATTLIST presentation:settings
presentation:stay-on-top %boolean; "false"<

o oT
n Ti

5c 5c

For presentations onayc

hotspresentation doiSment ian iontain one or more shotsc shot enabaes yoS to iSstomike the order in thiih thepages are dispaayed dSring a presentationc YoS ian aaso omit pages irom the presentation or repeat the pages
dSring the presentationc
rg i nt Ti<presentation:show<

RrT 9Ti

This eaement is optionaac

o oT<!ELEMENT presentation:show EMPTY<n Ti

For presentations onayc

The attribStes that yoS ian assoiiate tith the <presentation:show< eaement are:
●

Name

●

Pages

Name
This attribSte SniqSeay identiiies a <presentation:show< eaementc
rg i nt Ti

presentation:nameRrT 9Ti
o oT

394<!ATTLIST presentation:showpresentation:name %styleName; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

PagesThis attribSte iontains a iomma separated aist oi page namesc The pages are dispaayed in the order in thiih they
are aisted dSring a presentation that Sses this shotc Pages ian be iniaSded more than oniec
rg i nt Ti

presentation:pages

RrT 9Tio oT<!ATTLIST presentation:showpresentation:pages CtATA teEt|IeEt<

5c 6 Presentation nimations
n a presentation doiSments shapes ian be animatedc Eaih presentation page ian hare an optionaa <presentation:animations< eaements thiih is a iontainer ior animation eiieitsc The animation is e.eiSted then thepage is dispaayed dSring a presentationc
rg i nt Ti<presentation:animations<RrT 9Tio oT<!ELEMENT presentation:animations(presentation:show-shape|presentation:show-text|
presentation:hite-shape|presentation:hite-text|
presentation:tim|presentation:playya<oT
1 4 un1
Tu u 4 un19T

The iSrrent iiae iormat speiiiiiation is more ie.ibae than the iSrrent soittare impaementationc
The iSrrent impaementation oi the OpenOiiiiecorg mpress appaiiation onay sSpports one shotand one hide eiieit per shape tith an additionaa shot and hide te.t and one dim and soSndeiieitc

5c 6c0 oSnd
YoS ian iniaSde the <presentation:sount< eaement in any animation eiieit that sSpports soSndc The
soSnd iiae reierenied by the Xaink attribStes is paayed then the eiieit is e.eiStedc
rg i nt Ti<presentation:sount<RrT 9Tio oT<!ELEMENT presentation:sount EMPTY<<!ATTLIST presentation:sountxlink:href %urieeference; teEt|IeEt
xlink:type (simpley tFIXEt "simple"
xlink:show (new|replacey tIMPLIEt
xlink:actuate (oneequesty "oneequest"<

The attribStes that yoS ian assoiiate tith the apresentation:sount< eaement are:●Paay iSaa

Chapter 5 Graphic Content

395

Paay FSaai the raaSe oi this attribSte is trues the ne.t eiieit starts aiter the soSnd is paayedc i the raaSe oi this attribSte isfalses the ne.t eiieit starts then the iSrrent eiieit is iinishedc
rg i nt Ti

presentation:play-fullRrT 9Ti<!ATTLIST presentation:sountpresentation:play-full %boolean; tIMPLIEt<

o oT

5c 6c

hot hape

The <presentation:show-shape< eaement makes a shape risibaec i there is a <presentation:
show-shape< eaement ior one shapes this shape is aStomatiiaaay inrisibae beiore the eiieit is e.eiStedc
rg i nt Ti<presentation:show-shape<

RrT 9Ti
o oT

a!ELE ENT presentation:shot-shape ipresentation:soSndo?<

The attribStes that yoS ian assoiiate tith the apresentation:show-shape< eaement are:
●

hape

●

Eiieit●Direition

●

peed

●

tart iaae

●

Path

hape
This attribSte speiiiies the shape oi this eiieit Ssing a shape Dc
rg i nt Ti

traw:shape-it

RrT 9Tio oT<!ATTLIST presentation:show-shape
traw:shape-it %shapeIt; teEt|IeEt<

EiieitThis attribSte speiiiies the type oi eiieitc

396

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

presentation:effectRrT 9Ti
o oT<!ENTITY % presentationEffects "(none|fate|move|stripes|
open|close|tissolve|wavyline|rantom|lines|laser|appear|hite|move-short|checkerboart|rotate|stretchy" <<!ATTLIST presentation:show-shapepresentation:effect %presentationEffects; "none"<

Direition
This attribSte speiiiies the direition oi the eiieitc This is reaerant ior some eiieits onayc
rg i nt Ti

presentation:tirection

RrT 9Ti
o oT<!ENTITY % presentationEffecttirections "(none|from-left|
from-top|from-right|from-bottom|from-center|from-upper-left|
from-upper-right|from-lower-left|from-lower-right|to-left|
to-top|to-right|to-bottom|to-upper-left|to-upper-right|tolower-right|to-lower-left|path|spiral-inwart-left|spiralinwart-right|spiral-outwart-left|spiral-outwart-right|
vertical|horivontal|to-center|clockwise|counter-clockwisey"<<!ATTLIST presentation:show-shape presentation:tirection %presentationEffecttirections; "none"<peed
This attribSte speiiiies the speed oi the eiieitc
rg i nt Ti

presentation:speet

RrT 9Ti
o oT<!ENTITY % presentationSpeets "(slow|metium|fasty" <<!ATTLIST presentation:show-shapepresentation:speet %presentationSpeets; "metium"<tart iaae
ome eiieits siaae a shape dSring e.eiStion oi the eiieitc This attribSte speiiiies the start sike oi the shape as aperientage oi its originaa sikec
rg i nt Ti

presentation:start-scale

RrT 9Tio oT<!ATTLIST presentation:show-shapepresentation:start-scale %percentage; "100%"<

Path
This optionaa attribSte appaies to move eiieitsc The attribSte speiiiies the path to a poaygonc The eiieit mores
Chapter 5 Graphic Content

397

aaong the aines oi the speiiiied poaygonc The poaygon is not risibae dSring the presentationc
rg i nt Ti

presentation:path-it

RrT 9Tio oT<!ATTLIST presentation:show-shapepresentation:path-it %shapeIt; tIMPLIEt<

5c 6c4 hot Te.t
This eaement makes the te.t oi a shape risibaec i there is a <show-text< eaement ior one shapes the te.t oi theshape is aStomatiiaaay inrisibae beiore the eiieit is e.eiStedc
rg i nt Ti<presentation:show-text<

RrT 9Tio oT<!ELEMENT presentation:show-text (presentation:sounty?<<!ATTLIST presentation:show-text
traw:shape-it %shapeIt; teEt|IeEt<
presentation:effect %presentationEffects; "none"
presentation:tirection %presentationEffecttirections; "none"
presentation:speet %presentationSpeets; "metium"
presentation:start-scale %percentage; "100%"
presentation:path-it %shapeIt; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the apresentation:show-text< eaement are:●hapes Eiieits Direitions peeds tart iaaes Path l see eition 5c 6c

5c 6c9 Oide hapeThis eaement makes a shape inrisibaec
rg i nt Ti<presentation:hite-shape<

RrT 9Tio oT<!ELEMENT presentation:hite-shape (presentation:sounty?<<!ATTLIST presentation:hite-shape
traw:shape-it %shapeIt; teEt|IeEt
presentation:effect %presentationEffects; "none"
presentation:tirection %presentationEffecttirections; "none"
presentation:speet %presentationSpeets; "metium"
presentation:start-scale %percentage; "100%"
presentation:path-it %shapeIt; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the apresentation:hite-shape< eaement are:●398

hapes Eiieits Direitions peeds tart iaaes Path l see eition 5c 6cOpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

5c 6c5 Oide Te.t
This eaement makes the te.t oi a shape inrisibaec
rg i nt Ti<presentation:hite-text<

RrT 9Tio oT<!ELEMENT presentation:hite-text (presentation:sounty?<<!ATTLIST presentation:hite-text
traw:shape-it %shapeIt; teEt|IeEt
presentation:effect %presentationEffects; "none"
presentation:tirection %presentationEffecttirections; "none"
presentation:speet %presentationSpeets; "metium"
presentation:start-scale %percentage; "100%"
presentation:path-it %shapeIt; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the apresentation:hite-text< eaement are:●hapes Eiieits Direitions peeds tart iaaes Path l see eition 5c 6c

5c 6c6 Dim
This eaement iiaas a shape in a singae ioaorc
rg i nt Ti<presentation:tim<

RrT 9Tio oT<!ELEMENT presentation:tim (presentation:sounty?<<!ATTLIST presentation:tim traw:shape-it %shapeIt;
teEt|IeEt<

The attribStes that yoS ian assoiiate tith the apresentation:tim< eaement are:●●hape l see eition 5c 6c
Coaor

Coaor
This attribSte speiiiies the ioaor that is Ssed to iiaa the shape then the shape is dimmedc
rg i nt Ti

traw:color

RrT 9Tio oT<!ATTLIST presentation:tim traw:color %color; teEt|IeEt<

5c 6cm Paay
This eaement starts the animation oi a shape that sSpports animationc

Chapter 5 Graphic Content

399

rg i nt Ti<presentation:play<

RrT 9Tio oT<!ELEMENT presentation:play EMPTY<<!ATTLIST presentation:play
traw:shape-it %shapeIt; teEt|IeEt
presentation:speet %presentationSpeets; "metium"<

The attribStes that yoS ian assoiiate tith the apresentation:play< eaement are:●400

hape D and peed l see eition 5c 6cOpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CHAPTER

6

6

Form Content
This ihapter desiribes the OpenOiiiiecorg X L representation oi iorms and iontroasc This ihapter iontains the
ioaaoting seitions:
●

Forms

●

Controas●

Common Form and Controa ttribStes●

Common Controa ttribStes●

Erents●Properties

6c0 Forms
iorm is a iontainer ior Sser interiaie iontroas thiih a Sser interaits tithc For e.ampaes bSttonss te.t bo.ess
iheik bo.ess and drop-dotn aists are Sser interiaie iontroas that ian be iontained in a iormc n the OpenOiiiiec
org X L iiae iormats the ioaaoting basii rSaes appay to Sser interiaie iontroas and iorms:●

YoS mSst aoiate erery iontroa in a iormc●

iontroa that is not hidden mSst iontain te.t or hare an absoaSte positionc se a irame iontaining a reierenie
to the iontroa to represent the position oi the iontroac●

YoS ian nest iormsc●

Forms are not ionneited tith the te.t iaot and aayoSt oi a doiSmentc This does not appay to iontroasc●

Forms ian be data-atarec The iontroas reiaeit the iontent oi a databasec

Forms deiine rSaes ior the ioaaoting iorm beharioSr:●

Sbmitting the iorms thiih is simiaar to OT L 9c20c Note: YoS ian not sSbmit nested iorms and iontroas thatian not be ionrerted to OT Lc●

Conneiting to a data soSriec Dhen this happenss the iontroas in a iorm beiome data-atarec
nI 9i4I ion1 4u1 tiu1i r iFlrrovaerluofti9 o un1inei41iOpenOiiiiecorgirg itnor

1 ii

6c0c0 Form
The <form:form< eaement represents a Sser interiaie iorm and deiines the iontents and properties oi the iormc
401

rg i nt T

<form:form<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:●●

The <office:forms< eaement oi a doiSmentc
nother <form:form< eaementc

The eaement iontains the ioaaoting items:●

o oT

The iontroas and sSb-iorms in the iormc●<form:properties< eaement that deiines the properties oi the iormc●<office:events< eaement that iontains the erents ior the iormc<!ELEMENT form:form (form:properties?, office:events?, (form:
control|form:formyay<<!ATTLIST form:form %name;%service-name;<

The attribStes that yoS ian assoiiate tith the <form:form< are as ioaaots:●●

erriie namec ee eition 6c4c

●

ition

●

402

Namec ee eition 6c4c

Target irame

●

ethod

●

Enitype●aaot deaetes●

aaot inserts●

aaot Spdates●

ppay iiater●

Command type●Command●

Data soSrie●

aster iieads●

Detaia iieads●

Esiape proiessing●

Fiater●gnore resSat●

Narigation mode

●

Order

●

Tabbing iyiae

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

itionThe xlink:href attribSte represents therg i nt T

L oi the proiessing agent ior the iormc

xlink:href

RrT 9To oT<!ATTLIST form:form xlink:href %url; tIMPLIEt<

Target Frame
The office:target-frame attribSte speiiiies the target irame oi the iormc ee Chapter
iniormation aboSt this attribStec
rg i nt T

office:target-frame

RrT 9T

This attribSte ian hare one oi the ioaaoting raaSes:o oT

ior more detaiaed●_self: The iorm repaaies the iontent oi the iSrrent iramec●_blank: The iorm is dispaayed in a net iramec●_parent: The iorm is dispaayed in the parent irame oi the iSrrent iramec●_top: The iorm is dispaayed in the topmost irames that is the irame that iontains the iSrrent
irame as a ihiad or desiendent bSt is not iontained tithin another iramec●

irame name: The iorm is dispaayed in the named iramec i the named irame does not e.ists a
net irame tith that name is ireatedc<!ATTLIST form:form office:target-frame CtATA "_blank"<

ethod
The form:methot attribSte speiiiies the OTTP method to Sse to sSbmit the data in the iorm to the serrerc
rg i nt T

form:methot

RrT 9TThe raaSe oi this attribSte ian be get or postc The deiaSat raaSe is getc These raaSes are notiase sensitirec

o oT<!ATTLIST form:form form:methot CtATA "get"<Enitypei the raaSe oi the form:methot attribSte is posts the form:enctype attribSte speiiiies the iontent type
Ssed to sSbmit the iorm to the serrerc
rg i nt T

form:enctype

RrT 9TThe deiaSat raaSe oi this attribSte is application/x-www-form-urlencotetc Other sSitabae
E types are aaso aiieptabaec
ee eition 0mc4 oi the STss e.dW Tpecification ior more iniormationc ee the Preiaie ior apointer to this speiiiiiationc

o oT<!ATTLIST form:form form:enctype CtATA "application/x-wwwform-urlencotet"<
Chapter 6 Form Content

403

aaot Deaetes
The form:allow-teletes attribSte speiiiies thether or not data reiords ian be deaetedc
rg i nt T

form:allow-teletes

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:allow-teletes %boolean; "true"<aaot nserts
The form:allow-inserts attribSte speiiiies thether or not net data reiords ian be insertedc
rg i nt T

form:allow-inserts

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:allow-inserts %boolean; "true"<aaot pdates
The form:allow-uptates attribSte speiiiies thether or not data reiords ian be Spdatedc
rg i nt T

form:allow-uptates

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:allow-uptates %boolean; "true"<

ppay Fiater
The form:apply-filter attribSte speiiiies thether or not iiaters shoSad be appaied to the iormc
rg i nt T

form:apply-filter

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:apply-filter %boolean; "false"<

Command TypeThe form:commant-type attribSte speiiiies the type oi iommand to e.eiSte on the data soSriec
rg i nt T

form:commant-type

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

404

●

table: The iommand iontains a tabae namec The iorm retrieres aaa oi the data in the tabaec●

query : The iommand iontains the name oi qSeryc The iorm retrieres and e.eiStes the
qSeryc●commant : The iommand iontainss ior e.ampaes an oL statementc The iorm e.eiStes theoL statementc<!ATTLIST form:form form:commant-type (table|query|commanty"commant"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CommandThe form:commant attribSte speiiiies the iommand to e.eiSte on the data soSriec
rg i nt T

form:commant

RrT 9TThe raaSe oi this attribSte ian be the name oi a database tabae s the name oi a qSery objeit or an
oL statementc

o oT<!ATTLIST form:form form:commant CtATA tIMPLIEt<

Data oSrie
The form:tatasource attribSte speiiiies the name oi a data soSrie to Sse ior the iormc
rg i nt T

form:tatasource

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:
●
●

o oT

L speiiiying a database ionneitionc
data soSrie name that OpenOiiiiecorg Sses to estabaish database ionneitionsc<!ATTLIST form:form form:tatasource CtATA tIMPLIEt<

aster Fieads
The form:master-fielts attribSte is Ssed ior nested database iormsc The attribSte speiiiies the names oi
the ioaSmns in the parent iorm resSat setc The ioaSmns are SsSaaay the ioreign key iieads oi the parent iormc The
raaSes oi the ioaSmns are Ssed to identiiy the data ior the sSbiormc Eaih time the parent iorm ihanges the iSrrent
rots the sSbiorm qSeries the database again based on the raaSes oi the master iieadsc
rg i nt T

form:master-fielts

RrT 9T

This attribSte ian iontain a iomma separated aist oi iiead namesc

o oT<!ATTLIST form:form form:master-fielts CtATA tIMPLIEt<

Detaia Fieads
The form:tetail-fielts attribSte is Ssed ior nested database iormsc The attribSte speiiiies the names oi
the ioaSmns in sSbiorms that are reaated to ioaSmns in the parent iormc The parent iorm is speiiiied Ssing theform:master-fielts attribStec The ioaSmns represent part oi the primary key iieads or their aaiasesc The
ioaSmns are Ssed as parameters in the iommand ior the nested iorm to retriere the detaias ior a matihing masteriormc
rg i nt T

form:tetail-fielts

RrT 9T

This attribSte ian iontain a iomma separated aist oi iiead namesc

o oT<!ATTLIST form:form form:tetail-fielts CtATA tIMPLIEt<

Esiape Proiessing
mS the value oS the form:commant-type attribute is commants the form:escape-processing attributes eciSies whether or not the a lication rocesses the commana beSore the aatabase ariver.
Chapter 6 Form Content

405

rg i nt T

form:escape-processing

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:escape-processing %boolean; "true"<

Fiater
The form:filter attribSte speiiiies a iiater ior the iommandc The iiater is SsSaaay part oi the TmEeE ionditionin an oL qSeryc The form:apply-filter attribute s eciSies whether or not Silters are a liea to thecommana.
rg i nt T

form:filter

RrT 9To oT<!ATTLIST form:form form:filter CtATA tIMPLIEt<

gnore esSat
The form:ignore-result attribSte speiiiies thether or not to disiard aaa resSats that are retriered irom thedata soSriec
rg i nt T

form:ignore-result

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:form form:ignore-result %boolean; "false"<

Narigationode

The form:navigation-mote attribSte speiiiies hot the reiords in a database iorm are narigatedc
rg i nt T

form:navigation-moteRrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

●

none: narigation bar is not proridedc The iorm mSst be narigated Ssing the T B andO FTsT B keys on the keyboardc●

current: A narigation bar is prorided and the narigation is periormed on the iSrrent iormc●

parent: A narigation bar is prorided and the narigation is periormed on the parent iorm oi
the iSrrent iormc<!ENTITY %navigation "(none|current|parenty"<<!ATTLIST form:form form:navigation-mote %navigation;tIMPLIEt<

Order
The form:orter attribSte speiiiies a sort iriteria ior the iommandc The sort is SsSaaay part oi the OetEe
iondition in an oL qSeryc

406

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

form:orterRrT 9To oT<!ATTLIST form:form form:orter CtATA tIMPLIEt<

Tabbing Cyiae
The form:tab-cycle attribSte speiiiies hot the appaiiation responds then the Sser presses the T B key inthe iontroas in a iormc The beharior oi the appaiiation depends on thether or not the iorm is boSnd to a data
soSriecrg i nt T

form:tab-cycle

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

6c

●

recorts: i a Sser presses the T B key in the aast iontroa oi the iorms the ioiSs mores tothe iirst iontroa speiiiied in the tab order ior the ne.t reiord oi the same iormc●

current: i a Sser presses the T B key in the aast iontroa oi the iorms the ioiSs mores tothe iirst iontroa speiiiied in the tab order ior the same reiordc●

pagep i a Sser presses the T B key in the aast iontroa oi a iorms the ioiSs mores to the iirst
iontroa speiiiied in the tab order ior the ne.t iormc<!ENTITY %cycles "(recorts|current|pagey"<<!ATTLIST form:form form:tab-cycle %cycles; tIMPLIEt<

Controas
sers Sse iontroas to interait tith iormsc Eaih iontroa in a iorm is identiiied by a namec Controas are notionneited to the te.t iaot oi a doiSmentc Controas are ionneited to a iorm by binding them to a shape that aits asa paaiehoader ior the iontroac
The <form:control< eaement represents a iontroac
rg i nt T<form:control<RrT 9To oT<!ENTITY % controls"(form:text|form:textarea|form:fixet-text|form:file|
form:passwort|form:formattet-text|
form:button|form:image|form:checkbox|form:ratio|form:listbox|
form:combobox|form:frame|form:hitten|form:image-frame|form:
grit|form:generic-controly"<<!ELEMENT form:control (%controls;ty<<!ATTLIST form:control %name;%service-name;%control-it;<

Erery iontroa has the ioaaoting tto raaSes:●n initiaa raaSe●

iSrrent raaSe

Both raaSes are iharaiter stringsc n generaas the initiaa raaSe is speiiiied in a form:value attribSte oi the<form:control< eaementc The initiaa raaSe oi a iontroa does not ihangec

Chapter 6 Form Content

407

The iSrrent raaSe is initiaaay set to the initiaa raaSec Thereaiter the iSrrent raaSe ian be modiiied dSring Sser interaition and siriptingc Dhen a iorm is resets the iSrrent raaSe oi eaih iontroa is reset to the initiaa raaSe ior theiontroac i a iontroa does not hare an initiaa raaSes the resSat oi resetting the iorm is Sndeiinedc
Dhen a Sser sSbmits a iorm ior proiessings the names oi some iontroas are paired tith the iSrrent raaSes oi the
iontroas and the pairs are sSbmitted tith the iormc These iontroas are iaaaed sSiiessiSa iontroasc ee eition
0mc04c oi the STss e.dW Tpecification ior more iniormationc ee the Preiaie ior a pointer to this speiiiiiationc
YoS ian aaso aink iontroas to a database iieadc The iontroa reieires a raaSe irom a data soSriec The modiiied datais stored in the data soSrie instead oi in the doiSmentc
Controas iontain attribStess thiih are deiined by the iiae iormatc ome appaiiations reqSire additionaa iontroa
attribStesc These attribStes arestored in the <form:properties< eaement in eaih iontroac Controa erents are
speiiiied in the <office:events< eaementc
The OpenOiiiiecorg X L iiae iormat prorides eaements ior the ioaaoting standard iontroas:
●

Te.t

●

Te.t area●

Passtord

●

Fiae

●

Formatted te.t●

Fi.ed te.t●

Combo bo.

●

List bo.

●

BStton●mage●

Cheik bo.

●adio bStton

●

Frame

●

mage irame●

Oidden●Grid

YoS ian aaso deiine appaiiation-speiiiii iontroasc These iontroas are desiribed by the aform:genericcontrol< eaementc

6c c0 Te.t
The <form:text< eaement deiines a iontroa ior inpStting te.ts thiih aaso aaaots a Sser to aater the te.tdispaayedc

408

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<form:text<

RrT 9To oT<!ELEMENT form:text (form:properties?, office:events?y<<!ATTLIST form:text %current-value;%tisablet;%max-length;%printable;%reatonly;%tab-intex;%tab-stop;%title;%value;%convert-empty;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:text< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent VaaSes Disabaeds a.imSm Lengths Printabaes ead onays Tab nde.s Tab tops Titae and
VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc●

Conrert Empty and Data Fieadc ee eition 6c9c0 ior iniormation aboSt these attribStesc

6c c Te.t rea
The <form:textarea< eaement deiines a iontroa ior inpStting te.t on mSatipae ainess thiih aaso aaaots a Sser
to aater the te.t dispaayedc
rg i nt T<form:textarea<

RrT 9To oT<!ELEMENT form:textarea (form:properties?, office:events?y<<!ATTLIST form:textarea %current-value;%tisablet;%max-length;%printable;%reatonly;%tab-intex;%tab-stop;%title;%value;%convert-empty;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:textarea< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent VaaSes Disabaeds a.imSm Lengths Printabaes ead onays Tab nde.s Tab tops Titae and
VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc●

Conrert Empty and Data Fieadc ee eition 6c9c0 ior iniormation aboSt these attribStesc

Chapter 6 Form Content

409

6c c4 Passtord
The <form:passwort< eaement deiines a iontroa that hides the te.t that a Sser inpSts Ssing an eiho iharaiters
ior e.ampaes an asteriskc This type oi iontroa is oiten Ssed ior inpStting sensitire te.t sSih as a passtordc
rg i nt T<form:passwort<

RrT 9To oT<!ELEMENT form:passwort (form:properties?, office:events?y<<!ATTLIST form:passwort %tisablet;%max-length;%printable;%tab-intex;%tab-stop;%title;%value;<

The attribStes that yoS ian assoiiate tith the <form:passwort< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds a.imSm Lengths Printabaes Tab nde.s Tab tops Titae and VaaSec ee eition 6c9 ior
iniormation aboSt these attribStesc●

Eiho Char

Eiho CharThe form:echo-char attribSte speiiiies the iharaiter that the iorm Sses in paaie oi the te.t that a Sser inpSts
in a passtord iontroac
rg i nt T

form:echo-char

RrT 9To oT<!ATTLIST form:passwort form:echo-char CtATA "a"<6c c9 Fiae
The <form:file< eaement deiines a iontroa ior seaeiting a iiaec
rg i nt T<form:file<RrT 9To oT<!ELEMENT form:file (form:properties?, office:events?y<<!ATTLIST form:file %current-value;%tisablet;%max-length;%printable;%reatonly;%tab-intex;%tab-stop;%title;%value;<

The attribStes that yoS ian assoiiate tith the <form:file< eaement are:410

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent VaaSes Disabaeds Printabaes ead onays Tab nde.s Tab tops Titae and VaaSec ee eition
6c9 ior iniormation aboSt these attribStesc6c c5 Formatted Te.t
The <form:formattet-text< eaement deiines a iontroa ior inpStting iormatted te.ts thiih aaso aaaots a
Sser to aater the te.t dispaayedc
rg i nt T<form:formattet-text<

RrT 9To oT<!ELEMENT form:formattet-text (form:properties?, office:events?y<<!ATTLIST form:formattet-text %current-value;%tisablet;%max-length;%printable;%reatonly;%tab-intex;%tab-stop;%title;%value;%convert-empty;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:formattet-text< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent VaaSes Disabaeds a.imSm Lengths Printabaes ead onays Tab nde.s Tab tops Titae and
VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc●

Conrert Empty and Data Fieadc ee eition 6c9c0 ior iniormation aboSt these attribStesc●a.imSm VaaSe●

inimSm VaaSe●

Vaaidation

a.imSm VaaSe
The form:max-value attribSte speiiiies the ma.imSm raaSe that a Sser ian enterc
rg i nt T

form:max-value

RrT 9To oT<!ATTLIST form:formattet-text form:max-value CtATA tIMPLIEt<

inimSm VaaSe
The form:min-value attribSte speiiiies the minimSm raaSe that a Sser ian enterc

Chapter 6 Form Content

411

rg i nt T

form:min-value

RrT 9To oT<!ATTLIST form:formattet-text form:min-value CtATA tIMPLIEt<

Vaaidation
The form:valitation attribSte speiiiies thether or not the te.t that the Sser enters is raaidatedc
rg i nt T

form:valitation

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:formattet-text form:valitation %boolean;"false"<6c c6 Fi.ed Te.t
The <form:fixet-text< eaement attaihes additionaa iniormation to iontroas and dispaays the iniormation in
the appaiiationc The iniormation is aaso dispaayed in error messages and tarnings ior the reaated iontroasc eaations ian be estabaished by speiiiying the form:for attribSte oi the aabeac Onay one aabea may be assoiiatedtith the same iontroac
rg i nt T<form:fixet-text<

RrT 9To oT<!ELEMENT form:fixet-text (form:properties?, office:events?y<<!ATTLIST form:fixet-text %for;%tisablet;%label;%printable;%title;<

The attribStes that yoS ian assoiiate tith the <form:fixet-text< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds Fors Labeas Printabaes and Titaec ee eition 6c9 ior iniormation aboSt these attribStesc●

Sati-Line

Sati-LineThe form:multi-line attribSte speiiiies thether or not the aabea is dispaayed on mSatipae ainesc
rg i nt T

form:multi-line

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:fixet-text form:multi-line %boolean; "false"<

6c cm Combo Bo.
The <form:combobox< eaement deiines a iontroa iontaining a aist oi possibae raaSes ior a te.t inpSt iontroac
412

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<form:combobox<

RrT 9To oT<!ELEMENT form:combobox (form:properties?, office:events?,
form:itemay<<!ATTLIST form:combobox %current-value;%tisablet;%troptown;%max-length;%printable;%reatonly;%sive;%tab-intex;%tab-stop;%title;%value;%convert-empty;%tata-fielt;%list-source;%list-source-type;<

The attribStes that yoS ian assoiiate tith the <form:combobox< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent VaaSes Disabaeds Dropdotns a. Lengths Printabaes ead onays ikes Tab nde.s Tab
tops Titaes and VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc●

Conrert Emptys Data Fieads List oSries and List oSrie Typec ee eition 6c9c0 ior iniormation aboSt these
attribStesc●

Stomatii Compaetion

Stomatii Compaetion
The form:auto-complete attribSte speiiiies that then a Sser enters te.t in the iombobo. that matihes one
oi the aist items in the iombobo.s the appaiiation iompaetes the te.t ior the Sserc
rg i nt T

form:auto-complete

RrT 9To oT<!ATTLIST form:combobox form:auto-complete %boolean; tIMPLIEt<

6c cr tem
The <form:item< eaement deiines the aist items ior a iombobo. iontroac
rg i nt T<form:item<

RrT 9To oT<!ELEMENT form:item (tPCtATAy<<!ATTLIST form:item %label;<

The attribSte that yoS ian assoiiate tith the <form:item< eaement is:●

Labeac ee eition 6c9 ior iniormation aboSt this attribStec

Chapter 6 Form Content

413

6c c List Bo.
The <form:listbox< eaement deiines an inpSt iontroa that aaaots a Sser to seaeit one or more items irom aaistc t is another representation oi a groSp oi radio bSttonsc
rg i nt T<form:listbox<

RrT 9To oT<!ELEMENT form:listbox (form:properties?, office:events?,
form:optionay<<!ATTLIST form:listbox %tisablet;%troptown;%printable;%sive;%tab-intex;%tab-stop;%title;%bount-column;%tata-fielt;%list-source;%list-source-type;<

The attribStes that yoS ian assoiiate tith the <form:listbox< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds Dropdotns Printabaes ead onays
ior iniormation aboSt these attribStesc●

BoSnd CoaSmns Data Fieads List oSries and List oSrie Typec ee eition 6c9c0 ior iniormation aboSt these
attribStesc●

ikes Tab nde.s Tab tops and Titaec ee eition 6c9

Satipae

Satipae
The form:multiple attribSte determines thether or not a Sser ian seaeit mSatipae items irom a aist bo.crg i nt T

form:multiple

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:listbox form:multiple %boolean; "false"<

6c c02 Option
The <form:option< eaement deiines the aist items ior a aist bo. iontroac n item ian be preseaeited and ian
iontain a reaated raaSec
rg i nt T<form:option<

RrT 9To oT

414<!ELEMENT form:option (tPCtATAy<<!ATTLIST form:option %current-selectet;%selectet;%label;%value;<OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

The attribStes that yoS ian assoiiate tith the <form:option< eaement are:●

CSrrent eaeiteds eaeiteds Labeas and VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc

6c c00 BStton
The <form:button< eaement deiines a bSttonc se a value attribSte to deiine the iontent oi the bSttonc
Dhen presseds a bStton SsSaaay triggers an aitionc
rg i nt T<form:button<

RrT 9T<!ELEMENT form:button (form:properties?, office:events?y<<!ATTLIST form:button %button-type;%tisablet;%image-tata;%printable;%tab-intex;%tab-stop;%target-frame;%target-location;%title;%value;<o oT

The attribStes that yoS ian assoiiate tith the aform:button< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●

BStton Types Controa Ds Disabaeds mage Datas Printabaes Tab nde.s Tab tops Target Frames Target Loiations Titaes and VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc●DeiaSat BStton

DeiaSat BStton
The form:tefault-button attribSte determines thether or not the bStton is the deiaSat bStton on the iormc
i a Sser iaiiks the deiaSat bStton or presses etSrns the appaiiation takes the same aitionc
rg i nt T

form:tefault-button

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i yoS deiine more than one deiaSat bSttons the beharioSr oi the appaiiation is Sndeiinedc

o oT

6c c0

<!ATTLIST form:tefault-button %boolean; "false"<

mage

The <form:image< eaement deiines a graphiiaa bStton iontroac This eaement iorresponds to the inpSt eaementoi type image in OT L 9c20c n TiOT L 9c20 onay aaaots the bStton type to be sSbmit ior an image bSttonc n
OpenOiiiiecorg X Ls an image bStton ian be oi any typec

Chapter 6 Form Content

415

rg i nt T

<form:image<RrT 9To oT<!ELEMENT form:image (form:properties?, office:events?y<<!ATTLIST form:image %button-type;%tisablet;%image-tata;%printable;%tab-intex;%tab-stop;%target-frame;%target-location;%title;%value;<

The attribStes that yoS ian assoiiate tith the <form:image< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●

BStton Types Controa Ds Disabaeds mage Datas Printabaes Tab nde.s Tab tops Target Frames Target Loiations Titaes and VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc

6c c04 Cheik Bo.
iheik bo. is an onsoii iontroa thiih a Sser ian toggaec The iontroa is on then the raaSe oi the form:
current-state attribSte assoiiated tith the iontroa eaement is checketc Dhen a Sser sSbmits a iorms onay
the iontroas those iSrrent state is checket are sSiiessiSac
rg i nt T<form:checkbox<

RrT 9To oT<!ELEMENT form:checkbox (form:properties?, office:events?y<<!ATTLIST form:checkbox %tisablet;%label;%printable;%tab-intex;%tab-stop;%title;%value;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:checkbox< eaement are:416●

Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds Labeas Printabaes Tab nde.s Tab tops Titaes and VaaSec ee eition 6c9 ior iniormation
aboSt these attribStesc●

Data Fieadc ee eition 6c9c0 ior iniormation aboSt this attribStec●

CSrrent tate●s Tristate

●

tate

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CSrrent tate
The form:current-state attribSte speiiiies the iSrrent state oi the iheik bo. iontroac i the raaSe oi this
attribSte is sets it orerrides the iSrrent statec
rg i nt T

form:current-state

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

●

unchecket: The iheik bo. is not iheikedc●

checket: The iheik bo. is iheikedc The raaSe oi the iontroa is sSbmitted tith the iormc●

unknown: This raaSe is onay araiaabae then the iontroa is in tristate modec se this raaSe in
ionneition tith data iiead binding to indiiate that the raaSe is N LLc<!ENTITY % states "(unchecket|checket|unknowny"<<!ATTLIST form:checkbox form:current-state %states; tIMPLIEt<

s Tristate
The form:is-tristate attribSte speiiiies that the iheik bo. ian hare three states instead oi the iommon
tto statesc
rg i nt T

form:is-tristate

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST form:checkbox form:is-tristate %boolean; "false"<tate
The form:state attribSte speiiiies the deiaSat state oi the iheik bo. iontroac This state is Ssed to initiaaise theiontroacrg i nt T

form:state

RrT 9To oT

6c c09<!ATTLIST form:checkbox form:state %states; "unchecket"<adio BStton

adio bSttons are aike iheik bo.es e.iept that then sereraa radio bSttons share the same iontroa name they are
mStSaaay e.iaSsirec Dhen one bStton is ons aaa oi the other bSttons tith the same name are oiic i no radio bSttonis initiaaay ons the tay in thiih the appaiiation ihooses thiih bStton to tSrn on initiaaay is Sndeiinedc
i a groSp oi radio bSttons is boSnd to one database iieads the raaSe oi the seaeited radio bStton is tritten into the
database iieadc

Chapter 6 Form Content

417

rg i nt T

<form:ratio<

RrT 9To oT<!ELEMENT form:ratio (form:properties?, office:events?y<<!ATTLIST form:ratio %current-selectet;%tisablet;%label;%printable;%selectet;%tab-intex;%tab-stop;%title;%value;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:ratio< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds CSrrent eaeiteds Disabaeds Labeas Printabaes eaeiteds Tab nde.s Tab tops Titaes and VaaSec eeeition 6c9 ior iniormation aboSt these attribStesc●

Data Fieadc ee eition 6c9c0 ior iniormation aboSt this attribStec

6c c05 Frame
The <form:frame< eaement deiines a irames thiih yoS ian Sse to arrange iontroas risSaaayc This eaement does
not hare a raaSe and it does not aaaot any Sser inpStc
rg i nt T<form:frame<

RrT 9To oT<!ELEMENT form:frame (form:properties?, office:events?y<<!ATTLIST form:frame %tisablet;%for;%label;%printable;%title;<

The attribStes that yoS ian assoiiate tith the <form:frame< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds Fors Labeas Printabaes and Titaec ee eition 6c9 ior iniormation aboSt these attribStesc

6c c06 mage Frame
The <form:image-frame< eaement deiines a graphiiaa iontroac The iontroa dispaays an images thiih is
aoiated at the image data aoiationc

418

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<form:image-frame<

RrT 9To oT<!ELEMENT form:image-frame (form:properties?, office:events?y<<!ATTLIST form:image-frame %tisablet;%image-tata;%printable;%reatonly;%title;%tata-fielt;<

The attribStes that yoS ian assoiiate tith the <form:image-frame< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds mage Datas Printabaes ead onays and Titaec ee eition 6c9 ior iniormation aboSt these
attribStesc●

Data Fieadc ee eition 6c9c0 ior iniormation aboSt this attribStec

6c c0m Oidden
The <form:hitten< eaement deiines a iontroa that does not hare a risSaa representationc This eaement is
SsSaaay Ssed as a iontainer ior iniormationc
rg i nt T<form:hitten<

RrT 9To oT<!ELEMENT form:hitten (form:properties?, office:events?y<<!ATTLIST form:hitten %name;%service-name;%value;<

The attribStes that yoS ian assoiiate tith the <form:hitten< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●

VaaSec ee eition 6c9 ior iniormation aboSt these attribStesc

6c c0r Grid
The <form:grit< eaement deiines a iontroa that dispaays tabae datac This iontroa is data-atare and is boSnd toa iorm thiih retrieres data irom a data soSriec Eaih ioaSmn in the grid is speiiiied by a <form:column<
eaementc Eaih ioaSmn is boSnd to a iiead in the resSating data tabaec The rots in the grid iontain the data reiords
irom the resSating data tabaec
rg i nt T<form:grit<RrT 9To oT<!ELEMENT form:grit (form:properties?, office:events?, %form:
columnay<<!ATTLIST form:grit %tisablet;%printable;%tab-intex;%tab-stop;%title;<Chapter 6 Form Content

419

The attribStes that yoS ian assoiiate tith the <form:grit< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Controa Ds Disabaeds Printabaes Tab nde.s Tab tops and Titaec ee eition 6c9 ior iniormation aboSt these
attribStesc

6c c0 CoaSmn
The <form:column< eaement deiines a ioaSmn in a grid iontroac The ioaSmn iontains a iontroa that dispaays
the grid data ior the ioaSmnc
rg i nt T<form:column<

RrT 9To oT<!ENTITY % column-type"(form:text| form:textarea| form:formattet-text| form:
checkbox| form:listbox| form:comboboxy"<<!ELEMENT form:column (form:properties?, office:events?,
column-type;ty<<!ATTLIST form:column %name;%service-name;%label;<The attribStes that yoS ian assoiiate tith the aform:column< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc●Labeac ee eition 6c9 ior iniormation aboSt this attribStec

6c c 2 Generii Controa
The <form:generic-control< eaement deiines a paaiehoader ior a generii iontroac The generii iontroa ian
iontain any properties and any erentsc The appaiiation deteits the type oi the iontroa and instantiates the iorreit
iontroacrg i nt T<form:generic-control<RrT 9To oT<!ELEMENT form:generic-control (form:properties?, office:events?y<

The attribStes that yoS ian assoiiate tith the <form:generic-control< eaement are:●Name and erriie Namec ee eition 6c4 ior iniormation aboSt these attribStesc

6c4 Common Form and Controa ttribStes
Name
The form:name attribSte speiiiies the name oi the iorm or iontroa eaementc YoS ian Sse this attribSte to gire aiorm or iontroa eaement an identitys thiih is important ior siripting and ior sSbmitting the iontent oi iontroasc
420

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

form:nameRrT 9To oT<!ENTITY % name "form:name CtATA tIMPLIEt"<

erriie Name
The form:service-name attribSte identiiies the name oi the serriie that the iorm or iontroa sSpportsc
rg i nt T

form:service-name

RrT 9To oT<!ENTITY % service-name "form:service-name CtATA tIMPLIEt"<

6c9 Common Controa ttribStes
BStton TypeThe form:button-type attribSte speiiiies the type oi a bSttonc YoS ian Sse this attribSte tith the ioaaoting
eaements:●<form:button<●<form:image<rg i nt T

form:button-type

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:●submit: Pressing the bStton sSbmits the iormc●

reset: Pressing the bStton resets erery iontroa to its initiaa raaSec●

push: Pressing the bStton does not periorm a deiaSat aitionc sSaaays there is a siript boSnd
to bSttonc and the siript is rSn●

url: Pressing the bStton opens theattribStec

L that is speiiiied in the form:target-url

o oT<!ENTITY % types "(submit|reset|push|urly"<<!ENTITY % button-type "form:button-type %types; 'push'"<n T

n OT Ls the deiaSat bStton type is submitc n an OpenOiiiiecorg appaiiations the mostiommon bStton type is pushc

Controa D
Controas that are not hidden are iontained in a iormc The iontroas iontain te.t or they hare an absoaSte positionc
The position is represented by a irame that iontains a reierenie to the iontroa eaement tithin the iorm eaementc
Controas that are not hidden mSst hare a form:it assoiiated tith thems thiih is Ssed to reierenie the iontroasc
YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<

Chapter 6 Form Content

421

●

<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:fixet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:frame<●<form:image-frame<●<form:grit<

rg i nt T

form:itRrT 9TThe D ian not iontain a iommac

o oT<!ENTITY % control-it "form:it CtATA teEt|IeEt"<

CSrrent eaeited
The form:current-selectet attribSte determines the iSrrent state oi a radio bStton or option eaementc
YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:option<●<form:ratio<rg i nt T

form:current-selectet

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ENTITY %current-selectet "form:current-selectet %boolean;'false'"<CSrrent VaaSe
The form:current-value attribSte speiiiies the iSrrent statSs oi an inpSt iontroac t orerrides the raaSe oi aform:value attribStes ii one is presentc OT L does not hare an eqSiriaant attribStec
YoS ian Sse this attribSte tith the ioaaoting eaements:

422●<form:text<●<form:textarea<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●<form:file<●<form:formattet-text<●<form:combobox<

rg i nt T

form:current-value

RrT 9To oT<!ENTITY % current-value "form:current-value CtATA tIMPLIEt"<

VaaSe
The form:value attribSte speiiiies the raaSe oi an inpSt iontroa at a speiiiied timec
YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:combobox<●<form:option<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:hitten<

rg i nt T

form:value

RrT 9To oT<!ENTITY % value "form:value CtATA tIMPLIEt"<

DeiaSat VaaSe
The form:tefault-value attribSte speiiiies the deiaSat raaSe oi a iontroac This raaSe is dispaayed then theiontroa is initiaaay dispaayed or then a Sser resets a iormc
rg i nt T

form:tefault-value

RrT 9To oT<!ENTITY % tefault-value "form:tefault-value CtATA tIMPLIEt"<

Chapter 6 Form Content

423

Disabaed
The form:tisablet attribSte speiiiies thether or not a iontroa ian aiiept Sser inpStc YoS ian Sse this
attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:fixet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:frame<●<form:image-frame<●<form:grit<

rg i nt T

form:tisablet

RrT 9TThe raaSe oi this attribSte ian be true or falsec
Controas that are disabaed are not iniaSded in the tabbing narigation seqSenie and ian not beseaeitedc

o oT<!ENTITY % tisablet "form:tisablet %boolean; 'false'"<Dropdotn
The form:troptown attribSte speiiiies thether the aist in a iombo bo. or aist bo. is aatays risibae or is onay
risibae then the Sser iaiiks the drop-dotn bSttonc YoS ian Sse this attribSte tith the ioaaoting eaements:

424●<form:combobox<●<form:listbox<

rg i nt T

form:troptown

RrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is trues the aist is aatays risibaec
i the raaSe is falses the aist is onay risibae then the Sser iaiiks the drop-dotn bSttonc

o oT<!ENTITY % troptown "form:troptown %boolean; 'false'"<OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

For
The attribSte speiiiies the Ds oi the iontroas tith thiih the iontroa eaement is Ssedc YoS ian Sse this attribSte
tith the ioaaoting eaements:●<form:fixet-text<●<form:frame<

rg i nt T

form:forRrT 9T

This attribSte iontains a iomma separated aist oi iontroa Dsc

o oT<!ENTITY % for "form:for CtATA tIMPLIEt"<

mage Data
The iorm:image-tata attribSte ainks the iontroa to an e.ternaa iiae iontaining image datac YoS ian Sse this
attribSte tith the ioaaoting eaements:●<form:button<●<form:image<●<form:image-frame<

rg i nt T

form:image-tata

RrT 9To oT<!ENTITY % image-tata "form:image-tata %url; tIMPLIEt"<

Labea
The form:label attribSte iontains a aabea ior a iontroa sSih as a radio bStton or iheik bo.c YoS ian Sse this
attribSte tith the ioaaoting eaements:●<form:fixet-text<●<form:item<●<form:option<●<form:checkbox<●<form:ratio<●<form:frame<●<form:column<

rg i nt T

form:label

RrT 9To oT<!ENTITY % label "form:label CtATA tIMPLIEt"<

Chapter 6 Form Content

425

a.imSm Length
The form:max-length attribSte speiiiies the ma.imSm nSmber oi iharaiters that a Sser ian enter in an inpSt
iontroac YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:passwort<●<form:formattet-text<●<form:combobox<

rg i nt T

form:max-length

RrT 9TThe deiaSat raaSe oi this attribSte is unlimitets thiih aaaots a Sser to enter an Snaimited
nSmber oi iharaitersc

o oT<!ENTITY % max-length "form:max-length CtATA tIMPLIEt"<

Printabae
The form:printable attribSte speiiiies thether or not a iontroa is printed then a Sser prints the doiSment inthiih the iontroa is iontainedc YoS ian Sse this attribSte tith the ioaaoting eaements:

426●<form:text<●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:fixet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:frame<●<form:image-frame<●<form:grit<

rg i nt T

form:printable

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ENTITY % printable "form:printable %boolean; 'true'"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

ead onay
The form:reatonly attribSte speiiiies thether or not a Sser ian modiiy the raaSe oi a iontroac YoS ian Sse
this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:file<●<form:formattet-text<●<form:combobox<●<form:listbox<●<form:image-frame<

rg i nt T

form:reatonly

RrT 9TThe raaSe oi this attribSte ian be true or falsec
ead-onay iontroas are iniaSded in the tabbing narigation seqSeniec

o oT<!ENTITY % reatonly "form:reatonly %boolean; 'false'"<eaeitedThe form:selectet attribSte speiiiies the deiaSat state oi a radio bStton or optionc Dhen the iontroa is initiaaiseds it is in the deiaSat state speiiiied by this attribStec YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:option<●<form:ratio<rg i nt T

form:selectet

RrT 9TThe raaSe oi this attribSte ian be true or falsec n a groSp oi radio bSttons that share the samenames onay one radio bStton ian hare this attribSte set to truec

o oT<!ENTITY % selectet "form:selectet %boolean; 'false'"<ike
The form:sive attribSte speiiiies the nSmber oi rots that are risibae at a time in a iombo bo. aist or a aist bo.
aistc YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:combobox<●<form:listbox<

rg i nt T

form:siveRrT 9To oT<!ENTITY % sive "form:sive CtATA tIMPLIEt"<

Chapter 6 Form Content

427

Tab nde.
The form:tab-intex attribSte speiiiies the tabbing narigation order oi a iontroa tithin a iormc The tabbingorder is the order in thiih iontroas are giren ioiSs then a Sser narigates throSgh the iorm Ssing the T B key on
the keyboardc The tabbing order ian iniaSde eaements that are nested in other eaementsc YoS ian Sse this attribSte
tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:grit<

rg i nt T

form:tab-intex

RrT 9TThe rSaes ior tabbing are simiaar to the tabbing rSaes Ssed in OT L 9c2c
Controas that ian be giren ioiSs are narigated in the order desiribed in the ioaaoting rSaes:
0c The iontroas that hare a positire raaSe ior the form:tab-intex attribSte are narigatediirstcc The narigation starts at the iontroa tith aotest form:tab-intex raaSe and ends at theiontroa tith the highest raaSec VaaSes do not hare to be seqSentiaa and they do not hare to
begin tith a partiiSaar raaSec
4c Controas that hare the same raaSes ior the form:tab-intex attribSte are narigatedaiiording their position in the iormc
9c Controas that do not iontain the form:tab-intex attribSte or iontain the attribSte tith a
raaSe oi 0 are narigated ne.tc These iontroas are narigated aiiording to their position in theiormc
5c Controas that hare the form:tisablet attribSte set to true are not iniaSded in the nagigationc

o oT<!ENTITY % tab-intex "form:tab-intex CtATA tIMPLIEt"<

Tab top
The form:tab-stop attribSte speiiiies thether or not a iontroa is iniaSded in the tabbing narigation orderc
YoS ian Sse this attribSte tith the ioaaoting eaements:●428<form:text<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:grit<

rg i nt T

form:tab-stop

RrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is falses the iontroa is not
iniaSded in the tabbing narigationc

o oT<!ENTITY % tab-stop "form:tab-stop %boolean; 'true'"<

Target Frame
The office:target-frame attribSte speiiiies the aink target irame oi the areac YoS ian Sse this attribSte
tith the ioaaoting eaements:●<form:button<●<form:image<rg i nt T

office:target-frame

RrT 9To oT<!ENTITY % target-frame "office:target-frame CtATA '_blank'"<

Target Loiationn xlink:href attribSte speiiiies thetith the ioaaoting eaements:●<form:button<●<form:image<

L that is dispaayed ii a bStton is iaiikedc YoS ian Sse this attribSte

rg i nt T

xlink:href

RrT 9T

This attribSte is onay eraaSated ii the raaSe oi the form:button-type attribSte is locationc

o oT<!ENTITY % target-location "xlink:href %url; tIMPLIEt"<

Chapter 6 Form Content

429

Titae
The form:title attribSte iontains additionaa iniormation aboSt a iontroac The raaSe oi the attribSte ian be
Ssed as a tooa tipc YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:passwort<●<form:file<●<form:formattet-text<●<form:fixet-text<●<form:combobox<●<form:listbox<●<form:button<●<form:image<●<form:checkbox<●<form:ratio<●<form:image<●<form:image-frame<●<form:grit<

rg i nt T

form:title

RrT 9To oT<!ENTITY % title "form:title CtATA tIMPLIEt"<

6c9c0 Database ttribStes
YoS ian bind iontroas to database iieadsc i yoS do thiss the iontroas beiomes data-atarec The iontroa aiqSires the
raaSes oi a database iiead by going throSgh a resSat set that is prorided by the iormc Eaih time there is a rot
ihange in the iorms the raaSe oi the iontroa ian ihangec The raaSe ihanges are stored in the assoiiated databaseiieadcBoSnd CoaSmn
The form:bount-column attribSte speiiiies the ioaSmn raaSes oi the aist soSrie resSat set that are Ssed to iiaa
the data iiead raaSesc YoS ian Sse this attribSte tith the <form:listbox< eaementc
rg i nt

form:bount-column

RrT 9T
o oT

430<!ENTITY % bount-column "form:bount-column CtATA tIMPLIEt"<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Conrert Empty To NSaa
The form:convert-empty-to-null attribSte speiiiies thether or not empty iSrrent raaSes are regarded
as N LL This attribSte is important ior data-atare iontroas to determine thiih raaSes to store ior the boSnd
database iieadc YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:formattet-text<●<form:combobox<

rg i nt T

form:convert-empty-to-nullRrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe oi the attribSte is trues the raaSeoi the iontroa is regarded as nSaac i the raaSe oi the attribSte is falses the raaSe oi the iontroa isregarded as an empty stringc

o oT<!ENTITY % convert-empty "form:convert-empty-to-nullboolean; 'false'"<%Data Fiead
The form:tata-fielt attribSte speiiiies the name oi a resSat set ioaSmnc The resSat set is speiiiied ior theiormc YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:text<●<form:textarea<●<form:formattet-text<●<form:combobox<●<form:listbox<●<form:checkbox<●<form:ratio<●<form:image-frame<

rg i nt T

form:tata-fielt

RrT 9To oT<!ENTITY % tata-fielt "form:tata-fielt CtATA tIMPLIEt"<

List oSrie
The form:list-source attribSte speiiiies the soSrie Ssed to popSaate the aist in a aist bo. or iombo bo.c The
iirst ioaSmn oi the aist soSrie resSat set popSaates the aistc YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:combobox<●<form:listbox<

Chapter 6 Form Content

431

rg i nt T

form:list-source

RrT 9To oT<!ENTITY % list-source "form:list-source CtATA tIMPLIEt"<

List oSrie TypeThe form:list-source-type attribSte speiiiies the type oi data soSrie that is Ssed to popSaates the aist
data in a aist bo. or iombo bo.c YoS ian Sse this attribSte tith the ioaaoting eaements:●<form:combobox<●<form:listbox<

rg i nt T

form:list-source-type

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

●

table: The aist is popSaated Ssing the iontent oi a database tabaec●

query: The aist is popSaated by e.eiSting a qSeryc●

sql: The aist is popSaated by e.eiSting an oL statementc●

sql-pass-through: The aist is popSaated by e.eiSting any type oi statement that is passed
direitay to a database drirerc●

value-list: The aist is popSaated tith raaSes speiiiied by the Sser Ssing the form:
value attribSte in the <form:option< eaementc This setting is onay appaiiabae to aistbo.esc●table-fielts: The aist is popSaated Ssing the iiead names in a database tabaec<!ENTITY % list-source-types "(table|query|sql|sql-passthrough|value-list|table-fieltsy"<<!ENTITY % list-source-type "form:list-source-type %listsource-types; tIMPLIEt"<

6c5 Erents
OT L deiines a aist oi standard erents ior iontroasc These erents are represented by attribStess thiih are assoiiated tith the iontroa eaementsc n the OpenOiiiiecorg X L iiae iormats these erents and any additionaa erents
deiined by the OpenOiiiiecorg iomponent are stored as eaements in an <office:events< eaementc
For a singae erent eaements the script:event-name attribSte speiiiies the type oi erent and other attribStes
speiiiy the aangSage and the erent handaerc

6c5c0 Erents tith an EqSiraaent OT L Erent TypeThe ioaaoting tabae desiribes the OpenOiiiiecorg X L erents that hare an eqSiraaent erent in OT Lc

432

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

h4Tr ineifvuo Ve
a a Vt eoa
A Iu rE ruv4T 1 iH g
Ev 1

o 9oIuo un1ineiEv 1

on-change

onihange

OiiSrs then a iontroa is no aonger ioiSssed and the raaSe oi
the iontroa tas modiiied sinie it tas giren ioiSsc

on-focus

onioiSs

OiiSrs then a iontroa is giren ioiSs Ssing the moSse or theT B keyc

on-blur

onbaSrOiiSrs then a iontroa is no aonger ioiSssed as a resSat oi
moring the moSse or by tabbing narigationc t may be Ssed tith
the same eaements as form:on-focusc

on-keytown

onkeydotn

OiiSrs then a key is pressed on a iontroac

on-keyup

onkeySp

OiiSrs then a key is reaeased on a iontroac

on-mouseover

onmoSseorer

OiiSrs then the moSse pointer is mored orer the iontroac

on-mousemove

onmoSsemore

OiiSrs then the moSse pointer is mored onto a iontroac

on-mousetown

onmoSsedotn

OiiSrs then a moSse bStton is pressed on a iontroac

on-mouseup

onmoSseSp

OiiSrs then a moSse bStton is reaeased on a iontroac

on-mouseout

onmoSseoSt

OiiSrs then the moSse pointer is mored atay irom a iontroac

on-reset

onresetOiiSrs then a iorm is resetc

on-submit

onsSbmit

OiiSrs then a iorm is sSbmittedc

6c5c OpenOiiiiecorg Erent Typesn addition to the OT L erent typess OpenOiiiiecorg X L aaaots additionaa erents to be handaed at rSn timec
h4Tr ineifvuo Ve
a a Vt eoaiA Iu r

AooTu 9i n

on-approveaction

BStton or imagec

OiiSrs beiore the on-performeaction erent takes paaiec
aaots the Sser to reto the aitionc

on-performeaction BStton or imagec

OiiSrs then the iontroa aition is to be periormedc The
iommon interpretation oi this erent is epressing the bSttonrc

on-textchange

aa iontroas that aaaot
te.t inpStc

OiiSrs then a Sser ihanges the te.t in a iontroac

onitemstatechange

Cheik bo. or radiobSttonc

OiiSrs then the state oi a iheik bo. or radio bStton ihangesc

on-mousetragaa iontroasc

o 9oIuo un1ineiEv 1

OiiSrs then a Sser presses and hoads one oi the moSse bSttons
and mores the moSse pointer onto a iontroac

on-approveresetsame objeits as ior
form:on-reset

on-approveuptate

aa iontroas that ian be OiiSrs beiore the on-uptate erent takes paaiec aaots the
boSnd to a database
Sser to reto the Spdatec
iieads that is iontroas that
iontain the tatafielt attribStec

OiiSrs beiore the on-reset erent takes paaiec aaots theSser to reto the reset erentc

Chapter 6 Form Content

433

h4Tr ineifvuo Ve
a a Vt eoaiA Iu r

AooTu 9i no 9oIuo un1ineiEv 1

on-uptateaa iontroas that ian be OiiSrs then the iontent oi a iontroa that is boSnd to a database
boSnd to a databaseiiead is iommittedc
iieads that is iontroas that
iontain the tatafielt attribStec

on-loat

FormscOiiSrs then the iorm estabaishes a ionneition to the data
soSriec

on-startrealot

FormscOiiSrs then the iorm is aboSt to reiresh a data soSrie ionneitionc

on-reloat

FormscOiiSrs then the iorm has reireshed a data soSrie ionneitionc

on-startunloat

FormscOiiSrs then the iorm is aboSt to drop a data soSrie ionnei tionc

on-unloat

FormscOiiSrs then the iorm has dropped a data soSrie ionneitionc

on-confirmtelete

FormscOiiSrs then the Sser is aboSt to deaete a reiordc

onapproverowchange

FormscOiiSrs beiore the on-rotihange erent takes paaiec aaots theSser to reto the ihangec

on-rowchange

FormscOiiSrs aiter ihanges to a rot are iompaetes sSih as deaetionss
Spdatess and insertionsc

onFormscapprovecursormove

OiiSrs beiore the iorm is mored to another rotc aaots theSser to reto the morec

on-cursormove

FormscOiiSrs aiter the iorm is mored to another rotc

onsupplyparameter

FormscOiiSrs then the iorm needs to iiaa parameters to ionneit to adata soSriec

on-errorFormss iombo bo.es and OiiSrs then a database-reaated error oiiSrsc
aist bo.esc

6c6 Properties
YoS ian Sse properties to store the ioaaoting settings ior iontroas and iorms:●

ettings that are not knotn by the doiSment iormatc●

ettings that are prorided by e.ternaa rendorsc●

ettings that are speiiiii to the appaiiationc

Properties ionsist oi a namesraaSe pairc The name identiiies the propertyc The raaSe ian be giren in a iSndamentaa data type or as a aist oi iSndamentaa data typesc

6c6c0 Property et
The <form:properties< eaement iontains the property settingc
rg i nt T<form:properties<

RrT 9To oT
434<!ELEMENT form:properties (form:propertyty<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

6c6c Property
The <form:property< eaement desiribes the name oi the propertys the property types and thether or not theproperty iontains aist data or singae datac
rg i nt T<form:property<

RrT 9T

This eaement is iontained in the <form:properties< eaementc

o oT<!ELEMENT form:property (form:property-valueay<

The attribStes that yoS ian assoiiate tith the <form:property< eaement are:●s List

●

Name

●

Type

s List
The form:property-is-list attribSte speiiiies that the property ian iontain a aist oi property raaSesc
rg i nt T

form:property-is-list

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i this attribSte is not present or its raaSe is falses onay one ioaaoting <form:propertyvalue< eaement is eraaStatedc<!ATTLIST form:property form:property-is-list %boolean;tIMPLIEt<

o oT

Property Name
The form:property-name attribSte speiiiies the name oi a property eaementc
rg i nt T

form:property-name

RrT 9To oT<!ATTLIST form:property form:property-name CtATA teEt|IeEt<

Property TypeThe form:property-type attribSte speiiiies the data type oi the property raaSec

Chapter 6 Form Content

435

rg i nt T

form:property-type

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:

o oT

●

boolean: reqSires the raaSe trSe or iaase●short: speiiiies a 06-bit integer●

int: speiiiies a 4 -bit integer●

long: speiiiies a 69-bit based integer●

touble: speiiiies a 69-bit iaoating point nSmber●

string: speiiiies a string<!ATTLIST form:property form:property-type (boolean|short|int|
long|touble|stringy teEt|IeEt<

6c6c4 Property VaaSe
The <form:property-value< eaement speiiiies the iontent oi the propertyc
rg i nt T<form:property-value<RrT 9To oT<!ELEMENT form:property-value (tPCtATAy<

E 4 oT Tih4 oT ioIno I u 9<form:properties<<form:property form:property-namep"Name" form:property-typep"string"<<form:property-value<Name 1</form:property-value<</form:property<<form:property form:property-namep"Items" form:property-typep"string"
form:property-is-listp"true"<<form:property-value<Item 1</form:property-value<<form:property-value<Item 2</form:property-value<<form:property-value<Item 3</form:property-value<</form:property<</form:properties<

436

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CHAPTER

7mnde.ing
This ihapter desiribes the OpenOiiiiecorg X L representation oi inde.esc t iontains the ioaaoting seitions:●

Basii Components oi OpenOiiiiecorg X L nde.es●nde. Entries●nde. oSrie tyaes

●

nde.

●

Tabae oi Contents●nde. oi aaSstrations●

nde. oi Tabaes●nde. oi Objeits●

ser-Deiined nde.

●aphabetiiaa nde.

●

arks

Bibaiography

mc0 Basii Components oi OpenOiiiiecorg X L nde.es
OpenOiiiiecorg ian aStomatiiaaay generate sereraa types oi inde.s depending on:●

The type oi data to be inde.ed●

The tay in thiih the data ior the inde. is gathered●

The iormatting options reqSired ior the inde.
n e.ampae oi one type oi aStomatiiaaay generated inde. is a tabae oi iontentsc
n inde. is represented by an inde. eaement and this eaement iontains the ioaaoting tto ihiad eaements:●nde. soSrie●

nde. body

mc0c0 nde. oSrie
The inde. soSrie eaements desiribe hot the iontent oi an inde. is generatedc The inde. soSrie eaement aaone issSiiiiient to reireate the inde. iontents prorided that the Sser did not ihange the soSrie iontent sinie the aast437

inde. tas generatedc The inde. soSrie eaement iontains:●●

ereraa attribStes that aid the proiess oi ireating the inde.c
nde. entry tempaate eaements that desiribe the e.ait iormat oi the indiridSaa inde. entriesc For e.ampaes theinde. entries in the Tabae oi Contents in this manSaa iontain the seition nSmbers the seition names a tab stops
and the page nSmberc The iorresponding inde. entry tempaate eaement iontains one inde. entry eaement ior
eaih oi these itemsc

mc0c

nde. Body

The inde. body eaement iontains the te.t that makes Sp the body oi the inde.c t is a standard baoik oi te.ts tith
the possibae addition oi an inde. header eaementc i the trite proteition ior the inde. is disabaeds the Sser ian
modiiy the inde. body bSt these ihanges are aost then the inde. is Spdated againc
inie yoS ian regenerate the inde. body at any times it may seem Snneiessary to e.port itc Ooterers it is better toe.port the inde. body ior the ioaaoting reasons:●●t makes it easier to proiess the doiSment Ssing e.ternaa tooas beiaSse ii it is not e.porteds the e.ternaa tooas
mSst regenerate the inde.c
sers ian modiiy the inde.s eren thoSgh their ihanges are aost then the inde. is Spdatedc

The <text:intex-boty< eaement iontains the te.t eaements that make Sp the inde.c Dhen the inde. isregenerateds the iSrrent inde. body iontent is orertrittenc
rg i nt T<text:intex-boty<

RrT 9To oT<!ELEMENT text:intex-boty %text;<

mc0c4 nde. Titae Tempaate
The <text:intex-title-template< eaement determines the styae oi the inde. titaec
rg i nt T<text:intex-title-template<RrT 9T

The text:style-name attribSte speiiiies the paragraph styae to Sse ior the inde. titaec
There ian onay be one <text:intex-title-template< eaement iontained in a<text:table-of-content-source< eaementc

o oT<!ELEMENT text:intex-title-template CtATA<<!ATTLIST text:intex-title-template text:style-name %styleName; tIMPLIEt<

mc0c9 nde. Entry Tempaates
The iormat oi an inde. entry is determined by the inde. entry tempaate eaementc There is a tempaate eaement ior
eaih iaass oi entryc For e.ampaes ior a Tabae oi Contents there is an eaement ior the inde. header and an eaement
ior eaih oStaine aereac For a Bibaiography nde. there is an eaement ior the header and an eaement ior eaih doiSment iaassc
Eaih inde. tempaate eaement iontains a seqSenie oi tempaate eaementss there eaih tempaate eaement represents

438

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

one part oi an inde. entryc The most iommon iormat ior inde. entries is the ihapter nSmbers the ihapter titaes atabbed spaie iiaaed tith dotss and a page nSmberc To aihiere this the inde. entry is ioniigSred to iontaineaements ior the ihapter nSmbers the entry te.ts the tab spaies and the page nSmberc
Diiierent types oi inde.es sSpport diiierent inde. entry eaementsc Thereiores eaih type oi inde. sSpports a
speiiiii inde. entry tempaate eaement tith the raaid ihiad eaementsc
rg i nt T<text:intex-entry-template<RrT 9To oT<!ENTITY % templateElement "text:intex-entry-chapter|text:
intex-entry-page-number|text:intex-entry-text|text:intexentry-span|text:intex-entry-tab-stop"<<!ELEMENT text:intex-entry-template (%entryElement;ya<u u 4 un1T

The OpenOiiiiecorg Sser interiaie onay aaaots tempaates to Sse one page nSmber and one entry
te.t eaementc

Tempaate OStaine Lerea
This attribSte speiiiies to thiih oStaine aerea this entry ioniigSration appaiesc There may not be sereraa <text:
outline-level< eaements ior the same oStaine aerea tithin the same parent eaementc
rg i nt T

text:outline-level

RrT 9T

This attribSte mSst be SniqSe among aaa <text:outline-level<
eaementsc tithin the same parent eaementc

o oT<!ATTLIST text:intex-entry-template text:outlinelevel %number; teEt|IeEt<

Paragraph tyae
The paragraph styae attribSte names the paragraph styae to be Ssed ior instantiations oi this tempaatec
rg i nt T

text:style-name

RrT 9To oT<!ATTLIST text:intex-entry-template text:stylename %styleName; teEt|IeEt<

mc0c5 Common nde. and nde. oSrie ttribStes
The ioaaoting attribSte is sSpported by aaa inde. eaements:●

text:outline-level

The ioaaoting attribStes are sSpported by aaa inde. soSrie eaements:●

text:use-intex-marks●

text:intex-scope

Chapter 7 Indexing439

tyae Namen inde. is iormatted Ssing a seition styaec This aaaots the inde. to iontain mSatipae ioaSmnsc nde. header
eaements Sse their otn seition styaes thiih enabaes a mSatiioaSmn inde. to hare a singae ioaSmn titaec The
text:style-name attribSte identiiies the seition styae Ssed to iormat the inde.crg i nt T

text:style-name

RrT 9T
h4 oT io oT<!ATTLIST text:table-of-content text:style-name %styleName;tIMPLIEt<

Drite Proteition
YoS ian proteit inde.es so that they are not aiiidentaaay ihanged by a Sserc i the text:protectet attribSte
is sets the Sser interiaie shoSad prerent Ssers irom modiiying the iontents oi the inde.crg i nt T

text:protectet

RrT 9T
h4 oT io oT<!ATTLIST text:table-of-content text:protectet %boolean;"false"<nde. iope
aa inde. soSrie eaements iontain a text:intex-scope attribSte thiih determines thether the inde. isgenerated ior the entire doiSment or ior the iSrrent ihapter onayc
rg i nt T

text:intex-scope

RrT 9T
h4 oT io oT
n T<!ATTLIST text:table-of-content-source text:intexscope (tocument|chaptery "tocument"<
This attribSte is not sSpported ior Bibaiography nde.esc

eaatire Tab tops in nde. Entries
The text:relative-tab-stop-position attribSte determines thether the position oi tab stops is reaatire to the aeit margin or to the aeit indent as determined by the paragraph styaec This is SseiSa ii yoS tant to iopy
the same entry ioniigSration ior aaa oStaine aereas beiaSse tith reaatire tab stop positions the tabs do not need tobe adjSsted to the respeitire paragraph iormatc
rg i nt T

text:relative-tab-stop-position

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i the raaSe is trues the tab stop position is reaatire to the aeit indentc
i the raaSe is falses the tab stop position is reaatire to the aeit marginc

o oiE 4 oT T
n T

440

<!ATTLIST text:table-of-content-source text:
relative-tab-stop-position %boolean; "true"<
This attribSte is not sSpported ior Bibaiography nde.esc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

mc

nde. Entries
There are nine types oi inde. entriess as ioaaots:●

Chapter nSmber●

Chapter iniormation●

Entry te.t●

Page nSmber●

Fi.ed string●

Bibaiography iniormation●

Tab stop●

Oyperaink start and end

mc c0 Chapter NSmber
The <text:intex-entry-chapter-number< eaement dispaays the ihapter nSmber oi the inde. entryc
The iharaiter styae ior the ihapter nSmber ian be iniaSded in the inde. entry eaement as a text:style-nameattribStec
rg i nt T<text:intex-entry-chapter-number<RrT 9To oT

n T<!ELEMENT text:intex-entry-chapter-number EMPTY<<!ATTLIST text:intex-entry-chapter-number text:style-name %styleName; tIMPLIEt<
This eaement ian onay dispaay the ihapter nSmberc To dispaay the ihapter names yoS mSst Sse the<text:intex-entry-text< eaementsc

mc c Chapter niormation
The <text:intex-entry-chapter< eaement dispaays the ihapter nSmber oi the inde. entryc The iharaiter
styae ior the ihapter nSmber ian be iniaSded in the inde. entry eaement as a text:style-name attribStec
rg i nt T<text:intex-entry-chapter<

RrT 9To oT

n T<!ELEMENT text:intex-entry-chapter-number EMPTY<<!ATTLIST text:intex-entry-chapter-number text:style-name %styleName; tIMPLIEt<
This eaement ian onay dispaay the ihapter nSmberc To dispaay the ihapter names yoS mSst Sse the<text:intex-entry-text< eaementsc

Dispaay Chapter Format
The text:tisplay attribSte dispaays either the ihapter nSmbers the ihapter names or bothc

Chapter 7 Indexing441

rg i nt T

text:tisplay

RrT 9To oT<!ATTLIST text:intex-entry-chapter text:tisplay( name | number | number-ant-name y "number-antname"<

mc c4 Entry Te.t
The <text:intex-entry-text< eaement dispaays the te.t oi the inde. entrys ior e.ampaes the ihapter nameii the entry is derired irom a header or the phrase iontained in the inde. mark ii the entry is derired irom an
inde. markc The iharaiter styae ior the entry te.t ian be iniaSded in the inde. entry eaement as a text:stylename attribStec
rg i nt T<text:intex-entry-text<

RrT 9To oT<!ELEMENT text:intex-entry-text EMPTY<<!ATTLIST text:intex-entry-text text:style-name %styleName;tIMPLIEt<

mc c9 Page NSmber
The <text:intex-entry-page-number< eaement dispaays the page nSmber on thiih the inde. entry isaoiatedc The iharaiter styae ior the page nSmber ian be iniaSded in the inde. entry eaement as a text:stylename attribStec
rg i nt T<text:intex-entry-page-number<RrT 9To oT<!ELEMENT text:intex-entry-page-number EMPTY<<!ATTLIST text:intex-entry-page-number text:style-name %styleName; tIMPLIEt<

mc c5 Fi.ed tring
The <text:intex-entry-span< eaement represents a ii.ed string tithin an inde. entryc The iharaiter styae
ior the entry te.t ian be iniaSded in the inde. entry eaement as a text:style-name attribStec
rg i nt T<text:intex-entry-span<RrT 9T

naike the <text:span< eaements the <text:intex-entry-span< eaement does nothare any ihiad eaementsc

o oT<!ELEMENT text:intex-entry-string CtATA<<!ATTLIST text:intex-entry-string text:style-name %styleName;tIMPLIEt<

mc c6 Bibaiography niormation
The <text:intex-entry-bibliography< eaement introdSies bibaiography data into inde. entry
442

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

tempaatesc
rg i nt T<text:intex-entry-bibliography<

RrT 9To oT<!ELEMENT text:intex-entry-bibliography EMPTY<<!ATTLIST text:intex-entry-bibliography text:style-name %styleName; tIMPLIEt<

Eaih <text:intex-entry-bibliography< eaement ian iontain:●

text:style-name attribSte speiiiying a iharaiter styae ior the entry●

bibaiography data iiead identiiier

Bibaiography Data Fiead dentiiier
The text:bibliography-tata-fielt attribSte determines thiih part oi the bibaiography data iiead todispaaycrg i nt T

text:bibliography-tata-fielt

RrT 9To oT<!ATTLIST text:intex-entry-bibliography text:
bibliography-tata-fielt ( attress | annote |author | bibiliographic_type | booktitle | chapter| custom1 | custom2 | custom3 | custom: | custom4| etition | etitor | howpublishet | itentifier |institution | isbn | iournal | month | note |number | organivations | pages | publisher |report_type | school | series | title | url |volume | year y teEt|IeEt<

mc cm Tab top
The <text:intex-entry-tab-stop< eaement represents a tab stop tithin an inde. entryc t aaso iontains
the position iniormation ior the tab stopc
rg i nt T<text:intex-entry-tab-stop<

RrT 9To oT<!ELEMENT text:intex-entry-tab-stop EMPTY<<!ATTLIST text:intex-entry-tab-stop text:style-name %styleName; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <text:intex-entry-tab-stop< eaement are:●style:leater-char●style:type●style:position

Chapter 7 Indexing443

Leader CharThe style:leater-char attribSte speiiiies the aeader iharaiterc
rg i nt T

style:leater-char

RrT 9To oT<!ATTLIST text:intex-entry-tab-stop style:leaterchar %char; " "<Tab Type
The style:type attribSte speiiiies the tab stop typec
rg i nt T

style:type

RrT 9T

The <text:intex-entry-tab-stop< eaement onay sSpports tto types
oi tab: left and rightc
i the raaSe oi this attribSte is lefts the style:position attribSte mSst
aaso be Ssedc Othertises this attribSte mSst be omittedc

o oT<!ATTLIST text:intex-entry-tab-stop style:type(left|righty "left"<

Tab Position
The style:position attribSte speiiiies the position oi the tabc
rg i nt T

style:position

RrT 9T

This attribSte ian onay be Ssed tith <text:intex-entry-tab-stop<eaements there the raaSe oi the style:type attribSte is leftc

o oT<!ATTLIST text:intex-entry-tab-stop style:position%length; tIMPLIEt<n T

Depending on the raaSe oi the text:relative-tab-stop-position
attribSte in the <text:intex-entry-config< eaements the position oi
the tab is interpreted as being reaatire to the aeit margin or the aeit indentc

mc cr Oyperaink tart and End
The <text:intex-entry-link-start< and <text:intex-entry-link-ent< eaements mark thestart and end oi a hyperaink inde. entryc The iharaiter styae ior the hyperaink ian be iniaSded in the inde. entry
eaement as a text:style-name attribStec

444

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:intex-entry-link-start<<text:intex-entry-link-ent<

RrT 9To oT<!ELEMENT text:intex-entry-link-start EMPTY<<!ELEMENT text:intex-entry-link-ent EMPTY<<!ATTLIST text:intex-entry-link-start text:style-name %styleName; tIMPLIEt<<!ATTLIST text:intex-entry-link-ent text:style-name %styleName; tIMPLIEt<

mc c E.ampae oi an nde. Entry ConiigSration
The ioaaoting is an e.ampae oi the X L iode ior a tabae oi iontents iaaaed Tabae oi Content tith the ioaaoting
iharaiteristiis:●

t Sses the top tto oStaine aereasc●

Eaih entry ionsists oi the ihapter nSmbers a iaosing parenthesiss the ihapter titaes a tab stops and the pagenSmberc●

For the top oStaine aereas the page nSmber is iormatted Ssing a styae iaaaed Boadc●

For the seiond oStaine aereas a braiket is Ssed instead oi a iaosing parenthesisc

E 4 oT T 4 T inei n1 1
<text:table-of-content<<text:table-of-content-source
text:outline-levelp"2"
text:use-intex-marksp"false"
text:intex-scopep"tocument"<<text:intex-title-template text:style-namep"Intex 1"<
Table of Content</text:intex-title-template<<text:intex-entry-template
text:ouline-levelp"1"
text:style-namep"Contents 1"<<text:intex-entry-chapter-number/<<text:intex-entry-span<y </text:intex-entry-span<<text:intex-entry-text/<<text:intex-entry-tab-stop style:typep"right"/<<text:intex-entry-page-number text:style-namep"bolt"/<</text:intex-entry-template<<text:intex-entry-template
text:ouline-levelp"2"
text:style-namep"Contents 2"<<text:intex-entry-chapter-number/<<text:intex-entry-span<] </text:intex-entry-span<<text:intex-entry-text/<<text:intex-entry-tab-stop style:typep"right"/<<text:intex-entry-page-number/<</text:intex-entry-template<</text:table-of-content-source<

Chapter 7 Indexing445

<text:table-of-content-boty<.ea el<text:p text:style-namep"..."<1y Chapter<text:tab-stop/<<text:span style-namep"bolt"< 1 </text:span<</text:p<<text:p text:style-namep"..."<1.1] Subchapter<text:tab-stop/<1</text:p<ale e eleeE</text:table-of-content-boty<</text:table-of-content<

mc4

nde. oSrie tyaes
The tabae oi iontent inde. ian gather inde. entries irom paragraphs iormatted Ssing iertain paragraph styaesc The<text:intex-source-styles< eaement iontains aaa oi the <text:intex-source-style< eaements
ior a partiiSaar oStaine aereac
rg i nt T<text:intex-source-styles<

RrT 9To oT<!ELEMENT text:intex-source-styles (text:intex-source-styleya<

oSrie tyaes OStaine Lerea
The text:outline-levels attribSte determines at thiih oStaine aerea to aist the inde. entries gathered irom
the respeitire paragraph styaesc
rg i nt T

text:outline-levels

RrT 9To oT<!ATTLIST text:intex-source-styles text:outlinelevel %number; tIMPLIEt<

mc4c0 nde. oSrie tyaeaa paragraphs iormatted Ssing the styae speiiiied in the <text:intex-source-style< eaement are
iniaSded in the inde.crg i nt T<text:intex-source-style<RrT 9To oT<!ELEMENT text:intex-source-style EMPTY<

The attribSte assoiiated tith the <text:intex-source-style< eaement is:●tyae nametyae Name
The text:style-name attribSte speiiiies the paragraph styaec Paragraphs iormatted Ssing this styae are
446

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

iniaSded in the inde.crg i nt T

text:style-name

RrT 9T
o oT

mc9

nde.

<!ATTLIST text:intex-source-style text:style-name%styleName; teEt|IeEt<

arks

There are three types oi inde. marks to iorrespond to the three types oi inde. that Sse oi inde. marksc The three
types oi inde. marks are:●Tabae oi iontent inde. marks●

ser-deiined inde. marks●

aphabetiiaa inde. marks

The X L iode ior inde. marks is simiaar to the iode ior Bookmarks and eiereniesc The ioaaoting are somebasii rSaes aboSt inde. marks:●

Eaih inde. mark is represented by a start and an end eaementc●

Both eaements Sse an D attribSte to matih the appropriate start and end eaementsc●

The start and end eaements ior an inde. mark mSst be iontained in the same paragraphs tith the start eaement
oiiSrring iirstc●

The attribStes assoiiated tith the inde. mark are attaihed to the start eaementc●

The te.t betteen the start and end eaements is the te.t the inde. entryc●

The iormatting attribStes ior inde. marks ian oreraapc

mc9c0 Tabae oi Content nde.

arks

The <text:toc-mark-start< eaement marks the start oi a tabae oi iontent inde. entryc
rg i nt T<text:toc-mark-start<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
There mSst be an end eaement to matih the start eaement aoiated in the same paragraphs tith thestart eaement appearing iirstc

o oT<!ELEMENT text:toc-mark-start EMPTY<<!ATTLIST text:toc-mark-start text:it It teEt|IeEt<<!ATTLIST text:toc-mark-start text:outline-level %number;tIMPLIEt<

The attribStes assoiiated tith the <text:toc-mark-start< eaement are:●text:it attribSte to aaaot the start and end eaements to be matihedc●

text:outline-level attribSte to speiiiy the oStaine aerea oi the resSating tabae oi iontent inde. entryc

The <text:toc-mark-ent< eaement marks the end oi a tabae oi iontents inde. entryc

Chapter 7 Indexing447

rg i nt T

<text:toc-mark-ent<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
The mSst be a start eaement to matih the end eaement aoiated in the same paragraphs tith the starteaement appearing iirstc<!ELEMENT text:toc-mark-ent EMPTY<<!ATTLIST text:toc-mark-ent text:it It teEt|IeEt<

o oT

Tabae oi iontent inde. marks aaso hare a rariant that does not eniaose the te.t to be inde.edc This is represented
Ssing the <text:toc-mark< eaement thiih iontains a text:string-value attribSte ior the te.t oi theinde. entryc n this sitSations a text:it attribSte is not neiessary beiaSse there are no start and end eaements tomatihcrg i nt T<text:toc-mark<RrT 9T<!ELEMENT text:toc-mark EMPTY<<!ATTLIST text:toc-mark text:string-value %string teEt|IeEt<<!ATTLIST text:toc-mark text:outline-level %number; tIMPLIEt<

o oT

mc9c

ser-Deiined nde.

arks

The <text:user-intex-mark-start< eaement marks the start oi a Sser-deiined inde. entryc
rg i nt T<text:user-intex-mark-start<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
There mSst be an end eaement to matih the start eaement aoiated in the same paragraphs tith thestart eaement appearing iirstc

o oT<!ELEMENT text:user-intex-mark-start EMPTY<<!ATTLIST text:user-intex-mark-start text:it It teEt|IeEt<<!ATTLIST text:user-intex-mark-start text:outline-level %number; tIMPLIEt<

The <text:user-intex-mark-ent< eaement marks the end oi the Sser-deiined inde. entryc
rg i nt T<text:user-intex-mark-ent<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
There mSst be a start eaement to matih the end eaement aoiated in the same paragraphs tith thestart eaement appearing iirstc

o oT<!ELEMENT text:user-intex-mark-ent EMPTY<<!ATTLIST text:user-intex-mark-ent text:it It teEt|IeEt<

ser inde. marks aaso hare a rariant that does not eniaose the te.t to be inde.edc This is represented by the<text:user-intex-mark< eaement thiih iontains a text:string-value attribSte ior the te.t oi theinde. entryc n this sitSations the text:it attribSte is not neiessary beiaSse there are no start and end eaements
to matihc

448

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:user-intex-mark<RrT 9T<!ELEMENT text:user-intex-mark EMPTY<<!ATTLIST text:user-intex-mark text:string-value %string;teEt|IeEt<<!ATTLIST text:user-intex-mark text:outline-level %number;tIMPLIEt<

o oTName oi ser nde.
There ian be more than one Sser-deiined inde.c n this iases the Sser inde. mSst be named Ssing the text:
intex-name attribStec This attribSte determines to thiih Sser-deiined inde. an inde. mark beaongsc i no nameis girens the deiaSat Sser-deiined inde. is Ssedc
rg i nt T

text:intex-name

RrT 9T<!ATTLIST text:user-intex-mark text:intex-name %string tIMPLIEt<<!ATTLIST text:user-intex-mark-start text:intexname %string tIMPLIEt<

o oT

mc9c4

aphabetiiaa nde.

ark

The <text:alpha-intex-mark-start< eaement marks the start oi an aaphabetiiaa inde. entryc inie
aaphabetiiaa entries may make Sse oi tto keys to strSitSre entriess there are tto optionaa attribStes ior these keysc
There is aaso a booaean attribSte that determines ii this entry is intended to be the main entrys ii there are sereraa
eqSaa entriesc
rg i nt T<text:alpha-intex-mark-start<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
There mSst be an end eaement to matih the start eaement aoiated in the same paragraphs tith thestart eaement appearing iirstc

o oT<!ELEMENT text:alpha-intex-mark-start EMPTY<<!ATTLIST text:alpha-intex-mark-start text:it It teEt|IeEt<

The attribStes assoiiated tith the <text:toc-mark-start< eaement are:●text:it attribSte to aaaot the start and end eaements to be matihedc●

dditionaa keys●

ain entry

The <text:alpha-intex-mark-ent< eaement marks the end oi an aaphabetiiaa inde. entryc

Chapter 7 Indexing449

rg i nt T

<text:alpha-intex-mark-ent<

RrT 9TThe D speiiiied by the text:it attribSte mSst be SniqSec
There mSst be a start eaement to matih the end eaement aoiated in the same paragraphs tith thestart eaement appearing iirstc

o oT<!ELEMENT text:alpha-intex-mark-ent EMPTY<<!ATTLIST text:alpha-intex-mark-ent text:it It teEt|IeEt<

aphabetiiaa inde. marks aaso hare a rariant that does not eniaose the te.t to be inde.edc This is represented
Ssing the <text:alpha-intex-mark< eaement thiih iontains a text:string-value attribSte ior thete.t oi the inde. entryc n this sitSations a text:it attribSte is not neiessary beiaSse there are no start and end
eaements to matihc
rg i nt T<text:alpha-intex-mark<RrT 9To oT<!ELEMENT text:alpha-intex-mark EMPTY<<!ATTLIST text:alpha-intex-mark text:string-value %string;teEt|IeEt<

dditionaa 2eys
The text:key1 and text:key2 attribStes speiiiy additionaa keys ior the aaphabetiiaa inde. markc
rg i nt T

text:key1
text:key2

RrT 9Ti onay one key is Sseds it mSst be iontained in the text:key1 attribSteco oT<!ATTLIST text:alpha-intex-mark-start
text:key1 %string; tIMPLIEt
text:key2 %string; tIMPLIEt <<!ATTLIST text:alpha-intex-mark
text:key1 %string; tIMPLIEt
text:key2 %string; tIMPLIEt <ain Entry
i there are sereraa inde. marks ior the same entrys yoS ian deiaare one entry as the main entry Ssing the text:
main-entry attribStec
rg i nt T

text:main-entry

RrT 9To oT<!ATTLIST text:alpha-intex-mark-start
text:main-entry %boolean; "false"<<!ATTLIST text:alpha-intex-mark
text:main-entry %boolean; "false"<

mc9c9 Bibaiography nde.

ark

The <text:bibliography-mark< eaement iontains the te.t and iniormatin ior a bibaiography inde. entryc
t sSpports attribStes ior eaih type oi bibaiographiiaa data that a bibaiography inde. may iontainc

450

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:bibliography-mark<RrT 9To oT<!ELEMENT text:bibliography-mark (tPCtATAy<<!ATTLIST text:bibliography-mark text:bibiliographic-type( article | book | booklet | conference | custom1 |custom2 | custom3 | custom: | custom4 | email | inbook |incollection | inproceetings | iournal | manual |mastersthesis | misc | phtthesis | proceetings |techreport | unpublishet | www y teEt|IeEt <<!ATTLIST text:bibliography-mark text:itentifier CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:attress CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:annote CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:author CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:booktitle CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:chapter CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:etition CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:etitor CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:howpublishet CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:institution CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:iournal CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:month CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:note CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:number CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:organivations CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:pages CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:publisher CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:school CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:series CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:title CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:report-type CtATAtIMPLIEt<<!ATTLIST text:bibliography-mark text:volume CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:year CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:url CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:custom1 CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:custom2 CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:custom3 CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:custom: CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:custom4 CtATA tIMPLIEt<<!ATTLIST text:bibliography-mark text:isbn CtATA tIMPLIEt<

mc5 Tabae oi Contentstabae oi iontents ian be ireated irom:●

Tabae oi iontent inde. marks in the te.t●

The oStaine strSitSre iormed by the headers●

rbitrary paragraph iormats

The tabae oi iontents is represented by the <text:table-of-content< eaementc
Chapter 7 Indexing451

<text:table-of-content<

rg i nt T
RrT 9T<!ELEMENT text:table-of-content(text:table-of-content-source, text:intex-botyy<

o oT

The attribSte that yoS ian assoiiate tith the <text:table-of-content< eaement is:●

text:style-nameThis attribSte speiiiies the seition styae to Sse ior iormatting the tabae oi iontentsc
o oT<!ATTLIST text:table-of-content text:style-name %styleName;tIMPLIEt<

mc5c0 Tabae oi Content oSrie
The <text:table-of-content-source< eaement speiiiies hot the tabae oi iontents is generatedc t
speiiiies hot the entries are gatheredc<text:table-of-content-source<

rg i nt T
RrT 9T<!ELEMENT text:table-of-content-source(text:intex-heater-template? |text:table-of-content-entry-templatea |text:intex-source-stylesa y <o oTThe attribStes that yoS ian attaih to the <text:table-of-content-source< eaement are:●OStaine aerea●

se inde. marks●

se inde. soSrie styaes●nde. siope
ee eition mc0c5 ior iniormation aboSt this attribSteco oT●<!ATTLIST text:table-of-content-source text:intex-scope(tocument|chaptery "tocument"<

eaatire tab stop positionee eition mc0c5 ior iniormation aboSt this attribSteco oT<!ATTLIST text:table-of-content-source text:relative-tabstop-position %boolean; "true"<

OStaine Lerea
The text:outline-level attribSte speiiiies thiih oStaine aereas are Ssed then generating the tabae oi
iontentsc
rg i nt T

452

text:outline-level

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

RrT 9T

The raaSe oi this attribSte mSst be none or an integer greater than keroc
i the raaSe oi this attribSte is nones no entries are generated irom the oStainec
i this attribSte is omitteds aaa oStaine aereas are Ssed by deiaSatc

o oT

se nde.

<!ATTLIST text:table-of-content-source text:
outline-level CtATA teEt|IeEt<

arks

The text:use-intex-marks attribSte determines thether or not to Sse inde. marks to generate the tabae oi
iontentc
rg i nt T

text:use-intex-marks

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i the raaSe is trues the tabae oi iontents iniaSdes entries generated irom tabaeoi iontent inde. marksc ee eition mc9 ior more iniormation on inde. marksc

o oT<!ATTLIST text:table-of-content-source text:useintex-marks %boolean; "true"<se nde. oSrie tyaes
The text:use-intex-source-styles attribSte determines thether or not inde. entries are generated ior
paragraph iormatted Ssing iertain paragraph styaesc
rg i nt T

text:use-intex-source-styles

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i the raaSe is trues the tabae oi iontents iniaSdes an entry ior erery paragraph iormatted tith one oi the styaes speiiiied in a <text:intexsource-style< eaementc

o oT<!ATTLIST text:table-of-content-source text:useintex-source-styles %boolean; "false"<

mc5c Tabae oi Content Entry Tempaate
The <text:table-of-content-entry-template< eaement determines the iormat oi an inde. entry ior
a partiiSaar oStaine aereac

Chapter 7 Indexing453

rg i nt T

<text:table-of-content-entry-template<RrT 9T

This eaement sSpports the ioaaoting ihiad eaements:●

text:intex-entry-chapter-number●

text:intex-entry-page-number●

text:intex-entry-text●

text:intex-entry-span●

text:intex-entry-tab-stop●

text:intex-entry-link-start●

text:intex-entry-link-ent

o oT<!ELEMENT text:table-of-content-entry-template( text:intex-entry-chapter |text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop |text:intex-entry-link-start |text:intex-entry-link-ent ya<

u u 4 un1T

The OpenOiiiiecorg Sser interiaie onay aaaots tempaates to Sse one page nSmber and one entry
te.t eaementc

The attribStes that yoS ian assoiiate tith the <text:table-of-content-entry-template< eaement
are:●Tempaate oStaine aerea●

Paragraph styae

Tempaate OStaine Lerea
This attribSte speiiiies to thiih oStaine aerea the entry ioniigSration appaiesc
rg i nt T

text:outline-level

RrT 9TYoS iannot hare sereraa <text:outline-level< eaements ior the sameoStaine aerea tithin a parent eaementc

o oT<!ATTLIST text:table-of-content-entry-template
text:outline-level %number; teEt|IeEt<

Paragraph tyae
The text:style-name attribSte speiiiies the paragraph styae to Sse ior this tempaatec
rg i nt T

text:style-name

RrT 9To oT

454<!ATTLIST text:table-of-content-entry-template
text:style-name %styleName; teEt|IeEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

mc6

nde. oi aaSstrations
The inde. oi iaaSstrations aists aaa images and graphiis in the iSrrent doiSment or ihapterc The inde. entries ian
be derired irom the iaption oi the iaaSstration or the name oi the iaaSstrationc<text:illustration-intex<

rg i nt T
RrT 9T<!ELEMENT text:illustration-intex(text:illustration-intex-source, text:intex-botyy<

o oT

The attribStes that yoS ian attaih to the <text:illustration-intex< eaement are:●text:style-nameThis attribSte speiiiies the seition styae to Sse ior the inde. oi iaaSstrationsc
o oT<!ATTLIST text:illustration-intex
text:style-name %styleName; tIMPLIEt<

mc6c0 nde. oi aaSstration oSrie
The <text:illustration-intex-source< eaement speiiiies hot the inde. oi iaaSstrations is generatedc<text:illustration-intex-source<

rg i nt T
RrT 9T<!ELEMENT text:illustration-intex-source(text:intex-heater-template? |text:illustration-intex-entry-template?y <o oTThe attribStes yoS ian Sse tith a <text:illustration-intex-source< eaement are:●se iaption●

Caption seqSenie name●

Caption seqSenie iormat●

nde. siope
This attribSte speiiiies thether the inde. appaies to the entire doiSment or onay the the iSrrent ihapterc
o oT●<!ATTLIST text:illustration-intex-source text:intex-scope(tocument|chaptery "tocument"<

text:relative-tab-stop-position
This attribSte speiiiies thether the position oi tab stops are interpreted reaatire to the aeit margin or the aeit
indentco oT<!ATTLIST text:illustration-intex-source text:relative-tabstop-position %boolean; "true"<

Chapter 7 Indexing455

se Captionn OpenOiiiiecorgs eaih objeit iontained in a te.t doiSment has a namec n additions images aaso hare a iaptionc
The image iaption or the image name ian be gathered ior the inde. oi iaaSstrationsc
rg i nt T

text:use-caption

RrT 9T

This attribSte ian hare a raaSe oi true or falsec
i the raaSe is trues the image iaption is Ssedc
i the raaSe is falses the image name is Ssedc<!ATTLIST text:illustration-intex-source text:usecaption %boolean; "true"<o oTCaption eqSenie Name
Captions are assoiiated tith a seqSenie namec i the text:use-caption attribSte is set to trues yoS mSst
Sse this attribSte to speiiiy the seqSenie tith thiih the iaptions are assoiiatedc
rg i nt T

text:caption-sequence-name

RrT 9Ti this attribSte is omitteds the deiaSat seqSenie ior the objeit type is Sseds ior
e.ampae the seqSenie e aaSstrationr is Ssed ior iaaSstrationsc

o oT<!ATTLIST text:illustration-intex-source text:
caption-sequence-name %string; tIMPLIEt<

Caption eqSenie Format
i the entries ior the inde. oi iaaSstrations are obtained irom the image iaptionss yoS mSst Sse this attribSte tospeiiiy the iormat ior the entriesc
rg i nt T

text:sequence-format

RrT 9TThe raaSe oi this attribSte ian be texts category-ant-values or
captionc

o oT<!ATTLIST text:illustration-intex-source text:
sequence-format (text|category-ant-value|captiony
tIMPLIEt<

mc6c

aaSstration nde. Entry Tempaate

The iaaSstration inde. entry tempaate eaement determines the iormat oi an inde. entry ior a partiiSaar oStaine aereac

456

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<text:illustration-intex-entry-template<RrT 9T

This eaement sSpports the ioaaoting ihiad eaements:●

text:intex-entry-page-number●

text:intex-entry-text●

text:intex-entry-span●

text:intex-entry-tab-stopo oT<!ELEMENT text:illustration-intex-entry-template( text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop ya<

u u 4 un1T

The OpenOiiiiecorg Sser interiaie onay aaaots tempaates to Sse one page nSmber and one entry
te.t eaementc

inie yoS ian onay hare one <text:illustration-intex-entry-template< eaements yoS do notneed to Sse the text:outline-level attribStec The attribSte that yoS ian assoiiate tith the <text:
illustration-intex-entry-template< eaement is:●

Paragraph styae

Paragraph tyaeThis attribSte identiiies the paragraph styae to Sse ior this tempaatec
rg i nt T

text:style-name

RrT 9To oT

mcm<!ATTLIST text:illustration-intex-entry-template
text:style-name %styleName; teEt|IeEt<

nde. oi Tabaes
The inde. oi tabaes aists aaa oi the tabaes in the iSrrent doiSment or ihapterc t torks in e.aitay the same tay as
the inde. oi iaaSstrationsc
rg i nt T<text:table-intex<

RrT 9To oT<!ELEMENT text:table-intex(text:table-intex-source, text:intex-botyy<<!ATTLIST text:table-intex
text:style-name %styleName; tIMPLIEt<

mcmc0 Tabae nde. oSrie
The <text:table-intex-source< eaement speiiiies hot the inde. oi tabaes is generatedc

Chapter 7 Indexing457

rg i nt T

<text:table-intex-source<

RrT 9To oT<!ELEMENT text:table-intex-source(text:intex-heater-template?,
text:table-intex-entry-template?y <<!ATTLIST text:table-intex-source
text:intex-scope (tocument|chaptery "tocument"
text:relative-tab-stop-position %boolean; "true"
text:use-caption %boolean; "true"
text:caption-sequence-name %string; tIMPLIEt
text:sequence-format(text|category-ant-value|captiony tIMPLIEt<

The attribStes that yoS ian assoiiate tith this eaement are the same as those that ian be assoiiated tith the<text:illustration-intex-source< eaementc ee eition mc6c0 ior detaiaed iniormation aboSt these
attribStescmcmc Tabae nde. Entry Tempaate
The tabae inde. entry tempaate eaement determines the iormat oi an inde. entry ior a partiiSaar oStaine aereac
rg i nt T<text:table-intex-entry-template<RrT 9To oT<!ELEMENT text:table-intex-entry-template( text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop ya<<!ATTLIST text:table-intex-entry-template
text:style-name %styleName; teEt|IeEt<

The attribStes that yoS ian assoiiate tith this eaement are the same as those that ian be assoiiated tith the<text:illustration-intex-entry-template< eaementc ee eition mc6c0 ior detaiaed iniormation
aboSt these attribStescmcr

nde. oi Objeits
The inde. oi objeits aists aaa oi the objeits in the iSrrent doiSment or ihapterc t gathers its entries irom theknotn objeit typesc
rg i nt T<text:obiect-intex<

RrT 9To oT<!ELEMENT text:obiect-intex(text:obiect-intex-source, text:intex-botyy<<!ATTLIST text:obiect-intex
text:style-name %styleName; tIMPLIEt<

mcrc0 Objeit nde. oSrie
The <text:obiect-intex-source< eaement determines thiih objeit types to iniaSde in the inde. oi
458

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

objeitsc t aaso sSpports the standard inde. soSrie attribStesc<text:obiect-intex-source<

rg i nt T
RrT 9T<!ELEMENT text:obiect-intex-source(text:intex-heater-template?,
text:obiect-intex-entry-template?y <o oTThe attribStes that yoS ian assoiiate tith the <text:obiect-intex-source< eaement are:●se attribStess text:use-a-obiects●

nde. siope
This attribSte speiiiies thether the inde. appaies to the entire doiSment or onay the the iSrrent ihapterc
o oT●<!ATTLIST text:illustration-intex-source text:intex-scope(tocument|chaptery "tocument"<

eaatire tab stop position
This attribSte speiiiies thether the position oi tab stops are interpreted reaatire to the aeit margin or the aeit
indentco oT<!ATTLIST text:illustration-intex-source text:relative-tabstop-position %boolean; "true"<se ttribStes
The text:use-a-obiects attribStes speiiiy thiih types oi objeits to iniaSde in the inde. oi objeitsc Thereis an attribSte ior eaih type oi OpenOiiiiecorg objeit as ioaaots:●

text:use-spreatsheet-obiects●

text:use-traw-obiects●

text:use-chart-obiects●

text:use-math-obiects

Other objeits are iniaSded or omitted Ssing the ioaaoting attribSte:●

text:use-other-obiects

rg i nt T

text:use-spreatsheet-obiects
text:use-math-obiects
text:use-traw-obiects
text:use-chart-obiects
text:use-other-obiects

RrT 9To oT<!ATTLIST text:obiect-intex-source
text:use-spreatsheet-obiects %boolean;"false"text:use-traw-obiects %boolean; "false"
text:use-chart-obiects %boolean; "false"
text:use-other-obiects %boolean; "false"
text:use-math-obiects %boolean; "false"<

Chapter 7 Indexing459

mcrc Objeit nde. Entry Tempaate
The objeit inde. entry tempaate eaement determines the iormat oi an inde. entry ior a partiiSaar oStaine aereac
rg i nt T<text:obiect-intex-entry-template<RrT 9T<!ELEMENT text:obiect-intex-entry-template( text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop ya<<!ATTLIST text:obiect-intex-entry-template
text:style-name %styleName; teEt|IeEt<

o oT

The attribStes that yoS ian assoiiate tith this eaement are the same as those that ian be assoiiated tith the<text:illustration-intex-entry-template< eaementc ee eition mc6c0 ior detaiaed iniormation
aboSt these attribStescmc

ser-Deiined nde.
Sser-deiined inde. iombines the iapabiaities oi the inde.es disiSssed earaier in this ihapterc
inde. ian gather entries irom the ioaaoting soSries:●nde. marks●

Paragraphs iormatted Ssing partiiSaar paragraph styaes●

Tabaess imagess or objeits●

Te.t irames

Sser-deiined

The <text:user-intex< eaement represents a Sser-deiined inde.crg i nt T<text:user-intex<

RrT 9To oT

mc c0<!ELEMENT text:user-intex(text:user-intex-source, text:intex-botyy<<!ATTLIST text:user-intex
text:style-name %styleName; tIMPLIEt<

ser-Deiined nde. oSrie

The <text:user-intex-source< eaement ian iontain sereraa attribStes that determine hot the inde.
entries are gatheredc t aaso sSpports an attribSte that determines hot the oStaine aereas oi the inde. entries aregatheredc
The paragraph iormats that are Ssed as inde. marks are enioded in <text:intex-source-styles<
eaementss jSst aike in <text:table-of-content-source< eaementsc

460

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<text:user-intex-source<

rg i nt T
RrT 9T<!ELEMENT text:user-intex-source( text:intex-heater-template?,
text:user-intex-entry-templatea,
text:intex-source-stylesa y <o oTThe attribStes yoS ian Sse tith <text:user-intex-source< eaements are:●se attribStess text:use-a●

Copy oStaine aerea●nde. siope
This attribSte speiiiies thether the inde. appaies to the entire doiSment or onay to the iSrrent ihapterc
o oT●<!ATTLIST text:user-intex-source text:intex-scope (tocument|
chaptery "tocument"<

nde. namen order to sSpport sereraa Sser-deiined inde.es tith diiierent iontentss Sser inde. marks hare a text:
intex-name attribStec The same attribSte ian be Ssed tith a <text:user-intex-source< eaement tospeiiiy thiih inde. marks appay to the iSrrent inde.co oT●<!ATTLIST text:user-intex-source text:intex-name %string;tIMPLIEt<

eaatire tab stop position
This attribSte speiiiies thether the position oi tab stops are interpreted reaatire to the aeit margin or the aeit
indentco oT<!ATTLIST text:user-intex-source text:relative-tab-stopposition %boolean; "true"<se ttribStes
The text:use-a attribStes speiiiy thiih entries to iniaSde in the Sser-deiined inde.c The attribStes that yoS
ian speiiiy are:●text:use-intex-marks●

text:use-graphics●

text:use-tables●

text:use-floating-frames●

text:use-obiects

rg i nt T

text:use-intex-marks
text:use-graphics
text:use-tables
text:use-floating-frames
text:use-obiects

RrT 9T
Chapter 7 Indexing

461

<!ATTLIST text:user-intex-source
text:use-intex-marks %boolean; "false"
text:use-graphics %boolean; "false"
text:use-tables %boolean; "false"
text:use-floating-frames %boolean;"false"text:use-obiects %boolean; "false"<o oT

Copy OStaine Lereas
rg i nt T

text:copy-outline-levels

RrT 9T

This attribSte ian hare a raaSe oi true or falsec
i the raaSe is trues the entries are gathered at the oStaine aerea oi the soSrie
eaement to thiih they reierc
i the raaSe is falses aaa inde. entries gathered are at the top oStaine aereac For
e.ampaes ii an image appears in eition 0c c4s the entry ior the image is aoiatedat oStaine aerea 4c<!ATTLIST text:user-intex-source text:copyoutline-levels %boolean; "false"<

o oT

mc c

ser-Deiined nde. Entry Tempaate

ser inde. entry tempaates sSpport entry eaements ior ihapter nSmbers page nSmbers entry te.ts te.t spanss andtab stopsc
rg i nt T<text:user-intex-entry-template<RrT 9T

This eaement sSpports the ioaaoting ihiad eaements:

o oT

●

text:intex-entry-chapter-number●

text:intex-entry-page-number●

text:intex-entry-text●

text:intex-entry-span●

text:intex-entry-tab-stop<!ELEMENT user-intex-entry-template( text:intex-entry-chapter |text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop ya<

The attribStes that yoS ian assoiiate tith the <text:user-intex-entry-template< eaements are:●Tempaate oStaine aerea●

Paragraph styae

Tempaate OStaine Lerea
The text:outline-level attribSte speiiiies to thiih oStaine aerea this entry ioniigSration appaiesc
462

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

text:outline-level

RrT 9TYoS iannot hare sereraa <text:outline-level< eaements ior the sameoStaine aerea tithin a parent eaementc

o oT<!ATTLIST text:table-of-content-entry-template
text:outline-level %number; teEt|IeEt<

Paragraph tyae
The text:style-name attribSte speiiiies the paragraph styae to Sse ior the tempaatec
text:style-namerg i nt T
RrT 9T<!ATTLIST text:table-of-content-entry-template
text:style-name %styleName; teEt|IeEt<

o oT

mc02

aphabetiiaa nde.
n aaphabetiiaa inde. gathers its entries soaeay irom inde. marksc<text:alphabetical-intex<

rg i nt T
RrT 9T<!ELEMENT text:alphabetical-intex (text:alphabatical-intexsource, text:intex-botyy<<!ATTLIST text:alphabetical-intex text:style-name %styleName;tIMPLIEt<

o oT

mc02c0aphabetiiaa nde. oSrie

The <text:alphabetical-intex-source< eaement speiiiies hot the aaphabetiiaa inde. is generatedc
rg i nt T<text:alphabetical-intex-source<

RrT 9To oT<!ELEMENT text:alphabetical-intex-source( text:intex-heater-template?,
text:alphabetical-intex-entry-templatea y <The attribStes yoS ian assoiiate tith <text:alphabetical-intex-source< eaements are:●gnore iase●ain entry styae name●aphabetiiaa separators●

Combine entries attribStes●●

se keys as entries
Capitaaike entries

Chapter 7 Indexing

463

●

Comma separated entries●nde. siope
This attribSte speiiiies thether the inde. appaies to the entire doiSment or onay to the iSrrent ihapterc
o oT●<!ATTLIST text:alphabetical-intex-source text:intex-scope(tocument|chaptery "tocument"<

eaatire tab stop position
This attribSte speiiiies thether the position oi tab stops are interpreted reaatire to the aeit margin or the aeit
indentco oT<!ATTLIST text:alphabetical-intex-source text:relative-tabstop-position %boolean; "true"<gnore Case
The text:ignore-case attribSte determines thether or not the iapitaaikation oi tords is ignoredc
rg i nt T

text:ignore-case

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i the raaSe is trues the iapitaaikation is ignored and entries that are identiiaa
e.iept ior iharaiter iase are aisted as the same entriesc
i the raaSe is falses the iapitaaikation oi tords is not ignoredc

o oT<!ATTLIST text:alphabetical-intex-source text:
ignore-case %boolean; "false"<

ain Entry tyae Name
The text:main-entry-style-name attribSte determines the iharaiter styae to Sse ior main entriesc Sbentries are iormatted Ssing the deiaSat iharaiter styae determined by the paragraph styae oi the entriesc
rg i nt T

text:main-entry-style-name

RrT 9To oT<!ATTLIST text:alphabetical-intex-source text:
main-entry-style-name %styleName; tIMPLIEt<

aphabetiiaa eparators
The text:alphabetical-separators attribSte determines thether or not entries beginning tith thesame aetter are groSped and separated irom the entries beginning tith the ne.t aetters and so onc
rg i nt T

text:alphabetical-separators

RrT 9TThe raaSe oi this attribSte ian be true or falsec
i the raaSe is trues aaa entries beginning tith the same aetter are groSped
togetherc The inde. iontains headings ior eaih seitions ior e.ampaes ior aaa
entries starting tith the aetter s B ior aaa entries starting tith the aetter Bs andso onc464

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<!ATTLIST text:alphabetical-intex-source text:
alphabetical-separators %boolean; "false"<o oT

Combining Entries
The OpenOiiiiecorg soittare prorides sereraa options ior deaaing tith the iommon sitSation there yoS hare
mSatipae inde. entries ior the same tord or phrases as ioaaots:●

Satipae entries ior the same tord ian be iombined into a singae entry Ssing the text:combineentries attribStec

●i the iombined entry iontains a seqSenie oi pagess the pages ian be iormatted:➢

s a range oi nSmbers separated by a dash Ssing the text:combine-entries-with-tash
attribSte➢s the start nSmber tith a pp aabeas or the appropriate aabea ior the ihosen aangSages Ssing the text:
combine-entries-with-pp attribSte
text:combine-entries
text:combine-entries-with-tash
text:combine-entries-with-pp

rg i nt T

RrT 9T<!ATTLIST text:alphabetical-intex-source
text:combine-entries %boolean; "true"
text:combine-entries-with-tash %boolean; "false"
text:combine-entries-with-pp %boolean; "true"<o oTE 4 oT Ti n

u1u1.iu1t i 1 Iu 9n inde. mark ior the tord Ass oiiSrs on pages 95s 96s 9ms and 9rc The entries ian be iormatted as ioaaots:
E1 IyienI 4

ti49

R 9rT

eparate entries

X Lcccccccccccccccccccccccccccccccccccccc 95
X Lcccccccccccccccccccccccccccccccccccccc 96
etic

impae iombined entries

X Lcccccccccccccccccccccccccccccccccccccc 95s 96s 9ms 9r

Entries iombined tith dash

X Lcccccccccccccccccccccccccccccccccccccc 95-9r

Entries iombined tith pp

X Lcccccccccccccccccccccccccccccccccccccc 95pp

se 2eys as Entries
n addition to a keytords inde. marks ian hare Sp to tto keysc
rg i nt T

text:use-keys-as-entries

RrT 9Ti the raaSe oi this atttribSte is trues the keys are Ssed as additionaa entriesc
i the raaSe oi this attribSte is falses the keys are Ssed as sSb-entriesc

o oT<!ATTLIST text:alphabetical-intex-source text:usekeys-as-entries %boolean; "false"<

Chapter 7 Indexing465

Capitaaike Entries
The text:capitalive-entries attribSte determines thether or not the OpenOiiiiecorg soittare iapitaaikes aaa entries in the inde.crg i nt T

text:capitalive-entries

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST text:alphabetical-intex-source text:
capitalive-entries %boolean; "false"<

Comma eparated Entries
The text:comma-separatet attribSte speiiiies hot to treat mSatipae inde. entriesc nstead oi aisting eaih
inde. entry on a separate aines the OpenOiiiiecorg soittare ian aist mSatipae entries on a singae aine separated by aiommacrg i nt T

text:comma-separatet

RrT 9Ti the raaSe oi this attribSte is trues mSatipae entries are aisted on a singae aine
separated by a iommac
By deiaSats the raaSe oi this attribSte is false and eaih inde. entry is
dispaayed on a separate ainec<!ATTLIST text:alphabetical-intex-source text:
comma-separatet %boolean; "false"<

o oT

mc02c

aphabetiiaa nde. Entry Tempaate

aphabetiiaa inde.es sSpport three aereas; one aerea ior the main inde. entrys and Sp to tto additionaa aereas ior
keys assoiiated tith the inde. entriesc aphabetiiaa inde.es aaso Sse an entry tempaate ior the aaphabetiiaa separatorc
rg i nt T<text:alphabetical-intex-entry-template<aphabetiiaa inde.es sSpport the ioaaoting ihiad eaements:

RrT 9To oT●

text:intex-entry-chapter●

text:intex-entry-page-number●

text:intex-entry-text●

text:intex-entry-span●

text:intex-entry-tab-stop<!ELEMENT alphabetical-intex-entry-template( text:intex-entry-chapter |text:intex-entry-page-number |text:intex-entry-text |text:intex-entry-span |text:intex-entry-tab-stop ya<

The attribStes that yoS ian assoiiate tith the <text:alphabetical-intex-entry-template<eaements are:●466

Tempaate oStaine aerea

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●Paragraph styae

Tempaate OStaine Lerea
This attribSte speiiiies thether the tempaate appaies to:●

One oi the three aereas 0s sor 4

or●The aaphabetiiaa separator

rg i nt T

text:outline-level

RrT 9TThe raaSe oi this attribSte ian be 1s 2s 3s or separatorc
YoS iannot hare sereraa <text:outline-level< eaements ior the sameoStaine aerea tithin the same parent eaementc<!ATTLIST text:table-of-content-entry-template
text:outline-level (1|2|3|separatory teEt|IeEt<o oT

Paragraph tyae
The text:style-name attribSte speiiiies the paragraph styae to Sse ior the tempaatec
rg i nt T

text:style-name

RrT 9To oT<!ATTLIST text:table-of-content-entry-template
text:style-name %styleName; teEt|IeEt<

mc00 Bibaiography
bibaiography inde. gathers its entries irom bibaiography inde. marksc The <text:bibliography< eaement
represents a bibaiographyc
rg i nt T<text:bibliography<

RrT 9To oT<!ELEMENT text:bibliography (text:bibliography-source, text:
intex-botyy<<!ATTLIST text:bibliography text:style-name %styleName;tIMPLIEt<

mc00c0 Bibaiography nde. oSrie
The <text:bibliography-source< eaement speiiiies hot the bibaiography is generatedc

Chapter 7 Indexing467

rg i nt T

<text:bibliography-source<

RrT 9T

This eaement does not hare an assoiiated attribStesco oT<!ELEMENT text:alphabetical-intex-source( text:intex-heater-template?,
text:bibliography-entry-templateay <oT
1 4 un1
Tu u 4 un1T

Bibaiography do not iSrrentay sSpport the iommon inde. soSrie attribStes desiribed in eition
mc0c5cmc00c Bibaiography Entry Tempaate
Bibaiography entry tempaates sSpport entry eaements ior bibaiography datas te.t spanss and tab stopsc There is one
entry tempaate eaement ior eaih type oi entryc
rg i nt T<text:bibliography-entry-template<RrT 9T

This eaement sSpports the ioaaoting ihiad eaements:

o oT

●

text:intex-entry-span●

text:intex-entry-tab-stop●

text:intex-entry-bibliography-tata-fielt<!ELEMENT text:bibliography-entry-template( text:intex-entry-span |text:intex-entry-tab-stop |text:intex-entry-bibliography-tata-fielt ya<

The attribStes that yoS ian assoiiate tith the <text:bibligraphy-entry-template< eaements are:●Bibaiography type●

Paragraph styae

Bibaiography Type
This attribSte speiiiies to thiih type oi bibaiographiiaa entry the tempaate appaiesc
rg i nt T

text:bibliography-type

RrT 9T

This attribSte mSst be SniqSe among aaa <text:bibliography-type<eaements tithin the same parent eaementc

o oT<!ATTLIST text:bibliography-entry-template
text:outline-level( article | book | booklet | conference |custom1 | custom2 | custom3 | custom: |custom4 | email | inbook | incollection |inproceetings | iournal | manual |mastersthesis | misc | phtthesis |proceetings | techreport | unpublishet |www y teEt|IeEt<

Paragraph tyae
The text:style-name attribSte speiiiies the paragraph styae to Sse ior this tempaatec
468

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

text:style-name

RrT 9To oT<!ATTLIST text:table-of-content-entry-template
text:style-name %styleName; teEt|IeEt<

Chapter 7 Indexing

469

CHAPTERr

8

Chart Content
This ihapter desiribes OpenOiiiiecorg X L ihart iontentc t iontains the ioaaoting seitions:●

ntrodSition to Chart DoiSments

●

Chart

●

Titae

●

Sbtitae●

Legend●Paot rea

●

Daaa

●

Faoor

●

.is

●

eries

●

Categories●

Data Point●

Common Chart Properties

rc0

ntrodSition to Chart DoiSments
n OpenOiiiiecorg X Ls ihart doiSments are aatays iontained tithin other X L doiSmentsc There are tto
types oi iontainer ihart doiSments:●

DoiSments that do not proride data ior the ihart
The ihart data is iontained in a <table:table< eaement inside the <chart:chart< eaementc●

DoiSments that proride data ior the ihart
The ihart data may be iontained in a <table:table< eaement in the parent doiSments ior e.ampaes in a
spreadsheet or te.t doiSmentc

To reierenie the iorreit tabae and tabae ieaass yoS ian Sse the table:cell-range-attress attribStessthiih are appaied to the achart:plot-area< eaement that represents the risSaaikation iontainer oi aaa data
series in the ihartc

471

rc

Chart
The ihart eaement represents an entire iharts iniaSding titaess a aegend s and the graphiiaa objeit that risSaaikes theSnderaying data iaaaed the paot areac The data Snderaying the ihart is represented by a tabae eaementc This eaement
may aaso e.ist ior embedded iharts that get the data irom the iontainer doiSmentc n this iase the ihart ian berendered tithoSt getting the data irom the iontainer doiSmentc
rg i nt Ti<chart:chart<

RrT 9Tio oT<!ELEMENT chart:chart( chart:plot-area,
chart:title?,
chart:subtitle?,
chart:legent?
table:table? y<

Caass
The iaass attribSte speiiiies the ihart typec i yoS need to speiiiy the type more preiiseay there are additionaa
properties that yoS ian assign Ssing styaesc For e.ampaes ii yoS tant to speiiiy a 4D bar ihart tith horikontaa
barss yoS mSst set the iaass attribSte to bar and yoS mSst set the properties ior three dimensionaa and horikontaa
arrangement in the iorresponding styae attribStec
rg i nt Ti

chart:classRrT 9Ti

The raaSe oi this attribSte ian be one oi the main iategories oi ihart types: lines areas
circles rings scatters ratars bars or stockc The raaSe bubble is not yet sSpportedby the <chart:chart< eaementcoT
1 4 un1
Tu u 4 un1T

CSrrentays this attribSte is onay sSpported by the <chart:chart< eaementc

o oT<!ENTITY % chart-class "(line|area|circle|ring|scatter|
ratar|bar|stock|bubble|att-iny"<<!ATTLIST chart:chart
chart:class %chart-class; teEt|IeEt
chart:att-in-name %string; tIMPLIEt
svg:witth %length; tIMPLIEt
svg:height %length; tIMPLIEt
chart:column-mapping %string; tIMPLIEt
chart:row-mapping %string; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <The att-in-name attribSte iontains the serriie name oi a ihart type addin that is Ssed ii the chart-classis set to att-inc That is a NO serriie that is registered in the oiiiie and is iapabae oi rendering a ihartc
The svg:witth and svg:height attribStes deiine the e.tent oi the entire ihartc Normaaays the sike oi theihart is determined by the sike oi the tindot in thiih the ihart is dispaayedc YoS ian set these attribStes as areierenie sikes so that positions and sikes in sSb-eaements ian be adaptedc
The chart:column-mapping and chart:row-mapping attribStes iontain ii prorided a aist oi inde.es oi
seriesc The nSmbers deiine a reordering oi data that iomes irom a iontainer doiSment that prorides the data ior
the ihartc aist oi asiending nSmbers beginning tith 0 has no eiieitc i yoS tant to e.ihange tto seriess yoS
mSst trite the nSmbers in e.ihanged orders ior e.ampaes 1 3 2 :, to e.ihange the seiond and the third seriesc
The nSmbering begins tith 0c Note that yoS ian onay Sse one oi the tto attribStesc

472

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Generaa tyae Properties
The siaae te.t property aaaots yoS to speiiiy that aaa te.t objeits in the ihart shoSad be siaaed thenerer the sikeoi the ihart ihanges c
rg i nt Ti

chart:scale-text

RrT 9Ti

To enabae siaaings set the raaSe oi this property to truec

o oT<!ATTLIST style:properties chart:scale-text %boolean;"true" <To set the baikgroSnd properties ior a achart:chart< eaements yoS ian Sse the Fiaa Properties idesiribed ineition rc04c0o and the troke Properties idesiribed in eition rc04c oc

rc4 Titae
The titae eaement represents a main titae objeit in a ihart doiSmentc
rg i nt Ti<chart:title<RrT 9Ti

This eaement ian iontain ii.ed te.t or it ian iontain a <table:cell-attress< eaement
pointing to the te.t that shoSad be dispaayed as the titaec
This eaement ian aaso be a sSb-eaement oi chart:axis,see eition rc c n this iase the titae
is dispaayed beside the a.is objeitcoT
1 4 un1
Tu u 4 un1T

CSrrentays onay inpaaie titaes are sSpportedc

o oT<!ELEMENT chart:title text:p?<<!ATTLIST chart:title
table:cell-range %cell-attress; tIMPLIEt
svg:x %Coortinate; tIMPLIEt
svg:y %Coortinate; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <Properties
YoS ian appay iiaa and stroke properties to the sSrroSnding titae bo.c ee eitions rc04c0 and rc04c ior moreiniormationc YoS ian aaso appay te.t properties to the titae te.t itseais see eition rc04c4c YoS ian aaso appay tto
aaignment propertiess Orientation and otation ngaes see eition rc04c9c

rc9

Sbtitae
The sSbtitae eaement represents a sSbtitae thiih ian be Ssed ior additionaa titae iniormation in a ihartc The strSitSre oi the sSbtitae eaement is simiaar to that oi the titae eaementc

Chapter 8 Chart Content

473

rg i nt Ti<chart:subtitle<RrT 9TioT
1 4 un1
Tu u 4 un1T

CSrrentays onay inpaaie titaes are sSpportedc

o oT<!ELEMENT chart:subtitle text:p?<<!ATTLIST chart:subtitle
table:cell-range %cell-attress; tIMPLIEt
svg:x %Coortinate; tIMPLIEt
svg:y %Coortinate; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <Properties
YoS ian appay the same properties to the <chart:subtitle< eaement as yoS ian appay to the <chart:
title< eaementc ee eition rc4 ior more iniormationc

rc5 Legend
The aegend eaement determines thether or not a aegend is dispaayed in the ihartc YoS ian set either a reaatire oran absoaSte position ior the aegendc The sike oi the aegend is iaaiSaated aStomatiiaaay and thereiore iannot be set
as attribStec
rg i nt Ti<chart:legent<

RrT 9Tio oT<!ELEMENT chart:legent EMPTY<<!ATTLIST chart:legent
chart:legent-position (top|left|bottom|righty "right"
svg:x %Coortinate; tIMPLIEt
svg:y %Coortinate; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <Properties
YoS ian appay iiaa and stroke properties to the aegend objeits see eitions rc04c0and rc04c c YoS ian aaso set te.t
properties ior the te.t inside the aegend objeits see eition rc04c4c

rc6 Paot rea
The paot area eaement is a iontainer ior the graphiis objeits that represent ihart datac The main pSrpose oi thepaot area is to be a iontainer ior the series eaements that represent singae data seriess and the a.is eaementsc

474

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<chart:plot-area<

RrT 9Tio oT<!ELEMENT chart:plot-area(chart:seriesa,
chart:axisa,
chart:wall?,chart:floor?y <<!ATTLIST chart:plot-area
svg:x %Coortinate; tIMPLIEt
svg:y %Coortinate; tIMPLIEt
svg:witth %length; tIMPLIEt
svg:height %length; tIMPLIEt
table:cell-range-attress %cell-range-attress;tIMPLIEt
chart:table-number-list %string; tIMPLIEt
chart:tata-source-has-labels (none|row|column|
bothy "none" <chart:style-name %style-name; tIMPLIEt <The styae that yoS appay to the paot area eaement is Ssed ior aaa data eaements iontained inside the paot areas Snaess
yoS speiiiy e.tra styaes in one oi those sSb eaementsc These data eaements ian be achart:series< andachart:tata-point< eaementsc
i the position and sike attribStes are not speiiiieds the raaSes are iaaiSaated by the render appaiiationc
i a ihart is embedded in a doiSment that prorides the data ior the iharts the table:cell-range-attress
attribSte reiaeits the ranges irom thiih aaa the data ior the ihart iomesc The range giren here is interpreted by theihart as ionseiStire seriesc i the iirst rot or ioaSmns or both iontains aabeass this is stated by the chart:tatasource-has-labels attribStec
The chart:table-number-list is neiessary ior storing Caai doiSments in the oad binary iormatc The
attribSte mSst be stored sinie this iniormation ian not be obtained easetherec The aist ionsists oi inde.es oi sheets
oi the Caai doiSmentc There is an inde. ior eaih range in the table:cell-range-attress eaement
iontaining the inde. oi the sheet iontaining the reierred ieaasc
The onay pSrpose oi the styae attribSte is to store siene properties ior three-dimensionaa ihartsc

Properties
i the ihart is three-dimensionaas yoS ian appay siene properties to the paot areac ee the ihapter entitaed heapiic
hontent ior more iniormationc

Sbtype Properties
se these properties to iSstomike the basii ihart type set in the <chart:chart< eaementc

Chapter 8 Chart Content

475

rg i nt Ti

chart:stock-uptown-bars
chart:stock-with-volume
chart:three-timensional
chart:teepchart:lines
chart:percentage
chart:solit-type
chart:splines
chart:stacket
chart:symbol
chart:verticalchart:lines-uset
chart:connect-bars

RrT 9Ti

The chart:teep property is onay reaerant tith the chart:three-timensional
propertyc
The chart:symbol property is onay reaerant tith the chart:lines-uset propertyc
The chart:vertical and chart:connect-bars properties are ior bar iharts onayc
The chart:stock-uptown-bars and chart:stock-with-volume properties
are onay eiieitire ior stoik ihartsc

o oT<!ATTLIST style:properties
chart:stock-uptown-bars %boolean; "false"
chart:stock-with-volume %boolean; "false"
chart:three-timensional %boolean; "false"
chart:teep %boolean; "false"
chart:lines %boolean; "false"
chart:percentage %boolean; "false"
chart:solit-type %chart-solit-type; "cuboit"
chart:splines %nonNegativeInteger; "0"chart:stacket %boolean; "false"
chart:symbol %integer; "-1"chart:vertical %boolean; "false"
chart:lines-uset %nonNegativeInteger; "0"chart:connect-bars %boolean; "false"<

rcm Daaa
The taaa eaement ian be iontained in the paot area eaementc For tto-dimensionaa ihartss the taaa eaement spansthe entire paot areac For three-dimensionaa ihartss the taaa eaement SsSaaay ionsists oi tto perpendiiSaar reitangaesc YoS ian Sse the tidth attribSte to set the tidth oi a taaa ior three-dimensionaa ihartsc
rg i nt Ti<chart:wall<RrT 9Ti

476

oT
1 4 un1
Tu u 4 un1T

OpenOiiiiecorg Chart does not yet sSpport the tidth oi the taaac Daaas are aatays dratn as
kero-tidth reitangaesc

o oT<!ELEMENT chart:wall EMPTY<<!ATTLIST chart:wall
svg:witth %length; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Properties
YoS ian appay iiaa and stroke properties to a taaac ee eitions rc04c0 and rc04c ior more iniormationc

rcr Faoor
The iaoor eaement ian be iontained in the paot area eaementc For three-dimensionaa ihartss the iaoor eaement ispresent in addition to the taaa eaementc The sike oi the iaoor is determined in respeit oi the sike oi the paot areas
thiih is aatays a tto-dimensionaa reitangae that serres as a boSnding reitangae oi the three-dimensionaa sienec
YoS ian Sse the tidth attribSte to set the tidth oi the iaoorc
rg i nt Ti<chart:floor<

RrT 9TioT
1 4 un1
Tu u 4 un1T

OpenOiiiiecorg Chart does not yet sSpport the iaoor thiiknessc The iaoor thiikness is aatays aii.ed tidthc

o oT<!ELEMENT chart:floor EMPTY<<!ATTLIST chart:floor
svg:witth %length; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <Properties
YoS ian appay iiaa and stroke properties to a iaoorc ee eitions rc04c0 and rc04c ior more iniormationcrc.is
The a.is eaement mainay iontains styae iniormations in partiiSaar siaaing iniormationc Chart data is SsSaaay strSitSred as ioaaots:●

ereraa data series eaih ionsisting oi a names ior e.ampaes the name oi a iompanyc●

VaaSess ior e.ampaes the yiead oi the iompany in diiierent yearsc●

One raaSe in eaih series beaongs to a iategorys ior e.ampaes the yearc
u.rI Ti r4I it4 4i41tiu 9iI oI 9 1 4 un1

Chapter 8 Chart Content

477

categories
row

View

10
9
8
7
6

Members of Series

Name 1Name 2Name 3

5

name
cell

4
3
2
1
0
Category 1

Category 2

Category 3

Category 4

valuesrow

10
98

aomain

7
6

row

5

Sor scatter ana
bubble charts

Name 1Name 24
3
2

aomain1

row

0

Sor bubble charts

2

3

4

5

6

7

8

9

10

rg i nt Ti<chart:axis<

RrT 9Tise the chart:axis-class attribSte to speiiiy thiih type oi data the a.is is assoiiated
tithc

o oT

<!ELEMENT chart:axis (chart:title?,chart:grit?y<<!ATTLIST chart:axis
chart:axis-class (category|value|series|tomainy teEt|IeEt
chart:axis-name %string tIMPLIEt;
chart:style-name %style-name; tIMPLIEt <rII 1 iu oT

1 4 un1iTu u 4 un19T●

Titaes are onay sSpported ior a ma.imSm oi one a.is per iaassc●

OpenOiiiiecorg Chart onay sSpports the ioaaoting a.ess the nSmbers in parenthesis indiiating hot iar the
raaSe ian e.tended:

ouI o un1

1o
r

2o
I

A 4or4 T

category2-

tomain iior siattersbSbbae ihartso

I

A 4or4 T

0i -9o2

0i4-9o0i4-9o-0i -9o

2

2

-

-

value
seriesr

Deiining .es
Oere are some gSideaines ior deiining a.es in a ihart doiSment:
0c The iirst a.is yoS might tant to appay to a ihart is an a.is representing iategoriesc To do thiss yoS insert an
478

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

a.is eaement tith the axis:class attribSte set to categorycc Ne.ts yoS insert an a.is shoting a siaae ior yoSr raaSesc To do thiss yoS insert an a.is eaement tith theaxis:class attribSte set to valuec
4c n three-dimensionaa iharts the names oi the seriess that are SsSaaay dispaayed in the aegends ian aaso be
dispaayed on an a.isc To do thiss insert an a.is eaement tith the axis:class attribSte set to seriesc
9c i yoS hare a siatter or bSbbae iharts eaih series has a domain oi raaSes speiiiying the .-ioordinates and yioordinate ior bSbbae ihartss apart irom the raaSes that are to be risSaaikedc For these types oi ihartss yoS ian
insert an a.is eaement tith the axis:class attribSte set to tomains thiih tiaa resSat in an a.is simiaar to
the a.is desiribed in tep c5cihart ian iontain more than one a.is oi the same typec For e.ampaes ii yoS hare tto raaSe a.ess data series
ian be attaihed to either a.isc This tay data ian be groSped ior diiierent siaaingc To attaih a speiiiii a.is to aseries eaement yoS mSst reier to the a.is by the chart:axis-name attribStec The a.is name is reqSiredthenerer yoS intend to attaih data series to an a.isc Othertise the a.is beiomes a iopy oi an e.isting a.is oi
the same iaassc

The position oi an a.is in a ihart is determined by the render appaiiation and depends on the ihart typec i yoS
hare a ihart tith horikontaa barss the render appaiiation SsSaaay paints the raaSe a.is on the bottom oi the paot
areac i yoS hare tto raaSe a.ess a render appaiiation might paint the seiond a.is at the top oi the paot areacn T i yoSr data ionsists oi nSmbers onay and yoS tant to ireate a siatter iharts the a.is representing the raaSes
irom the .-a.is mSst hare the axis:class attribSte set to tomain aathoSgh yoSr domain ionsists oi raaSesc
E 4 oT TiB4Iior4I
n this e.ampaes there are tto raaSe a.es and one a.is has the name primary-valuec YoS ian attaih a data
series to that named a.is by Ssing the namec There is no data attaihed to the seiond a.iss thereiore yoS do notneed to speiiiy a name and the a.is is jSst a iopy oi the iirst onec
<chart:chart chart:classp"bar"<<chart:title<<text:p<Title of my chart</text:p<</chart:title<<chart:plot-area<...
<chart:axis chart:axis-classp"category" chart:axis-namep"x"/<<chart:axis chart:axis-classp"value" chart:axis-namep"primary-value"/<<chart:axis chart:axis-classp"value"/< <!-- copy of previous axis --<...
<chart:series chart:values-attressp"Sheet1.A1:.A:"
chart:attachet-axis-namep"primary-value"/<...
</chart:plot-area<</chart:chart<

Generaa Properties
YoS ian appay stroke properties to a.ess see eition rc04c c These properties aiieit aaa aines oi the a.is objeitc
YoS aaso ian appay te.t properties to a.ess see eition rc04c4c These properties aiieit the appearanie oi aaa te.t
objeitsc

NSmber Format Properties
YoS ian appay nSmber iormat properties to a.ess thiih aiieit the nSmbers dispaayed beside the a.isc ee eition
Chapter 8 Chart Content

479

ior iniormation on nSmber iormat propertiesc i yoS omit these propertiess the standard nSmber iormat is Ssedc i
the ihart is embedded in a spreadsheet and yoS omit the nSmber iormat propertiess the nSmber iormat is taken
irom the nSmber iormat settings oi the spreadsheet ieaas that iontain the ihart datac
o oT<!ATTLIST style:properties
style:tata-style-name %style-name; tIMPLIEt
chart:link-tata-style-to-source %boolean; "true" <The chart:link-tata-style-to-source attribSte ian onay be Ssed in ihart doiSments that reside in a
doiSment that prorides the data ior the ihartc i the raaSe oi the attribSte is trues the nSmber iormat Ssed ior
rendering the a.is is the iormat that the iontainer doiSment sSggests based on the seaeited ieaa rangec For
e.ampaes ii yoS hare a ieaa range tith iSrreniies aaa iormatted in hs yoS tiaa aaso get this iormat at this a.isc

Visibiaity Property
To determine thether or not an a.is objeit is risibaes Sse the chart:axis-visible styae propertyc This tays
yoS ian proride a ihart tith siaaing iniormation tithoSt dispaaying the a.is objeitc
rg i nt Ti

chart:axis-visible

RrT 9Tio oT<!ATTLIST style:properties chart:axis-visible %boolean;"true" <iaaing Properties
i a siaaing attribSte is omitteds the a.is is set to adaptation modec This means that the raaSe is not set to a ii.ed
raaSe bSt may be ihanged by the render appaiiation ii data ihangesc Ooterers the chart:axislogarithmic attribSte is set to falsec
o oT<!ATTLIST style:properties
chart:axis-minimum %float; tIMPLIEt
chart:axis-maximum %float; tIMPLIEt
chart:axis-interval-maior %float; tIMPLIEt
chart:axis-interval-minor %float; tIMPLIEt
chart:axis-origin %float; tIMPLIEt
chart:axis-logarithmic %boolean; "false"<

Tiikmark Properties
The tiikmark properties aaaot yoS to speiiiy the e.istenie oi tiikmarks at an a.isc The major marks are dratn
tith respeit to the major interraa that may be speiiiied by the chart:axis-interval-maior attribStec The
minor tiik marks reier to the chart:axis-interval-minor attribStec nner marks are dratn totards theinside oi the paot areas that is to the right ior an a.is dispaayed on the aeit hand side oi the paot areas and to the aeit
ior an a.is dispaayed on the right hand side oi the paot areac OSter marks point in the opposite direitionc i bothproperties are speiiiieds one tiik mark is dratn that irosses the a.isc

480

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti

chart:axis-ticks-maior-innerchart:axis-ticks-maior-outerchart:axis-ticks-minor-innerchart:axis-ticks-minor-outerRrT 9Tio oT<!ATTLIST style:properties
chart:axis-ticks-maior-inner %boolean; "false"
chart:axis-ticks-maior-outer %boolean; "true"
chart:axis-ticks-minor-inner %boolean; "false"
chart:axis-ticks-minor-outer %boolean; "false" <Desiription Properties
The desiription properties iniaSenie the desiriptire te.t Snderneath the a.is objeitc
rg i nt Ti

chart:axis-show-textstyle:rotation-angle
chart:axis-text-overlap
chart:axis-text-breakRrT 9Tio oT<!ATTLIST style:properties
chart:axis-show-text %boolean; "true"style:rotation-angle %integer; "0"chart:axis-text-overlap %boolean; "false"
chart:axis-text-break %boolean; "true" <rc c0 Grid
Grids ian be added to a.is eaementsc i yoS appay a major grid to an a.iss the major tiikmarks are e.tended togridainesc i a grid is minors any minor tiikmarks assigned to the a.is are Ssedc
rg i nt Ti<chart:grit<RrT 9Tio oT<!ELEMENT chart:grit EMPTY<<!ATTLIST chart:grit grit:class (maior|minory "maior"chart:style-name %style-name; <Generaa Properties
YoS ian appay stroke properties to gridss thiih aiieit the aines oi the gridc ee eition rc04c ior iniormation onthese stroke propertiesc

rc02 eries
The series eaement represents a data series in a ihartc

Chapter 8 Chart Content

481

rg i nt Ti<chart:series<

RrT 9TioT
1 4 un1
Tu u 4 un1T

OpenOiiiiecorg Chart does not iSrrentay sSpport the chart:class attribSte ior a seriesc
YoS ian onay set this attribSte ior an entire ihartc

o oT<!ELEMENT chart:series (chart:class?,
chart:tomaina,
chart:tata-pointa y<<!ATTLIST chart:series
chart:values-cell-range-attress %cell-rangeattress; tIMPLIEt
chart:label-cell-attress %cell-attress; tIMPLIEt
chart:class %chart-class; tIMPLIEt
chart:style-name %style-name; tIMPLIEt <The chart:values-cell-range-attress attribSte aaaots yoS to speiiiy a range that iontains the raaSes
that shoSad be risSaaiked by this data seriesc The chart:label-cell-attress attribSte aaaots to proride aname ior the seriesc i the ihart reqSires more inpSt data aike siatter and bSbbae ihartss yoS mSst deiine chart:tomain sSb-eaements that mainay iontain the cell-range-attress oi the iorresponding datac

Generaa Properties
YoS ian appay iiaa and stroke properties ior seriess see eitions rc04c0 and rc04c ior iniormationc YoS ian aaso
appay te.t properties to the desiriptire te.t Snderneath the seriess see eition rc04c4 ior iniormationc

rc02c0 Domain
For siatter and bSbbae ihartss yoS mSst speiiiy a domain ior the seriesc For e.ampaes one cell-rangeattress raaSe that points to the ioordinate raaSes ior the siatter iharts or tto cell-range-attress
raaSes ior the . and y ioordinate raaSes ior bSbbae ihartsc For these ihart typess yoS need at aeast one series tith
the neiessary nSmber oi domain sSb-eaementsc aa other series ian omit theses the iirst domain speiiiied is Ssedc
rg i nt Ti<chart:tomain<RrT 9TioT
1 4 un1
Tu u 4 un1T

n OpenOiiiiecorg Charts yoS ian onay gire one range addresss thiih may be iompoSnds irom
thiih raaSes are taken in a ii.ed orderc For e.ampaes in siatter iharts the iirst rotsioaSmn
speiiiies the .-raaSes ior aaa seriess the seiond rotsioaSmn represents the raaSes oi the iirst
series and so onc

o oT<!ELEMENT chart:tomain EMPTY<<!ATTLIST chart:tomain chart:coortinate-attress %cell-rangeattress; teEt|IeEt <rc00 Categories
The iategories eaement represents the range oi ieaa addresses that iontains the iaptions ior the iategories
iontained in eaih seriesc

482

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt Ti<chart:categories<

RrT 9TioT
1 4 un1
Tu u 4 un1T

OpenOiiiiecorg Chart does not iSrrentay sSpport the chart:class attribSte ior a seriesc
YoS ian onay set this attribSte ior an entire ihartc

o oT<!ELEMENT chart:categories EMPTY<<!ATTLIST chart:categories
table:cell-range-attress %cell-range-attress; <rc0 Data Pointi a singae data point in a data series shoSad hare a speiiiii appearanies the data point eaement is Ssed to appay thereqSired propertiesc
rg i nt Ti<chart:tata-point<

RrT 9Tio oT<!ELEMENT chart:tata-point<<!ATTLIST chart:tata-point chart:intex %nonNegativeInteger;
teEt|IeEt chart:style-name %style-name; <Generaa Properties
YoS ian appay iiaa and stroke properties to eaih data point objeits see eitions rc04c0 and rc04c c YoS ian aaso
appay te.t properties to the desiriptire te.t aoiated Snderneath the data pointss see eition rc04c4c

rc04 Common Chart Properties
The properties desiribed in this seition appay to aaa types oi data representation objeitss iniaSding the eaements<chart:plot-area<s <chart:series<s and <chart:tata-point<cProperties are appaied in a hierarihiiaa mannerc i a property is set in the <chart:chart< eaements it appaies to
aaa data points iontained in the ihartc i the same property is set in a <chart:series< eaements it onay appaies
to the data points iontained in that speiiiii seriesc To set a iormatting property ior one data point onays yoS shoSad
set the property in the <chart:tata-point< eaementc

rc04c0 Fiaa Properties
The iiaa properties appay to aaa soaid objeits aike reitangaes or iiriaesc ee eition Chapter 5 ior iniormation on iiaa
propertiesc

rc04c

troke Properties

The stroke properties appay to aaa aine objeits aike the a.iss grids or ainear parts oi a reitangae or iiriaec ee
Chapter 5 ior iniormation stroke propertiesc

Chapter 8 Chart Content

483rc04c4 Te.t Properties
The te.t properties appay to aaa objeits that dispaay te.ts ior e.ampaes the legents titles subtitles axiss
charts series, and tata-pointc ee Chapter 4 ior iniormation on te.t propertiesc

rc04c9aignment Properties

The aaignment properties desiribed in this seition appay to sereraa te.t objeitsc They determine the tay te.t ispositioned inside the sSrroSnding bo.c

taiked Te.t
This property determines thether or not te.t is dispaayed rertiiaaay tithoSt rotating the aettersc
rg i nt Ti

chart:text-stacket

RrT 9Ti

The raaSe oi this property ian be ltr ii te.t goes irom aeit to right or ttb ii the te.t is
staikeds that is goes irom top to bottomc

o oT<!ATTLIST style:properties fo:tirection (ltr|ttby tIMPLIEt<

otation ngae
The style:rotation-angle property speiiiies the raaSe oi a rotation angae in degreesc ee Chapter 9 ior
iniormation on Ssing this propertyc

rc04c5 Data Labea Properties
Data aabeas ian be appaied to data series and data points as teaa as to an entire ihartc n the aatter iases aabeas are
shotn ior aaa data pointsc Data aabeas ian ionsist oi the ioaaoting three parts:●

The raaSes thiih ian be dispaayed as a perientage or the raaSe itseaic●

The aabea oi the iorresponding seriesc●

The aegend symboac

VaaSe
This attribSte represents the raaSe oi the data aabeac
rg i nt Ti

chart:tata-label-number

RrT 9Ti
o oT

484<!ATTLIST style:properties chart:tata-label-number (none|
value|percentagey "none" <OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

LabeaThis attribSte determines thether or not to dispaay the aabea oi the iorresponding seriesc
rg i nt Ti

chart:tata-label-text

RrT 9Ti

The raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST style:properties chart:tata-label-text %boolean;"false" <Legend ymboa
This attribSte determines thether or not to dispaay the aegend symboac
rg i nt Ti

chart:tata-label-symbol

RrT 9Ti

The raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST style:properties chart:tata-label-symbol %boolean;"false" <rc04c6 tatistiiaa Properties
tatistiiaa properties ian be appaied to data series or to an entire ihartc n the aatter iases the properties appay to aaa
series in the ihartc

ean VaaSe
This attribSte determines thether or not to dispaay a aine that represents the statistiiaa mean raaSe oi aaa data
points oi a seriesc
rg i nt Ti

chart:mean-value

RrT 9Ti

The raaSe oi this attribSte ian be true or falsec

o oT<!ATTLIST style:properties chart:mean-value %boolean;"false" <Error Category
This attribSte is Ssed to determine thiih iSnition is Ssed to dispaay error indiiators at data pointsc YoS ian set the
ioaaoting iSnitions:●

Varianie oi the raaSes oi a series assSming an eqSaa distribStionc●

tandard-deriation oi the raaSes oi a series assSming an eqSaa distribStionc●

se a ii.ed perientage oi eaih raaSe●

se a ii.ed perientage oi the biggest raaSe l this is iaaaed error-marginc●

se ii.ed absoaSte raaSes ior both direitions: positire and negatire

Chapter 8 Chart Content

485

rg i nt Ti

chart:error-categoryRrT 9Ti

i this attribSte is set to any raaSe other than none, error indiiators are shotnc To determine
in thiih direition the indiiators are pointing see the attribStes chart:error-upperinticator and chart:error-lower-inticatorc

o oT<!ATTLIST style:properties chart:error-category(none|variance|stantart-teviation|percentage|error-margin|
constanty "none" <Error Perientage
This attribSte determines the perientage that is Ssed to dispaay error indiiators ior eaih data point oi a seriesc
rg i nt T

chart:error-percentage

RrT 9Ti<!ATTLIST style:properties chart:error-percentage %float; <

o oT

Error

argin

This attribSte determines the perientage that is Ssed to dispaay error indiiators ior the biggest raaSe in a seriesc
rg i nt T

chart:error-margin

RrT 9Tio oT<!ATTLIST style:properties chart:error-margin %float; <Constant Error Loter and pper Limit
i yoS set the error iategory to constants these attribStes determine the absoaSte raaSes in a positire and negatire direition that are Ssed to dispaay the error indiiatorsc
rg i nt T

chart:error-lower-limit
chart:error-upper-limit

RrT 9Tio oT<!ATTLIST style:properties
chart:error-lower-limit %nonNegativeInteger; tIMPLIEt
chart:error-upper-limit %nonNegativeInteger; tIMPLIEt <Error ndiiators
The chart:error-lower-inticator and chart:error-upper-inticator attribStes determine inthiih direition indiiators shoSad be dratnc

486

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

chart:error-lower-inticator
chart:error-upper-inticator

RrT 9Tio oT<!ATTLIST style:properties
chart:error-lower-inticator %boolean; "false"
chart:error-upper-inticator %boolean; "false" <egression CSrres
se this attribSte to dispaay a regression ior a seriesc Dith a regression yoS ian appro.imate the data points yoS
hare in a series by a mathematiiaa iSnitionc YoS ian Sse one oi the ioaaoting modeas ior appro.imation:●

Linear regression l appro.imate the raaSes oi the series Ssing the modea: y●Logarithmii regression l appro.imate the raaSes oi the series Ssing the modea: yTLaogieo i Lc●

E.ponentiaa regression l appro.imate the raaSes oi the series Ssing the modea: y

TieLiec●

Tie i Lc

egression tith a poter iSnition l appro.imate the raaSes oi the series Ssing the modea: y g TieLc

rg i nt T

chart:regression-type

RrT 9Ti

This property is onay reaerant in siatter ihartss beiaSse regression needs both e and y raaSes ior
iaaiSaationo oT<!ATTLIST style:properties chart:regression-type(none|linear|logarithmic|exponential|powery "none" <rc04cmotation oi Three-Dimensionaa Diagrams

The atr3t:transform< eaement represents the rotation oi a ihart sienes that is the three-dimensionaa paot
areac The tr3t:transform eaement represents a ioSr-dimensionaa transiormation matri.c ee the ihapter entitaed heapiic hontent ior more iniormationc

Chapter 8 Chart Content

487

CHAPTER

9

ser nteriaie Content
This ihapter desiribes the OpenOiiiiecorg X L representation oi Sser interiaie iomponentsc Dhere possibaes theSser interiaie eaements iorrespond to the E.tensibae ser nteriaie LangSage iX Lo Sser interiaie eaementsc Thisenabaes Ssers to easiay migrate Sser interiaie eaements irom one aangSage to anotherc This ihapter iontains the
ioaaoting seitions:●enSbars●iieaerators●

tatSs bars●

Tooabars●

Erents●mages

YoS ian store Sser interiaie iontent in an OpenOiiiiecorg doiSment or in a gaobaa Sser ioniigSration oaikagec
Eaih OpenOiiiiecorg iomponents sSih as Driter or Caais has its otn ioniigSration ior menSss aiieaeratorss a
statSs bars and some tooabarsc ome tooabars are not ionte.t-dependent aike the iSnition barc Eaih menSbars
aiieaerators statSs bars tooabars or erents ioniigSration is stored as a sSbdoiSment in the gaobaa Sser ioniigSrationpaikage or in an OpenOiiiiecorg doiSmentc The name oi the sSbdoiSment desiribes the iontent oi the sSbdoiSments ior e.ampae writerstatusbar.xml iontains the tarDriter statSs bar ioniigSrationc

c0

enSbars
menS is a aist oi iommandss attribStess or states irom thiih a Sser ian ihoosec enSs are based on the interiaie
priniipae oi e ee-and-Pointrc menSbar is an area in the Sser interiaie there menSs residec
The menSbar spans Sp the iontainer top-aerea eaement ior aaa other menS eaements embedded in itc
n the OpenOiiiiecorg X L iiae iormats the ioaaoting basii rSaes appay to menSbars:●

YoS mSst aoiate <menu:menuitem<s <menu:menuseparator<s and <menu:menu< eaements in a<menu:menupopup< eaementc●

YoS ian not nest <menu:menubar< eaementsc

c0c0

enSbar

The <menu:menubar< eaement represents a menSbar that an OpenOiiiiecorg iomponent Sses and deiines theiontents and properties oi the menSbarc489

rg i nt T

<menu:menubar<

RrT 9T

This eaement is a iontainer eaement ior aaa other menS eaementsc

o oT<!ELEMENT menu:menubar (menu:menuty<<!ATTLIST menu:menubar
menu:it %menu-it; teEt|IeEt
xmlns:menu CtATA tFIXEt "http://openoffice.org/2001/
menu"<

The attribSte that yoS ian assoiiate tith the <menu:menubar< is:●dentiiier isee eition c0c6o

c0c

enS

The <menu:menu< eaement represents the titae oi a menS on the menSbarc This eaement ian be paaied on a
menSbar or as a sSbmenS inside a menSpopSpc
rg i nt T<menu:menu<

RrT 9T

Erery menS mSst hare a SniqSe D that represents the iSnition oi the menSco oT<!ELEMENT menu:menu (menu:menupopupy<<!ATTLIST menu:menu
menu:it %menu-it; teEt|IeEt
menu:label %menu-label; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <menu:menu< eaement are:●dentiiier isee eition c0c6o●Labea isee eition c0c6o

c0c4

enS PopSp

The <menu:menupopup< eaement represents the popSp bo. that appears then yoS iaiik on the menS titaec
rg i nt T<menu:menupopup<

RrT 9T

This eaement is a iontainer eaement ior menS itemss menS separatorss and sSbmenSsc

o oT<!ELEMENT menu:menupopup (menu:menuitem | menu:menuseparator |menu:menuyt<

There are no attribStes assoiiated tith this eaementc The eaement ian iontain the ioaaoting eaements:●<menu:menuitem<●<menu:menuseparator<●<menu:menu<

c0c9

enS tem

The <menu:menuitem< eaement represents an option on the menSc

490

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<menu:menuitem<

RrT 9T

Erery menS item mSst hare a SniqSe D that represents the iSnition oi the itemc

o oT<!ELEMENT menu:menuitem EMPTY<<!ATTLIST menu:menuitem
menu:it %menu-it; teEt|IeEt
menu:helpit CtATA tIMPLIEt
menu:label %menu-label; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <menu:menuitem< eaement are:●dentiiier isee eition c0c6o●Labea isee eition c0c6o●

Oeap identiiier

Oeap dentiiier
The menu:helpit attribSte speiiiies the heap identiiier ior the menS itemc
rg i nt T

menu:helpit

RrT 9TThe raaSe oi this attribSte is a string that speiiiies the heap identiiier ior the menS itemc

o oT<!ATTLIST menu:menuitem menu:helpit CtATA tIMPLIEt<

c0c5

enS eparator

The <menu:menuseparator< eaement separates groSps oi menS itemsc
rg i nt T<menu:menuseparator<

RrT 9To oT

E 4 oT Tih4 oT i<!ELEMENT menu:menuseparator EMPTY<

1r 4I

The ioaaoting e.ampae shots a menSbar tith one menS iaaaed Fiae and one sSbmenS iaaaed Netc
<menu:menubar menu:itp"test"<<menu:menu menu:itp"slot:4300" menu:labelp"eFile"<<menu:menupopup<<menu:menu menu:itp"slot:4:00" menu:labelp"eNew"<<menu:menupopup<<menu:menuitem menu:itp"macro:currency/euro" menu:labelp"eEuro
converter"/<</menu:menupopup<</menu:menu<<menu:menuitem menu:itp"slot:4301" menu:labelp"eOpen"/<</menu:menupopup<</menu:menu<</menu:menubar<

Chapter 9 User Interface Content

491

c0c6 Common

enSbar ttribStes

YoS ian assoiiate the attribStes desiribed in this seition tith the menSbar eaementsc

dentiiier
The menu:it attribSte speiiiies a SniqSe string that identiiies the iSrrent menS iomponent and deiines theoperation that is e.eiStedc
rg i nt T

menu:itRrT 9TThe raaSe oi this attribSte mSst be a SniqSe string tithin a menSc The attribSte deiines the opera tion that is e.eiSted aiter aitirationc Normaaay this is a iommand
L sSih as esaot:5524r that
represents a iSnitionc

o oT<!ENTITY % menu:it "CtATA"<<!ATTLIST menu:menuitem menu:it %menu-it; teEt|IeEt<

Labea
The menu:label attribSte speiiiies the te.t that appears on the menS or menS items sSih as Fiae or Editc
rg i nt T

menu:label

RrT 9T

This attibSte iontains the te.t oi a menS or menS itemc
YoS ian Sse the speiiaa iharaiter e~r to speiiiy the key that the Sser ian press to aitirate themenS or menS itemc This aetter is typiiaaay Snderained in the te.t aabeac For e.ampaes Sse e~Fiaers
to speiiiy that the aetter F aitirates the menSc

o oT

c

<!ENTITY % menu:label "CtATA"<<!ATTLIST menu:menuitem menu:label %menu-label; tIMPLIEt<

iieaeratorsn aiieaerator binds a menS iommand to a keyboard shortiStc This enabaes a Sser rSn a iommand by pressing a
seqSenie oi keys on the keyboard instead oi aiiessing a menS itemc
n the OpenOiiiiecorg X L iiae iormats the ioaaoting basii rSaes appay to aiieaerators:●

YoS mSst iniaSde aaa <accel:item< eaements in an <accel:acceleratorlist< eaementc●

YoS ian not nest <accel:acceleratorlist< eaementsc

aa aiieaerator deiinitions are iontained in a sSbdoiSment oi an OpenOiiiiecorg X L doiSment or in thesoffice.cfg paikage ior the gaobaa Sser settingsc

c c0

iieaerator List

The <accel:acceleratorlist< eaement is a iontainer eaement ior aaa aiieaerator itemsc

492

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<accel:acceleratorlist<

rg i nt Taa aiieaerator items are embedded in this eaementc

RrT 9T<!ELEMENT accel:acceleratorlist (accel:itemay<<!ATTLIST accel:acceleratorlist
xmlns:accel CtATA tFIXEt "http://openoffice.org/2001/
accel"
xmlns:xlink CtATA tFIXEt "http://www.w3.org/1999/
xlink"<o oT

There are no modiiiabae attribStes assoiiated tith this eaementc

c ciieaerator tem

The <accel:item< eaement speiiiies the keyboard shortiSt and the iommand to e.eiStec
rg i nt T<accel:item<

RrT 9TYoS mSst speiiiy raaSes ior the xlink:href and the accel:cote attribStesco oT<!ELEMENT accel:item EMPTY<<!ATTLIST accel:item
accel:cote CtATA teEt|IeEt
accel:shift %boolean; tIMPLIEt
accel:mot1 %boolean; tIMPLIEt
accel:mot2 %boolean; tIMPLIEt
xlink:href CtATA teEt|IeEt<

The attribStes that yoS ian assoiiate tith the <accel:item< eaement are:●2ey iode●

hiit key state●odiiier 0 key state●odiiierkey state●

CommandL

2ey Code
The accel:cote attribSte speiiiies the key iode oi the key that the Sser mSst press to aitirate the iommandc
rg i nt T

accel:cote

RrT 9TThe raaSe oi this attribSte is a rirtSaa key iode that represents the keyc

o oT<!ATTLIST accel:item accel:cote CtATA teEt|IeEt<

The ioaaoting tabae aists the rirtSaa key iodes that are araiaabaec ome oi the keys desiribed in the tabae are notaraiaabae on aaa keyboardsc

Chapter 9 User Interface Content

493

2EY_2

2EY_0

2EY_

2EY_4

2EY_9

2EY_5

2EY_6

2EY_m

2EY_r

2EY_

2EY_

2EY_B

2EY_C

2EY_D

2EY_E

2EY_F

2EY_G

2EY_O

2EY_

2EY_J

2EY_2

2EY_L

2EY_

2EY_N

2EY_O

2EY_P

2EY_o

2EY_

2EY_

2EY_T

2EY_

2EY_V

2EY_D

2EY_X

2EY_Y

2EY_1

2EY_F0

2EY_F

2EY_F4

2EY_F92EY_F52EY_F62EY_Fm2EY_Fr

2EY_F

2EY_F02

2EY_F00

2EY_F02EY_F04

2EY_F09

2EY_F05

2EY_F06

2EY_F0m

2EY_F0r

2EY_F02EY_F 2

2EY_F 0

2EY_F

2EY_F 4

2EY_F 92EY_F 52EY_F 6

2EY_DODN

2EY_ P

2EY_LEFT

2EY_ GOT

2EY_OO E

2EY_END

2EY_P GE P

2EY_P GEDODN

2EY_ ET

2EY_T B

2EY_B C2 P CE

2EY_ P CE

2EY_DELETE

2EY_ DD

2EY_

2EY_D V DE

2EY_PO NT

2EY_CO

2EY_LE

2EY_G E TE

2EY_EoL

2EY_OPEN

2EY_C T

2EY_COPY

2EY_P

TE

2EY_ NDO

2EY_ EPE T

2EY_F ND

2EY_P OPE T E

2EY_CONTEXT EN

2EY_ EN

2EY_OELPN

BT

2EY_E C PE
2EY_ N E T

CT

2EY_

LT PLY

2EY_LE

2EY_F ONT

hiit 2ey tate
The accel:shift attribSte speiiiies thether or not the hiit key is reqSired to aitirate the keyboard shortiStc
rg i nt T

accel:shift

RrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is trues the Sser mSst press thehiit key to aitirate the shortiStc

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST accel:item accel:shift %boolean; "false"<

odiiier 0 2ey tate
The accel:mot1 attribSte speiiiies thether or not the modiiier one key is reqSired to aitirate the keyboard
shortiStc The modiiier one key is system dependent as ioaaots:●

494

Dindots

Leit or right iontroa key

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

●

NX

●

ai

Leit or right iontroa key
Command key

rg i nt T

accel:mot1

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST accel:item accel:mot1 %boolean; "false"<

odiiier2ey tate

The accel:mot2 attribSte speiiiies thether or not the modiiier tto key is reqSired to aitirate the keyboard
shortiStc The modiiier tto key is system dependent as ioaaots:c●

Dindots

at key●NXat key●ai

Option key

rg i nt T

accel:mot1

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST accel:item accel:mot2 %boolean; "false"<

CommandL

The xlink:href attribSte speiiiies the iommand to e.eiSte ii the aiieaerator is aitiratedc
rg i nt T

xlink:href

RrT 9To oT<!ENTITY % url "CtATA"<<!ATTLIST xlink:href %url; teEt|IeEt<

E 4 oT Tih4 oT i4oo T I4 nIiTu9 iAu ri Ani4oo T I4 nIiu

9i

<accel:acceleratorlist<<accel:item accel:cotep" EY_F:" xlink:hrefp"slot:4401"/<<accel:item accel:cotep" EY_Y" accel:mot1p"true" xlink:hrefp"slot:4:01"/<</accel:acceleratorlist<c4

tatSs Bars
statSs bar is SsSaaay paaied aaong the bottom oi a tindot and prorides statSs iniormation to the Sserc n the
OpenOiiiiecorg X L iiae iormats the ioaaoting basii rSaes appay to statSs bars:●

YoS mSst aoiate a <statusbar:statusbaritem< eaement in a <statusbar:statusbar< eaementc●

YoS ian not nest <statusbar:statusbar< eaementsc

Chapter 9 User Interface Content

495statSs bar is iontained as a separate sSbdoiSment oi an OpenOiiiiecorg X L doiSment or in the soffice.
cfg paikage ior the gaobaa Sser settingsc

c4c0 tatSs Bar
The <statusbar:statusbar< eaement is a iontainer eaement ior statSs bar itemsc
rg i nt T<statusbar:statusbar<

RrT 9TYoS mSst iniaSde aaa statSs bar items in a this eaementc

o oT<!ELEMENT statusbar:statusbar (statusbar:statusbaritemay<<!ATTLIST statusbar:statusbar
xmlns:statusbar CtATA tFIXEt "http://openoffice.org/
2001/statusbar"
xmlns:xlink CtATA tFIXEt "http://www.w3.org/1999/
xlink"<

c4c

tatSs Bar tem

The <statusbar:statusbaritem< eaement represents an iniormation iiead that is dispaayed in the statSs
barc
rg i nt T<statusbar:statusbaritem<

RrT 9TYoS mSst speiiiy a raaid raaSe ior the xlink:href attribSteco oT<!ELEMENT statusbar:statusbaritem EMPTY<<!ATTLIST statusbar:statusbaritem
xlink:href CtATA teEt|IeEt
statusbar:align %alignment; tIMPLIEt
statusbar:style %style; tIMPLIEt
statusbar:autosive %boolean; tIMPLIEt
statusbar:ownertraw %boolean; tIMPLIEt
statusbar:witth %numeric; tIMPLIEt
statusbar:offset %numeric; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <statusbar:statusbaritem< eaement are:
●

tatSs

●

aignment

●

tyae

●

Stosike●

Otnerdrat

●

Didth

●

Oiiset

tatSs

L

L

The xlink:href attribSte speiiiies the state that is dispaayed ior this statSs bar itemc

496

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

xlink:href

RrT 9TThe raaSe oi this attribSte mSst be a raaid statSs
L ian be ioSnd at ccc???

o oT<!ATTLIST statusbar:statusbaritem xlink:href CtATA teEt|IeEt<

Lc

reierenie oi the iSrrentay araiaabae statSs

aignment
The statusbar:align attribSte speiiiies hot the iniormation is aaigned in the boSnding bo. oi the statSs
barc
rg i nt T

statusbar:alignRrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:●left: The iniormation is aaigned to the aeit border oi the boSnding bo.c●

center: The iniormation is aaigned to the ienter oi the boSnding bo.

●

right: The iniormation is aaigned to the right border oi the boSnding bo.c

The deiaSat raaSe oi this attribSte is centerc
o oT<!ENTITY % alignment "(left|center|righty"<<!ATTLIST statusbar:statusbaritem statusbar:align %alignment;"center"<tyae
The statusbar:style attribSte speiiiies hot the statSs bar item is dispaayed in the boSnding bo. oi thestatSs barc
rg i nt T

statusbar:style

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:●in: The iniormation is dispaayed in a bo. tith a 4D eiieitc●

out: The iniormation is dispaayed in a bo. tith a 4D eiieit c●flat: The iniormation is dispaayed in a iaat bo. tithoSt any 4D eiieitc

The deiaSat raaSe oi this attribSte is inc
o oT<!ENTITY % style "(in|out|flaty"<<!ATTLIST statusbar:statusbaritem statusbar:style %style;"in"<

Stosike
The statusbar:autosive attribSte speiiiies thether or not the sike oi the boSnding bo. ior the statSs bar
item is set aStomatiiaaay by the statSs barc

Chapter 9 User Interface Content

497

rg i nt T

statusbar:autosive

RrT 9TThe raaSe oi this attribSte ian be true or falsec i the raaSe is trues the sike oi the boSnding
bo. is set aStomatiiaaay by the statSs barc i the raaSe is falses the statusbar:witth
attribSte determines the sike oi the boSnding bo.c The deiaSat raaSe is false.

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST statusbar:statusbaritem statusbar:autosive %boolean;"false"<Otnerdrat
The statusbar:ownertraw attribSte speiiiies thether or not the statSs bar item is dispaayed Ssing ane.ternaa iSnitionc
rg i nt T

statusbar:ownertraw

RrT 9TThe raaSe oi this attribSte ian be true or falsec

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST statusbar:statusbaritem statusbar:ownertraw %boolean; "false"<

Didth
The statusbar:witth attribSte speiiiies the tidth oi the boSnding bo. ior a statSs bar itemc
rg i nt T

statusbar:witth

RrT 9T

This attribSte is onay raaid ii the raaSe oi the statusbar:autosive attribSte is set tofalsecThe raaSe oi the attribSte mSst be a positire raaSec The deiaSat raaSe is 0c

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST statusbar:statusbaritem statusbar:witth %numeric;"0"<

OiisetThe statusbar:offset attribSte speiiiies the distanie by thiih the te.t oi the statSs bar item is oiiset on the.-a.iscrg i nt T

statusbar:offset

RrT 9TThe raaSe oi this attibSte is a nSmeriiaa raaSe in pi.easc The deiaSat raaSe oi is 4 pi.easc

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST statusbar:statusbaritem statusbar:offset %numeric;"4"<

E 4 oT Tih4 oT i9 4 r9i 4I
The ioaaoting e.ampae shots a statSs bar tith tto iniormation iieadsc

498

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<statusbar:statusbar<<statusbar:statusbaritem xlink:hrefp"slot:10000" statusbar:alignp"center"statusbar:witthp"34"/<<statusbar:statusbaritem xlink:hrefp"slot:211-1" statusbar:alignp"left"
statusbar:autosivep"true" statusbar:witthp"4:"/<</statusbar:statusbar<

c9 Tooabars
tooabar is a Sser interiaie iomponent that prorides risSaa aiiess to the most important and ireqSentay-Ssed
iSnitionsc Eaih item on the tooabar is represented as an image or a te.t aabeas or bothc
The tooabar eaement spans Sp the iontainer ior aaa other tooabar eaements embedded in itc n the OpenOiiiiecorg
X L iiae iormats the ioaaoting basii rSaes appay to tooabars:●

YoS mSst embed aaa <toolbar:toolbaritem<s <toolbar:toolbarspace<, <toolbar:toolbarbreak<, <toolbar:toolbarseparator< eaements in a <toolbar:toolbar< eaementc●

YoS ian not nest <toolbar:toolbar< eaementsc●

The <toolbar:toolbarlayouts< eaement is the top-aerea iontainer eaement ior aayoSt iniormation oi
erery tooabar Ssed inside OpenOiiiiecorgc●

YoS mSst aoiate a <toolbar:toolbarlayout< eaement in a <toolbar:toolbarlayouts<
eaementc●

YoS iannot nest <toolbar:toolbarlayouts< eaementsc

aa tooabar deiinitions are iontained in a sSbdoiSment oi an OpenOiiiiecorg X L doiSment or ian be ioSnd in
the soffice.cfg paikage ior the gaobaa Sser settingsc
Erery tooabar has additionaa aayoSt iniormation thiih is stored in a separate sSbdoiSment iaaaed
toolbarlayout.xmlc To iompaeteay desiribe a tooabars there mSst be an raaid entry in the
toolbarlayout.xml sSbdoiSmentc

c9c0 Tooabar
The <toolbar:toolbar< eaement represents a tooabar tith bSttons and other items sSih as separatorss
spaiess and breaksc
rg i nt T<toolbar:toolbar<

RrT 9To oT<!ELEMENT toolbar:toolbar (toolbar:toolbaritem | toolbar:
toolbarspace | toolbar:toolbarbreak | toolbar:
toolbarseparatorya<<!ATTLIST toolbar:toolbar xmlns:toolbar CtATA tFIXEt "http://
openoffice.org/2001/toolbar" xmlns:xlink CtATA tFIXEt "http://
www.w3.org/1999/xlink" <YoS ian iniaSde the ioaaoting tooabar eaements in the <toolbar:toolbar< eaement:●<toolbar:toolbaritem<●<toolbar:toolbarspace< (section missingy
Chapter 9 User Interface Content

499

●

<toolbar:toolbarbreak< (section missingy●<toolbar:toolbarseparator< (section missingy

c9c Tooabar tem
The <toolbar:toolbaritem< eaement deiines a bStton on the tooabarc The bStton represents a iSnitionc<toolbar:toolbaritem<

rg i nt T
RrT 9T<!ELEMENT toolbar:toolbaritem EMPTY<<!ATTLIST toolbar:toolbaritem
xlink:href CtATA teEt|IeEt
toolbar:visible %boolean; "true"
toolbar:usertefinet %boolean; "false"
toolbar:text CtATA tIMPLIEt
toolbar:witth %numeric; "0"toolbar:style CtATA tIMPLIEt
toolbar:bitmap CtATA tIMPLIEt
toolbar:helpit CtATA tIMPLIEt<o oTThe attribStes that yoS ian assoiiate tith the <toolbar:toolbaritem< eaement are:●Command●

Visibae●L

ser-deiined

●

Te.t

●

Didth

●

tyae

●

Bitmap●

Oeap identiiier

CommandL

The xlink:href attribSte speiiiies the iommand that is e.eiSted ii a Sser seaeits the tooabar itemc
rg i nt T

xlink:href

RrT 9To oT<!ATTLIST toolbar:toolbaritem xlink:href CtATA teEt|IeEt<

Visibae
The toolbar:visible attribSte speiiiies the minimSm raaSe that a Sser ian enterc

500

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

toolbar:visible

RrT 9TThe raaSe oi this attribSte ian be true or falsec DeiaSat raaSe is etrSerc

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST toolbar:toolbaritem toolbar:visible %boolean;"true"<

ser-deiined
The toolbar:usertefinet attribSte speiiiies thether or not the tooabar item is Sser-deiinedc
rg i nt T

toolbar:usertefinet

RrT 9TThe raaSe oi this attribSte ian be true or falsec The deiaSat raaSe is falsec

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST toolbar:toolbaritem toolbar:usertefinet %boolean;"false"<Te.t
The toolbar:text attribSte speiiiies the te.t ior this tooabar itemc The te.t is onay dispaayed ii the aayoSt
styae oi the tooabar is set to text or symboltextc ee the <toolbar:toolbarlayout< eaementc
rg i nt T

toolbar:text

RrT 9To oT<!ATTLIST toolbar:text CtATA tIMPLIEt<

Didth
The toolbar:witth attribSte speiiiies the tidth oi the tooabar itemc
rg i nt T

toolbar:witth

RrT 9TThe deiaSat raaSe oi this attribSte is 0c

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST toolbar:witth %numeric; "0"<tyae
The toolbar:style attribSte speiiiies additionaa styaes ior a tooabar itemc

Chapter 9 User Interface Content

501

rg i nt T

toolbar:style

RrT 9TThe raaSe oi this attribSte ian be a spaie-separated aist oi the ioaaoting styaes:●

ratio: This raaSe indiiates that the tooabar item beaongs to a groSp oi itemsc Onay one itemin the groSp ian be aitiratedc●

auto: This raaSe indiiates that yoS ian toggae the tooabar item betteen aitirated and deaitiratedc●

left: This raaSe is onay raaid ii the aayoSt styae oi the tooabar is set to symboltextc niion is paaied on aeit side oi the te.ts aike an entry in a taskbarc●

autosive: This raaSe indiiates that the sike oi the tooabar item is aStomatiiaaay adjSstedc●

troptown: This raaSe indiiates that the tooabar item sSpports a dropdotn menS or tooabar
ior additionaa iSnitionsc●

repeat: This raaSe indiiates that the tooabar item iontinSes to e.eiSte the iommand thiae
yoS iaiik and hoad the moSse bSttonc

The deiaSat raaSe oi this attribSte is an empty stringco oT<!ATTLIST toolbar:style CtATA tIMPLIEt<

Bitmap
The toolbar:bitmap attribSte speiiiies the name oi a Sser-deiined bitmap ior the tooabar itemc CSrrentay thebitmap iiae mSst be aoiated besides the tooabar sSbdoiSmentc
rg i nt T

toolbar:bitmap

RrT 9TThe raaSe oi this attribSte ian be empty or the name oi an image iiaec

o oT<!ATTLIST toolbar:bitmap CtATA tIMPLIEt<

Oeap dentiiier
The toolbar:helpit attribSte speiiiies an optionaa heap identiiierc sSaaay the xlink:href assoiiates heap
te.t tith the tooabar itemc This attribSte assoiiates additionaa heap te.t tith the tooabar itemc
rg i nt T

toolbar:helpit

RrT 9To oT<!ATTLIST toolbar:helpit CtATA tIMPLIEt<

E 4 oT Tih4 oT i nnT 4IiAu ri Ani nnT 4Iiu

9 in1 i9 o4I4 nI i41ti41i4ttu un14Ti nnT 4Iiu

i<toolbar:toolbar<<toolbar:toolbaritem xlink:hrefp"slot:4400"/<<toolbar:toolbaritem xlink:hrefp"slot:449:" toolbar:witthp"300"/<<toolbar:toolbarseparator/<<toolbar:toolbaritem xlink:hrefp"slot:49:2" toolbar:stylep"troptown"/<</toolbar:toolbar<

502

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c9c4 Tooabar LayoSts
The <toolbar:toolbarlayouts< eaement is the top-aerea iontainer eaement ior aaa speiiiii tooabar aayoSt
eaementsc
rg i nt T<toolbar:toolbarlayouts<

RrT 9T

This eaement is a iontainer eaement ior tooabar aayoSt eaementsc

o oT<!ELEMENT toolbar:toolbarlayouts (toolbar:toolbarlayoutay<<!ATTLIST toolbar:toolbarlayouts xmlns:toolbar CtATA tFIXEt"http://openoffice.org/2001/toolbar"<

There are no attribStes assoiiated tith this eaementc The eaement ian iontain the ioaaoting eaement:●<toolbar:toolbarlayout<s see the ne.t seitionc

c9c9 Tooabar LayoSt
The <toolbar:toolbarlayout< eaement speiiiies the aayoSt detaias ior a speiiiii tooabarc
rg i nt T<toolbar:toolbarlayout<

RrT 9T

This eaement mSst be embedded in a <toolbar:toolbarlayouts< eaementc

o oT<!ELEMENT toolbar:toolbarlayout EMPTY<<!ATTLIST toolbar:toolbarlayout
toolbar:it CtATA teEt|IeEt
toolbar:floatingposleft %numeric; tIMPLIEt
toolbar:floatingpostop %numeric; tIMPLIEt
toolbar:floatinglines %numeric; "0"toolbar:tockinglines %numeric; "1"toolbar:align %alignment; "left"
toolbar:visible %boolean; "false"
toolbar:floating %boolean; "false"
toolbar:style %style; "symbol"<

The attribStes that yoS ian assoiiate tith the <toolbar:toolbarlayout< eaement are:●dentiiier●

Faoating state●

Faoating position●

Faoating aines●

Doiking aines●

Doiking aaignment●

Visibae●tyae

Chapter 9 User Interface Content

503

dentiiier
The toolbar:it attribSte is a SniqSe identiiier ior a tooabar aayoSt entryc This identiiier is Ssed to iind theiorresponding tooabar deiinitionc For e.ampaes ii the raaSe oi toolbar:it is writerobiectbars there mSst
be a iiae ne.t to this tooabar aayoSts iiae iaaaed writerobiectbar.xmls to attaih both iniormationc
rg i nt T

toolbar:it

RrT 9T

This attribSte mSst hare a raaid name to iind the iorresponding tooabar deiinition .ma iiaec

o oT<!ATTLIST toolbar:toolbarlayout toolbar:it CtATA teEt|IeEt<

Faoating tate
The toolbar:floating attribSte speiiiies the initiaa state oi the tooabarc
rg i nt T

toolbar:floating

RrT 9TThe deiaSat raaSe oi this attribSte is true or falsec
i the raaSe is trues the toolbar:floatingposleft and toolbar:
floatingpostop attribStes determine the initiaa position oi the tooabarc
i the raaSe is falses the tooabar is doiked and the toolbar:align attribSte determines theinitiaa doiking positionc

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST toolbar:toolbarlayout toolbar:floating %boolean;"false"<Faoating Position
The toolbar:floatingposleft attribSte speiiiies the initiaa aeit position oi the tooabar then the tooabar isin the iaoating statec
rg i nt T

toolbar:floatingposleft

RrT 9T

This attribSte is onay raaid ii the raaSe oi the toolbar:floating attribSte is truec

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST toolbar:toolbarlayout toolbar:floatingposleft %numeric; tIMPLIEt<

The toolbar:floatingpostop attribSte speiiiies the initiaa top position oi the tooabar then the tooabar isin the iaoating statec504

rg i nt T

toolbar:floatingpostop

RrT 9T

This attribSte is onay raaid ii the raaSe oi the toolbar:floating attribSte is truec

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST toolbar:toolbarlayout toolbar:floatingpostop %numeric; tIMPLIEt<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Faoating Lines
The toolbar:floatinglines attribSte speiiiies the nSmber oi aines that are Ssed to dispaay the tooabar ii
the tooabar is iaoatingc
rg i nt T

toolbar:floatinglines

RrT 9TYoS mSst assign a raaSe to this attribSte ii the raaSe oi the toolbar:floating attribSte istruec The deiaSat raaSe oi this attribSte is 0c

o oT<!ENTITY % numeric "CtATA"<<!ATTLIST form:formattet-text form:min-value CtATA tIMPLIEt<

Doiking Lines
The toolbar:tockinglines attribSte speiiiies the nSmber oi aines that are Ssed to dispaay the tooabar ii the
tooabar is doikedc
rg i nt T

toolbar:tockinglines

RrT 9TThe deiaSat raaSe oi this attribSte is 1co oT<!ENTITY % numeric "CtATA"<<!ATTLIST toolbar:toolbarlayout toolbar:tockinglines %numeric;"1"<

Doiking aignment
The toolbar:align attribSte speiiiies the aoiation at thiih the tooabar is initiaaay doikedc
rg i nt T

toolbar:alignRrT 9T

This attribSte is onay reaerant ii the raaSe oi the toolbar:floating attribSte is falsec
The raaSe oi this attribSte ian be one oi the ioaaoting:●

top: The tooabar is doiked at the top oi the doiSment tindotc●

bottom: The tooabar is doiked at the bottom oi the doiSment tindotc●

left: The tooabar is doiked at the aeit side oi the doiSment tindotc●

right: The tooabar is doiked at the right side oi the doiSment tindotc

The deiaSat raaSe oi this attribSte is leftc
o oT<!ENTITY % alignment "(top|bottom|left|righty"<<!ATTLIST toolbar:toolbarlayout toolbar:align %numeric; "1"<Visibae
The toolbar:visible attribSte speiiiies thether or not the tooabar is initiaaay risibaec

Chapter 9 User Interface Content

505

rg i nt T

toolbar:visible

RrT 9TThe raaSe oi this attribSte ian be true or falsec The deiaSat raaSe is falsec

o oT<!ENTITY % boolean "(true|falsey"<<!ATTLIST toolbar:toolbarlayout toolbar:visible %boolean;"false"<tyae
The toolbar:style attribSte speiiiies the dispaay styae oi the tooabar itemsc This styae does not iniaSenie thestyae oi the Sser-deiined tooabar itemsc ee desiription oi the tooabaritem attribStescrg i nt T

toolbar:style

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:●symbol: The standard tooabar items are shotn as bSttons tith an image to represent theiSnition oi the itemc●

text: The standard tooabar items are shotn as bSttons tith te.t to desiribe the iSnition oi
the itemc●

symboltext: The standard tooabar items are shotn as bSttons tith an image and te.t todesiribe the iSnition oi the itemc

The deiaSat raaSe oi this attribSte is symbolc
o oT<!ENTITY % style "(symbol|text|symboltexty"<<!ATTLIST toolbar:toolbarlayout toolbar:style %style;"symbol"<

E 4 oT Tih4 oT i nnT 4IiT4ynr it eu1u un1iAu ri Ani nnT 4I9io4TT tiEer1o un1 4Ipi41tiEerTT9oI 1 4Ipi
<toolbar:toolbarlayouts<<toolbar:toolbarlayout toolbar:itp"functionbar" toolbar:alignp"top"toolbar:visiblep"true" toolbar:stylep"symbol"/<<toolbar:toolbarlayout toolbar:itp"fullscreenbar" toolbar:alignp"top"toolbar:visiblep"true" toolbar:floatingp"false" toolbar:stylep"symbol"/<</toolbar:toolbarlayouts<

c5 Erentsn erent is Ssed to e.eiSte a mairo then a speiiiii aition is takenc For e.ampaes then yoS open a doiSments
this aition ian e.eiSte a mairo to searih the doiSment ior speiiiii tordsc n the OpenOiiiiecorg X L iiae
iormats the ioaaoting basii rSaes appay to erents:●

YoS mSst embed erery erent in the <event:events< iontainer eaementc●

YoS ian not nest erentsc

Erents that are deiined in the gaobaa ionte.t are stored as a sSbdoiSment in the soffice.cfg paikage aoiatedin the SsersioniigSration direitoryc

506

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c5c0 Erents
The <event:events< eaement is a top-aerea iontainer eaement ior aaa erentsc
rg i nt T<event:events<

RrT 9To oT<!ELEMENT event:events (event:eventay<<!ATTLIST event:events xmlns:event CtATA tFIXEt "http://
openoffice.org/2001/event"<<!ATTLIST event:events xmlns:xlink CtATA tFIXEt "http://www.
w3.org/1999/xlink"<

There are no attribStes assoiiated tith the <event:events< eaementc

c5c Erent
The <event:event< eaement deiines an erentc
rg i nt T<event:event<RrT 9To oT<!ELEMENT event:event EMPTY<<!ATTLIST event:event
event:name CtATA teEt|IeEt
event:language CtATA teEt|IeEt
event:library CtATA teEt|IeEt
event:macro-name CtATA teEt|IeEt
xlink:type CtATA tFIXEt "simple"
xlink:href CtATA tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <event:event< eaement are:
●

Name

●

LangSage●

Library●

airo name●n optionaa

L there the aibrary ian be ioSnd

Name
The event:name attribSte speiiiies the name oi the erent that mSst oiiSr to aitirate the mairoc
rg i nt T

event:nameRrT 9T

This attribSte mSst hare a raaSec

o oT<!ATTLIST event:event event:name CtATA teEt|IeEt<

Chapter 9 User Interface Content

507

LangSage
The event:language attribSte speiiiies the aangSage Ssed to trite the mairoc The onay aangSage that
OpenOiiiiecorg X L iSrrentay sSpports is tarBasiic
rg i nt T

event:nameRrT 9T

This attribSte mSst hare a raaSec The onay raaSe that OpenOiiiiecorg X L iSrrentay sSpports is
StarBasicc

o oT<!ATTLIST event:event event:language CtATA teEt|IeEt<

Library
The event:library attribSte speiiiies the aibrary there the mairo is storedc
rg i nt T

event:libraryRrT 9T

This attribSte mSst hare a raaSec

o oT<!ATTLIST event:event event:library CtATA teEt|IeEt<

airo Name
The event:macro-name attribSte speiiiies the name oi the mairoc
rg i nt T

event:macro-name

RrT 9T

This attribSte mSst hare a raaSec

o oT<!ATTLIST event:event event:macro-name CtATA teEt|IeEt<

E 4 oT TiEv 1 9iAu rin1 i.Tn 4Ti v 1 it eu1u un1ienIi4i 4oIni r4 iu9i

or ti4 i4ooTuo4 un1i9 4I roi<event:events<<event:event event:namep"OnStartApp" event:languagep"StarBasic" event:libraryp"StarOffice" event:macro-namep"Tools.Strings.Checktouble"/<</event:events<

c6

mages
YoS ian paaie images on tooabar bSttons and menS itemsc The images heap the Sser to identiiy the iSnition oi abStton or menS itemc n the OpenOiiiiecorg X L iiae iormats the ioaaoting basii rSaes appay to images:

508●

The images iontainer eaement spans Sp the iontainer top-aerea eaement ior aaa other image eaements embedded
in itc●YoS mSst embed aaa imagess both internaa and e.ternaas in the top-aerea iontainer eaementc●

YoS mSst embed entry into an images eaement and an e.ternaa entry into an e.ternaaimages eaementc YoS
iannot mi. themc●

There ian be kero or more images eaement inside an images iontainer bSt onay one e.ternaaimages eaementc●

YoS ian not nest images or e.ternaaimagesc

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

c6c0 mages Container
The <image:imagescontainer< eaement is a top-aerea iontainer ior aaa image deiinitionsc
rg i nt T<image:imagescontainer<

RrT 9T<!ELEMENT image:imagescontainer (image:imagesa, image:externalimages?y<<!ATTLIST image:imagescontainer
xmlns:image CtATA tFIXEt "http://openoffice.org/2001/
image"
xmlns:xlink CtATA tFIXEt "http://www.w3.org/1999/
xlink"<o oT

There are no attribStes assoiiated tith the <image:imagescontainer< eaementc

c6c

mages

The <image:images< eaement deiines a iontainer ior an internaa bitmap that iontains one or more imagesc
rg i nt T<image:images<

RrT 9TYoS mSst speiiiy a raaSe ior the xlink:href attribSteco oT<!ELEMENT image:images (image:entryay<<!ATTLIST image:images
xlink:href %urieeference; teEt|IeEt
xlink:type CtATA tFIXEt "simple"
image:maskmote %maskMote; "maskcolor"
image:maskcolor %color; "t000000"
image:maskurl %url; tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <image:images< eaement are:●eierenie●

ask mode●

ask ioaor●

ask bitmap

eierenieThe xlink:href attribSte speiiiies a Sniiorm resoSrie identiiier imore imagesco ior the images thiih ian iontain one orrg i nt T

xlink:href

RrT 9T

This attribSte mSst hare a raaSec

o oT<!ENTITY % urieeference "CtATA"<<!ATTLIST image:images xlink:href %urieeference; teEt|IeEt<

Chapter 9 User Interface Content

509

ask

ode

The image:maskmote attribSte speiiiies the mask mode ior the imagec
rg i nt T

image:maskmote

RrT 9TThe raaSe oi this attribSte ian be one oi the ioaaoting:●maskbitmap: The image iontains a seiond bitmap tith images that are Ssed as masksc●

maskcolor:ioaor is Ssed as a transparent ioaorc

The deiaSat raaSe oi this attribSte is maskcolorc
o oT<!ATTLIST event:event event:language CtATA teEt|IeEt<

ask Coaor
The image:maskcolor attribSte speiiiies a ioaor that is rendered as transparentc
rg i nt T

image:maskcolor

RrT 9T

This raaSe oi this attribSte is onay raaid ii the raaSe oi the image:maskmote attribSte ismaskcolorc
The raaSe oi the attribSte mSst be in the iormat trrggbb and the three ioaor raaSes mSst be
he.adeiimaac
The deiaSat raaSe is t000000 thiih is baaikc

o oT<!ENTITY % color "CtATA"<<!ATTLIST image:images image:maskcolor %color; "t000000"<

ask Bitmap
The image:maskbitmap attribSte speiiiies a seiond bitmap tith embedded images that is Ssed as a mask ior
the images reierenied by xlink:hrefc
rg i nt T

image:maskurl

RrT 9T

This raaSe oi this attribSte is onay raaid ii the raaSe oi the image:maskmote attribSte ismaskbitmapc

o oT<!ENTITY % url "CtATA"<<!ATTLIST image:maskurl %url; IMPLIEt<

c6c4 Entry
The <image:entry< eaement deiines one image that is embedded in an internaa bitmap that is speiiiied by aparent <image:images< eaementc

510

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<image:entry<

RrT 9T

The image:commant and image:bitmap-intex attribStes are reqSiredc

o oT<!ELEMENT image:entry EMPTY<<!ATTLIST image:entry
image:commant %url; teEt|IeEt
image:bitmap-intex CtATA teEt|IeEt<

YoS mSst assoiiate the ioaaoting attribStes tith the <image:entry< eaement:●

Command●

Bitmap inde.

Command

L

L

The image:commant attribSte speiiiies the

L ior a iommand that is boSnd to the imagec

rg i nt T

image:commant

RrT 9T

This attribSte mSst hare a raaSec

o oT<!ENTITY % url "CtATA"<<!ATTLIST image:commant %url; teEt|IeEt<

Bitmap inde.
The image:bitmap-intex attribSte speiiiies the inde. to an image that is embedded in an internaa bitmapc
The image is addressed by the parent iontainer eaement <image:images<crg i nt T

image:bitmap-intex

RrT 9T

The attribSte mSst hare a positire integer raaSec

o oT<!ATTLIST image:entry image:bitmap-intex CtATA teEt|IeEt<

c6c9 E.ternaa mages
The <image:externalimages< eaement is a iontainer eaement ior e.ternaa bitmapsc
rg i nt T<image:externalimages<

RrT 9T

There ian onay be one <image:externalimages< eaement in the <image:
imagescontainer< eaementc

o oT<!ELEMENT image:externalimages (image:externalentryay<

There are no attribStes assoiiated tith the <image:externalimages< eaementc The eaement ian iontain the
ioaaoting eaement:●<image:externalimages<s see ne.t seitionc

c6c5 E.ternaa Entry
The <image:externalentry< eaement deiines an image entry that reierenies an e.ternaa bitmapc
Chapter 9 User Interface Content

511

rg i nt T

<image:externalimages<

RrT 9T

The eaement mSst be iontained in an <image:externalimages< eaementc
The image:commant and xlink:href attribStes are reqSiredc<!ELEMENT image:externalentry EMPTY<<!ATTLIST image:externalentry
image:commant %url; teEt|IeEt
xlink:href %urieeference; teEt|IeEt
xlink:type CtATA tFIXEt "simple"<o oT

The attribStes that yoS mSst assoiiate tith the <image:externalentry< eaement:●

Command●eierenie

Command

L

L

The image:commant attribSte speiiiies the

L ior a iommand that is boSnd to the imagec

rg i nt T

image:commant

RrT 9T

This attribSte mSst hare a raaSec

o oT<!ENTITY % url "CtATA"<<!ATTLIST image:commant %url; teEt|IeEt<

eierenieThe xlink:href attribSte speiiiies a
it is rendered on the sireenc

ior the bitmapc The bitmap is siaaed to the iorreit dimensions thenrg i nt T

image:bitmap-intex

RrT 9T

The attribSte mSst hare a positire integer raaSec

o oT<!ATTLIST image:entry image:bitmap-intex CtATA teEt|IeEt<

E 4 oT Ti

4. ion1eu.rI4 un1

The ioaaoting e.ampae shots an image ioniigSration tith one internaa and one e.ternaa image aistc Both aists
iontain tto image entriesc<image:imagescontainer<<image:images xlink:hrefp"/bitmaps/functionbar.bmp image:maskcolorpt-0-0-0<<image:entry image:commantp"slot:4400" image:bitmap-intexp"0"/<<image:entry image:commantp"slot:4410" image:bitmap-intexp"1"/<</image:images<<image:externalimages<<images:externalimage image:commantp"slot:4:00" xlink:hrefp"file:///f:/bitmaps/file_new.bmp"/<<images:externalimage image:commantp"slot:4:01" xlink:hrefp"file:///f:/bitmaps/file_save.bmp"/<</image:imagescontainer<

512

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

CHAPTER

02

10

Diaaog Content
This ihapter desiribes the T enTSSice.org X L representation oi diaaogsc The diaaog eaements are based on andiorrespond iaoseay to the E.tensibae ser nteriaie LangSage iX Lo diaaog eaementsc This enabaes easy migration oi diaaogs irom one aangSage to the otherc This ihapter iontains the ioaaoting seitions:●Diaaog Containers

●

tyaes

●

Controas●

02c0 Diaaog Containers
The <tlg:wintow< eaement is the top-aerea iontainer eaement ior aaa diaaog-reaated eaements iniaSding the
ioaaoting:●BSaaetin boardss see eition 02c0c0●

tyaess see eition 0c9●

Controass see eition 6c●

Erentss see eition c00

rg i nt T<tlg:wintow<

RrT 9T

Eaih doiSment iontains onay one <tlg:wintow< eaementc

o oT<!ELEMENT tlg:wintow (tlg:stylesa, (%event;ya,
tlg:bulletinboartay<<!ATTLIST tlg:wintow tlg:it CtATA teEt|IeEt
tlg:left CtATA tIMPLIEt
tlg:top CtATA tIMPLIEt
tlg:witth CtATA tIMPLIEt
tlg:height CtATA tIMPLIEt
tlg:style-it CtATA tIMPLIEt
tlg:title CtATA tIMPLIEt
tlg:page CtATA tIMPLIEt
tlg:tag CtATA tIMPLIEt
tlg:help-text CtATA tIMPLIEt
tlg:help-url CtATA tIMPLIEt
xmlns:tlg CtATA tFIXEt"http://openoffice.org/2000/tialog"
xmlns:script CtATA tFIXEt"http://openoffice.org/2000/script"<
513

02c0c0 BSaaetin Board
T enTSSice.org X L does not iaiiaitate iontroa aayoSt management or aStomatii positioningc The same appaies
to <tlg:titletbox< eaements thiih is another iontainer eaement ior iontroasc
rg i nt T<tlg:bulletinboart<

RrT 9T

This eaement ian iontain iontroa eaements and other bSaaetin board eaementsc
The position oi aaa eaements iontained in this eaement is reaatire to the parent <tlg:bulletinboart< eaementc

o oT<!ELEMENT tlg:bulletinboart ((tlg:bulletinboart|
tlg:button|
tlg:checkbox|
tlg:combobox|
tlg:menulist|
tlg:ratiogroup|
tlg:titletbox|
tlg:textfielt|
tlg:text|
tlg:filecontrol|
tlg:img|
tlg:timefielt|
tlg:tatefielt|
tlg:numericfielt|
tlg:currencyfielt|
tlg:patternfielt|
tlg:formattetfielt|
tlg:fixetline|
tlg:progressmeter|tlg:scrollbar
yay<<!ATTLIST tlg:bulletinboart tlg:left CtATA tIMPLIEt
tlg:top CtATA tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <tlg:bulletinboart< eaement are:
●

Leit

●

Top

Leit
The tlg:left attribSte speiiiies the aeit i.o position oi the bSaaetin boardc
rg i nt T

tlg:leftRrT 9TThe raaSe oi this attribSte is nSmeriico oT<!ATTLIST tlg:bulletinboart tlg:left CtATA tIMPLIEt<

Top
The tlg:top attribSte speiiiies the Spper iyo position oi the bSaaetin boardc

514

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

02crg i nt T

tlg:topRrT 9TThe raaSe oi this attribSte is nSmeriico oT<!ATTLIST tlg:bulletinboart tlg:top CtATA tIMPLIEt<

tyaes
The <tlg:styles< eaement is a iontainer eaement ior <tlg:style< eaementsc
rg i nt T<tlg:styles<

RrT 9T

This eaement is iontained in the top-aerea <tlg:wintow< eaementc
This eaement ian iontain one or more <tlg:style< eaementsc

o oT

02c c0<!ELEMENT tlg:styles (tlg:stylety<tyae

The <tlg:style< eaement deiines the styae attribStes ior a iontroac The styae attribStes that are assoiiated titha iontroa depends oi the type oi iontroa to thiih the styae is ainkedc For e.ampaes iont attribStes are onay reaerant
ior iontroas that iontain te.tc

Chapter Oe Dialog Content

515

rg i nt T

<tlg:style<RrT 9T

This eaement does not iontain iSrther sSb eaementsc
The tlg:style-it attribSte is reqSiredc aa other attribStes are optionaac i yoS do not speiiiyraaSes ior the optionaa attribStess the appaiiation deiaSats are Ssedc

o oT<!ELEMENT tlg:style EMPTY<<!ATTLIST tlg:style tlg:style-it CtATA teEt|IeEt
tlg:backgrount-color CtATA tIMPLIEt
tlg:text-color CtATA tIMPLIEt
tlg:fill-color CtATA tIMPLIEt
tlg:borter (none|3t|simpley tIMPLIEt
tlg:font-name CtATA tIMPLIEt
tlg:font-height CtATA tIMPLIEt
tlg:font-witth CtATA tIMPLIEt
tlg:font-stylename CtATA tIMPLIEt
tlg:font-family (tecorative|motern|roman|script|swiss|systemy tIMPLIEt
tlg:font-charset (ansi|mac|ibmpc_:3:|
ibmpc_-40|ibmpc_-:0|ibmpc_-:1|
ibmpc_-:3|ibmpc_-:4|
system|symboly tIMPLIEt
tlg:font-pitch (fixet|variabley tIMPLIEt
tlg:font-charwitth CtATA tIMPLIEt
tlg:font-weight CtATA tIMPLIEt
tlg:font-slant (oblique|italic|reverse_oblique|reverse_italicy tIMPLIEt
tlg:font-unterline (single|touble|tottet|
tash|longtash|tashtot|
tashtottot|smallwave|wave|
toublewave|bolt|bolttottet|
bolttash|boltlongtash|
bolttashtot|bolttashtottot|
boltwavey tIMPLIEt
tlg:font-strikeout (single|touble|bolt|slash|xy tIMPLIEt
tlg:font-orientation CtATA tIMPLIEt
tlg:font-kerning (true|falsey tIMPLIEt
tlg:font-wortlinemote (true|falsey tIMPLIEt
tlg:font-type (raster|tevice|scalabley tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <tlg:style< eaement are:●tlg:style-it

peiiiies the D oi the styae so that yoS ian assoiiate the styae tith a iontroac This attribSte is mandatoryc●

tlg:backgrount-color

peiiiies the baikgroSnd ioaor oi a iontroac●

tlg:text-color

peiiiies the te.t ioaor oi a iontroac●

tlg:fill-color

peiiiies the iiaa ioaor oi a iontroac●516

tlg:borter

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

peiiiies the border styae a iontroac●

tlg:font-namepeiiiies the name oi the iont to Sse ior te.t in the iontroac●

tlg:font-heightpeiiiies the height oi the iont to Sse ior te.t in a iontroac●

tlg:font-witth

peiiiies the tidth oi the iont to Sse ior te.t in a iontroac●

tlg:font-stylename

peiiiies the name oi the iont styae to Sse ior te.t in a iontroac For e.ampaes Italic Boltc●

tlg:font-family topeiiiies the iont iamiay to Sse ior te.t in a iontroac For e.ampaes eomanc●

tlg:font-charset topeiiiies the iharaiter set to Sse ior te.t in a iontroac●

tlg:font-pitch topeiiiies thether the pitih oi the iont ior te.t in a iontroa is fixet or variablec●

tlg:font-charwitth topeiiiies the iharaiter tidth oi the iont to Sse ior te.t in a iontroac●

tlg:font-weight topeiiiies the iont teight to Sse ior te.t in a iontroac●

tlg:font-slant topeiiiies the saant to Sse ior te.t in a iontroac●

tlg:font-unterline topeiiiies the Snderaine styae to Sse ior te.t in a iontroac●

tlg:font-strikeout topeiiiies the strikeoSt styae to Sse ior te.t in a iontroac●

tlg:font-orientation topeiiiies the orientation in degreess to Sse ior te.t in a iontroas there 2 is the baseainec●

tlg:font-kerning topeiiiies thether or not to Sse iont kerning ior the te.t in a iontroac●

tlg:font-wortlinemote topeiiiies thether or not onay tords are Snderained in the te.t oi a iontroac●

tlg:font-type to

peiiiies the iont type to Sse ior te.t in a iontroac

Chapter Oe Dialog Content

517

For a iompaete aist oi the aiiepted raaSes ior these attribStess paease reier to the prerioSs tabaec

02c4 Controas
To bSiad a Sser interiaie diaaogs yoS Sse a ioaaeition oi iontroas sSih as bSttonss te.t bo.ess iheik bo.ess anddrop-dotn aistsc The ioaaoting seitions desiribe the iontroa eaements that are araiaabae; bSttonss aist bo.ess
iombo bo.ess ihoiiess radio bSttonss titaed bo.ess aabeass te.t iieadss imagess iiae diaaogss iSrreniy iieadss dateiieadss time iieadss nSmerii iieadss pattern iieadss ii.ed ainess siroaa barss and progress barscn T n the ioaaoting seitions:●

The %tefault-attributes; paaiehoader denotes the iommon attribStes desiribed in eition 02c4c0c●

The %event paaiehoader iorresponds to an erent eaement as desiribed in eition c00c

02c4c0 Common Controa ttribStes
There are some attribStes that yoS ian assoiiate tith any iontroa eaementc The ioaaoting entity shots theiommon iontroa attribStes:<!ENTITY % tefault-attributes "tlg:it CtATA teEt|IeEt
tlg:left CtATA teEt|IeEt
tlg:top CtATA teEt|IeEt
tlg:witth CtATA teEt|IeEt
tlg:height CtATA teEt|IeEt
tlg:style-it CtATA tIMPLIEt
tlg:tab-intex CtATA tIMPLIEt
tlg:tisablet (true|falsey tIMPLIEt
tlg:printable (true|falsey tIMPLIEt
tlg:page CtATA tIMPLIEt
tlg:tag CtATA tIMPLIEt
tlg:help-text CtATA tIMPLIEt
tlg:help-url CtATA tIMPLIEt"<

The pSrpose oi these iommon iontroa attribStes is as ioaaots:●

tlg:it is a mandatory string attribSte oi aaa iontroas

peiiiies the SniqSe D oi the iontroa tithin a doiSmentc This attribSte is mandatoryc●

tlg:style-it

Contains a nSmerii string that speiiiies the D nSmber oi a styae to Sse ior the iontroac This attribSte reierenies a <tlg:
style< eaement tith the same Dc This attribSte is optionaac●

tlg:left

Contains a nSmerii raaSe that speiiiies the aeit position i.o oi the iontroa reaatire to the parent <tlg:bulletinboart< eaementc This attribSte is mandatoryc●

tlg:top

Contains a nSmerii raaSe that speiiiies the Spper position iyo oi the iontroa reaatire to the parent <tlg:bulletinboart< eaementc This attribSte is mandatoryc●

518

tlg:witth

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Contains a nSmerii raaSe that speiiiies the tidth oi the iontroac This attribSte is mandatoryc●

tlg:heightContains a nSmerii raaSe that speiiiies the height oi the iontroac This attribSte is mandatoryc●

tlg:tab-intex

Contains a nSmerii raaSe that speiiiies the aoiation in the tabbing order then the iontroa gains ioiSsc This attribSte is
optionaac●

tlg:tisablet

peiiiies thether or not a iontroa is disabaedc The raaSe oi the attribSte ian be true or false and the deiaSat raaSe isfalsec This attribSte is optionaac●

tlg:printablepeiiiies thether or not a iontroa is printabaec The raaSe oi the attribSte ian be true or falsec This attribSte is
optionaac●

tlg:pageContains a nSmerii raaSe that speiiiies the page oi mSatiaayer diaaogsc This attribSte is optionaac●

tlg:tag

Contains a te.t string that speiiiies additionaa Sser datas thiih ian be eraaSated by a basii siriptc This attribSte is
optionaac●

tlg:help-text

Contains a te.t string that speiiiies heap te.t ior the iontroac The heap te.t ian be dispaayed as a tooatipc This attribSte is
optionaac●

tlg:help-url

Contains a te.t string that speiiiies a
L that iontains heap te.t ior the iontroac i yoS speiiiy aaiiessed and dispaayed then the Sser reqSests heapc This attribSte is optionaac

Ls theL is

02c4c BStton
The <tlg:button< eaement desiribes a iaiikabae bSttonc Dhen yoS iaiik on a bSttons a deiined erent eaement
notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:button<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:button ((%event;yay<<!ATTLIST tlg:button %tefault-attributes;
tlg:value CtATA tIMPLIEt
tlg:tefault (true|falsey tIMPLIEt
tlg:tabstop (true|falsey tIMPLIEt
tlg:button-type(stantart|ok|cancel|helpy tIMPLIEt<

Chapter Oe Dialog Content

519

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:value

peiiiies the te.t aabea oi the bSttonc This attribSte is optionaac●

tlg:tefault

peiiiies thether or not the bStton is the deiaSat bStton ior the diaaogc This attribSte is optionaac●

tlg:tabstop

peiiiies thether or not the bStton is reaihabae ria the Tab keyc This attribSte is optionaac●

tlg:button-typepeiiiies the type oi the bSttonc The deiaSat bStton type is stantartc This attribSte is optionaac

02c4c4 Cheik Bo.
The <tlg:checkbox< eaement desiribes a iontroa that yoS ian iheikc Dhen yoS modiiy the iheik bo.s adeiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:iheikbo.<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:checkbox ((%event;yay<<!ATTLIST tlg:checkbox %tefault-attributes;
tlg:value CtATA tIMPLIEt
tlg:checket (true|falsey tIMPLIEt
tlg:tristate (true|falsey tIMPLIEt
tlg:tabstop (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:value

peiiiies the te.t aabea oi the iheik bo.c This attribSte is optionaac●

tlg:checket

peiiiies thether or not the iheik bo. is iheikedc To speiiiy state ton't knows set the attribSte tlg:tristate totrue and omit the tlg:checket attribStec This attribSte is optionaac●

tlg:tristatepeiiiies thether or not the iheik bo. ian hare three states; checkets uncheckets and ton't knowc i yoS
speiiiy ton't knows yoS mSst omit the tlg:checket attribStec This attribSte is optionaac●

tlg:tabstop

peiiiies thether or not the iheik bo. is reaihabae ria the Tab keyc This attribSte is optionaac

520

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

02c4c9 List Bo. and Combo Bo.
For aist and iombo bo.ess there is a predeiined set oi eaements irom thiih a Sser ian ihoosec The iombo bo.
iniaSdes a te.t iiead there the Sser ian enter te.ts ior e.ampaes to aimit the set oi items that the Sser ian seaeit
irom the aist bo.c

List Bo.
The <tlg:menulist< eaement represents a aist bo.c aist bo. is a aist oi items irom thiih a Sser ian ihoose
one or more itemsc Dhen a Sser ihooses an items a deiined erent eaement notiiies an aitions thiih triggers amairoc i the aist bo. iontains itemss the <tlg:menulist< eaement iontains a <tlg:menupopup< sSbeaement thiih iontains one or more <tlg:menuitem< eaementsc
rg i nt T<tlg:menulist<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:menulist (tlg:menupopup?, (%event;yay<<!ATTLIST tlg:menulist %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:spin (true|falsey tIMPLIEt
tlg:multiselection(true|falsey tIMPLIEt
tlg:linecount CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the aist bo. is reaihabae ria the Tab keyc●

tlg:spin

peiiiies thether or not the aist bo. has a spin bSttonc●

tlg:multiselection

peiiiies thether or not a Sser ian seaeit more than one item irom the aist bo.c●

tlg:linecountpeiiiies the nSmber oi aines oi the seaeition that are risibaec
seaeitionc

Sser ian Sse the siroaabar to aiiess the remainder oi the

Combo Bo.
The <tlg:combobox< eaement represents a aist bo. and te.t iiead iombinationc Dhen a Sser ihooses a item
irom the aist bo. or enters te.t in the te.t iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc
i the aist bo. seition oi the iombo bo. iontains predeiined itemss the <tlg:combobox< eaement iontains a<tlg:menupopup< sSb-eaement thiih iontains one or more <tlg:menuitem< eaementsc

Chapter Oe Dialog Content

521

rg i nt T

<tlg:combobox<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:combobox (tlg:menupopup?, (%event;yay<<!ATTLIST tlg:combobox %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:autocomplete (true|falsey tIMPLIEt
tlg:spin (true|falsey tIMPLIEt
tlg:maxlength CtATA tIMPLIEt
tlg:linecount CtATA tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iombo bo. is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian edit the iontents oi the iombo bo.c●

tlg:autocomplete

peiiiies thether or not the iombo bo. aStoiompaetes manSaa inpStsc●

tlg:spin

peiiiies thether or not the iombo bo. has a spin bSttonc●

tlg:maxlength

peiiiies the ma.imSm nSmber oi iharaiters that is aaaoted ior manSaa inpStsc●

tlg:linecountpeiiiies the nSmber oi aines oi the seaeition that are risibaec
seaeitionc●

Sser ian Sse the siroaabar to aiiess the remainder oi thetlg:value

peiiiies the te.t in the te.t iieadc

enS PopSp
The <tlg:menupopup< eaement serres as a iontainer eaement ior <tlg:menuitem< eaementsc
rg i nt T<tlg:menupopup<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT
522

●

<tlg:menulist<●<tlg:combobox<<!ELEMENT tlg:menupopup (tlg:menuitemty<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

enS tem
The <tlg:menuitem< eaements represent the items that yoS ian seaeit irom a aist bo. or irom the aist bo.
seition oi a iombo bo.crg i nt T<tlg:menuitem<

RrT 9T

This eaement is iontained in the <tlg:menupopup< eaement and iontains one or more styaeeaementsc

o oT<!ELEMENT tlg:menuitem EMPTY<<!ATTLIST tlg:menuitem tlg:value CtATA teEt|IeEt
tlg:selectet (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:value

peiiiies the te.t aabea oi the itemc●

tlg:selectet

peiiiies thether or not the item is seaeitedc

02c4c5adio GroSp and Titaed Bo.

radio groSp is a ioaaeition oi items irom thiih a Sser ian seaeit one itemc i yoS speiiiy that more than one
radio item ian be seaeiteds it is Sndeiined thiih one is seaeitedc

adio GroSp
The <tlg:ratiogroup< eaement serres as a iontainer eaement ior one or more <tlg:ratio< eaementsc
There ian be none or one radio item iheiked at a timec
rg i nt T<tlg:ratiogroup<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:ratiogroup (tlg:ratioty<

adio tems
The <tlg:ratio< eaement represents an item in a radio groSpc Dhen a Sser seaeits a radio items a deiined
erent eaement notiiies an aitions thiih triggers a mairoc

Chapter Oe Dialog Content

523

rg i nt T

<tlg:ratio<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:ratiogroup<●<tlg:titletbox<<!ELEMENT tlg:ratio ((%event;yay<<!ATTLIST tlg:ratio %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt
tlg:tristate (true|falsey tIMPLIEt
tlg:checket (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the radio item is reaihabae ria the Tab keyc●

tlg:value

peiiiies the te.t aabea oi the radio itemc●

tlg:tristatepeiiiies thether or not the item ian hare three states; checkets uncheckets and ton't knowc To speiiiy the
raaSe to ton't knows set this to true and omit the tlg:checket attribStec●

tlg:checket

peiiiies thether or not the radio item is iheikedc To speiiiy the tristate raaSe to ton't knows set the attribSte tlg:
tristate to true and omit the tlg:checket attribStec

Titaed Bo.
The <tlg:titletbox< eaement groSps arbitrary iontroas and <tlg:ratio< items and assigns a border anda titae to the groSpc titaed bo. is sometimes iaaaed a groSp bo.c Dhen a Sser mores the moSse pointer orer atitaed bo.s a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:titletbox<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

524

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:titletbox(tlg:title?, tlg:ratioa,(tlg:bulletinboart|tlg:button|tlg:checkbox|
tlg:combobox|tlg:menulist|tlg:ratiogroup|tlg:titletbox|
tlg:textfielt|tlg:text|tlg:filecontrol|tlg:img|
tlg:timefielt|tlg:tatefielt|tlg:numericfielt|
tlg:currencyfielt|tlg:patternfielt|tlg:formattetfielt|
tlg:fixetline|tlg:progressmeter|tlg:scrollbarya,(%event;yay<<!ATTLIST tlg:titletbox %tefault-attributes;<

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

TitaeThe <tlg:title< eaement represents the titae aabea oi a <tlg:titletbox<c
rg i nt T<tlg:title<RrT 9T

This eaement is optionaaay iontained in a <tlg:titletbox< eaementc

o oT<!ELEMENT tlg:title EMPTY<<!ATTLIST tlg:title tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:value

peiiiies the te.t oi the titae aabea oi the titaed bo.c

02c4c6 Labea
The <tlg:text< eaement desiribes a ionstant string oi te.tc Dhen a Sser mores the moSse pointer orer a te.taabeas a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:text<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:text ((%event;yay<<!ATTLIST tlg:text %tefault-attributes;
tlg:align (left|center|right|noney tIMPLIEt
tlg:multiline (true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:align

peiiiies hot the te.t is aaigneds ior e.ampae ii it is aaigned to the aeit or right oi a speiiiied dimensionc●

tlg:multiline

peiiiies thether or not the te.t ian appear on more than one ainec●

tlg:value

peiiiies the te.t oi the aabeac

02c4cm Te.t Fiead
The <tlg:textfielt< eaement represents a te.t iieadc te.t iiead serres as an inpSt iontroa ior strings oi
iharaitersc Dhen a Sser modiiies a te.t iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc

Chapter Oe Dialog Content

525

rg i nt T

<tlg:textfielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:textfielt ((%event;yay<<!ATTLIST tlg:textfielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:align(left|center|right|noney tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:echochar CtATA tIMPLIEt
tlg:hart-linebreaks(true|falsey tIMPLIEt
tlg:hscroll (true|falsey tIMPLIEt
tlg:vscroll (true|falsey tIMPLIEt
tlg:maxlength CtATA tIMPLIEt
tlg:multiline (true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the te.t iiead is reaihabae ria the Tab keyc●

tlg:align

peiiiies hot the inpSt te.t is aaigneds ior e.ampae ii it is aaigned to the aeit or right oi a speiiiied dimensionc●

tlg:reatonly

peiiiies thether or not a Sser ian edit the te.t iieadc●

tlg:echochar

peiiiies a speiiaa eiho iharaiterc i this attribSte is enabaeds the same iharaiter is dispaayed in the oStpSt dispaay
regardaess oi thiih iharaiters the Sser inpStsc This attribSte is SseiSa ior passtord inpSt iieadsc●

tlg:hart-linebreaks

peiiiies thether or not aine break iharaiters remain part oi the inpStc●

tlg:hscroll

peiiiies thether or not a horikontaa siroaabar is dispaayed ior the te.t iieadc●

tlg:vscroll

peiiiies thether or not a rertiiaa siroaabar is dispaayed ior the te.t iieadc●

tlg:maxlength

peiiiies the ma.imSm nSmber oi inpSt iharaiters that is aaaotedc●

tlg:multiline

peiiiies thether or not the te.t ian appear on more than one ainec●

526

tlg:value

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

peiiiies the inpSt te.t string oi the iieadc

02c4cr mageThe <tlg:img< eaement represents an imagec Dhen a Sser iaiiks on the image or more the moSse pointer orer
the images a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:img<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:●<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:img ((%event;yay<<!ATTLIST tlg:img %tefault-attributes;
tlg:src CtATA tIMPLIEt
tlg:scale-image (true|falsey tIMPLIEt<o oTn addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:src

peiiiies a●

L ior the image soSrie iiaec

tlg:scale-image

peiiiies thether or not the image is siaaed to sSit the sike oi the iontroa in thiih it residesc

02c4c Fiae Diaaog
The <tlg:filecontrol< eaement represents a iontroa that dispaays a iiae diaaogc The iiae diaaog is Ssed toseaeit a iiaec Dhen a Sser aiiesses a iiae diaaogs a deiined erent eaement notiiies an aitions thiih triggers amairocrg i nt T<tlg:filecontrol<RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:filecontrol ((%event;yay<<!ATTLIST tlg:filecontrol %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether the iontroa is reaihabae ria the Tab keyc●

tlg:value
Chapter Oe Dialog Content

527

peiiiies the name oi the iiae that is seaeited Ssing the iiae diaaogc

02c4c02 Date Fiead
The <tlg:tatefielt< eaement represents a date iiead that a Sser ian modiiyc Dhen a Sser modiiies a dateiieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:tatefielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:tatefielt ((%event;yay<<!ATTLIST tlg:tatefielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:tate-format(system_short|system_short_YY|
system_short_YYYY|system_long|short_ttMMYY|short_MMttYY|
short_YYMMtt|short_ttMMYYYY|
short_MMttYYYY|short_YYYYMMtt|short_YYMMtt_tIN400-|
short_YYYYMMtt_tIN400-y tIMPLIEt
tlg:value CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt
tlg:spin (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the date iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian edit the iieadc●

tlg:strict-format

peiiiies thether or not the system iheiks the raaidity oi the date thiae the Sser is modiiying the iieadc●

tlg:tate-format

peiiiies the iormat in thiih the date raaSe is dispaayedc●

tlg:value

peiiiies the date raaSe by a rot oi digits YYYYMMtt; a ioSr digit years ioaaoted by a tto digit months and a tto digit
dayc For e.ampaes 20010330 represents arih 42ths 220c●

tlg:value-min

peiiiies the aoter date boSndary oi the iieadc
528

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2●

tlg:value-max

peiiiies the Spper date boSndary oi the iieadc●

tlg:spin

peiiiies thether or not the iiead has a spin bStton to inirease or deirease the date raaSe by a ii.ed step deatac ee tlg:
value-stepc●

tlg:value-steppeiiiies the nSmerii step deata then Ssing the spin bSttonc

02c4c00 Time Fiead
The <tlg:timefielt< eaement represents a time iiead that a Sser ian modiiyc Dhen a Sser modiiies the timeiieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:timefielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:timefielt ((%event;yay<<!ATTLIST tlg:timefielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:time-format(2:h_short|2:h_long|12h_short|
12h_long|turation_short|turation_longy tIMPLIEt
tlg:value CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt
tlg:spin (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian edit the iiead to modiiy the timec●

tlg:strict-format

peiiiies thether or not the system iheiks the raaidity oi the time setting thiae the Sser is modiiying the iieadc●

tlg:time-format

peiiiies the iormat in thiih the time is dispaayedc●

tlg:value
Chapter Oe Dialog Content

529

peiiiies the time raaSe by a rot oi digits mmMMSSCC; tto digit hoSrs ioaaoted by minStess seiondss and 02 miaaiseiondsc For e.ampaes 12300000 represents 0 :22 pcmc●

tlg:value-min

peiiiies the aoter time boSndary oi the iieadc●

tlg:value-max

peiiiies the Spper time boSndary oi the iieadc●

tlg:spin

peiiiies thether or not the iiead has a spin bStton to inirease or deirease the time raaSe by a ii.ed step deatac ee tlg:
value-stepc●

tlg:value-steppeiiiies the nSmerii step deata then Ssing the spin bSttonc

02c4c0 NSmerii Fiead
The <tlg:numericfielt< eaement represents a nSmerii iiead that a Sser ian modiiyc Dhen a Sser modiiies
the iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:numericfielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:numericfielt ((%event;yay<<!ATTLIST tlg:numericfielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:tecimal-accuracy CtATA tIMPLIEt
tlg:thousants-separator(true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt
tlg:value-step CtATA tIMPLIEt
tlg:spin (true|falsey tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian modiiy the raaSe oi the iieadc●

530

tlg:strict-format

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

peiiiies thether or not the system iheiks the raaidity oi the raaSe thiae the Sser is modiiying the raaSec●

tlg:tecimal-accuracy

peiiiies the deiimaa aiiSraiy oi the iieadc●

tlg:thousants-separator

peiiiies thether or not a thoSsands separator is dispaayed in the iieadc●

tlg:value

peiiiies the nSmerii raaSe oi the iieadc●

tlg:value-min

peiiiies the aoter nSmerii boSndary oi the iieadc●

tlg:value-max

peiiiies the Spper nSmerii boSndary oi the iieadc●

tlg:spin

peiiiies thether or not the iiead has a spin bStton to inirease or deirease the raaSe by a ii.ed step deatac ee tlg:
value-stepc●

tlg:value-steppeiiiies the nSmerii step deata then Ssing the spin bSttonc

02c4c04 CSrreniy Fiead
The <tlg:currencyfielt< eaement represents a iiead that dispaays a iSrreniy raaSec Dhen a Sser modiiies
the iSrreniy iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc
rg i nt T<tlg:currencyfielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:currencyfielt ((%event;yay<<!ATTLIST tlg:currencyfielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:currency-symbol CtATA tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:tecimal-accuracy
CtATA tIMPLIEt
tlg:thousants-separator(true|falsey tIMPLIEt
tlg:value CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt
tlg:value-step CtATA tIMPLIEt
tlg:spin (true|falsey tIMPLIEt<

Chapter Oe Dialog Content

531

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian modiiy the raaSe oi the iieadc●

tlg:currency-symbol

peiiiies the iSrreniy symboac●

tlg:strict-format

peiiiies thether or not the system iheiks the raaidity oi a raaSe thiae a Sser is modiiying the iieadc●

tlg:tecimal-accuracy

peiiiies the deiimaa aiiSraiy oi the iieadc●

tlg:thousants-separator

peiiiies thether or not a thoSsands separator is dispaayed in the iieadc●

tlg:value

peiiiies the nSmerii raaSe oi the iieadc●

tlg:value-min

peiiiies the aoter nSmerii boSndary oi the iieadc●

tlg:value-max

peiiiies the Spper nSmerii boSndary oi the iieadc●

tlg:spin

peiiiies thether or not the iiead has a spin bStton to inirease or deirease the raaSe by a ii.ed step deatac ee tlg:
value-stepc●

tlg:value-steppeiiiies the nSmerii step deata then Ssing the spin bSttonc

02c4c09 Pattern Fiead
The <tlg:patternfielt< eaement represents a iiead that dispaays a pattern that a Sser ian modiiyc Dhen aSser modiiies the pattern iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc

532

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<tlg:patternfielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:patternfielt ((%event;yay<<!ATTLIST tlg:patternfielt %tefault-attributes;
tlg:tabstop (true|falsey tIMPLIEt
tlg:reatonly (true|falsey tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:etit-mask CtATA tIMPLIEt
tlg:literal-mask CtATA tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian edit the raaSe oi the iieadc●

tlg:strict-format

peiiiies thether or not the system iheiks the raaidity oi a pattern raaSe thiae a Sser is modiiying the iieadc●

tlg:etit-mask

peiiiies the edit mask oi the iieadc●

tlg:literal-mask

peiiiies the aiteraa mask oi the iieadc●

tlg:value

peiiiies the patternc

02c4c05 Formatted Fiead
The <tlg:formattetfielt< eaement represents a iormatted iieads thiih dispaays nSmberss iSrreniiess
datess and so onc Dhen a Sser modiiies a iormatted iieads a deiined erent eaement notiiies an aitions thiih triggers a mairoc

Chapter Oe Dialog Content

533

rg i nt T

<tlg:formattetfielt<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:formattetfielt ((%event;yay<<!ATTLIST tlg:formattetfielt %tefault-attributes;
tlg:tabstop(true|falsey tIMPLIEt
tlg:reatonly(true|falsey tIMPLIEt
tlg:strict-format(true|falsey tIMPLIEt
tlg:maxlength CtATA tIMPLIEt
tlg:spin (true|falsey tIMPLIEt
tlg:align(left|center|righty tIMPLIEt
tlg:text CtATA tIMPLIEt
tlg:value-tefault CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value CtATA; tIMPLIEt
tlg:format-cote CtATA tIMPLIEt
tlg:format-locale CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:tabstop

peiiiies thether or not the iiead is reaihabae ria the Tab keyc●

tlg:reatonly

peiiiies thether or not a Sser ian modiiy the raaSe oi the iieadc●

tlg:strict-format

peiiiies thether or not the system iheiks the raaidity oi a raaSe thiae a Sser is modiiying the iieadc●

tlg:maxlength

peiiiies the ma.imSm nSmber oi inpSt iharaiters aaaoted in the iieadc●

tlg:spin

peiiiies thether or not the iiead iontains a spin bStton to inirease or deirease the raaSe oi the iieadc●

tlg:align

peiiiies hot the te.t is aaignedc●

tlg:text

peiiiies the te.t dispaayed in the iontroac●

tlg:value-min

peiiiies the minimSm eiieitire nSmerii raaSe oi the iieadc●

534

tlg:value-max

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

peiiiies the ma.imSm eiieitire nSmerii raaSe oi the iieadc●

tlg:value

peiiiies the eiieitire nSmerii raaSe oi the iieadc●

tlg:value-tefault

peiiiies the deiaSat raaSe oi the iiead inSmerii or stringoc●

tlg:format-cote

peiiiies the iormat oi the iieadc●

tlg:format-locale

peiiiies the iormat aoiaae oi the iieads thiih is " O_LangSageCode; O_CoSntryCode; Variant"c For e.ampaes the
raaSe oi this attribSte ian be "te;tE;TIN"c YoS ian omit the iinaa rariantc

02c4c06 Fi.ed LineThe <tlg:fixetline< eaement represents a horikontaa or rertiiaa aines thiih ian optionaaay hare a aabea te.tc
Dhen a Sser mores the moSse pointer orer a ii.ed aines a deiined erent eaement notiiies an aitions thiih triggers
a mairoc
rg i nt T<tlg:fixetline<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:fixetline ((%event;yay<<!ATTLIST tlg:fixetline %tefault-attributes;
tlg:align(horivontal|verticaly tIMPLIEt
tlg:value CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:align

peiiiies the orientation oi the ainec●

tlg:value

peiiiies the te.t oi the aabeac

02c4c0m iroaabar
The <tlg:scrollbar< eaement represents a horikontaa or rertiiaa siroaabarc Dhen a Sser Sses the siroaabars adeiined erent eaement notiiies an aitions thiih triggers a mairoc

Chapter Oe Dialog Content

535

rg i nt T

<tlg:scrollbar<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:scrollbar ((%event;yay<<!ATTLIST tlg:scrollbar %tefault-attributes;
tlg:align(horivontal|verticaly tIMPLIEt
tlg:curpos CtATA tIMPLIEt
tlg:maxpos CtATA tIMPLIEt
tlg:increment CtATA tIMPLIEt
tlg:pageincrement CtATA tIMPLIEt
tlg:visible-sive CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:align

peiiiies the orientation oi the siroaabarc●

tlg:curpos

peiiiies the iSrrent position oi the siroaabar as a nSmerii raaSec●

tlg:maxpos

peiiiies the ma.imSm position oi the siroaabar as a nSmerii raaSec●

tlg:incrementpeiiiies the inirement amoSnt ior a singae aine more oi the siroaabar as a nSmerii raaSec●

tlg:pageincrementpeiiiies the inirement amoSnt ior a baoik more oi the siroaabar as a nSmerii raaSec●

tlg:visible-sivepeiiiies the risibae sike oi the siroaabarc

02c4c0r Progress Bar
The <tlg:progressmeter< eaement represents a progress barc Dhen a Sser Sses the progress bars a deiined
erent eaement notiiies an aitions thiih triggers a mairoc

536

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

rg i nt T

<tlg:progressmeter<

RrT 9T

This eaement is iontained in one oi the ioaaoting eaements:

o oT

●

<tlg:bulletinboart<●<tlg:titletbox<<!ELEMENT tlg:progressmeter ((%event;yay<<!ATTLIST tlg:progressmeter %tefault-attributes;
tlg:value CtATA tIMPLIEt
tlg:value-min CtATA tIMPLIEt
tlg:value-max CtATA tIMPLIEt<

n addition to the iommon iontroa attribStes desiribed in eition 02c4c0s the attribStes that yoS ian assoiiate tiththe <tlg:button< eaement are:●tlg:value

peiiiies the iSrrent position oi the progress bar as a nSmerii raaSec●

tlg:value-min

peiiiies the aoter boSndary ior progress bar positions as a nSmerii raaSec●

tlg:value-max

peiiiies the Spper boSndary ior progress bar positions as a nSmerii raaSec

02c9 Erents
n addition to the obsoaete tlg:event eaements there are tto other eaements that enabae yoS to aink to erents
that oiiSr as a resSat oi Ssing iontroasc The ioaaoting e.ampae shots an erent entity:<!ENTITY % event "(script:event|script:listener-event|tlg:eventy"<

02c9c0 Erents peiiiied sing Common Erent Names
The <script:event< eaement represents an erent that Sses iommon erent namess ior e.ampaes on-itemstatechangec
rg i nt T<script:event<RrT 9T

This eaement ian be iontained in any eaement that represents a iontroac

o oT<!ELEMENT script:event EMPTY<<!ATTLIST script:event script:location CtATA tIMPLIEt
script:language CtATA teEt|IeEt
script:macro-name CtATA teEt|IeEt
script:event-name CtATA teEt|IeEt<

The attribStes that yoS ian assoiiate tith the <script:event< eaement are:●script:location

peiiiies the aoiation there the mairo is e.eiStedc The onay raaSes iSrrentay aiiepted are application or tocumentc The deiaSat is tocumentc

Chapter Oe Dialog Content

537

●

script:language

peiiiies the programming aangSage oi the mairo to be e.eiSteds ior e.ampae StarBasicc●

script:macro-namepeiiiies the name oi a mairo to e.eiSte then the erent is iiredc●

script:event-namepeiiiies the name oi the erent that is oiiSrringc CSrrentay the ioaaoting names are sSpported:538➢

on-approveaction➢

on-performaction➢

on-change➢

on-textchange➢

on-itemstatechange➢

on-focus➢on-blur➢

on-keytown➢

on-keyup➢

on-mouseover➢

on-mousetrag➢on-mousemove➢

on-mousetown➢

on-mouseup➢

on-mouseout➢

on-approvereset➢

on-reset➢

on-submit➢

on-approveuptate➢

on-uptate➢

on-loat➢on-startreloat➢

on-reloat➢

on-startunloat➢

on-unloat➢

on-confirmtelete➢

on-approverowchange➢

on-rowchange➢

on-approvecursormove

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2➢

on-cursormove➢

on-supplyparameter➢

on-error

02c9c E.paiiit Erents peiiiied by Listener
The <script:listener-event< eaement desiribes an erent by an speiiiii aistener type methodc
rg i nt T<script:listener-event<RrT 9T

This eaement ian be iontained in any eaement that desiribes a iontroac

o oT<!ELEMENT script:listener-event EMPTY<<!ATTLIST script:listener-event
script:location CtATA tIMPLIEt
script:language CtATA teEt|IeEt
script:macro-name CtATA teEt|IeEt
script:listener-type CtATA teEt|IeEt
script:listener-methot CtATA teEt|IeEt
script:listener-param CtATA tIMPLIEt<

The attribStes that yoS ian assoiiate tith the <script:listener-event< eaement are:●script:location

peiiiies the aoiation there the mairo is e.eiStedc The onay raaSes iSrrentay aiiepted are application or tocumentc The deiaSat is tocumentc●

script:language

peiiiies the programming aangSage oi the mairo to be e.eiSteds ior e.ampae StarBasicc●

script:macro-namepeiiiies the name oi a mairo to e.eiSte then the erent is iiredc●

script:listener-typepeiiiies the name oi the erent aistener types ior e.ampae com.sun.star.awt.XActionListenerc●

script:listener-methot

peiiiies the destination erent method oi the aisteners ior e.ampae actionPerformetc●

script:listener-parampeiiiies an optionaa parameter that qSaaiiies the aisteners ior e.ampae when listening for propertychanges, you have to know the property namec

Chapter Oe Dialog Content

539

CHAPTER

00

11

Paikage Format
This ihapter desiribes the paikage iormat Ssed in OpenOiiiiecorgc t iontains the ioaaoting seitions:●

ntrodSition●

1ip Fiae trSitSre●

Eniryption●

aniiest Fiae

00c0 ntrodSitions X L has no natire sSpport ior binary objeits sSih as imagess OLE objeitss or other media typess OpenOiiiiec
org Sses a paikage iiae to store the X L iontent oi a doiSment together tith its assoiiated binary datac Thispaikage is a standard 1ip iiaes those strSitSre is disiSssed beaotc
niormation aboSt the iiaes iontained in the paikage is stored in an X L iiae iaaaed the maniiest iiaec The maniiest iiae is aatays stored at the pathname ET - NFsmaniiestc.mac The main pieies oi iniormation stored in themaniiest are as ioaaots:●

aist oi aaa oi the iiaes in the paikagec●

The media type oi eaih iiae in the paikagec●i a iiae stored in the paikage is enirypteds the iniormation reqSired to deirypt the iiae is stored in the maniiestc

541

00c 1ip Fiae trSitSre
1ip iiae starts tith a seqSenie oi iiaess eaih oi thiih
ian be iompressed or stored in rat iormatc Eaih iiae
has a aoiaa header immediateay beiore its datas thiih
iontains most oi the iniormation aboSt the iiaes
iniaSding time-stampss iompression method and iiae
namec The iompressed iiae iontents immediateay
ioaaots and are terminated by an optionaa data
desiriptorc The data desiriptor iontains the C C andiompressed sike oi the iiaes thiih are ireqSentay notaraiaabae then triting the aoiaa iiae headerc i thesedetaias tere iniaSdeds the data desiriptor ian beskippedc
Eaih iiae in the arihire is aaid dotn seqSentiaaay in thisiormats ioaaoted by a ientraa direitory at the end oi the
1ip arihirec The ientraa direitory is a iontigSoSs set oi
direitory entriess eaih oi thiih iontains aaa the iniormation in the aoiaa iiae headers paSs e.tras sSih as iiae
iomments and attribStesc ost importantays the ientraa
direitory iontains pointers to the position oi eaih iiae
in the arihires thiih makes narigation oi the 1ip iiae
qSiik and easyc
For more detaias aboSt the 1ip iiae iormats see: http:ss
tttcpktareciomsappnotechtmac

00c4 Eniryption
The eniryption proiess takes paaie in the ioaaoting mSatipae stages:
0c2-byte O 0 digest oi the Sser entered passtord is ireated and passed to the paikage iomponentc

c The paikage iomponent initiaaikes a random nSmber generator tith the iSrrent timec
4c The random nSmber generator is Ssed to generate a random r-byte initiaaikation reitor and 06-yte saat ior eaihiiaec
9c This saat is Ssed together tith the 2-byte O 0 digest oi the passtord to derire a SniqSe 0 r-bit key ior
eaih iiaec The aagorithm Ssed to derire the key is the PB2DF isee FC r o tith an iteration ioSnt oi
02 9c
5c The derired key is Ssed together tith the intiaaisation reitor to enirypt the iiae Ssing the Baotiish aagorithm
in iipher-ieedbaik iCFBo modec
Eaih iiae that is enirypted is iompressed beiore being eniryptedc To aaaot the iontents oi the paikage iiae to bereriiieds it is neiessary that enirypted iiaes are iaagged as ' TO ED' rather than 'DEFL TED'c s entries thiih
are ' TO ED' mSst hare their sike eqSaa to the iompressed sikes it is neiessary to store the Sniompressed sike inthe maniiestc The iompressed sike is stored in both the aoiaa iiae header and ientraa direitory reiord oi the 1ip
iiaec

542

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

00c9

aniiest Fiae
The eaements and attribStes in the maniiest iiae are in the namespaie: http:ssopenoiiiiecorgs 220smaniiestc
I eu

o 9oIuo un1

4

9o4o imanifest

The maniiest namespaie iontains
aaa attribStes and eaements Ssed in
the maniiest iiaec

http://openoffice.org/2001/manifest

00c9c0aniiest oot Eaement

The root eaement is iaaaed maniiestc The root eaement iontains one ii.ed attribSte thiih speiiiies the namespaieas desiribed aborec
rg i nt Ti<manifest:manifest<

RrT 9Ti

This is the root eaement oi the maniiest iiaec t iontains mSatipae 'iiae-entry' eaementss eaih oi
thiih desiribes a singae iiae in the paikagec

o oT<!ELEMENT manifest:manifest (manifest:file-entrytya<<!ATTLIST manifest:manifest xmlns:manifest CtATA tFIXEt"http://openoffice.org/2001/manifest"<

00c9c Fiae Entry
The <manifest:file-entry< eaement represents a singae iiae tithin the paikages and stores the iiaes aoiation in the paikages the mime-type oi the iiae and optionaaay the data reqSired to deirypt this iiaec
rg i nt Ti<manifest:file-entry<o oT<!ELEMENT manifest:file-entry (manifest:encryption-tata?y<

The attribStes assoiiated tith a <manifest:fileentry>●

are as ioaaots:

FSaa path

●

ike

●

edia typeFSaa Path
The manifest:full-path attribSte desiribes the aoiation oi the iiae tithin the paikagec
rg i nt Ti

manifest:full-patho oT<!ATTLIST manifest:file-entry manifest:full-path CtATA
teEt|IeEt<

Chapter OO Package Format

543

ike
The manifest:sive attribSte is onay present ii the iiae is stored in an enirypted iormatc The reason thy this
attribSte is reqSired is e.paained in eition 0c9c
rg i nt Ti

manifest:sive

RrT 9Ti

This attribSte is onay Ssed ior enirypted iiaesc

o oT<!ATTLIST manifest:file-entry manifest:sive CtATA tIMPLIEt<

edia TypeThe manifest:metia-type attribSte speiiiies the mime type oi the speiiiied iiaec For a iSaa aist oi mimetypes see http:sstttcisicedSsin-notessianasassignmentssmedia-typessmedia-typesc s an e.ampaes aaa X L streams
hare the media type "te.ts.ma"crg i nt Ti

manifest:metia-typeo oT<!ATTLIST manifest:file-entry manifest:metia-type CtATAtIMPLIEt<

00c9c4 Eniryption Data
The <manifest:encryption-tata< eaement iontains aaa oi the iniormation reqSired to deirypt the iiaec
rg i nt Ti<manifest:encryption-tata<o oT<!ELEMENT manifest:encryption-tata (manifest:algorithm,
manifest:key-terivationy<

The <encryption-data>●●

eaement iontains the ioaaoting eaements:

agorithm
2ey Deriration

00c9c9agorithm

The <manifest:algorithm< eaement iontains iniormation aboSt the aagorithm Ssed to enirypt the datac
rg i nt Ti<manifest:algorithm<

o oT<!ELEMENT manifest:algorithm EMPTY<

The attribStes assoiiated tith <manifest:algorithm> are as ioaaots:●

agorithm name●nitiaaikation reitor

agorithm Name
The manifest:algorithm-name attribSte speiiiies the name oi the aagorithm Ssed to enirypt the iiaes and
544

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

aaso speiiiies in thiih mode this aagorithm tas Ssedc CSrrentays the paikage iomponent onay sSpports theBlowfish aagorithm in CFB modec
rg i nt Ti

manifest:algorithm-nameo oT<!ATTLIST manifest:algorithm manifest:algorithm-name CtATA
teEt|IeEt<

nitiaaikation Veitor
The manifest:initialisation-vector attribSte speiiiies the r bytes Ssed as an initiaaikation reitor to
the stream iiphercrg i nt Ti

manifest:initialisation-vectoro oT<!ATTLIST manifest:algorithm manifest:initialisation-vector
CtATA teEt|IeEt<

n 9T

The initiaaikation reitor is an r byte binary seqSenies and so is enioded in base69 thentritten to the maniiest iiaec

00c9c5 2ey Deriration
The <manifest:key-terivation< eaement iontains the iniormation that tas Ssed to derire the eniryption
key ior this iiae irom the Sser speiiiied passtordc
rg i nt Ti<manifest:key-terivation<o oT<!ELEMENT manifest:key-terivation EMPTY<

The attribStes assoiiated tith the <manifest:key-terivation< eaement are as ioaaots:●

2ey deriration name

●

aat

●

teration ioSnt

2ey Deriration Name
The manifest:key-terivation-name attribSte speiiiies the name oi the aagorithm Ssed to derire thenamec t this times the paikage iomponent onay sSpports the Sse oi the PB2DF key deriration methodc For
iSrther detaias see FC r rc
rg i nt Ti

manifest:key-terivation-nameo oT<!ATTLIST manifest:key-terivation manifest:key-terivationname CtATA teEt|IeEt<

aat
The manifest:key-terivation attribSte speiiiies the 06-byte seqSenie Ssed as the 'saat' by the key
deriration aagorithmc

Chapter OO Package Format545

rg i nt Ti

manifest:key-terivationo oT<!ATTLIST manifest:key-terivation manifest:salt CtATA
teEt|IeEt<
The saat is a 06 byte binary seqSenies and thSs is enioded in base69 beiore being tritten to
the maniiest iiaec

n 9T

teration CoSnt
The manifest:key-terivation attribSte speiiiies the nSmber oi iterations Ssed by the key deriration
aagorithm to derire the keyc
rg i nt Ti

manifest:key-terivationo oT<!ATTLIST manifest:key-terivation manifest:iteration-countCtATA teEt|IeEt<

ampae

aniiestThis is a sampae maniiest iiae generated by bSiad 6 54 oi OpenOiiiiecorgc t is an enirypted OpenOiiiiecorg
Driter doiSment that iniaSdes one graphiic The iormatting has been saightay adjSsted ior iaarityc

546

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

<?xml versionp"1.0" encotingp"|TF--"?<<!tOCTYPE manifest:manifest P|BLIC "-//OpenOffice.org//tTt Manifest 1.0//EN" "Manifest.ttt"<<manifest:manifest xmlns:manifestp"http://openoffice.org/2001/manifest"<<manifest:file-entry manifest:metia-typep"application/vnt.sun.xml.writer" manifest:full-pathp"/"/<<manifest:file-entry manifest:metia-typep"image/ipeg"
manifest:full-pathp"Pictures/10000000000003200000024-912EB1C3.ipg"
manifest:sivep":::0:"<<manifest:encryption-tata<<manifest:algorithm manifest:algorithm-namep"Blowfish CFB"
manifest:initialisation-vectorp"Ttmiu:03:-:p"/<<manifest:key-terivation manifest:key-terivation-namep"PB tF2"
manifest:iteration-countp"102:" manifest:saltp"aNYtmqv:cObAJSJim:evqApp"/<</manifest:encryption-tata<</manifest:file-entry<<manifest:file-entry manifest:metia-typep"" manifest:full-pathp"Pictures/"/<<manifest:file-entry manifest:metia-typep"text/xml"
manifest:full-pathp"content.xml"
manifest:sivep"31:3"<<manifest:encryption-tata<<manifest:algorithm manifest:algorithm-namep"Blowfish CFB"
manifest:initialisation-vectorp"Ttmiu:03:-:p"/<<manifest:key-terivation manifest:key-terivation-namep"PB tF2"
manifest:iteration-countp"102:" manifest:saltp"aNYtmqv:cObAJSJim:evqApp"/<</manifest:encryption-tata<</manifest:file-entry<<manifest:file-entry manifest:metia-typep"text/xml"
manifest:full-pathp"styles.xml" manifest:sivep"4149"<<manifest:encryption-tata<<manifest:algorithm manifest:algorithm-namep"Blowfish CFB"
manifest:initialisation-vectorp"bChL2No4ItAp"/<<manifest:key-terivation manifest:key-terivation-namep"PB tF2"
manifest:iteration-countp"102:" manifest:saltp"/kfasyu:X0Aet1uopteCtApp"/<</manifest:encryption-tata<</manifest:file-entry<<manifest:file-entry manifest:metia-typep"text/xml" manifest:full-pathp"meta.xml"/<<manifest:file-entry manifest:metia-typep"text/xml"
manifest:full-pathp"settings.xml" manifest:sivep"431:"<<manifest:encryption-tata<<manifest:algorithm manifest:algorithm-namep"Blowfish CFB"
manifest:initialisation-vectorp"JtxEm:rtt:cp"/<<manifest:key-terivation manifest:key-terivation-namep"PB tF2"
manifest:iteration-countp"102:" manifest:saltp"Plptaxloh: | xtv1g:"9gpp"/<</manifest:encryption-tata<</manifest:file-entry<</manifest:manifest<

Chapter OO Package Format

547

Gaossary
TermDefinition

4 Iu r 9

ttribStes are Ssed to assoiiate name-raaSe pairs tith eaementsc Eaih
attribSte speiiiiiation has a name and a raaSec ttribSte speiiiiiations may
appear onay tithin start-tags and empty-eaement tagsc

4r n 4 uoi9 yT 9istyae that is aStomatiiaaay generated then the doiSment is e.portedc The
aStomatii styae is assigned to objeits sSih as paragraphss so that a separation oi iontent and aayoSt is aihieredc

ntyi.Inrobody groSp is a groSp oi rots or ioaSmns that do not repeat airosspagesc Typiiaaays a body groSp iontains the iontent oi the tabae that is notpart oi the headerc

or4I4o I9Parsed data is made Sp oi iharaiterss some oi thiih iorm iharaiter datas
and some oi thiih iorm markSpc

onTT4o9u1.i nIt Ii nt T

This is a modea oi hot to represent tabae bordersc The ioaaapsing bordermodea means that then tto adjaient ieaas hare diiierent borderss thetider border appears as the border betteen the ieaasc Eaih ieaa reieires
haai oi the tidth oi the borderc

onTr 1i.Inro

YoS ian groSp ioaSmns in ioaSmn groSpsc These groSps speiiiy thether
or not to repeat a ioaSmn on the ne.t pagec CoaSmn groSps ian be either
body groSps or header groSpsc tabae mSst iontain at aeast one ioaSmn
body groSps bSt onay one ioaSmn header groSpc

on

19

Comments may appear anythere in a doiSment oStside other markSpc nadditions they may appear tithin the doiSment type deiaaration at paaies
aaaoted by the grammarc They are not part oi the iharaiter data oi a doiSmentc n X L proiessor mays bSt need nots make it possibae ior an appaiiation to retriere the te.t oi iommentsc

onn1i9 yT 9

The styae that an OpenOiiiiecorg Sser tho doesn't iare aboSt the
OpenOiiiiecorg X L iiae iormat e.peits to be a styaec The term common
styles is Ssed to diiierentiate in iases there there might be ioniSsion tithautomatic stylesn othertise it is the same as stylesc
The te.t betteen the start-tag and end-tag is the iontent oi an elementc

on1 1
hh

Casiading tyae heethh1

Casiading styae sheetss aerea corII 1 ieuT ienI 4 iv I9un1

This rersion stores aaa the iniormation iontained in the doiSment tithoSt
aosing any iniormation then the doiSment is read againc

ooE

Dynamii Data E.ihangec

tnor

1i T

1

n OpenOiiiiecorg X L doiSment begins tith a doiSment elementc

549

Term

Definitiontnor

1 ieu Tt9

The ioaaeitire name ior iieads that dispaay iniormation aboSt the iSrrent
doiSment or a speiiiii part oi the iSrrent doiSmentc For e.ampaes theaSthors the iSrrent page nSmbers or the doiSment ireation datec

tnor

1 iInn i

The doiSment root eaement is the primary eaement ior deiining the iharaiteristiis oi an X L doiSmentc

tnor

1 i yo it oT4I4 un1

The doiSment type deiaaration ian point to an e.ternaa sSbset iontaining
markSp deiaarationss or ian iontain the markSp deiaarations direitay in aninternaa sSbsets or ian do bothc The DTD ior a doiSment ionsists oi bothsSbsets taken togetherc

tI4Au1.io4.

The main aoiation ior iontent in a drating or presentation doiSmentco o

The X L doiSment type deiaaration iontains or points to markSp deiaarations that proride a grammar ior a iaass oi doiSmentsc This grammar isknotn as a doiSment type deiinitions or DTDc

T

19

1uy

X L doiSments are made Sp oi storage Snits iaaaed entitiess thiih
iontain either parsed or Snparsed datac Entities may reier to other entities
to iaSse their iniaSsion in the doiSmentc

EtEnd-oi-aine
I14Ti9 yT 9i. 1 Iuoiut 1 ueu I

tyaes not iontained tithin the X L iiae that iontains the iontentc
The type oi an eaementc
ee meneeic identifieecir 4t Ii.Inroheader groSp is a groSp oi rots or ioaSmns that repeat on eaih page ii
the tabae e.tends orer sereraa pagesc

u1 I14Ti9 yT 9ityaes iontained tithin the X L iiae that iontains the iontentc

Tu9 iT v Ti9 yT 9aist aerea styae is a speiiiiiation iontaining a set oi properties to appay toa aist oi a iertain aist aereac

4I ro

Code desiription oi the storage aayoSt and aogiiaa strSitSre oi an X L
doiSmentc arkSp takes the iorm oi start-tagss end-tagss empty-eaement
tagss entity reiereniess iharaiter reiereniess iommentss CD T seition
deaimiterss doiSment type deiaarationss and proiessing instrSitionsc

49 Iio4.

The iommon baikgroSnd ior a drating pagec Eaih drating page mSst beainked to one master pagec

4t4 4etadata is generaa iniormation aboSt the doiSments sSih as titaes aSthors
ireation dates and so onc
token beginning tith a aetter or one oi a iet pSnitSation iharaiterss andiontinSing tith aetterss digitss hyphenss Sndersioress ioaonss or iSaa stopss
together knotn as name iharaitersc

14

14

9o4o 9Namespaies aaaot yoS to deiine speiiiii names ior eaementsc The pSrposeoi namespaies is to aroid ioniaiits betteen doiSments irom rarioSs
aSthors tith diiierent naming ionrentionsc1n 1

Name token; any mi.tSre oi name iharaitersc

nIor41550

Eaih X L doiSment iontains one or more eaementss the boSndaries oi
thiih are either deaimited by start-tags and end-tagss ors ior empty
eaementss by an empty-eaement tagc Eaih eaement has a types identiiied bynames and may hare a set oi attribSte speiiiiiationsc

n orphan is a short aine at the start oi a paragraphs thiih then printeds
appears aaone at the bottom oi the pagec

OpenOffice.org XML File Format Working Draft Technical Reference Manual

Version 2

December 2ee2

TermDefinitiono4. i 49 I

page-master speiiiies the sikes border and orientation oi a master pages
qcrc

o4I4.I4ori T

The X L eaements that are Ssed to represent headings and paragraphs in
te.tc

19

InAi.InroYoS ian groSp rots in rot groSpsc These groSps speiiiy thether or not torepeat a rot on the ne.t pagec ot groSps ian be either body groSps orheader groSpsc tabae mSst iontain at aeast one rot body groSps bSt onay
one rot header groSpc

9 o4I4 u1.i nIt Ii nt T

This is a modea oi hot to represent tabae bordersc The separating bordermodea means that borders appear tithin the ieaa that speiiiies the borderc

9 r 1o iv4Iu4 T

seqSenie rariabae nSmbers items sSih as tabaes or images in a doiSmentc

h gtandard Generaaiked

9u oT iv4Iu4 T

simpae rariabae ian hare diiierent raaSes at diiierent times in a doiSmentc

9 In ioIno I u 9

VG stroke properties deiine graphii objeit aine iharaiteristiis in
OpenOiiiiecorg Drat and OpenOiiiiecorg mpress doiSments:

9 yT 9The X L representations oi the styaes that are araiaabae in the
OpenOiiiiecorg Sser interiaiec

9r 4 TsSbtabae is a tabae tithin another tabaec t oiiSpies one ieaa and no otheriontent ian appear in this ieaac i a tabae ieaa iontains a sSbtabaes it iannot
iontain any paragraphsc Sbtabaes are sometimes reierred to as nested
tabaeschh

iaaar Veitor Graphiisc n X L aangSage ior ireating reitor graphiis innternet-rietabae doiSmentsc

yo

The name in the start-tags and end-tags gires the eaement types see aaso
meneeic identifieec
Sser rariabae has the same raaSe throSghoSt a doiSmentc

r9 Iiv4Iu4 T

n X L doiSment is raaid ii it has an assoiiated doiSment type deiaaration and ii the doiSment iompaies tith the ionstraints e.pressed in itc

v4Tut
A TT-enI

arkSp LangSagec

titnor1i

n a teaa-iormed doiSments the aogiiaa and physiiaa strSitSres in an X L
doiSment are properay nestedc ConseqSentays no start-tags end-tags emptyeaement tags eaements iomments proiessing instrSitions iharaiter reierenies or entity reierenie ian begin in one entity and end in anotherc

T2

Dorad Dide Deb Committeec

AutnA

tidot is a short aine at the end oi a paragraphs thiih then printeds
appear aaone at the top oi the ne.t pagec

r u1 9Oyperainks in X L doiSmentss identiiied by the xml:links attribStec
XLink gorerns hot yoS insert ainks into yoSr X L doiSments and there
the aink might points toc

rg i

The eXtensibae arkSp LangSage iX Lo is a sSbset oi G L desiribedin the D4C X L peiiiiiationc The goaa oi X L is to enabae generii
G L to be serreds reieireds and proiessed on the Deb in a tay iomparabae to OT Lc X L prorides ease oi impaementation and interoperabiaity tith both G L and OT Lc

rg itnor

1 9i

iaass oi data objeits desiribed by X Lc X L doiSments are
ioniorming G L doiSmentsc

Preface

551

552

Term

Definitionrg ioIno 99nI

soittare modSae Ssed to read X L doiSments and proride aiiess totheir iontent and strSitSrec

r 4r

X L Path LangSage; a aangSage ior addressing parts oi an X L doiSments designed to be Ssed by both X LT and XPointercrh

E.tensibae tyae heet LangSage; a styaesheet aangSage ior X Lc Dhen
yoS Sse X L aaa yoSr doiSments are iormatted the same tays no matter
thiih appaiiation or paatiorm they are oncrh

X LT is a aangSage ior transiorming X L doiSments into other X L
doiSmentsc X LT is designed ior Sse as part oi X Ls or independentay oi
X Lc

r nu1 I

XPointer gorerns the iragment identiiier that ian go on a
L thenyoS're ainking to an X L doiSment irom anytheres ior e.ampae irom an
OT L iiaec XPointer and XLinks are part oi the same paikagec

OpenOffice.org XML File Format Working Draft Technical Reference Manual

Version 2

December 2ee2

nde.

1t
-time 004
l ieaa-address ml ieaa-range-address ml ieaa-range-address-aist m
ldatabase-tabae; 06
lnSm-iormat; 0 r
lraaSe-attaist; 0 5lrariabae-deiaarations; 0r4
lrariabae-iieads; 0r4
aaiiea:aiieaeratoraist< 9 4
aaiiea:item< 9 4
aihart:a.is< 9mraihart:iategories< 9r4
aihart:ihart< 9maihart:data-point< 9r4
aihart:domain< 9raihart:iaoor< 9mmaihart:grid< 9r0
aihart:aegend< 9m9aihart:paot-area< 9m5
aihart:series< 9r
aihart:sSbtitae< 9m9aihart:titae< 9m4
aihart:taaa< 9m6
aioniig:ioniig-item-map-entry< 005
aioniig:ioniig-item-map-inde.ed< 005
aioniig:ioniig-item-map-named< 005
aioniig:ioniig-item-set< 005
aioniig:ioniig-item< 009
adi:ireator< 4m
adi:date< 4r
adi:desiription< 46adi:aangSage< 90
adi:sSbjeit< 4m
adi:titae< 46
adag:bSaaetinboard< 509
adag:bStton< 50
adag:iheikbo.< 5 2
adag:iombobo.< 5 0s 5
adag:iSrreniyiiead< 540

adag:dateiiead< 5 r
adag:iiaeiontroa< 5 m
adag:ii.edaine< 545
adag:iormattediiead< 544s 549
adag:img< 5 m
adag:menSitem< 5 0s 5 s 5 4
adag:menSaist< 5 0
adag:menSpopSp< 5 0s 5
adag:nSmeriiiiead< 542
adag:patterniiead< 54 s 544
adag:progressmeter< 546s 54m
adag:radio< 5 4s 5 9
adag:radiogroSp< 5 4
adag:siroaabar< 545s 546
adag:styae< 506
adag:styaes< 505
adag:te.t< 5 5
adag:te.tiiead< 5 5s 5 6
adag:timeiiead< 5
adag:titae< 5 5
adag:titaedbo.< 5 9s 5 5
adag:tindot< 504
adrat:a< 025
adrat:appaet< radrat:iaption< 492
adrat:iiriae< 446
adrat:ionneitor< 44r
adrat:iontoSr-path< 4adrat:iontoSr-poaygon< 4adrat:iontroa< 494
adrat:desi< 9adrat:eaaipse< 44m
adrat:iiaa-image< 45adrat:iaoating-irame< 4adrat:g< 499
adrat:gaSe-point< 4r6
adrat:gradient< 456
adrat:hatih< 45r
adrat:image< r6adrat:aine< 44adrat:marker< 46

Index

553

adrat:measSre< 49adrat:page-thSmbnaia< 494
adrat:page-thSmbnaia<s 4 m
adrat:page< 4adrat:param<
adrat:path< 449
adrat:paSgin< 0adrat:poaygon< 449
adrat:poayaine< 444
adrat:reit< 440adrat:te.t-bo.< r5adrat:transpareniy< 462
aerent:erent< 52m
aerent:erents< 52maiorm:bStton< 905aiorm:iheikbo.< 906aiorm:ioaSmn< 9 2aiorm:iombobo.< 90aiorm:iontroa< 92maiorm:iiae< 902aiorm:ii.ed-te.t< 90aiorm:iorm< 92aiorm:iormatted-te.t< 900aiorm:irame< 90r
aiorm:generii-iontroa< 9 2aiorm:grid< 90aiorm:hidden< 90aiorm:image-irame< 90r
aiorm:image< 905aiorm:item< 904aiorm:aistbo.< 909
aiorm:option< 909
aiorm:passtord< 902aiorm:properties< 949
aiorm:property-raaSe< 946
aiorm:property< 945
aiorm:radio< 90r
aiorm:te.t< 92raiorm:te.tarea< 92aimage:entry< 502
aimage:e.ternaaentry< 500
aimage:e.ternaaimages< 500
aimage:images< 52aimage:imagesiontainer< 52
amaniiest:aagorithm< 599
amaniiest:eniryption-data< 599
amaniiest:iiae-entry< 594
amaniiest:key-deriration< 595
amaniiest:maniiest< 594
amenS:menS< 9 2
amenS:menSbar< 9 2
amenS:menSitem< 9 0
amenS:menSpopSp< 9 2
amenS:menSseparator< 9 0ameta:aSto-reaoad< 4ameta:ireation-date< 4r
554

OpenOffice.org XML File Format Working Draft

ameta:doiSment-statistii< 9ameta:editing-iyiaes< 90
ameta:editing-dSration< 9ameta:generator< 46ameta:hyperaink-beharioSr< 92
ameta:initiaa-ireator< 4mameta:keytords< 4mameta:print-date< 4rameta:printed-by< 4mameta:tempaate< 4rameta:Sser-deiined< 9anSmber:am-pm< m9
anSmber:booaean-styae< m5
anSmber:booaean< m5
anSmber:iSrreniy-styae< 6m
anSmber:iSrreniy-symboa< 6m
anSmber:date-styae< 6r
anSmber:day-oi-teek< m0
anSmber:day< 6anSmber:era< m2
anSmber:iraition< 66
anSmber:hoSrs< m4
anSmber:minStes< m4
anSmber:month< 6
anSmber:nSmber-styae< 69
anSmber:nSmber< 65
anSmber:perientage-styae< 6r
anSmber:qSarter< manSmber:siientiiii-nSmber< 66
anSmber:seionds< m9
anSmber:te.t-iontent< m6
anSmber:te.t-styae< m5
anSmber:te.t< m5
anSmber:time-styae< manSmber:teek-oi-year< m0
anSmber:year< m2
aoiiiie:annotation< m5aoiiiie:ihange-inio< 004
aoiiiie:dde-soSrie< 0aoiiiie:erents< 000s 94
aoiiiie:iont-deias< 64
aoiiiie:iorms< 92
aoiiiie:meta< 46
aoiiiie:settings< 009
apresentation:notes< 4 rapresentation:paaiehoader< 4rm
apresentation:settings< 4 2
apresentation:shot< 4 9asiript:erent< 000s 54m
asiript:aistener-erent< 54asiript:siript< 002
astyae:baikgroSnd-image< 5astyae:ioaSmn-sep< 4astyae:ioaSmn< 40astyae:ioaSmns< 42astyae:drop-iap<
Technical Reference Manual Version 2

December 2ee2

astyae:iont-deia< 64astyae:iooter-aeit< 62astyae:iooter-styae< 62astyae:iooter< 62astyae:iootnote-aayoSt< 60
astyae:iootnote-sep< 6astyae:handoSt-master< 4 mastyae:header-aeit< 62astyae:header-styae< 62astyae:header< 62astyae:map< 9astyae:master-page< 4 6astyae:master-page< 5r
astyae:page-master< 5astyae:presentation-page-aayoSt< 4r6
astyae:properties< 95astyae:styae< 96astyae:tab-stop< 0astyae:tab-stops< 0atabae:iaaiSaation-settings< 92
atabae:ieaa-iontent-ihange< 54s 59
atabae:ieaa-iontent-deaetion< 95atabae:ieaa-range-soSrie< m4atabae:ihange-deaetion< 95atabae:ihange-traik-tabae-ieaa< 5atabae:ionsoaidation< 404
atabae:iontent-raaidation< r2atabae:iontent-raaidations< r2
atabae:iorered-tabae-ieaa< 6r
atabae:iSt-oiis< 9r
atabae:data-piaot-iiead< 402
atabae:data-piaot-aerea< 400atabae:data-piaot-member< 40
atabae:data-piaot-members< 40
atabae:data-piaot-sSbtotaa< 40
atabae:data-piaot-sSbtotaas< 40
atabae:data-piaot-tabae< 426
atabae:data-piaot-tabaes< 425
atabae:database-range< 6atabae:database-ranges< 6atabae:database-soSrie-qSery< 422
atabae:database-soSrie-sqa< ratabae:database-soSrie-tabae<atabae:dde-aink< 405
atabae:dde-ainks< 405
atabae:deaetion< 9matabae:deaetions< 95
atabae:dependenie< 95atabae:dependenies< 99atabae:deteitire< m6atabae:error-mairo< r4atabae:error-message< ratabae:iiater-and< 4atabae:iiater-iondition< 9atabae:iiater-or< 9atabae:iiater<

atabae:heap-message< ratabae:highaighted-range< m6atabae:insertion-iSt-oii< 9atabae:insertion< 96atabae:iteration< 94atabae:aabea-range< ratabae:aabea-ranges< rratabae:morement-iSt-oii< 9atabae:morement< 52
atabae:named-e.pression< 0atabae:named-e.pressions< 2atabae:named-range< 2atabae:nSaa-date< 9atabae:operation< mmatabae:sienario< 5ratabae:shapes< 62atabae:sort-by< 420atabae:sort-groSps< 424
atabae:sort< 422
atabae:soSrie-ieaa-range< 42atabae:soSrie-serriie< 42r
atabae:sSb-tabae< r9atabae:sSbtotaa-iiead< 429
atabae:sSbtotaa-rSae< 429
atabae:sSbtotaa-rSaes< 42atabae:tabae-ieaa< 6r
atabae:tabae-ioaSmn-groSp< 60
atabae:tabae-ioaSmn< 6atabae:tabae-ioaSmns< 6atabae:tabae-header-ioaSmns< 6atabae:tabae-header-rots< 65
atabae:tabae-rot-groSp< 69
atabae:tabae-rot< 65
atabae:tabae-rots< 65
atabae:tabae-soSrie< 5matabae:tabae< 55
atabae:traiked-ihanges< 99
ate.t:a< 0
ate.t:aapha-inde.-mark-end< 952
ate.t:aapha-inde.-mark-start< 99
ate.t:aapha-inde.-mark< 952
ate.t:aaphabetiiaa-inde.-entry-tempaate< 966
ate.t:aaphabetiiaa-inde.-soSrie< 964
ate.t:aaphabetiiaa-inde.< 964
ate.t:aSthor-initiaas< 060
ate.t:aSthor-name< 060
ate.t:bibaiography-entry-tempaate< 96r
ate.t:bibaiography-mark< 952
ate.t:bibaiography-soSrie< 96r
ate.t:bibaiography< 96m
ate.t:bookmark-end< 0 9
ate.t:bookmark-rei< 0r0
ate.t:bookmark-start< 0 9
ate.t:bookmark< 0 9
ate.t:ihange-end< 45
ate.t:ihange-start< 49
Index

555

ate.t:ihange< 45
ate.t:ihanged-region< 49
ate.t:ihapter< 0m9
ate.t:ionditionaa-te.t< 0m0
ate.t:ireation-date< 06m
ate.t:ireation-time< 06m
ate.t:ireator< 0m2
ate.t:database-dispaay< 064
ate.t:database-name< 066
ate.t:database-ne.t< 069
ate.t:database-rot-nSmber< 065
ate.t:database-rot-seaeit< 065
ate.t:date< 054
ate.t:dde-ionneition-deia< 0mr
ate.t:dde-ionneition-deias< 0mr
ate.t:dde-ionneition< 0r2
ate.t:deaetion< 46
ate.t:desiription< 06m
ate.t:editing-iyiaes< 06
ate.t:editing-dSration< 06
ate.t:endnote-body< 05
ate.t:endnote-iitation< 050
ate.t:endnote-rei< 0r0
ate.t:endnote< 050
ate.t:endnotes-ioniigSration< 09ate.t:e.eiSte-mairo< 0mr
ate.t:e.pression< 0 0
ate.t:iiae-name< 0m5
ate.t:iootnote-body< 052
ate.t:iootnote-iitation< 09ate.t:iootnote-iontinSation-notiie-baiktard< 09r
ate.t:iootnote-iontinSation-notiie-iortard< 09r
ate.t:iootnote-rei< 0r0
ate.t:iootnote< 09
ate.t:iootnotes-ioniigSration< 096
ate.t:iormat-ihange< 46
ate.t:get-page-rariabae< 0mm
ate.t:h< 00r
ate.t:hidden-paragraph< 0m4
ate.t:hidden-te.t< 0m
ate.t:iaaSstration-inde.-entry-tempaate< 95m
ate.t:iaaSstration-inde.-soSrie< 955
ate.t:iaaSstration-inde.< 955
ate.t:inde.-body< 94r
ate.t:inde.-entry-bibaiography< 99
ate.t:inde.-entry-ihapter-nSmber< 990
ate.t:inde.-entry-ihapter< 990
ate.t:inde.-entry-aink-end< 995
ate.t:inde.-entry-aink-start< 995
ate.t:inde.-entry-page-nSmber< 99
ate.t:inde.-entry-span< 99
ate.t:inde.-entry-tab-stop< 994
ate.t:inde.-entry-tempaate< 94
ate.t:inde.-entry-te.t< 99
ate.t:inde.-soSrie-styae< 996
ate.t:inde.-soSrie-styaes< 996
556

OpenOffice.org XML File Format Working Draft

ate.t:inde.-titae-tempaate< 94r
ate.t:initiaa-ireator< 066
ate.t:insertion< 45
ate.t:keytords< 06
ate.t:aine-break< 0 0
ate.t:ainenSmbering-ioniigSration< 09ate.t:ainenSmbering-seperator< 095
ate.t:aist-header< 04
ate.t:aist-item< 044
ate.t:aist-aerea-styae-bSaaet< 04r
ate.t:aist-aerea-styae-image< 04
ate.t:aist-aerea-styae-nSmber< 045
ate.t:aist-aerea-styae-nSmbering< 04m
ate.t:aist-styae< 049
ate.t:modiiiiation-date dSration< 0m2
ate.t:modiiiiation-time< 0m2
ate.t:objeit-inde.-entry-tempaate< 962
ate.t:objeit-inde.-soSrie< 95
ate.t:objeit-inde.< 95r
ate.t:ordered-aist< 040
ate.t:oStaine-aerea-styae< 090
ate.t:oStaine-styae< 090
ate.t:p< 00r
ate.t:page-iontinSation< 05m
ate.t:page-nSmber< 055
ate.t:paaiehoader< 060
ate.t:print-date< 06r
ate.t:print-time< 06r
ate.t:printed-by< 06r
ate.t:reierenie-mark-end< 0 5
ate.t:reierenie-mark-start< 0 5
ate.t:reierenie-mark< 0 5
ate.t:reierenie-rei< 0r0
ate.t:rSby-base < 2
ate.t:rSby-te.t < 24
ate.t:rSby< 20
ate.t:s< 0 2
ate.t:seition-soSrie< 0 r
ate.t:seition< 0 m
ate.t:sender-iity< 062
ate.t:sender-iompany< 05
ate.t:sender-ioSntry< 062
ate.t:sender-emaia< 05r
ate.t:sender-ia.< 05
ate.t:sender-iirstname< 05m
ate.t:sender-initiaas< 05r
ate.t:sender-aastname< 05r
ate.t:sender-phone-prirate< 05
ate.t:sender-phone-tork< 05
ate.t:sender-position< 05r
ate.t:sender-postaa-iode< 062
ate.t:sender-state-or-prorinie< 062
ate.t:sender-street< 05
ate.t:sender-titae< 05r
ate.t:seqSenie-deia< 0r
ate.t:seqSenie-rei< 0r0
Technical Reference Manual Version 2

December 2ee2

ate.t:seqSenie< 0 2
ate.t:set-page-rariabae< 0mm
ate.t:span< 0 0
ate.t:sSbjeit< 06
ate.t:tab-stop< 0 0
ate.t:tabae-inde.-entry-tempaate< 95r
ate.t:tabae-inde.-soSrie< 95m
ate.t:tabae-inde.< 95m
ate.t:tabae-oi-iontent-entry-tempaate< 954
ate.t:tabae-oi-iontent-soSrie< 95
ate.t:tabae-oi-iontent< 95
ate.t:tempaate-name< 0m6
ate.t:te.t-inpSt< 0
ate.t:time< 059
ate.t:titae< 06r
ate.t:toi-mark-end< 99r
ate.t:toi-mark-start< 99m
ate.t:toi-mark< 99r
ate.t:traiked-ihanges< 44
ate.t:Snordered-aist< 040
ate.t:Sser-deiined< 06m
ate.t:Sser-iiead-deia< 0rm
ate.t:Sser-iiead-get< 0rm
ate.t:Sser-iiead-inpSt< 0rr
ate.t:Sser-inde.-entry-tempaate< 96
ate.t:Sser-inde.-mark-end< 99r
ate.t:Sser-inde.-mark-start< 99r
ate.t:Sser-inde.-mark< 99
ate.t:Sser-inde.-soSrie< 960
ate.t:Sser-inde.< 962
ate.t:rariabae-deia< 0r9
ate.t:rariabae-get< 0r5
ate.t:rariabae-inpSt< 0r6
ate.t:rariabae-set< 0r9
atooabar:tooabar< 9atooabar:tooabaritem< 522
atooabar:tooabaraayoSt< 524
4D geometry properties 4r0
4D aighting properties 4r
4D materiaa properties 4r9
4D shapes 49
4D te.tSre properties 4r4A
aiiea:iode 9 4
aiiea:mod0 9 9aiiea:shiit 9 9aaternatire te.t 9
sP m9
anihor position 0
anihor type 0
animation properties 4m5
annotation eaement m5
aSthor iieads 062

aStomatii reaoad 4
aStomatii styae 40
aStomatii styaes 99
aStomatii te.t indent 9
aStomatii Spdate ior styaes 9r
aStomatiiaaay order ma.is 9mmB
baikgroSnd attribStes 442
baikgroSnd styaes ior drating shapes 442
base ieaa address 0
bibaiography data 99
bitmap 46r
body eaement 44
bookmarks 0 9
Booaean m5
Booaean styae m9border and border aine tidth ior irames 022
break inside 0r
bSaaet iharaiter 04r
bSaaet aerea styae 04m

Ciaption 492s 956
iaption point attribStes 490
iategories 9r
ieaa address entity mrieaa iSrrent Booaean raaSe attribSte mieaa iSrrent iSrreniy raaSe attribSte mieaa iSrrent date raaSe attribSte mieaa iSrrent nSmerii raaSe attribSte m0
ieaa iSrrent string raaSe attribSte mieaa iSrrent time raaSe attribSte mieaa range address attribSte r s 2
ieaa range address entity mieaa styae attribSte 6
ieaa raaSe type attribSte m0
ienter point attribStes 446
ihaining r6ihange end 45
ihange position 45
ihange start 49
ihange traiking 00 s 44s 94
ihanged region 49
ihapter iieads 0m9ihapter nSmber 990
ihart a.is 9mm
ihart data aabeas 9r9ihart data series 9r0
ihart iaoor 9mm
ihart aegend 9m9

Index

557

ihart paot area 9m9
ihart propertiess iommon 9r4
ihart sSbtitae 9m4
ihart titae 9m4
ihart taaa 9m6
ihart:a.is-shot-te.t 9r0
ihart:a.is-te.t-break 9r0
ihart:a.is-te.t-oreraap 9r0
ihart:a.is-tiiks-major-inner 9r0
ihart:a.is-tiiks-major-oSter 9r0
ihart:a.is-tiiks-minor-inner 9r0
ihart:a.is-tiiks-minor-oSter 9r0
ihart:a.is-risibae 9r2
ihart:iaass 9m
ihart:data-aabea-nSmber 9r9
ihart:data-aabea-symboa 9r5
ihart:data-aabea-te.t 9r5
ihart:siaae-te.t 9m4
ihart:stoik-Spdotn-bars
ihart:stoik-tith-roaSme
ihart:three-dimensionaa
ihart:deep
ihart:aines
ihart:perientage
ihart:soaid-typeihart:spaines
ihart:staiked
ihart:symboa
ihart:rertiiaa
ihart:aines-Ssed
ihart:ionneit-bars 9m6
ihart:te.t-staiked 9r9iharts 9m
iheiked 5 9iiriae 445
iaass attribSte 42
iaipping 024
ioaor 24
ioaSmn desiription 6
ioaSmn iormatting properties 40
ioaSmn groSp eaement 60
ioaSmn separator 4
ioaSmn styae attribSte 6
ioaSmns 022
iommon styaes 40
ionditionaa te.t iieads 0m2
ionneitor 44rionseiStire nSmbering 045
iontinSe nSmbering 04
iontoSr 4
iontoSr trapping mode 02
iontoSr-onay trapping 020
iontroa D 9 0
iontroas 92m
iontroass bStton 905
iontroass iheik bo. 906
iontroass ioaSmn grid 9 2
558

OpenOffice.org XML File Format Working Draft

iontroass iombo bo. 90
iontroass iombo bo. aist items 904
iontroass iiae seaeition 902
iontroass ii.ed te.t inpSt 90 s 52ms 52 s 502s 500
iontroass iormatted te.t inpSt 900
iontroass irame 90r
iontroass generii 9 2
iontroass graphiiaa bStton 905
iontroass grid ior tabae data 90
iontroass hidden 90
iontroass image irames 90r
iontroass aist bo. 909
iontroass aist bo. items 909
iontroass passtord 902
iontroass radio bSttons 90m
iontroass te.t bo. 92r
ionrentions 9
ioSntry mrs 2
ireation date and time 4r
ireator 4m
irossing oSt 29
iSrreniy aangSage and ioSntry 6miSrreniy styae 66
iSrreniy symboa 6m
iSrrent iiae iormat 49
iSrrent iiae iormat rersion 49
iSrrent rersion 49

Ddata piaot tabaes 425
data point 9r4
data styae iormatting properties m6
data styae mappings m6
data styaes 69
data styaes namespaie 69
database iieads 06
database range 6
database soSrie qSery 422
database soSrie tabaedate 4r
date adjSstment 059
date iieads 054
date styae 6r
date raaSe 059
day oi the month 6
day oi teek eaement m0
DDE ionneition attribStes 56
DDE ionneition iieads 0r2
DDE ionneitions 0mr
deiimaa paaies m9s r
deiimaa repaaiement r4
deaay 92
deaetion 45s 9m
deaimiter iharaiter 0
Technical Reference Manual Version 2

December 2ee2

desiription 46
disiaaimer 4
dispaay dSpaiiates attribSte 4
dispaay iaitor r4
dispaay aereas 04m
dag: 5 2s 5 s 5 4s 5 9s 5 5s 5 6s 5 ms 5 rs 5 s 542s 540s 54 s
544s 549s 545s 546s 54m
dag:aaign 5 5s 5 6s 549s 545s 546
dag:aStoiompaete 5
dag:bStton-type 5 2
dag:iheiked 5 2s 5 9
dag:iSrpos 546
dag:iSrreniy-symboa 54
dag:date-iormat 5 r
dag:deiimaa-aiiSraiy 540s 54
dag:deiaSat 5 2
dag:eihoihar 5 6
dag:edit-mask 544
dag:iormat-iode 545
dag:iormat-aoiaae 545
dag:hard-ainebreaks 5 6
dag:hsiroaa 5 6
dag:inirement 546
dag:aineioSnt 5 0s 5
dag:aiteraa-mask 544
dag:ma.aength 5 s 5 6s 549
dag:ma.pos 546
dag:mSatiaine 5 5s 5 6
dag:mSatiseaeition 5 0
dag:pageinirement 546
dag:readonay 5 s 5 6s 5 rs 5 s 542s 54 s 544s 549
dag:siaae-image 5 m
dag:seaeited 5 4
dag:spin 5 0s 5 s 5 s 542s 540s 54 s 549
dag:sri 5 m
dag:striit-iormat 5 rs 5 s 542s 54 s 544s 549
dag:tabstop 5 2s 5 0s 5 s 5 9s 5 6s 5 ms 5 rs 5 s 542s 54 s
544s 549
dag:te.t 549
dag:thoSsands-separator 540s 54
dag:time-iormat 5
dag:tristate 5 2s 5 9
dag:raaSe 5 2s 5 s 5 4s 5 9s 5 5s 5 6s 5 ms 5 rs 5 s 540s 54 s
544s 545s 54m
dag:raaSe-deiaSat 545
dag:raaSe-ma. 5 s 542s 540s 54 s 549s 54m
dag:raaSe-min 5 rs 542s 540s 54 s 549s 54m
dag:raaSe-step 5 s 542s 540s 54
dag:risibae-sike 546
dag:rsiroaa 5 6
doiSment ireation date and time 4r
doiSment desiription 46
doiSment iieads 054
doiSment keytords 4m
doiSment modiiiiation date 4r
doiSment root eaement rs

doiSment sSbjeit 46
doiSment tempaate name iieads 0m6
doiSment titae 46
doiSment type attribSte 42
domain 9r
dr4d:ambient-ioaor 4r9
dr4d:baik-siaae 4r
dr4d:baikiaie-iSaaing 4r
dr4d:depth 4r s 4r4
dr4d:diiiSse-ioaor 4r9
dr4d:edge-roSnding 4r0
dr4d:edge-roSnding-mode 4r
dr4d:emissire-ioaor 4r9
dr4d:horikontaa-segments 4r0
dr4d:aighting-mode 4r
dr4d:normaas-direition 4r4s 4r9
dr4d:shininess 4r9
dr4d:speiSaar-ioaor 4r9
dr4d:te.tSre-iiater 4r9
dr4d:te.tSre-generation-mode-. 4r4
dr4d:te.tSre-generation-mode-y 4r4
dr4d:te.tSre-kind 4r4
dr4d:rertiiaa-segments 4r0
drat:angae 45r
drat:arihire 2
drat:aSto-grot-tidthdrat:aSto-grot-height 4m
drat:baSe 4m9
drat:border 45r
drat:iaption-point-. 490
drat:iaption-point-y 490
drat:iode 2
drat:iodebase 2
drat:ioaor-mode 4m4
drat:iontrast 4m4
drat:iorner-radiSs 44 s 490
drat:distanie 45
drat:end-ioaor 45m
drat:end-gaSe-point 492
drat:end-gSide 4mm
drat:end-intensity 45m
drat:end-aine-spaiing-horikontaa 4m6
drat:end-aine-spaiing-rertiiaa 4m6
drat:end-shape 492
drat:iiaa 46m
drat:iiaa-ioaor 46m
drat:iiaa-gradient-name 46m
drat:iiaa-hatih-name 46m
drat:iiaa-image-height 46r
drat:iiaa-image-name 46r
drat:iiaa-image-tidth 46r
drat:iiater-name rm
drat:iit-to-sike 4m
drat:gamma 4m9
drat:gradient-step-ioSnt 46m
drat:green 4m9
Index

559

drat:gSide-distanie 4mm
drat:gSide-orerhang 4mm
drat:id 49m
drat:kind 44m
drat:aayer 49m
drat:aine-distanie 4m6
drat:aine-sket 492
drat:aSminanie 4m4
drat:marker-end 465
drat:marker-end-ienter 466
drat:marker-end-tidth 465
drat:marker-start 465
drat:marker-start-ienter 465
drat:marker-start-tidth 465
drat:maysiript 0
drat:measSre-aaign 4mr
drat:measSre-rertiiaa-aaign 4mr
drat:mimetype 0
drat:name r5
drat:objeit 2
drat:paraaaea 4mr
drat:paaiing 4mm
drat:red 4m9
drat:reiX 46
drat:reiY 46
drat:rotation 45
drat:shadot 4m5
drat:shadot-ioaor 4m5
drat:shadot-distanie-. 4m5
drat:shadot-distanie-y 4m5
drat:shadot-transpareniy 4m6
drat:start-ioaor 45m
drat:start-gaSe-point 44
drat:start-gSide 4mm
drat:start-intensity 45m
drat:start-aine-spaiing-horikontaa 4m6
drat:start-aine-spaiing-rertiiaa 4m6
drat:start-shape 44
drat:stroke 469
drat:styae-name r6s rms 496
drat:te.tarea-horikontaa-aaign 4m
drat:te.tarea-rertiiaa-aaign 4m
drat:tiae-repeat-oiiset 46
drat:transiorm 496
drat:transpareniy 46
drat:transpareniy-name 46
drat:raaSe
drat:k-inde. 49m
drat:k-inde. 6
drating page 4 r
drating shapes 440
drating shapess iommon attribStes 499
drating shapess groSp 499
drop iaps

560

OpenOffice.org XML File Format Working Draft

E
eiho iharaiter 902
editabae 022
editing iyiaes 90
editing dSration 9
eaaipse 44m
eniryption 59
end-oi-aine 44
end-oi-aine handaing 44
endnotes 09
era eaement m2
erent name 00
erent tabaes 000
erent:aangSage 52r
erent:aibrary 52r
erent:mairo-name 52r
erent:name 52m
erents 000
erents ior iontroas 94
e.pression iieads 0 0F
iiead attribStess iommon 0 9
iiead raaSe attribStes 0 9
iiead raaSe type 0 9
iieads 05
iieadss aSthor 062
iieadss iommon iharaiteristiis 05
iieadss date 054
iieadss doiSment 054
iieadss e.pression 0 0
iieadss page nSmbers 055
iieadss sender 05m
iieadss seqSenie 0 2
iieadss time 059
iieadss rariabae 0r4
iiae name iieads 0m5
iiaa ioaor 46m
iiaa properties 466
iiaa styae 46m
iiater iondition 9
iiater name rm
iiater-and 4
iiater-or 4
iiatersii.ed and minimSm irame heights mii.ed and minimSm irame tidths mii.ed attribSte 0 5
ii.ed iieads 05
ii.ed inde. string 99
ii.ed aine height 06
ii.ed te.t m5
iaoor 9mm
io:baikgroSnd-ioaor 5
Technical Reference Manual Version 2

December 2ee2

io:border mio:break-aiter 5
io:break-beiore 5
io:iaip 024
io:ioaor 29
io:ioaSmn-gap 42
io:ioaSmns-ioSnt 42
io:ioSntry 02
io:ioSntry-asian 02
io:ioSntry-iompae. 02
io:direition 4 0
io:end-indent 40
io:iont-iamiay 26
io:iont-sike 2r
io:iont-sike-asian 2r
io:iont-sike-iompae. 2r
io:iont-styae 02
io:iont-styae-asian 02
io:iont-styae-iompae. 02
io:iont-rariant 24
io:iont-teight 0
io:iont-teight-asian 0
io:iont-teight-iompae. 0
io:gayph-orientation-rertiiaa 4 0
io:height 092
io:hyphenate 2
io:hyphenation-keep 2
io:hyphenation-aadder-ioSnt 0
io:hyphenation-pSsh-ihar-ioSnt 0
io:hyphenation-remain-ihar-ioSnt 0
io:aangSage 2
io:aangSage-asian 2
io:aangSage-iompae. 2
io:aetter-spaiing 2
io:aine-height 06
io:margin-bottom 9
io:margin-aeit 4
io:margin-right 4
io:margin-top 9
io:ma.-tidth
io:ma.-height r
io:min-height m
io:min-tidth mio:orphans 0r
io:oreriaot 4
io:padding r
io:page-height 54
io:page-tidth 54
io:siore-spaies 0
io:spaie-aiter 40
io:spaie-beiore 40
io:start-indent 40
io:te.t-aaign 046s 0m
io:te.t-indent 9
io:te.t-shadot 00
io:te.t-transiorm 24

io:rertiiaa-aaign 4 2
io:tidots 0r
io:tidth 092
io:trap-option 4
iont iharaiter set 2miont deiaaration 64
iont iamiay 25
iont pitih 2m
iont sike 2riont styae 26s 02
iont rariant 24
iont teight 00
iootnote iitation te.t 096
iootnote iontinSation 09r
iootnote aayoSt 60
iootnote ma.imSm height 60
iootnote paragraph styae 09m
iootnote reierenie D 052
iootnote spaiing 60
iootnotes 096s 09
iootnotes position 09r
iorm:aaaot-deaetes 929
iorm:aaaot-inserts 929
iorm:aaaot-Spdates 929
iorm:appay-iiater 929
iorm:aSto-iompaete 904
iorm:boSnd-ioaSmn 942
iorm:bStton-type 9 0
iorm:iommand 925
iorm:iommand-type 929
iorm:ionrert-empty-to-nSaa 940
iorm:iSrrent-seaeited 9
iorm:iSrrent-state 90m
iorm:iSrrent-raaSe 9
iorm:data-iiead 940
iorm:datasoSrie 925
iorm:deiaSat-bStton 905
iorm:deiaSat-raaSe 9 4
iorm:detaia-iieads 925
iorm:disabaed 9 9iorm:dropdotn 9 9
iorm:eiho-ihar 902
iorm:enitype 924
iorm:esiape-proiessing 925
iorm:iiater 926
iorm:ior 9 5
iorm:id 9 0
iorm:ignore-resSat 926
iorm:image-data 9 5
iorm:is-tristate 90m
iorm:aabea 9 5
iorm:aist-soSrie 940
iorm:aist-soSrie-type 94
iorm:master-iieads 925
iorm:ma.-aength 9 6
iorm:ma.-raaSe 900
Index

561

iorm:method 924
iorm:min-raaSe 900
iorm:mSati-aine 90
iorm:mSatipae 909
iorm:name 9 0
iorm:narigation-mode 926
iorm:order 926
iorm:printabae 9 6
iorm:property-is-aist 945
iorm:property-name 945
iorm:property-type 946
iorm:readonay 9 m
iorm:seaeited 9 m
iorm:serriie-name 9 0
iorm:sike 9 m
iorm:state 90m
iorm:tab-iyiae 92m
iorm:tab-inde. 9 riorm:tab-stop 9 r
iorm:titae 942
iorm:raaidation 90
iorm:raaSe 9 4iormat ihange 46
iormat soSrie miormatting properties 99
iormatting propertiess iompae. 95
iormatting propertiess simpae 95
iormatting property sets 95
iorms 920
iorms eaement 44
iormSaa 0 m
iormSaa attribSte m2
iortard-iompatibae proiessing 49
iraition 66
irame baikgroSnd 022
irame iormatting properties mirames r9
irames in te.t doiSments 0Ggenerator 46
generii iont iamiay 26
gradient 456
gradient transpareniy 46
graphii properties 4m4graphii styae eaements 456
grid 9r0
groSp oi drating shapes 499
groSping separator rHhatih 45r

562

OpenOffice.org XML File Format Working Draft

heading aerea 00
headings and paragraphs 00m
hidden paragraph iieads 0m4
hidden te.t iieads 0m
horikontaa position
horikontaa reaation
hoSrs m4
hyperaink beharior 92
hyperaink inde. entry 999
hyperainkss in te.t doiSments 0
hyperainkss simpae 025
hyphenation 2
hyphenation keep 2
hyphenation pSsh ihar ioSnt 0
hyphenation remain ihar ioSnt 2

I
image 45
image aerea styae 04r
image sike 04
image rertiiaa aaignment 092
image:bitmap-inde. 500
image:iommand 500s 50
image:maskbitmap 502
image:maskioaor 502
image:maskmode 502
images r6
inde. body 94r
inde. entries 0 5s 990
inde. entriess iombining 965
inde. entry tempaate 94r
inde. entry te.t 99
inde. entrys aaphabetiiaa 99
inde. entrys main 952
inde. entrys Sser-deiined 99r
inde. marks 99m
inde. oi iaaSstrations 955
inde. oi objeits 95r
inde. oi tabaes 95m
inde. soSrie 94m
inde. tab stop 994
inde. titae 94r
inde.s aaphabetiiaa 964
inde.s bibaiography 96m
inde.s Sser-deiined 962
initiaa ireator 4m
insertion 45s 96
O 4066 9
O 64 9
O r620 9

JTechnical Reference Manual Version 2

December 2ee2

jSstiiy singae tord 0m

K
keep tith ne.t
keytords 4m
keytords 4mrL
aabea aaignment 046
aangSage 90s mms 2
aayer D 5s 6
aeader iharaiter 2
aeit and right margins ior irames r
aeit and right margins ior paragraphs
aegend 9m9aetter kerning 0aetter synihronikation 002
aine 44aine breaks 0 0aine distanie 06
aine end ienter 466
aine nSmbering 09
aink aoiation 025
aink name 026
aink target irame 025
aist header 04
aist styae 9r
aist styae name 040
aist styaes 049
aistss bSaaeted and nSmbered 042
aistss ordered 040
aistss Snordered 040

Mmairo iieads 0mr
major rersion 49
maniiest iiae 594
maniiest:aagorithm-name 595
maniiest:iSaa-path 594
maniiest:initiaaisation-reitor 595
maniiest:key-deriration 596
maniiest:key-deriration-name 595
maniiest:media-type 599
maniiest:sike 599
map 9
map appaied styae 52s 50s r0
map iondition 9 s r2s r s r4s r9marker eaement 460
master pages 4 6
master styaes 40
matri. m2

4

ma.imSm hyphens 0
menS:heapid 9 0
menS:id 9
menS:aabea 9
meta iniormation 45
meta iniormations e.ampae oi 99
meta:deaay 92
meta:target-irame-name 90
meta< eaement 40
metadata 40
metadata iieads 066
metadatas Sser-deiined 9
minimSm denominator digits r9
minimSm e.ponent digits r4
minimSm aabea distanie 046
minimSm aine height 06
minimSm nSmber oi integer digits r
minimSm nSmerator digits r4
minimSm tidth oi a nSmber 046
minor rersion 49
minStes m4
mirroring 02
modiiiiation date 4r
month 6
moring iontent in a ieaa 52

Nname 9s 4
named e.pressions r
named range 2
namespaies mnatire nSmber system r2
ne.t styae 9m
non-breaking baanks 0 6
non-breaking hyphens 0 6
nSmber 65
nSmber iormat 02
nSmber iormat speiiiiiation 002
nSmber aerea styae 045
nSmber oi ieaas repeated attribSte 6r
nSmber oi ioaSmns repeated attribSte 6
nSmber oi ioaSmns spanned attribSte 6
nSmber oi ioaSmns spanned by matri. attribSte m2
nSmber oi rots repeated attribSte 65
nSmber oi rots spanned attribSte 6
nSmber oi rots spanned by matri. attribSte m2
nSmber styae 69
nSmber:aStomatii-order mnSmber:iaaendar r9
nSmber:ioSntry 6ms mrnSmber:deiimaa-paaies m9s r
nSmber:deiimaa-repaaiement r4
nSmber:dispaay-iaitor r4
nSmber:iormat-soSrie m
Index

563

nSmber:groSping rnSmber:aangSage 6ms mm
nSmber:min-denominator-digits r9
nSmber:min-e.ponent-digits r4
nSmber:min-integer-digits rnSmber:min-nSmerator-digits r4
nSmber:styae 6
nSmber:te.tSaa 6
nSmber:titae mrnSmber:transaiteration-ioSntry r0
nSmber:transaiteration-iormat r2
nSmber:transaiteration-aangSage r0
nSmber:transaiteration-styae r0
nSmber:trSniate-on-oreriaot r2Ooiiiie:aSthor m5
oiiiie:aStomatii-Spdate 042
oiiiie:ihg-aSthor 004
oiiiie:ihg-date 004
oiiiie:ireate-date m5
oiiiie:dde-appaiiation 042
oiiiie:dde-item 042
oiiiie:dde-topii 042
oiiiie:dispaay m6
oiiiie:aayer-id 5s 6oiiiie:name 5s 026
oiiiie:serrer-map 026
oiiiie:target-irame 025s 924s 9oiiiie:target-irame-name 0 4
OpenOiiiiecorg appaiiation settings 009
orphans 0r
oStaine aerea styae 090
oStaine nSmbering 092
oStaine styae 090

Ppaikage iormat 590
padding 022s r
page and ioaSmn breaks 9page iontinSation te.t 056
page dSration 4rr
page master 50s 5 s 4 m
page name 4
page namec 5rs 4 6
page nSmber iieads 055
page nSmber iormat 5
page sike 54
page styae 4 ms 4
page styaes and aayoSt 50
page Ssage 54
page rariabae iieads 0m6

564

OpenOffice.org XML File Format Working Draft

page risibiaity 4r
paragraph baikgroSnd ioaor 5paragraph baikgroSnd image 5paragraph border 6paragraph border aine tidth mparagraph iormatting properties 0 2
paragraph te.t 00r
paragraph-onay trapping 020
parent styae 9m
perientage styae 6r
paaiehoaders 060
paot area 9m9
point reierenies 0 5
poaygon 449
poayaine 444
preii. and sSiii. 02
presentation notes 4 r
presentation page attribStes 4rm
presentation shapes 49mpresentation shapess iommon attribStes 49mpresentation:animations 4 4presentation:iaass
presentation:paaiehoader
presentation:Sser-transiormed 49r
presentation:endaess 4
presentation:iorie-manSaa 4
presentation:iSaa-sireen 4 0
presentation:moSse-as-pen 4 4presentation:moSse-risibae 4 4presentation:page-dSration 4r
presentation:paSse 4
presentation:presentation-page-aayoSt-name 4 rs 442
presentation:shot 4 0
presentation:shot-aogo 4presentation:soSnd 4r
presentation:start-page 4 0
presentation:start-tith-narigator 4 4presentation:stay-on-top 4 9
presentation:styae-name 49r
presentation:transition-on-iaiik 4 9
presentation:transition-speed 4rr
presentation:transition-styae 4rr
presentation:transition-typ 4rm
presentation:risibiaity 4r
print iontent r
print date 4r
printed by 4m
proteit r

Q
qSarter eaement m0

R
Technical Reference Manual Version 2

December 2ee2

radiSs 446
range reierenies 0 5
range Ssabae as 0
reitangae 440
reierenies 0 5
register trSe 4
reaated doiSmentation 9
reaoad deaay 92
reaoadL4
restart nSmbering 044
rot eaement 65
rot groSp eaement 69
rot styae attribSte 65
rSby 20
rSn throSgh trapping mode 02

Ssienario tabae 5r
siientiiii nSmber 66
siript: 54rs 54
siript:erent 54m
siript:erent-name 00 s 94 s 54r
siript:aangSage 00 s 54rs 54
siript:aistener-erent 54
siript:aistener-method 54
siript:aistener-param 54
siript:aistener-type 54
siript:aoiation 54ms 54
siript:mairo-name 54rs 54
siripts 002
seionds m4
seition baikgroSnd 42
seition ioaSmns 42
seition iormatting properties
seitions 0 6
sender iieads 05m
seqSenie iieads 0 2
seqSenie rariabaess deiaaring 0r
series 9r0
serrer side image map 026
shadot 022s r
shadot oiiset 4m5
shapess 4D 49
shapess dratings 440
shapess presentations 49m
simpae rariabaess deiaaring 0r4
simpae rariabaess dispaaying 0r5
simpae rariabaess setting 0r9
soit hyphens 0 6
sort 422
sort by 420
sort groSps 424
soSnds in presentations 4r
spaiing and aaignment 090

span 0 0
oL database r
statSsbar:aaign 9 m
statSsbar:aStosike 9 m
statSsbar:oiiset 9 r
statSsbar:otnerdrat 9 r
statSsbar:styae 9 m
statSsbar:tidth 9 r
stroke properties 464
styae 5styae and ionditionaa styae 00
styae iamiay 9m
styae mappings e.ampae 50
styae mappings 9
styae name 96
styae:appay-styae-name 52
styae:aSto-te.t-indent 9
styae:aSto-Spdate 9r
styae:aStomatii 9m
styae:base-ieaa-address 50
styae:border-aine-tidth mstyae:break-inside 0r
styae:ieaa-proteit 4 4styae:ihain-ne.t-name r6
styae:ihar 0
styae:ioaSmn-tidth 40
styae:iondition 52
styae:data-styae-name 064s 0r5s 0 m
styae:distanie
styae:distanie-aiter-sep 60
styae:distanie-beiore-sep 60
styae:editabae 020
styae:iamiay 9m
styae:iiater-name 6styae:iirst-page-nSmber 56
styae:iont-iharset 2r
styae:iont-iharset-asian 2r
styae:iont-iharset-iompae. 2r
styae:iont-iamiay-asian 26
styae:iont-iamiay-iompae. 26
styae:iont-iamiay-generii 26
styae:iont-iamiay-generii-asian26
styae:iont-iamiay-generii-asianstyae:iont-iamiay-generii-iompae. 26
styae:iont-name 25
styae:iont-name-asian 25
styae:iont-name-iompae. 25
styae:iont-pitih 2m
styae:iont-pitih-iompae. 2mstyae:iont-pitihgr 2mstyae:iont-sike-rea 2
styae:iont-sike-rea-asian 2
styae:iont-sike-rea-iompae. 2
styae:iont-styae-name 2mstyae:iont-styae-name-asian 2m
Index

565

styae:iont-styae-name-iompae. 2mstyae:horikontaa-aaign 6styae:horikontaa-pos s 22
styae:horikontaa-rea s 22
styae:jSstiiy-singae-tord 0r
styae:keep-tith-ne.t r
styae:aeader-ihar 2s 999
styae:aength 6 s
styae:aetter-kerning 0
styae:aine-break 06
styae:aine-height-at-aeast 06
styae:aine-spaiing 0m
styae:aines
styae:aist-styae-name 9r
styae:master-page-name 9r
styae:ma.-height 60
styae:may-break-betteen-rots 40r
styae:min-rot-height 4 2
styae:mirror 024
styae:name 96s 54s mms 049
styae:ne.t-styae-name 9ms 5
styae:nSm-iormat 002
styae:nSm-aetter-syni 002
styae:nSm-preii. 02
styae:nSm-sSiii. 02
styae:nSmber-trapped-paragraphs 020
styae:page-master-name 5styae:page-Ssage 54
styae:paper-tray-name 59
styae:parent-styae-name 9m
styae:position 6s 999
styae:print 56
styae:print-iontent rs 4 4styae:print-orientation 59
styae:print-page-order 56
styae:proteit rs 44
styae:pSnitSation-trap 05
styae:register-trSe 4
styae:register-trSth-rei-styae-name 56
styae:rea-ioaSmn-tidth 40
styae:rea-tidth 40s 406
styae:repeat 6s 46r
styae:rotation-aaign 4 4styae:rotation-angae 4 s 9r0
styae:rot-height 4 2
styae:rSby-aaign 2
styae:rSby-position 2
styae:rSn-throSgh 02
styae:siaae-to 5m
styae:siaae-to-pages 5mstyae:shadot r
styae:styae 5styae:styae-name 4styae:tabae-ientering 5m
styae:te.t-aaign-aast 0m
styae:te.t-aaign-soSrie 4 0
566

OpenOffice.org XML File Format Working Draft

styae:te.t-aStospaie 09
styae:te.t-baikgroSnd-ioaor 04
styae:te.t-bainking 04
styae:te.t-iombine 04
styae:te.t-iombine-end-ihar 09
styae:te.t-iombine-start-ihar 09
styae:te.t-irossing-oSt 29
styae:te.t-emphasike 09
styae:te.t-oStaine 29
styae:te.t-position 25
styae:te.t-Snderaine 00
styae:te.t-Snderaine-ioaor 00
styae:type 999
styae:rertiiaa-pos 022s 092s 22
styae:rertiiaa-rea 022s 092s 20
styae:roaatiae mrstyae:tidth 6 s 406
styae:trap 020
styae:trap-iontoSr 02
styae:trap-iontoSr-mode 02
styaes 40s 96
styaess e.ampaes oi 4styaess aoiation oi 4styaes:name 5
sSbjeit 46
sSbtabae eaements r9
sSbtotaa iiead 429
sSbtotaa rSae 429
sSbtotaa rSaes 42
srg:i. 446
srg:iy 446
srg:d 445
srg:end-angae 44m
srg:height ms 495
srg:r 446
srg:start-angae 44m
srg:stroke-ioaor 469
srg:stroke-dash 469
srg:stroke-ainejoin 466
srg:stroke-opaiity 466
srg:stroke-tidth 469
srg:rietbo. 496
srg:tidth ms 495
srg:.0 444
srg:. 444
srg:y0 444
srg:y 444Ttab position 0
tab stops 0 2s 0r
tab type 0tabbing narigation order 9 rtabae aaignment 406
Technical Reference Manual Version 2

December 2ee2

tabae ieaa iontent raaidations r2
tabae ieaa eaement 6m
tabae ieaa iormatting properties 4 2
tabae eaement 55
tabae iiater
tabae iiater eaementtabae iormatting properties 404
tabae margins 40m
tabae name attribSte 55
tabae oi iontents 950
tabae rot iormatting properties 40
tabae styae attribSte 55
tabae tidth 406
tabae:aiieptanie-state 59
tabae:aagorithm 420
tabae:aaign 406
tabae:aaaot-empty-ieaa rtabae:appaiiation-data 426
tabae:aStomatii-iind-aabeas 9tabae:base-ieaa-address r0
tabae:base-ihange-position 9r
tabae:bind-styaes-to-ionten 424
tabae:bind-styaes-to-iontent 422
tabae:booaean-raaSe mtabae:border-ioaor 5tabae:border-modea 40r
tabae:bSttons 42mtabae:iase-sensitire 90s 9s 420s 424
tabae:ieaa-address 5 s 54
tabae:ieaa-range-address mms 42
tabae:ioaSmn
tabae:rottabae:tabae 50
tabae:ioaSmns tabae:rots tabae:tabae 54
tabae:iomment 62
tabae:iondition r2
tabae:iondition-soSrie 4
tabae:iondition-soSrie-range-address 4tabae:iontains-error mm
tabae:iontains-header mtabae:iontent-raaidation-name 6tabae:ionrersion-mode 405
tabae:iopy-baik 5tabae:iopy-iormSaas 5tabae:iopy-styaes 5
tabae:ioSnt 96
tabae:ioSntry 420
tabae:iSrreniy m4tabae:data-ieaa-range-address rtabae:data-type 9s 424
tabae:database-name rtabae:date-raaSe 9 s mtabae:deiaSat-ieaa-styae-name 64s 66
tabae:direition mm
tabae:dispaay 60
tabae:dispaay-border 5tabae:dispaay-dSpaiiates 4tabae:dispaay-iiater-bSttons r
tabae:end-ieaa-address 495
tabae:end-. 495
tabae:end-y 495
tabae:e.eiSte r9
tabae:e.pression
tabae:iiead-nSmber 9s 429
tabae:iiater-name 5m
tabae:iiater-options 5r
tabae:iormSaa m2tabae:iSnition 425s 402
tabae:grand-totaa 42m
tabae:groSp-by-iiead-nSmber 429
tabae:has-persistent-data mtabae:id 59
tabae:identiiy-iategories 42mtabae:ignore-empty-rots 42mtabae:inde. mrtabae:is-aitire 62
tabae:is-data-aayoSt-iiead 402
tabae:is-seaeition 6
tabae:aabea-ieaa-range-address rtabae:aangSage 420
tabae:marked-inraaid mm
tabae:matri.-iorered 5tabae:ma.imSm-diiierenie 94
tabae:message-type r4tabae:mode 5m
tabae:name 55s mrtabae:nSaa-year 9tabae:nSmber-ioaSmns-repeated 6 s 6r
tabae:nSmber-ioaSmns-spanned 6
tabae:nSmber-matri.-ioaSmns-spanned m0
tabae:nSmber-matri.-rots-spanned m0
tabae:nSmber-rots-repeated 65
tabae:nSmber-rots-spanned 6
tabae:on-Spdate-keep-sike mtabae:on-Spdate-keep-styaes mtabae:operator 5
tabae:order 42 s 429
tabae:orientation r s ms 400
tabae:page-breaks-on-groSp-ihange 424
tabae:page-styae-name 40r
tabae:parse-sqa-statementtabae:position 9rs 9Tabae:position 96
tabae:preiision-as-shotn 90
tabae:prerioSs 54
tabae:print-ranges 56
tabae:proteited 56
tabae:proteition-key 99s 56
tabae:qSery-name 422
tabae:range-Ssabae-as 0tabae:reiresh-deaay 5rs r
tabae:rejeiting-ihange-id 55
Index

567

tabae:sienario-ranges 62
tabae:searih-iriteria-mSst-appay-to-thoae-ieaa 90
tabae:shot-empty 400
tabae:soSrie-iiead-name 402
tabae:sqa-statementtabae:start-ioaSmn
tabae:end-ioaSmn
tabae:start-rot
tabae:end-rot
tabae:start-tabae
tabae:end-tabae 50
tabae:start-position; tabae:end-position; tabae:position 9tabae:statSs 94
tabae:steps 94
tabae:string-raaSe mtabae:strSitSre-proteitedtabae:proteition-key 92
tabae:styae-name 56s 64s 66s 6
tabae:tabae 9ms 9r
tabae:tabae-baikgroSnd 495
tabae:tabae-name 5r
tabae:target-range-addresss rs 42m
tabae:target-range-address
tabae:soSrie-range-address 52
tabae:time-raaSe mtabae:titae r
tabae:traik-ihanges 99
tabae:type 96s 9r
tabae:Ssed-hierarihy 400
tabae:raaSe m0s 5
tabae:raaSe-type 9 s m0
tabae:risibiaity 64s 66
target irame 92
tempaate 4r
tempaate aoiation 4
tempaate modiiiiation date 4
tempaate titae 4terminoaogy 5te.t aaign 0m
te.t aaign oi aast aine 0m
te.t baikgroSnd ioaor 04
te.t bainking 0
te.t bo. r5
te.t iontent m6
te.t deioration tord mode 0
te.t iormatting properties 0 0s 24
te.t headings 00m
te.t indent 4
te.t inpSt iieads 0
te.t oStaine 29
te.t paragraphs 00m
te.t position 29
te.t seition 0 6
te.t shadot 02
te.t styae m5te.t styaes 0 0

568

OpenOffice.org XML File Format Working Draft

te.t transiormations 24
te.t:aitire 0mm
te.t:aaphabetiiaa-separators 969
te.t:anihor-page-nSmber 20
te.t:anihor-type 0
te.t:aStomatii-Spdate 0r2
te.t:bibaiography-data-iiead 994
te.t:bibaiography-type 96r
te.t:bSaaet-ihar 04r
te.t:bSaaet-reaatire-sike 04r
te.t:iapitaaike-entries 966
te.t:iaption-seqSenie-name 956
te.t:iitation-body-styae-name 09m
te.t:iitation-styae 096
te.t:ioaSmn-name 064
te.t:iombine-entries 965
te.t:iomma-separated 966
te.t:iond-styae-name 00
te.t:iondition 0 rs 069s 0m0s 0m s 0m4
te.t:ionseiStire-nSmbering 045
te.t:iontinSe-nSmbering 04
te.t:iopy-oStaine-aereas 96
te.t:ioSnt-empty-aines 099
te.t:ioSnt-in-iaoating-irames 099
te.t:database-ioaSmn-name 064
te.t:database-name 064s 069s 065s 066
te.t:date-adjSst 059
te.t:date-raaSe 059
te.t:dde-appaiiation 0m
te.t:dde-item 0m
te.t:dde-topii 0m
te.t:deiaSat-styae 09m
te.t:desiription 0 6
te.t:dispaay 0 ms 0m9s 0m5s 0r5s 0 6
te.t:dispaay-aereas 04m
te.t:dispaay-oStaine-aerea 0r
te.t:iiater-name 0
te.t:ii.ed 0 5
te.t:iootnotes-position 09r
te.t:iormSaa 0r9s 0 m
te.t:id 052
te.t:ignore-iase 969
te.t:inirement 094s 095
te.t:inde.-name 99
te.t:inde.-siope 992
te.t:key0 952
te.t:key 952
te.t:aabea 052
te.t:aerea 00 s 045
te.t:aine-nSmber 095
te.t:main-entry 952
te.t:main-entry-styae-name 969
te.t:master-page-name 09m
te.t:min-aabea-distanie 046
te.t:min-aabea-tidth 046
te.t:name 0 4s 0 ms 0mrs 0r2s 0r9s 0 6
Technical Reference Manual Version 2

December 2ee2

te.t:nSm-iormat 066s 0 r
te.t:nSm-aetter-syni 066s 0 r
te.t:nSmber-aines 094s 095
te.t:oiiset 099
te.t:oStaine-aerea 0m5s 94
te.t:page-adjSst 056s 0mm
te.t:paaiehoader-type 060
te.t:position 099
te.t:proteited 992
te.t:proteition-key 49
te.t:rei-name 0r0s 0 0
te.t:reierenie-iormat 0r0
te.t:reaatire-tab-stop-position 992
te.t:restart-nSmbering 044
te.t:restart-on-page 099
te.t:rot-nSmber 065
te.t:seition-name 0
te.t:seaeit-page 056s 05m
te.t:separation-iharaiter 0 2
te.t:seqSenie-iormat 956
te.t:spaie-beiore 046
te.t:start-nSmbering-at 09r
te.t:start-raaSe 044s 04ms 09m
te.t:string-raaSe 05ms 0m
te.t:string-raaSe-ii-iaase 0m0
te.t:string-raaSe-ii-trSe 0m0
te.t:styae-name 00 s 0 9s 0 ms 04 s 04ms 94 s 992
te.t:styae-name 094
te.t:tabae-name 064s 069s 065s 066
te.t:tabae-type 064s 069s 065s 066
te.t:time-adjSst 055
te.t:time-raaSe 055
te.t:traik-ihanges 49
te.t:Sse-iaption 956
te.t:Sse-ihart-objeits 95
te.t:Sse-drat-objeits 95
te.t:Sse-iaoating-irames 960
te.t:Sse-graphiis 960
te.t:Sse-inde.-marks 954s 960
te.t:Sse-inde.-soSrie-styaes 954
te.t:Sse-keys-as-entries 965
te.t:Sse-math-objeits 95
te.t:Sse-objeits 960
te.t:Sse-other-objeits 95
te.t:Sse-spreadsheet-objeits 95
te.t:Sse-tabaes 960
te.t:raaSe 066
te.t:raaSe-type 0r9s 0 9
te.t:risited-styae-name 0 9
te.tSaa representation attribSte 6
thSmbnaia 494
tiikmark properties 9r2
tiae reierenie point 46
tiae transaation 46
time adjSstment 055
time iieads 059

time styae mtime raaSe 055
time raaSe trSniation r2
titae 46s mrtooabar:aaign 525
tooabar:bitmap 52
tooabar:doikingaines 525
tooabar:iaoating 529
tooabar:iaoatingaines 525
tooabar:iaoatingposaeit 529
tooabar:iaoatingpostop 529
tooabar:heapid 52
tooabar:id 529
tooabar:styae 520s 526
tooabar:te.t 520
tooabar:Sserdeiined 520
tooabar:risibae 522s 525
tooabar:tidth 520
top and bottom margins ior irames r
top and bottom margins ior paragraphs
transition speed 4rr
transition styae 4rr
transition type 4rm
transpareniy gradient 462
tristate 5 99USnderaining 00
Snnamed styaes 99
Sser rariabae inpSt iieads 0rr
Sser rariabaess deiaaring 0rm
Sser rariabaess dispaaying 0rm
Sser-deiined metadata 9Vraaidation 49
raaSe-step 5 s 542s 540s 54
rariabae iieads 0r4
rariabae inpSt iieads 0r6
rersion attribSte 42
rersion attribStes iSnition oi 49
rersions 49
rertiiaa position 022
rertiiaa reaation 022
roaatiaity mrWtaaa 9m6
teek oi year eaement m0
thite-spaie iharaiters 44s 00rs 0 2
tidots 0r
Index

569

trap throSgh 02
trapping 020

X.aink:aitSate 5m.aink:hrei 0 4s 0 s 04 s 5ms 924s 9.aink:shot 0.aink:type 0 s 5m

s 9 5s 9 6s 522s 52 s 50

Yyear m2Z
1 inde. 6

570

OpenOffice.org XML File Format Working Draft

Technical Reference Manual Version 2

December 2ee2

Change Log
Changes irom speiiiiiation doiSment rersion 0 to
–
–

–
–

ome erroneoSs DTD e.ampaes hare been iorreitedc
ome depreiated and SnSsed eaement desiriptions hare been remored iior instanie <style:usestyles< and <office:a-map<come minor errors in speiiiiiation te.t hare been iorreitedc
Chapter aboSt diaaogs addedc

571