Thickness Struct

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Describes the thickness of a frame around a rectangle. Four Double values describe the Left, Top, Right, and Bottom sides of the rectangle, respectively.

public value class Thickness : IEquatable<System::Windows::Thickness>

[System.ComponentModel.TypeConverter(typeof(System.Windows.ThicknessConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public struct Thickness : IEquatable<System.Windows.Thickness>

[<System.ComponentModel.TypeConverter(typeof(System.Windows.ThicknessConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Thickness = struct

Public Structure Thickness
Implements IEquatable(Of Thickness)

Inheritance: Object

ValueType
Thickness

Attributes: TypeConverterAttribute LocalizabilityAttribute

Implements: IEquatable<Thickness>

Examples

The following example shows how to create an instance of a Thickness structure and set its properties by using Extensible Application Markup Language (XAML) and code.

myBorder2 = new Border();
myBorder2.BorderBrush = Brushes.SteelBlue;
myBorder2.Width = 400;
myBorder2.Height = 400;
myThickness = new Thickness();
myThickness.Bottom = 5;
myThickness.Left = 10;
myThickness.Right = 15;
myThickness.Top = 20;
myBorder2.BorderThickness = myThickness;

Dim myBorder2 As New Border()
myBorder2.BorderBrush = Brushes.SteelBlue
myBorder2.Width = 400
myBorder2.Height = 400
Dim myThickness As New Thickness()
myThickness.Bottom = 5
myThickness.Left = 10
myThickness.Right = 15
myThickness.Top = 20
myBorder2.BorderThickness = myThickness

<Border BorderBrush="SteelBlue" Width="400" Height="400" Canvas.Left="100" Canvas.Top="100">
  <Border.BorderThickness>
    10,20,15,5
  </Border.BorderThickness>
</Border>

Remarks

You can specify Thickness values in three ways. If you pass four Double values to the structure, they represent the Left, Top, Right and Bottom sides, respectively, of the bounding rectangle. You can also supply two Double values, the first value represents the Left and Right sides of the bounding rectangle and the second value represents the Top and Bottom sides of the bounding rectangle. You can also supply a single Double value, which applies a uniform value to all four sides of the bounding rectangle.

XAML Attribute Usage

<object property="left"/>

-or-

<object property="left,top"/>

-or-

<object property=" left,top,right,bottom" ... />

XAML Values

left
The left edge of the frame, described as either a Double value that specifies a device-independent units (1/96th inch per unit) measure, or as a qualifiedDouble (see below). If only a single measure is specified, that measure is applied to ALL of the left,top,right,bottom values of a Thickness. If only a pair of left,top measures are specified, these measures are applied symmetrically to a Thickness: the left value is used for right; the top value is used for bottom.

top
The top edge of the frame, described as either a Double value that specifies a device-independent units (1/96th inch per unit) measure, or as a qualifiedDouble (see below). If only a pair of left,top measures are specified, these measures are applied symmetrically to a Thickness: the left value is used for right; the top value is used for bottom.

right
The right edge of the frame, described as either a Double value that specifies a device-independent units (1/96th inch per unit) measure, or as a qualifiedDouble (see below). If left unspecified, will use the left value.

bottom
The bottom edge of the frame, described as either a Double value that specifies a device-independent units (1/96th inch per unit) measure, or as a qualifiedDouble (see below). If left unspecified, will use the left value.

qualifiedDouble
A double value as described above for any of the measures, followed by one of the following unit declaration strings: 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

Note

Values need not include the decimal point explicitly when specified as a string. The string "1" provided in XAML evaluates to a value of 1.0 when referenced in code.

Constructors

Thickness(Double, Double, Double, Double)	Initializes a new instance of the Thickness structure that has specific lengths (supplied as a Double) applied to each side of the rectangle.
Thickness(Double)	Initializes a new instance of the Thickness structure that has the specified uniform length on each side.

Properties

Bottom	Gets or sets the width, in pixels, of the lower side of the bounding rectangle.
Left	Gets or sets the width, in pixels, of the left side of the bounding rectangle.
Right	Gets or sets the width, in pixels, of the right side of the bounding rectangle.
Top	Gets or sets the width, in pixels, of the upper side of the bounding rectangle.

Methods

Equals(Object)	Compares this Thickness structure to another Object for equality.
Equals(Thickness)	Compares this Thickness structure to another Thickness structure for equality.
GetHashCode()	Returns the hash code of the structure.
ToString()	Returns the string representation of the Thickness structure.

Operators

Equality(Thickness, Thickness)	Compares the value of two Thickness structures for equality.
Inequality(Thickness, Thickness)	Compares two Thickness structures for inequality.

Applies to

Jaa