Share via


DisplayHangulFixedWidth Class

Always Use Fixed Width for Hangul Characters.When the object is serialized out as xml, its qualified name is w:displayHangulFixedWidth.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.OnOffType
        DocumentFormat.OpenXml.Wordprocessing.DisplayHangulFixedWidth

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

Syntax

'Declaration
Public Class DisplayHangulFixedWidth _
    Inherits OnOffType
'Usage
Dim instance As DisplayHangulFixedWidth
public class DisplayHangulFixedWidth : OnOffType

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.7 displayHangulFixedWidth (Always Use Fixed Width for Hangul Characters)

This element specifies whether applications should assume that all characters in the Hangul Syllables Unicode sub range (character values between 0xAC00 and 0xD7FF) are of a single fixed width or shall use the characters widths defined by the font in use (typical for a proportional width font).

Typically, applications shall retrieve the character width for any character in a document from the associated font, allowing each character to be of its own width (a proportional width character). This element, when present with a val attribute value of true (or equivalent), specifies that applications shall instead assume a single fixed width for all characters in the Hangul Syllables sub range, by reading the width of Unicode character 0x4E00 from the associated font and using that width for all Hangul characters (or, if that character is not present, the next available character in the font).

[Example: Consider a WordprocessingML document with three Hangul characters:

DocumentFormat.OpenXml.Wordprocessing.DisplayHangu

The default presentation would have each of those characters using the widths defined by the font (the highlighting indicates that each character has its own width):

DocumentFormat.OpenXml.Wordprocessing.DisplayHangu

However, if this compatibility setting is turned on:

<w:compat>
<w:displayHangulFixedWidth />
</w:compat>

Then all three characters are forced to the fixed width of character 0x4E00 from the font (or, in this case, the next available character), resulting in the characters in the font being forced to that fixed width, which results in the following output:

DocumentFormat.OpenXml.Wordprocessing.DisplayHangu

Notice from the highlighting that the characters have been compressed to the width of the single character and displayed at that fixed width. end example]

Parent Elements

compat (Part 1, §17.15.1.21)

This element’s content model is defined by the common boolean property definition in Part 1, §17.17.4.

© ISO/IEC29500: 2008.

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

DisplayHangulFixedWidth Members

DocumentFormat.OpenXml.Wordprocessing Namespace