PrintColorBlackWhite Class

Print Colors as Black And White without Dithering.When the object is serialized out as xml, its qualified name is w:printColBlack.

Inheritance Hierarchy


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


Public Class PrintColorBlackWhite _
    Inherits OnOffType
Dim instance As PrintColorBlackWhite
public class PrintColorBlackWhite : OnOffType


[ISO/IEC 29500-1 1st Edition] printColBlack (Print Colors as Black And White without Dithering)

This element specifies the way in which colored text and/or objects shall be handled when printed to a printer whose printer settings indicate that it can only handle black and white text.

Typically, the contents of a colored document are sent to a black and white printer using grayscale (different shades of gray) to represent each of the possible colors. This element, when present with a val attribute value of true (or equivalent), specifies that colors are not printed as mapped shades of grey, but rather exclusively in solid black and white. This setting prevents the fuzzy look that can occur when gray or blue content is dithered. Dithering is the process by which colors are simulated using various patterns of black dots on a white background

[Example: Consider a WordprocessingML document which is printed to a black and white printer. The default resulting printed content is typically dithered to appear in the appropriate shade of grayscale text.

However, if this compatibility setting is turned on:

<w:printColBlack />

Then the page contents must be printed as exclusively black or exclusively white text as needed, and no grayscale output must occur. end example]

Parent Elements

compat (Part 1, §

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


PrintColorBlackWhite Members

DocumentFormat.OpenXml.Wordprocessing Namespace