Thickness Struct
Definition
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.
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
- Attributes
- Implements
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) |
Initializes a new instance of the Thickness structure that has the specified uniform length on each side. |
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. |
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. |