Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

FlowDocument.ColumnWidth Property

Gets or sets the minimum desired width of the columns within a FlowDocument.

Namespace: System.Windows.Documents
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)] 
[TypeConverterAttribute(typeof(LengthConverter))] 
public double ColumnWidth { get; set; }
/** @property */
public double get_ColumnWidth ()

/** @property */
public void set_ColumnWidth (double value)

public function get ColumnWidth () : double

public function set ColumnWidth (value : double)

<object ColumnWidth="double"/>
- or -
<object ColumnWidth="qualifiedDouble"/>
- or -
<object ColumnWidth="Auto"/>
 double  String representation of a Double value equal to or greater than 0.0 but smaller than PositiveInfinity. An unqualified value is measured in device independent pixels. Strings need not explicitly include decimal points.  qualifiedDouble  A double value as described above, (excepting Auto) followed by one of the following unit specifiers: px, in, cm, pt.  px (default) is device-independent units (1/96th inch per unit)  in is inches; 1in==96px  cm is centimeters; 1cm==(96/2.54) px  pt is points; 1pt==(96/72) px Auto Causes column width to be automatically calculated to be 20 times the current FontSize. 

Property Value

A value specifying the minimum desired column width, in device independent pixels. A value of NaN causes only one column to be displayed, regardless of the page width. The default value is NaN.

A FlowDocument dynamically adjusts its contents to maximize content presentation within the available display space. The number of visible columns is determined by the number of columns that can fit in available display space, given the minimum column width specified by this property. The actual column width may be greater than the value specified by this property.

Changing the size of the window in either direction will result in columns being dynamically regenerated to make the best use of space. In this way, the content dynamically adapts to the user's environment.

For a sample that explores the ColumnWidth property in real time, see the Optimal Paragraph and Hyphenation in a FlowDocument Sample.

The following example shows how to set the ColumnWidth attribute of a FlowDocument element.

<FlowDocumentReader>
  <FlowDocument ColumnWidth="140.0">
    <Paragraph>
      Columns of content within a page in this FlowDocument will be at least 140 pixels wide.
    </Paragraph>
  </FlowDocument>
</FlowDocumentReader>

The following example shows how to set the ColumnWidth property programmatically.

FlowDocument flowDoc = new FlowDocument(new Paragraph(new Run("A bit of text content...")));
// Set minimum column width to 140 pixels.
flowDoc.ColumnWidth = 140.0;

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft