FlowDocument.ColumnWidth 属性 (System.Windows.Documents)

ColumnWidth 属性

全部折叠

语言筛选器

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework 3.0

.NET Framework 类库

FlowDocument..::.ColumnWidth 属性

获取或设置 FlowDocument 中列的所需最小宽度。这是一个依赖项属性。

命名空间： System.Windows.Documents
程序集： PresentationFramework（在 PresentationFramework.dll 中）
用于 XAML 的 XMLNS：http://schemas.microsoft.com/winfx/xaml/presentation

语法

Visual Basic（声明）

<LocalizabilityAttribute(LocalizationCategory.None, Readability := Readability.Unreadable)> _
<TypeConverterAttribute(GetType(LengthConverter))> _
Public Property ColumnWidth As Double

Visual Basic（用法）

Dim instance As FlowDocument
Dim value As Double

value = instance.ColumnWidth

instance.ColumnWidth = value

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

Visual C++

[LocalizabilityAttribute(LocalizationCategory::None, Readability = Readability::Unreadable)]
[TypeConverterAttribute(typeof(LengthConverter))]
public:
property double ColumnWidth {
    double get ();
    void set (double value);
}

/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
/** @attribute TypeConverterAttribute(LengthConverter) */
public double get_ColumnWidth()
/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
/** @attribute TypeConverterAttribute(LengthConverter) */
public  void set_ColumnWidth(double value)

JScript

public function get ColumnWidth () : double
public function set ColumnWidth (value : double)

XAML 属性用法

<object ColumnWidth="double"/>
- or -
<object ColumnWidth="qualifiedDouble"/>
- or -
<object ColumnWidth="Auto"/>

XAML 值

  double 
  Double 
 Double 值的字符串表示形式，该值大于等于 0.0，但小Double..::.PositiveInfinity。用与设备无关的像素来度量未限定的值。字符串无需显式包含小数点。
 
  qualifiedDouble 
  如上所述的一个 double 值（Auto 除外），后跟下列单位说明符之一：px、in、cm、pt。
  px（默认值）是与设备无关的单位（每个单位 1/96 英寸）
  in 表示英寸；1in==96px
  cm 表示厘米；1cm==(96/2.54) px
  pt 表示磅；1pt==(96/72) px
 
 Auto
  使列宽自动计算为当FontSize 的 20 倍。

属性值

类型：System..::.Double

所需的最小列宽，以与设备无关的像素为单位。值为 Double..::.NaN 会导致无论页面宽度如何，都只显示一列。默认值为 Double..::.NaN。

依赖项属性信息

标识符字段	ColumnWidthProperty
设置为 true 的元数据属性	AffectsRender

备注

FlowDocument 会动态调整其内容，以在可用的显示空间内显示尽可能多的内容。在此属性指定最小列宽的情况下，可见列数由可用显示空间内可以容纳的列数决定。实际列宽可能大于此属性所指定的值。

如果沿任一方向更改窗口的大小，则会动态地重新生成列，以充分利用空间。这样一来，内容可以动态地适应用户环境。

有关探讨实时使用 ColumnWidth 属性的示例，请参见 FlowDocument 中的最佳段落和断字的示例。

示例

下面的示例演示如何设置 FlowDocument 元素的 ColumnWidth 属性。

<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>

下面的示例演示如何以编程方式设置 ColumnWidth 属性。

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 Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

版本信息