Share via

Format Class

  • [アーティクル]

Text Box Form Field Formatting.When the object is serialized out as xml, its qualified name is w:format.

Inheritance Hierarchy

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

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

Syntax

'宣言
Public Class Format _
    Inherits OpenXmlLeafElement
'使用
Dim instance As Format

public class Format : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 初版]

17.16.15 format (Text Box Form Field Formatting)

This element specifies the field formatting which shall be applied to the contents of the parent form field whenever those contents are modified. The type of formatting which is applied to the field depends on the value of its type element (§17.16.34), as follows:

  • When the type is equal to currentDate, currentTime, or date, a date formatting string using the syntax defined in §17.16.4.1

  • When the type is equal to calculated or number, a number formatting string using the syntax defined in §17.16.4.2

  • When the type is equal to regular, a text formatting string defined as follows:

Argument

Description

Uppercase

All letters are uppercase. [Example: Mary Smith results in MARY SMITH. end example]

Lowercase

All letters are lowercase. [Example: Mary Smith results in mary smith. end example]

First capital

Capitalizes the first letter of the first word. [Example: Mary Smith results in Mary smith. end example]

Title case

Capitalizes the first letter of each word. [Example: Mary Smith results in Mary Smith. end example]

[Example: Consider the following WordprocessingML fragment for the properties of a text box form field:

<w:ffData>
<w:textInput>
<w:type w:val="number" />
<w:maxLength w:val="4" />
<w:format w:val="0.00" />
</w:textInput>
</w:ffData>

The format element specifies the field formatting which is applied to the input to the field (in this case, a grouping of number formatting picture items as the type element specifies a value of number). If a value of 8 was entered into this field, the formatted result would be 8.00. end example]

Parent Elements

textInput (§17.16.33)

Attributes

Description

val (String Value)

Specifies that its contents contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  …
</w:sdtPr>

In this case, the decimal number in the val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. 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_String) is located in §A.1. end note]

© ISO/IEC29500: 2008. 上記の引用はマイクロソフト (またはその代理) によって英語から日本語に翻訳されたものであり、ISO はこうした翻訳に対する責任を一切負いません。

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Format Members

DocumentFormat.OpenXml.Wordprocessing Namespace