ThemeFontLanguages Class

Статья
03/30/2011

Theme Font Languages.When the object is serialized out as xml, its qualified name is w:themeFontLang.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.LanguageType
        DocumentFormat.OpenXml.Wordprocessing.ThemeFontLanguages

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

Syntax

'Декларация
Public Class ThemeFontLanguages _
    Inherits LanguageType
'Применение
Dim instance As ThemeFontLanguages

public class ThemeFontLanguages : LanguageType

Remarks

[ISO/IEC 29500-1 редакция 1]

17.15.1.88 themeFontLang (Theme Font Languages)

This element specifies the language which shall be used to determine the appropriate theme fonts in the document's Theme part which map to the major/minor theme fonts. Specifically, the bidi attribute is used to determine the theme font applied to complex script text, the eastAsia attribute is used to determine the theme font applied to East Asian text, and the val attribute is used to determine the theme font applied to all other text.

These mappings are performed as follows:

For majorAscii/majorHAnsi, locate the font element (§20.1.4.1.16) in the majorFont element (§20.1.4.1.24) in the theme part for the language specified by the val attribute
For majorBidi, locate the font element in the majorFont element in the theme part for the language specified by the bidi attribute
For majorEastAsia, locate the font element in the majorFont element in the theme part for the language specified by the eastAsia attribute
For minorAscii/minorHAnsi, locate the font element in the minorFont element (§20.1.4.1.25) in the theme part for the language specified by the val attribute
For minorBidi, locate the font element in the minorFont element in the theme part for the language specified by the bidi attribute
For minorEastAsia, locate the font element in the minorFont element in the theme part for the language specified by the eastAsia attribute

If this element is omitted, then the default fonts for each region as specified by the latin, ea, and cs elements (§21.1.2.3.7; §21.1.2.3.3; §21.1.2.3.1) should be used.

[Example: Consider a document with the following WordprocessingML in its document settings:

<w:themeFontLang w:val="ja-JP" />

The themeFontLang element's val attribute has a value of ja-JP, specifying that the theme fonts used for Latin text must be the theme fonts for Japanese. If the following content was present in the theme part:

…
<a:majorFont>
…
<a:font script="Jpan" typeface="MS Mincho"/>
…
</a:majorFont>
…

Then this setting would specify that uses of the majorAscii and majorHAnsi theme font enumerations must be mapped to the MS Mincho font. end example]

Parent Elements
settings (§17.15.1.78)

Attributes	Description
bidi (Complex Script Language)	Specifies the language which shall be used when processing the contents of this run which use complex script characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using complex script characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains complex script characters in its contents. If those contents should be interpreted as Hebrew, that requirement would be specified as follows in the resulting WordprocessingML: `<w:r> <w:rPr> <w:lang w:bidi="he-IL" /> </w:rPr> </w:r>` The resulting run specifies that any complex script contents must be spell and grammar checked using a Hebrew dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§22.9.2.6).
eastAsia (East Asian Language)	Specifies the language which shall be used when processing the contents of this run which use East Asian characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using East Asian characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains East Asian characters in its contents. If those contents should be interpreted as Korean, that requirement would be specified as follows in the resulting WordprocessingML: `<w:r> <w:rPr> <w:lang w:eastAsia="ko-KR" /> </w:rPr> </w:r>` The resulting run specifies that any complex script contents must be spell and grammar checked using a Korean dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§22.9.2.6).
val (Latin Language)	Specifies the language which shall be used to check spelling and grammar (if requested) when processing the contents of this run which use Latin characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using Latin characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains Latin characters in its contents. If those contents should be interpreted as English (Canada), that requirement would be specified as follows in the resulting WordprocessingML: `<w:r> <w:rPr> <w:lang w:val="en-CA" /> </w:rPr> </w:r>` The resulting run specifies that any complex script contents must be spell and grammar checked using a English (Canada) dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§22.9.2.6).

Attributes

Description

bidi (Complex Script Language)

Specifies the language which shall be used when processing the contents of this run which use complex script characters, as determined by the Unicode character values of the run content.

If this attribute is omitted, then the languages for the contents of this run using complex script characters shall be automatically determined based on their contents using any appropriate method.

[Example: Consider a run which contains complex script characters in its contents. If those contents should be interpreted as Hebrew, that requirement would be specified as follows in the resulting WordprocessingML:

<w:r>
  <w:rPr>
    <w:lang w:bidi="he-IL" />
  </w:rPr>
</w:r>

The resulting run specifies that any complex script contents must be spell and grammar checked using a Hebrew dictionary and grammar engine, if one is available. end example]

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

eastAsia (East Asian Language)

Specifies the language which shall be used when processing the contents of this run which use East Asian characters, as determined by the Unicode character values of the run content.

If this attribute is omitted, then the languages for the contents of this run using East Asian characters shall be automatically determined based on their contents using any appropriate method.

[Example: Consider a run which contains East Asian characters in its contents. If those contents should be interpreted as Korean, that requirement would be specified as follows in the resulting WordprocessingML:

<w:r>
  <w:rPr>
    <w:lang w:eastAsia="ko-KR" />
  </w:rPr>
</w:r>

The resulting run specifies that any complex script contents must be spell and grammar checked using a Korean dictionary and grammar engine, if one is available. end example]

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

val (Latin Language)

Specifies the language which shall be used to check spelling and grammar (if requested) when processing the contents of this run which use Latin characters, as determined by the Unicode character values of the run content.

If this attribute is omitted, then the languages for the contents of this run using Latin characters shall be automatically determined based on their contents using any appropriate method.

[Example: Consider a run which contains Latin characters in its contents. If those contents should be interpreted as English (Canada), that requirement would be specified as follows in the resulting WordprocessingML:

<w:r>
  <w:rPr>
    <w:lang w:val="en-CA" />
  </w:rPr>
</w:r>

The resulting run specifies that any complex script contents must be spell and grammar checked using a English (Canada) dictionary and grammar engine, if one is available. end example]

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

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

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.

Поделиться через

ThemeFontLanguages Class

Inheritance Hierarchy

Syntax

Remarks

Thread Safety

See Also

Reference

Дополнительные ресурсы