This topic has not yet been rated - Rate this topic

Block.BorderThickness Property

.NET Framework 4.5

Gets or sets the border thickness for the element.

Namespace: System.Windows.Documents
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

C++

public Thickness BorderThickness { get; set; }

XAML Property Element Usage

<object>
  <object.BorderThickness>
    <Thickness .../>
  </object.BorderThickness>
</object>

XAML Attribute Usage

<object BorderThickness="uniformThickness"/>
- or -
<object BorderThickness="independentThickness"/>
- or -
<object BorderThickness="qualifiedUniformThickness"/>
- or -
<object BorderThickness="qualifiedIndependentThickness"/>

XAML Values

uniformThickness

String representation of a single Double value to apply uniformly to all four thickness dimensions. For example, a value of "10" is equivalent to a value of "10,10,10,10". An unqualified value is measured in device independent pixels. Strings need not explicitly include decimal points.

independentThickness

String representation of four ordered Double values corresponding to independent thickness dimensions for left, top, right, and bottom, in this order. The four values must be separated with commas; spaces are not allowed. For example, "5,10,15,20" results in 5 pixels of border to the left of content, 10 pixels of border above content, 15 pixels of border to the right of content, and 20 pixels of border below the content.

qualifiedUniformThickness

A value described by uniformThickness followed by one of the following unit specifiers: px, in.

px (default) is device-independent units (1/96th inch per unit)

in is inches; 1in==96px

For example, "1in" provides uniform border of 1 inch in all directions.

qualifiedIndependentThickness

A value described by independentThickness, with each independent value followed by one of the following unit specifiers: px, in.

px (default) is device-independent units (1/96th inch per unit)

in is inches; 1in==96px

For example, "1.5in,0.8in,1.5in,0.8in". Unit specifiers may be mixed or omitted from one or more values.

Property Value

Type: System.Windows.Thickness
A Thickness structure specifying the amount of border to apply, in device independent pixels. The default is a uniform thickness of zero (0.0).

Dependency Property Information

Identifier field	BorderThicknessProperty
Metadata properties set to true	AffectsMeasure

Examples

The following example shows how to set the BorderThickness attribute of a Block element (Paragraph).

XAML

<FlowDocument>
  <Paragraph Name="par"
    BorderBrush="Blue"
    BorderThickness="0.25in"
  >
    <Run>
      Child elements in this Block element (Paragraph) will be surrounded by a blue border.
    </Run>
    <LineBreak/><LineBreak/>
    <Run>
      This border will be one quarter inch thick in all directions.
    </Run>
  </Paragraph>
</FlowDocument>

The following figure shows how the preceding example renders.

Screenshot: Blue, 1/4inch border around Block

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

Paragraph par = new Paragraph();

Run run1 = new Run("Child elements in this Block element (Paragraph) will be surrounded by a blue border.");
Run run2 = new Run("This border will be one quarter inch thick in all directions.");

par.Inlines.Add(run1);
par.Inlines.Add(run2);

par.BorderBrush = Brushes.Blue;
ThicknessConverter tc = new ThicknessConverter();
par.BorderThickness = (Thickness)tc.ConvertFromString("0.25in");

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Block Class

System.Windows.Documents Namespace

BorderBrush

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)