Export (0) Print
Expand All

Thickness Structure

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

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

[LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)] 
[TypeConverterAttribute(typeof(ThicknessConverter))] 
public struct Thickness : IEquatable<Thickness>
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable) */ 
/** @attribute TypeConverterAttribute(System.Windows.ThicknessConverter) */ 
public final class Thickness extends ValueType implements IEquatable<Thickness>
<Thickness .../>
<object property="left"/>
- or -
<object property="left,top"/>
- or -
<object property=" left,top,right,bottom" ... />
 left  The left edge of the frame, described as either a Double value that specifies a  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  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  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  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 

You can specify Thickness values in two 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 a single value, which applies a uniform value to all four sides of the bounding rectangle.

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;

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

More Code

How to: Set Margins of Elements and Controls

This example describes how to set the Margin property, by changing any existing property value for the margin in code-behind. The Margin property is a property of the FrameworkElement base element, and is thus inherited by a variety of controls and other elements. For the complete sample, see Setting Margins Sample.

How to: Use a ThicknessConverter Object

This example shows how to create an instance of ThicknessConverter and use it to change the thickness of a border.

How to: Animate the Thickness of a Border by Using Key Frames

This example shows how to animate the BorderThickness property of a Border.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

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

Community Additions

ADD
Show:
© 2014 Microsoft