第6章 Office Open XML Language Reference

WordprocessingML Language Reference

document(Document)

この要素はWordprocessingML文書でメイン文書パーツのコンテンツを指定します。

WordprocessingML文書でメイン文書部分の基本構造は次のようになっています。

WordprocessingMLのメイン文書の基本構造
<w:document>
  <w:body>
    <w:p/>
  </w:body>
</w:document>

メイン文書パーツのコンテンツのすべてがdocument要素の下に含まれます。

Parent List

  • WordprocessingML メイン文書パーツのルート要素です。親要素はありません。

Child List

  • background (Document Background)
  • body (Document Body)

body(Document Body)

この要素は文書ボディのコンテンツを指定します。

文書本体はブロックレベルの要素を含みます。ブロックレベル要素とはWordprocessingML文書において兄弟要素として存在できる段落要素です。

1つの段落がメイン文書にある状態の文書を考えた場合、この文書はそのメイン文書部分で以下のWordprocessingMLとなります。

1つの段落がメイン文書にある状態の文書のWordprocessingML
<w:document>
  <w:body>
    <w:p/>
  </w:body>
</w:document>

Parent List

  • document

Child List

  • altChunk (Anchor for Imported External Content)
  • bookmarkEnd (Bookmark End)
  • bookmarkStart (Bookmark Start)
  • commentRangeEnd (Comment Anchor Range End)
  • commentRangeStart (Comment Anchor Range Start)
  • customXml (Block-Level Custom XML Element)
  • customXmlDelRangeEnd (Custom XML Markup Deletion End)
  • customXmlDelRangeStart (Custom XML Markup Deletion Start)
  • customXmlInsRangeEnd (Custom XML Markup Insertion End)
  • customXmlInsRangeStart (Custom XML Markup Insertion Start)
  • customXmlMoveFromRangeEnd (Custom XML Markup Move Source End)
  • customXmlMoveFromRangeStart (Custom XML Markup Move Source Start)
  • customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End)
  • customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start)
  • del (Deleted Run Content)
  • ins (Inserted Run Content)
  • moveFrom (Move Source Run Content)
  • moveFromRangeEnd (Move Source Location Container - End)
  • moveFromRangeStart (Move Source Location Container - Start)
  • moveTo (Move Destination Run Content)
  • moveToRangeEnd (Move Destination Location Container - End)
  • moveToRangeStart (Move Destination Location Container - Start)
  • oMath (Office Math)
  • oMathPara (Math Paragraph)
  • p (Paragraph)
  • permEnd (Range Permission End)
  • permStart (Range Permission Start)
  • proofErr (Proofing Error Anchor)
  • sdt (Block-Level Structured Document Tag)
  • sectPr (Document Final Section Properties)
  • tbl (Table)

p (Paragraph)

この要素は文書内容の段落を指定します。

WordprocessingML文書の段落のコンテンツは以下の4つのタイプの組み合わせから成ります。

  • Paragraph properties
  • Annotations (bookmarks, comments, revisions)
  • Custom markup
  • Run level content (fields, hyperlinks, runs)

1つの段落がある基本的なWordprocessingML文書を考えた場合、この段落は以下の通りに表されます。

基本的なWordprocessingML文書の段落
<w:document>
  <w:body>
    <w:p>
      <w:r>
        <w:t>Text</w:t>
      </w:r>
      <w:fldSimple w:instr="AUTHOR">
        <w:r>
          <w:t>Author Name</w:t>
        </w:r>
      </w:fldSimple>
    </w:p>
  </w:body>
</w:document>

p要素は段落コンテンツのためのコンテナーです。この例では段落のRunと単純なフィールドの両方を含んでいます。

Parent List

  • body
  • comment
  • customXml
  • docPartBody
  • endnote
  • footnote
  • ftr
  • hdr
  • sdtContent
  • tc
  • txbxContent

Child List

  • bookmarkEnd (Bookmark End)
  • bookmarkStart (Bookmark Start)
  • commentRangeEnd (Comment Anchor Range End)
  • commentRangeStart (Comment Anchor Range Start)
  • customXml (Inline-Level Custom XML Element)
  • customXmlDelRangeEnd (Custom XML Markup Deletion End)
  • customXmlDelRangeStart (Custom XML Markup Deletion Start)
  • customXmlInsRangeEnd (Custom XML Markup Insertion End)
  • customXmlInsRangeStart (Custom XML Markup Insertion Start)
  • customXmlMoveFromRangeEnd (Custom XML Markup Move Source End)
  • customXmlMoveFromRangeStart (Custom XML Markup Move Source Start)
  • customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End)
  • customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start)
  • del (Deleted Run Content)
  • fldSimple (Simple Field)
  • hyperlink (Hyperlink)
  • ins (Inserted Run Content)
  • moveFrom (Move Source Run Content)
  • moveFromRangeEnd (Move Source Location Container - End)
  • moveFromRangeStart (Move Source Location Container - Start)
  • moveTo (Move Destination Run Content)
  • moveToRangeEnd (Move Destination Location Container - End)
  • moveToRangeStart (Move Destination Location Container - Start)
  • oMath (Office Math)
  • oMathPara (Math Paragraph)
  • permEnd (Range Permission End)
  • permStart (Range Permission Start)
  • pPr (Paragraph Properties)
  • proofErr (Proofing Error Anchor)
  • r (Text Run)
  • sdt (Inline-Level Structured Document Tag)
  • smartTag (Inline-Level Smart Tag)
  • subDoc (Anchor for Subdocument Location)
Name
rsidDel (Revision Identifier for Paragraph Deletion)
Description

この属性は、段落がメイン文書パーツから削除された場合に編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidP(Revision Identifier for Paragraph Properties)
Description

この属性は、文書で段落が最後に変更された編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書の中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidR(Revision Identifier for Paragraph)
Description

この属性は、段落がメイン文書に追加された場合に編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidRDefault(Default Revision Identifier for Runs)
Description

この属性は段落の中のrsidR属性が宣言されていないすべてのRunに使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidRPr(Revision Identifier for Paragraph Glyph Formatting)
Description

この属性は段落マークを表すglyphが、最後にメイン文書で変更された編集セッションを追跡するのに使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional

pPr(Paragraph Properties)

この要素はすべてのスタイル/番号付け/テーブルの属性が段落のテキストに適用された後、親段落のコンテンツに適用されるべき1セットの段落属性を指定します。

段落の属性は以下のように指定されます。

段落の属性
<w:p>
  <w:pPr>
    <w:pBdr>
      <w:bottom w:val="single" w:sz="8" w:space="4" w:color="4F81BD" /> 
    </w:pBdr>
    <w:spacing w:after="300" /> 
    <w:contextualSpacing /> 
  </w:pPr>
</w:p>

このようにpPr要素は段落に適用される属性を指定します。bottom要素は下部の段落罫線、spacing要素は段落の後のスペース、contextualSpacing要素は無視されるべきスペースについて表しています。

Parent List

  • p

Child List

  • adjustRightInd (Automatically Adjust Right Indent When Using Document Grid)
  • autoSpaceDE (Automatically Adjust Spacing of Latin and East Asian Text)
  • autoSpaceDN (Automatically Adjust Spacing of East Asian Text and Numbers)
  • bidi (Right to Left Paragraph Layout)
  • cnfStyle (Paragraph Conditional Formatting)
  • contextualSpacing (Ignore Spacing Above and Below When Using Identical Styles)
  • divId (Associated HTML div ID)
  • framePr (Text Frame Properties)
  • ind (Paragraph Indentation)
  • jc (Paragraph Alignment)
  • keepLines (Keep All Lines On One Page)
  • keepNext (Keep Paragraph With Next Paragraph)
  • kinsoku (Use East Asian Typography Rules for First and Last Character per Line)
  • mirrorIndents (Use Left/Right Indents as Inside/Outside Indents)
  • numPr (Numbering Definition Instance Reference)
  • outlineLvl (Associated Outline Level)
  • overflowPunct (Allow Punctuation to Extent Past Text Extents)
  • pageBreakBefore (Start Paragraph on Next Page)
  • pBdr (Paragraph Borders)
  • pPrChange (Revision Information for Paragraph Properties)
  • pStyle (Referenced Paragraph Style)
  • rPr(Run Properties for the Paragraph Mark)
  • sectPr (Section Properties)
  • shd (Paragraph Shading)
  • snapToGrid (Use Document Grid Settings for Inter-Line Paragraph Spacing)
  • spacing (Spacing Between Lines and Above/Below Paragraph)
  • suppressAutoHyphens (Suppress Hyphenation for Paragraph)
  • suppressLineNumbers (Suppress Line Numbers for Paragraph)
  • suppressOverlap (Prevent Text Frames From Overlapping)
  • tabs (Set of Custom Tab Stops)
  • textAlignment (Vertical Character Alignment on Line)
  • textboxTightWrap (Allow Surrounding Paragraphs to Tight Wrap to Text Box Contents)
  • textDirection(Paragraph Text Flow Direction)
  • topLinePunct (Compress Punctuation at Start of a Line)
  • widowControl (Allow First/Last Line to Display on a Separate Page)
  • wordWrap (Allow Line Breaking At Character Level)

r (Text Run)

この要素は親フィールド内、ハイパーリンク、カスタムXML要素、構造化文書タグ、スマートタグ、またはパラグラフにおける、内容のRunを指定します。

WordprocessingML文書におけるRunの内容はRunコンテンツのあらゆる組み合わせから成り立ちます。

2つのRunを持つ基本的なWordprocessingML段落の場合、Runは以下の通りに表されます。

2つのRunを持つWordprocessingMLの例
<w:document>
  <w:body>
    <w:p>
      <w:r>
        <w:t>Text</w:t>
      </w:r>
      <w:fldSimple w:instr="AUTHOR">
        <w:r>
          <w:t>Author Name</w:t>
        </w:r>
      </w:fldSimple>
    </w:p>
  </w:body>
</w:document>

r要素はすべてのRun内容のためのコンテナです。上の例では、段落中とfldSimple要素中のRunの両方が含まれています。

Parent List

  • customXml
  • del
  • fldSimple
  • hyperlink
  • ins
  • moveFrom
  • moveTo
  • p
  • rt
  • rubyBase
  • stdContent
  • smartTag

Child List

  • annotationRef (Comment Information Block)
  • br (Break)
  • commentReference (Comment Content Reference Mark)
  • continuationSeparator (Continuation Separator Mark)
  • cr (Carriage Return)
  • dayLong (Date Block - Long Day Format)
  • dayShort (Date Block - Short Day Format)
  • delInstrText (Deleted Field Code)
  • delText (Deleted Text)
  • drawing (DrawingML Object)
  • endnoteRef (Endnote Reference Mark)
  • endnoteReference (Endnote Reference)
  • fldChar (Complex Field Character)
  • footnoteRef (Footnote Reference Mark)
  • footnoteReference (Footnote Reference)
  • instrText (Field Code)
  • lastRenderedPageBreak (Position of Last Calculated Page Break)
  • monthLong (Date Block - Long Month Format)
  • monthShort (Date Block - Short Month Format)
  • noBreakHyphen (Non Breaking Hyphen Character)
  • object (Inline Embedded Object)
  • pgNum (Page Number Block)
  • pict (VML Object)
  • ptab (Absolute Position Tab Character)
  • rPr (Run Properties)
  • ruby (Phonetic Guide)
  • separator (Footnote/Endnote Separator Mark)
  • softHyphen (Optional Hyphen Character)
  • sym (Symbol Character)
  • t (Text)
  • tab (Tab Character)
  • yearLong (Date Block - Long Year Format)
  • yearShort (Date Block - Short Year Format)
Name
rsidDel(Revision Identifier for Run Deletion)
Description

この属性は、Runがメイン文書から削除された場合に編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidR(Revision Identifier for Run)
Description

この属性は、Runがメイン文書に追加された場合に編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidRPr(Revision Identifier for Run Properties)
Description

この属性は、Runがメイン文書で最後に変更された場合に編集セッションを追跡する為に使用されるユニークな識別子を指定します。

文書中で同じ値を持つすべてのrsid*属性が、それらの領域が同じ編集セッションにおいて変更された事を示さなければなりません。

Data Type
hexBinary
Default
-
Use
optional

rPr(Run Properties)

この要素はすべてのスタイル形式がテキストに適用された後に、親Runのコンテンツに適用される1セットのRun属性を指定します。これらの属性は直接Runに適用されて、他のスタイルからの形式に取って代わるのでダイレクト形式と定義されます。

この形式は以下のようにスタイル階層構造において適用されます。

  • Document defaults
  • Table styles
  • Numbering styles
  • Paragraph styles
  • Character styles
  • Direct formatting(this element)

1セットのRun属性を持つ場合、以下のように指定されます。

1セットのRun属性
<w:r>
  <w:rPr>
    <w:b />
    <w:imprint />
    <w:lang w:val="en-ca" /> 
  </w:rPr>
</w:r>

この場合、rPr要素はそののRunに適用される属性を指定します。b要素はRunコンテンツのbold(太字)形式を、imprint要素はテキストの浮き彫り効果を表します。lang要素はRunテキストのスペルや文法をチェックする場合にEnglish(Canada)として解釈されるように使われます。

Parent List

  • ctrlPr
  • r

Child List

  • b (Bold)
  • bCs (Complex Script Bold)
  • bdr (Text Border)
  • caps (Display All Characters As Capital Letters)
  • color (Run Content Color)
  • cs (Use Complex Script Formatting on Run)
  • dstrike (Double Strikethrough)
  • eastAsianLayout (East Asian Typography Settings)
  • effect (Animated Text Effect)
  • em (Emphasis Mark)
  • emboss (Embossing)
  • fitText (Manual Run Width)
  • highlight (Text Highlighting)
  • i (Italics)
  • iCs (Complex Script Italics)
  • imprint (Imprinting)
  • kern (Font Kerning)
  • lang (Languages for Run Content)
  • noProof (Do Not Check Spelling or Grammar)
  • oMath (Office Open XML Math)
  • outline (Display Character Outline)
  • position (Vertically Raised or Lowered Text)
  • rFonts (Run Fonts)
  • rPrChange (Revision Information for Run Properties)
  • rStyle (Referenced Character Style)
  • rtl (Right To Left Text)
  • shadow (Shadow)
  • shd (Run Shading)
  • smallCaps (Small Caps)
  • snapToGrid (Use Document Grid Settings For Inter-Character Spacing)
  • spacing (Character Spacing Adjustment)
  • specVanish (Paragraph Mark Is Always Hidden)
  • strike (Single Strikethrough)
  • sz (Font Size)
  • szCs (Complex Script Font Size)
  • u (Underline)
  • vanish (Hidden Text)
  • vertAlign (Subscript/Superscript Text)
  • w (Expanded/Compressed Text)
  • webHidden (Web Hidden Text)

t (Text)

この要素は、Runが含む、文書に表示されるべき文字テキストを指定します。t要素は以下の条件でないすべてのテキストRunに使用されるものとします。

  • 削除された領域にdel要素を使用することで保管されているテキスト領域の部分

  • フィールドコードの中に含まれるテキスト領域の部分

段落が“This is text”のテキストを含んでいる場合、この段落は次のように表されます。

“This is text”のテキストを含んでいる段落
<w:p>
  <w:r>
    <w:t>This is text</w:t>
  </w:r>
</w:p>

テキスト内容はtの中に含まれます。

Parent List

  • r
Name

space (Content Contains Significant Whitespace)

Namespace: http://www.w3.org/XML/1998/namespace

Description

空白がこの要素のコンテンツのためにW3C space preservation rulesを使用してどう扱われるべきであるかを指定します。

xml:space="preserve"を指定したとき、XML中のスペースはアプリケーションによって除かれません。

Data Type
string
Default
-
Use
optional

WordprocessingML文書において次のRunを考えます。

space
<w:r>
  <w:t>significant whitespace   </w:t>
</w:r>

Runには3つの空白がテキストコンテンツの各サイドにありますが、その空白は重要であるとして明確にマークされていないので、このRunが文書に追加されるときにこれらは取り除かれます。

jc (Paragraph Alignment)

この要素はこの段落のテキストに適用される文字揃えを指定します。

この要素が段落で省略される場合、その値は前もって設定されたスタイル階層構造の設定によって決定します(すなわち、前回の設定が変わりなく残っています)。もしこの設定がスタイル階層構造で決して指定されないなら、段落に対して文字揃えは適用されません。

段落に対して文字の右寄せが指定された場合、WordprocessingMLでは以下のように表されます。

jc
<w:pPr>
  <w:jc w:val="right" />
</w:pPr>

Parent List

  • pPr
Name
val(Alignment Type)
Description

文書中の段落に適用される文字揃えのタイプを指定します。

この属性の値は、(右から左、左から右といった)文書自体の進行方向とは関係なく、ページに対して指定されます。

Data Type

string

  • left
  • center
  • right
  • both
  • mediumKashida
  • distribute
  • numTab
  • highKashida
  • lowKashida
  • thaiDistribute
Default
-
Use
required
jcの例
<w:pPr>
  <w:jc w:val="right" />
</w:pPr>

この段落は段落やセクションの設定に関係なくページ上で右寄せに配置されます。

b(Bold)

この要素は、文書が表示されるときに、太字プロパティがこのRunのコンテンツの中のすべての非コンプレックススクリプト文字に適用されるかどうかを指定します。

Parent List

  • rPr
Name
val (On/Off Value)
Description

b要素によって定義されるプロパティを指定します。

trueが指定されるなら、このプロパティが明らかに適用されることを意味します。この値はこの属性の既定値であり、b要素が存在し、この属性が省略された場合の暗黙の定義です。

falseが指定されると、このプロパティは消去されます。

Data Type
boolean
Default
-
Use
optional
bプロパティオフの明示
<w:… w:val="off"/>

この例では、val属性はこのプロパティをオフにすることを明確に宣言しています。

i(Italics)

この要素は、文書が表示されるときにイタリック体のプロパティがこのRunのコンテンツの中のすべての非コンプレックススクリプト文字に適用されるかどうかを指定します。

Parent List

  • rPr
Name
val(On/Off Value)
Description

i要素によって定義されるプロパティを指定します。

trueが指定されるなら、このプロパティが明らかに適用されることを意味します。この値はこの属性の既定値であり、i要素が存在し、この属性が省略された場合の暗黙の定義です。

falseが指定されると、このプロパティは消去されます。

Data Type
boolean
Default
-
Use
optional
w:val="off"の明示
<w:i … w:val="off"/>

sz(Font Size)

この要素は、文書が表示されるときにこのRunのコンテンツの中のすべての非コンプレックススクリプト文字に適用されるフォントサイズを指定します。

この要素が段落で省略される場合、その値は前もって設定されたスタイル階層構造の設定によって決定します。この設定がスタイル階層構造でまったく指定されない場合は、適切なフォントサイズが非コンプレックススクリプト文字に対して使用されるかもしれません。

13.5pointのフォントサイズを持つテキストの場合、WordprocessingMLでは以下のように表されます。

13.5pointのフォントサイズを持つテキスト
<w:rPr>
  <w:sz w:val="27"/>
</w:rPr>

sz属性に27が指定されているので、この非コンプレックススクリプト文字は27/2=13.5pointで表示されます。

Parent List

  • rPr
Name
val(Half Point Measurement)
Description
ハーフポイント(1/144inch)の正数でフォントサイズの値を指定します。
Data Type
decimal
Default
-
Use
required

drawing(DrawingML Object)

この要素は、DrawingMLオブジェクトがRunのコンテンツにおいてこの位置に存在することを表します。このDrawingMLオブジェクトのレイアウトプロパティは、WordprocessingML Drawing syntaxを使用することで指定されます。

段落のテキストに沿って画像が含まれるRunの場合、次のWordprocessingMLで表されます。

段落のテキストに沿って画像が含まれるRun
<w:r>
  <w:drawing>
    <wp:inline>
      …
    </wp:inline>
  </w:drawing>
</w:r>

drawing要素は、絵や図などのDrawingMLオブジェクトを示し、そのWordprocessingML Drawing位置データがRunのその位置に配置されることを意味しています。

Parent List

  • r

Child List

  • anchor(Anchor for Floating DrawingML Object)
  • inline(Inline DrawingML Object)

object(Inline Embedded Object)

この要素は、埋め込みオブジェクトがRunのコンテンツにおいてこの位置に存在することを表します。この埋め込みオブジェクトのレイアウトプロパティは、VML syntaxを使用することで指定されます。

段落のテキストに沿って埋め込みオブジェクトが含まれるRunの場合、以下のWordprocessingMLで表されます。

段落のテキストに沿ってオブジェクトを埋め込む
<w:r>
  <w:object>
    …
  </w:object>
</w:r>

object要素は、埋め込まれたオブジェクトを示し、そのVML位置データがRunのその位置に配置されることを意味しています。

Parent List

  • r

Child List

  • urn:schemas-microsoft-com:vml名前空間のすべての要素
  • urn:schemas-microsoft-com:office:office名前空間のすべての要素
  • control(Inline Embedded Control)
Name
dxaOrig(Original Image Width)
Description

文書の中の現在のコントロールのオリジナルイメージの幅を指定します。いくつかのベクトルイメージ形式はそれらの形式の中にネイティブのサイズを格納しません。そして、この属性はイメージがこの情報を格納する場合のみ使用され、必要に応じてイメージは適切に回復されるかもしれません。

この要素がない場合、イメージのオリジナルサイズが使用されるものとします。

Data Type
twip
Default
-
Use
optional

Name
dyaOrig(Original Image Height)
Description

文書中で、現在のコントロールのオリジナルイメージの高さを指定します。いくつかのベクトルイメージ形式はそれらの形式の中にネイティブのサイズを格納しません。そして、この属性はイメージがこの情報を格納する場合のみ使用され、必要に応じてイメージは適切に回復されるかもしれません。

この要素がない場合、イメージのオリジナルサイズが使用されるものとします。

Data Type
twip
Default
-
Use
optional
オリジナルイメージの幅、高さを指定
<w:object w:dxaOrig="3360" w:dyaOrig="2520">
  …
  <v:shape … style="width:168pt;height:4in">
    …
  </v:shape>
  <o:OLEObject … />
</w:object>

この例では、dyaOrig属性に2520の値があります。埋め込まれたイメージはネイティブの幅を持っていないかもしれません。しかし、この属性値によって、高さが2520twip(2520/20=126point)であることが指定されます。

pict(VML Object)

この要素は、VMLオブジェクトがrRnのコンテンツにおいてこの位置に存在することを表します。このオブジェクトのレイアウトプロパティは、VML syntaxを使用することで指定されます。

VMLを使ったオブジェクトが含まれるrRnの場合、次のWordprocessingMLで表されます。

VMLを使ったオブジェクトが含まれるrRn
<w:r>
  <w:pict>
    …
  </w:pict>
</w:r>

pict要素は、VMLオブジェクトを示し、そのVML位置データがRunのその位置に配置されることを意味しています。

Parent List

  • r

Child List

  • urn:schemas-microsoft-com:vml名前空間のすべての要素
  • urn:schemas-microsoft-com:office:office名前空間のすべての要素
  • control(Floating Embedded Control)
  • movie(Embedded Video)

sectPr(Section Properties)

この要素は文書のセクションプロパティを定義します。文書の最後のセクションにおいて、セクションプロパティはbody要素の子要素として格納されます。

複数のセクションで構成される文書の場合、最後のセクション以外のすべてのセクションは、そのセクションの最後の段落で、段落の子要素としてsectPr要素が格納されます。

sectPr
<w:body>
  <w:p>
    <w:pPr>
      <w:sectPr>
       (final section's properties)
      </w:sectPr>
    </w:pPr>
  …
  </w:p>
  …
  <w:sectPr>
   (final section's properties)
  </w:sectPr>
</w:body>

Parent List

  • body
  • pPr

Child List

  • bidi (Right to Left Section Layout)
  • cols (Column Definitions)
  • docGrid (Document Grid)
  • endnotePr (Section-Wide Endnote Properties)
  • footerReference(Footer Reference)
  • footnotePr(Section-Wide Footnote Properties)
  • formProt(Only Allow Editing of Form Fields)
  • headerReference (Header Reference)
  • lnNumType (Line Numbering Settings)
  • noEndnote (Suppress Endnotes In Document)
  • paperSrc (Paper Source Information)
  • pgBorders (Page Borders)
  • pgMar 8Page Margins)
  • pgNumType (Page Numbering Settings)
  • pgSz (Page Size)
  • printerSettings (Reference to Printer Settings Data)
  • rtlGutter (Gutter on Right Side of Page)
  • sectPrChange (Revision Information for Section Properties)
  • textDirection (Text Flow Direction)
  • titlePg (Different First Page Headers and Footers)
  • type (Section Type)
  • vAlign (Vertical Text Alignment on Page)
Name
rsidDel(Section Deletion Revision ID)
Description

このセクションへのセクションマークが文書から削除された場合に編集セッションを追跡する為に使用される、ユニークな識別子を指定します。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidR(Section Addition Revision ID)
Description

このセクションへのセクションマークが文書に追加された場合に編集セッションを追跡する為に使用される、ユニークな識別子を指定します。

Data Type
hexBinary
Default
-
Use
optional
Name
rsidRPr (Physical Section Mark Character Revision ID)
Description

このセクションマークを表す物理的な文字が最後に編集された場合に編集セッションを追跡するために使用されるユニークな識別子を指定します。

Data Type
hexBinary
Default
-
Use
optional

cols (Column Definitions)

この要素は文書のセクションにおいて定義されるカラム(段組)のセットを指定します。

セクションにおいて、4.16インチと1.83インチの幅の段組を定義する文書のWordprocessingMLは以下のように表されます。

4.16インチと1.83インチの幅の段組を定義する
<w:cols w:equalWidth="0">
  <w:col w:w="2640" w:space="720"/>
  <w:col w:w="6000"/>
</w:cols>

cols要素がこのセクションで定義される段組のセットです。equalWidth属性が0(false)の場合、カラム定義内のcol要素の数がカラムの数となります。この場合、最初のカラム幅は2640/20point=1.83inchで0.5inchのカラムの後のスペースが定義され、次のカラムは6000/20point=4.16inchが定義されています。

equalWidth属性の存在に基づいて、カラムの使用は以下のように表すものとします

  • equalWidth属性がtrueの場合、カラムはcols要素の属性として格納されたデータを使用することで定義されます。

  • equalWidth属性がfalseの場合、カラムは子要素であるcol要素の存在とそのデータを使用することで定義されます。

Parent List

  • sectPr

Child List

  • col(Single Column Definition)
Name
equalWidth(Equal Column Widths)
Description

現在のセクションのすべてのテキスト幅が等しいかどうかを指定します。

この属性が存在していて、かつその値がtrueの場合、すべてのカラムは等しい幅を持ち、その値は以下のように計算されます。

  1. ページの幅(マージンからマージンまでの)を取得します。

  2. num属性で指定されるカラムの数に従って分割します。

  3. 各カラムにおいて、space属性で定義される後ろのスペースを取り去ります。

  4. 残っているカラム幅がそのテキストカラムの幅となります。

もしこの属性が存在していて、かつその値がfalseの場合、すべてのカラムは異なる幅で、各col要素で以下のように定義されます。

  • それぞれのcol要素は1つのカラムを定義します。

  • それぞれのw属性はテキストカラム幅を定義します。

  • それぞれのspace属性はテキストカラムの後のスペースを定義します。

Data Type
boolean
Default
-
Use
optional

例えば、セクション内のカラム情報は以下のように定義されます。

w:cols
<w:cols w:num="3" w:space="1440"
  w:equalWidth="1">
  <w:col w:w="2880" w:space="2880" />
  <w:col w:w="2880" w:space="1440" />
  <w:col w:w="2880" />
</w:cols>

このカラムのセットでは、equalWidth属性値は1に設定されています。したがって、col要素は無視されます。3つの等しいサイズのカラムがあり、カラムの後のスペースとして1インチ(1440/20point)が定義されます。

Name
num(Number of Equal Width Columns)
Description

現在のセクションのテキストカラムの数を指定します。

すべてのカラムの幅が等しくないなら(equalWidth属性が設定されていないなら)、この値は無視されます。そして、カラムの数はcols要素の子要素であるcol要素の数によって決定されます。

このカラムのセットは、equalWidth属性が1に設定され、num属性が3に設定されているので、3つの等しいサイズのカラムがあることを表しています。

Data Type

10進数値

Default
-
Use
optional

例えば、セクションのカラム情報は以下のように定義されます。

セクションのカラム情報
<w:cols w:num="3" w:space="1440"
  w:equalWidth="1">
  …
</w:cols>
Name
sep(Draw Line Between Columns)
Description

縦線がこのセクションのテキストカラムの間に描かれるかどうかを指定します。

trueの場合、縦線が各カラムの間のスペースの中心に描かれることを意味します。

Data Type
boolean
Default
-
Use
optional
縦線が各カラムの間のスペースの中心に描かれる
<w:cols w:sep="1">
  …
</w:cols>
Name
space(Spacing Between Equal Width Columns)
Description

現在のセクションのテキストカラム間のスペースを指定します。

すべてのカラムが等しい幅でない(equalWidth属性が設定されない)場合、この属性は無視されます、そして、カラムの後のスペースはcols要素の子要素で定義されるそれぞれのcol要素のspace属性によって定義されます。

Data Type

twip

Default
-
Use
optional
テキストカラムの間のスペース
<w:cols w:num="3" w:space="1440"
  w:equalWidth="1">
  …
</w:cols>

col(Single Column Definition)

この要素はこのセクションの中で1つのシングル・カラムのプロパティを指定します。

2インチ幅で、カラムの後ろに1インチのスペースがある1つのカラムの場合、以下のWordprocessingMLで表されます。

2インチ幅で、カラムの後ろに1インチのスペースがあるカラム
<w:cols … >
  <w:col w:w="2880" w:space="1440"/>
  …
</w:cols>

col要素のコンテンツはfixedWidth属性がfalseに設定されるか、または省略される場合にのみカラムの数とサイズを計算するために使用されます。

Parent List

  • cols
Name
space(Space Before Following Column)
Description

現在のカラムと次のカラムの間のスペースを指定します。

セクションにおける最後のカラムに関しては、カラムの後のスペースは許されません。したがって、もしspace属性があっても無視されます。

Data Type
twip
Default
-
Use
optional
Name
w(Column Width)
Description

このテキストカラムの幅を指定します。

Data Type
twip
Default
-
Use
optional

pgMar(Page Margins)

この要素はこのセクションのすべてのページにページマージンを指定します。

1インチのマージンが四方にある状態で1ページを考えた場合、これらのマージンは以下のようなWordprocessingMLで表されます。

pgMar
<w:sectPr>
  <w:pgMar w:bottom="1440" w:top="1440" w:right="1440" w:left="1440"/>
  …
</w:sectPr>

Parent List

  • sectPr
Name
bottom(Page Bottom Spacing)
Description

このセクション内のすべてのページの下部マージンの値を指定します。

Data Type
twip
Default
-
Use
required
Name
footer(Spacing to Bottom of Footer)
Description

ページの下端からフッターの下端までの距離を指定します。

Data Type
twip
Default
-
Use
required
Name
gutter(Page Gutter Spacing)
Description

現在のセクションの各ページにおける綴じ代を指定します。

Data Type
twip
Default
-
Use
required
Name
header(Spacing to Top of Header)
Description

ページの上端からヘッダの上端までの距離を指定します。

Data Type
twip
Default
-
Use
required
Name
left(Left Margin Spacing)
Description

ページの左マージンを指定します。

Data Type
twip
Default
-
Use
required
Name
right(Right Margin Spacing)
Description

ページの右マージンを指定します。

Data Type
twip
Default
-
Use
required
Name
top(Top Margin Spacing)
Description

ページの上マージンを指定します。

Data Type
twip
Default
-
Use
required

pgSz(Page Size)

この要素は現在のセクションのすべてのページのプロパティ(サイズとオリエンテーション)を指定します。

A4用紙に印刷されるの場合、この用紙サイズのためのWordprocessingMLは以下のように表されます。

A4用紙のページプロパティ
<w:pgSz w:w="11907" w:h="16839" />

Parent List

  • sectPr
Name
code(Printer Paper Code)
Description

用紙タイプにプリンタ特有の用紙コードを指定します。タイプはこのセクションのページにおいてプリンタによって使用されます。

Data Type
decimal
Default
-
Use
optional
Name
h(Page Height)
Description

現在のセクションのすべてのページの高さを指定します。

Data Type
twip
Default
-
Use
optional
Name
orient(Page Orientation)
Description

このセクションのすべてのページのオリエンテーション(用紙の向き)を指定します。

Data Type
string
Enumeration Value Description

landscape(Landscape Mode)

このセクションのページがランドスケープモード(横置き)で印刷されるものとします。印刷されるページのコンテンツは通常の向きに対して90度回転されます。

portrait(Portrait Mode)

このセクションのページがポートレートモード(縦置き)で印刷されるものとします。

Default
-
Use
optional
Name
w (Page Width)
Description

現在のセクションのすべてのページの幅を指定します。

Data Type
twip
Default
-
Use
optional

tbl (Table)

この要素は文書のテーブルコンテンツを指定します。テーブルは、行と列から配置される段落や他のブロックレベルコンテンツの1セットです。WordprocessingMLのテーブルはtbl要素で定義されます。要素はHTMLテーブルタグに類似しています。

例えば、1つのセル(1つの列、1つの行)があり、各辺に1ポイントの罫線があるテーブルでは、以下のようなWordprocessingMLで表されます。

1つのセルがあり、各辺に1ポイントの罫線があるテーブルのWordprocessingML
<w:tbl>
  <w:tblPr>
    <w:tblW w:w="5000" w:type="pct"/>
    <w:tblBorders>
      <w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:left w:val="single" w:sz="4 w:space="0" w:color="auto"/>
      <w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/>
    </w:tblBorders>
  </w:tblPr>
  <w:tblGrid>
    <w:gridCol w:w="10296"/>
  </w:tblGrid>
  <w:tr>
    <w:tc>
      <w:tcPr>
        <w:tcW w:w="0" w:type="auto"/>
      </w:tcPr>
      <w:p/>
    </w:tc>
  </w:tr>
</w:tbl>

このサンプルのテーブルは、tblW要素を使用することで100%のページ幅のテーブルのプロパティを指定します。テーブルの罫線のセットは、tblBorders要素を使用しています。さらに、tblGrid要素を使用することで1セットの共有された縦の列を定義しています。そして、テーブル行を表すtr要素が1つあります。

Parent List

  • body
  • comment
  • customXml
  • docPartBody
  • endnote
  • footnote
  • ftr
  • hdr
  • sdtContent
  • tc
  • txbxContent

Child List

  • bookmarkEnd (Bookmark End)
  • bookmarkStart (Bookmark Start)
  • commentRangeEnd (Comment Anchor Range End)
  • commentRangeStart (Comment Anchor Range Start)
  • customXml (Row-Level Custom XML Element)
  • customXmlDelRangeEnd (Custom XML Markup Deletion End)
  • customXmlDelRangeStart (Custom XML Markup Deletion Start)
  • customXmlInsRangeEnd (Custom XML Markup Insertion End)
  • customXmlInsRangeStart (Custom XML Markup Insertion Start)
  • customXmlMoveFromRangeEnd (Custom XML Markup Move Source End)
  • customXmlMoveFromRangeStart (Custom XML Markup Move Source Start)
  • customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End)
  • customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start)
  • del (Deleted Run Content)
  • ins (Inserted Run Content)
  • moveFrom (Move Source Run Content)
  • moveFromRangeEnd (Move Source Location Container - End)
  • moveFromRangeStart (Move Source Location Container - Start)
  • moveTo (Move Destination Run Content)
  • moveToRangeEnd (Move Destination Location Container - End)
  • moveToRangeStart (Move Destination Location Container - Start)
  • oMath (Office Math)
  • oMathPara (Math Paragraph)
  • permEnd (Range Permission End)
  • permStart (Range Permission Start)
  • proofErr (Proofing Error Anchor)
  • sdt (Row-Level Structured Document Tag)
  • tblGrid (Table Grid)
  • tblPr (Table Properties)
  • tr (Table Row)

tblPr (Table Properties)

この要素はテーブルに適用されるテーブル全体のプロパティのセットを指定します。個々のテーブル行やセルに定義される特定の属性によってオーバーライドされる場合を除き、tblPr要素で定義されるプロパティは、この親テーブルの中ですべての列とセルの外観に影響します。

tblPr
<w:tbl>
  <w:tblPr>
    <w:tblW w:w="0" w:type="auto"/>
    <w:tblBorders>
      <w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:left w:val="single" w:sz="4 w:space="0" w:color="auto"/>
      <w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto"/>
    </w:tblBorders>
  </w:tblPr>
  …
</w:tbl>

この例では、tblW要素はテーブルの全幅を定義します。テーブルはそのコンテンツに合うように自動的にサイズを調整されるautoのタイプが指定されています。tblBorders要素は、上、下、左、右、および内側の水平面、内側の垂直面の罫線を1ポイントとして指定しています。

Parent List

  • tbl

Child List

  • bidiVisual (Visually Right to Left Table)
  • jc (Table Alignment)
  • shd (Table Shading)
  • tblBorders (Table Borders)
  • tblCellMar (Table Cell Margin Defaults)
  • tblCellSpacing (Table Cell Spacing Default)
  • tblInd (Table Indent from Leading Margin)
  • tblLayout (Table Layout)
  • tblLook (Table Style Conditional Formatting Settings)
  • tblOverlap (Floating Table Allows Other Tables to Overlap)
  • tblpPr (Floating Table Positioning)
  • tblPrChange (Revision Information for Table Properties)
  • tblStyle (Referenced Table Style)
  • tblStyleColBandSize (Number of Columns in Column Band)
  • tblStyleRowBandSize (Number of Rows in Row Band)
  • tblW (Preferred Table Width)