Freigeben über


AutoCaption-Klasse

Single Automatic Captioning Setting.When the object is serialized out as xml, its qualified name is w:autoCaption.

Vererbungshierarchie

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.AutoCaption

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class AutoCaption _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As AutoCaption
public class AutoCaption : OpenXmlLeafElement

Hinweise

[ISO/IEC 29500-1 1. Ausgabe]

17.15.1.7 autoCaption (Single Automatic Captioning Setting)

This element specifies what type(s) of objects shall automatically labelled with captions (§17.15.1.17), and with which captions the specified objects shall be labelled as defined in the caption element (§17.15.1.16).

[Example: Consider the diagram below illustrating a two page WordprocessingML document that has leveraged WordprocessingML to automatically label WordprocessingML tables with a specified caption when tables are inserted into the given document.

DocumentFormat.OpenXml.Wordprocessing.AutoCaption-DocumentFormat.OpenXml.Wordprocessing.AutoCaption-

This type of automatic captioning is specified using the following WordprocessingML fragment:

<w:captions>
<w:caption w:name="Table" w:pos="below" w:chapNum="1" w:heading="2" w:numFmt="upperLetter" w:sep="8212" />
<w:autoCaptions>
<w:autoCaption w:name="wfwTable" w:caption="Table" />
</w:autoCaptions>
</w:captions>

Here, the autoCaption element specifies through the name attribute being set equal to wfwTable that tables are automatically be labeled with the caption specified in the caption element whose name attribute is equal to Table, as the caption element's caption attribute has a value of Table. end example]

Parent Elements

autoCaptions (§17.15.1.8)

Attributes

Description

caption (Caption Used for Automatic Captioning)

Specifies the caption defined in using the caption element (§17.15.1.16) which shall be used to automatically label a given type of object inserted in a WordprocessingML document. The caption settings are linked by matching the value of this attribute with the name attribute of the corresponding caption element.

[Example: Consider the WordprocessingML below

<w:captions>
<w:caption w:name="table" w:pos="below" w:chapNum="1" w:heading="0" w:noLabel="1" w:numFmt="upperRoman" />
<w:autoCaptions>
<w:autoCaption w:name="Paint.Picture"      w:caption="table" />
</w:autoCaptions>
</w:captions>

The autoCaption element specifies through the name attribute being set equal to wfwTable that tables are automatically be labeled with the caption whose name attribute is equal to Table (specified by the caption element's attribute name having a value of Table). end example]

The possible values for this attribute are defined by the ST_String simple type (§22.9.2.13).

name (Identifier of Object to be Automatically Captioned)

Specifies a unique identifier which can be used to associate objects inserted into the document which are to be automatically labeled with a caption when inserted into the WordprocessingML document.

[Example: Consider the WordprocessingML below specifying that WordprocessingML tables should be labeled with the custom caption:

  <w:autoCaption w:name="wfwTables" w:caption="custom" /> 

The name attribute value of wfwTables specifies that WordprocessingML tables must be labeled with the custom caption. end example]

The possible values for this attribute are defined by the ST_String simple type (§22.9.2.13).

[Note: The W3C XML Schema definition of this element's content model (CT_AutoCaption) is located in §A.1. end note]

© ISO/IEC29500: 2008. Die oben aufgeführten Textauszüge wurden von Microsoft (und/oder den Microsoft-Vendoren) von Englisch nach Deutsch übersetzt, und im Rahmen von ISO wird keinerlei Verantwortung für diese Übersetzungen übernommen.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

AutoCaption-Member

DocumentFormat.OpenXml.Wordprocessing-Namespace