Skip to content

Latest commit

 

History

History
44 lines (32 loc) · 2.43 KB

control_padding.md

File metadata and controls

44 lines (32 loc) · 2.43 KB
-api-id -api-type
P:Windows.UI.Xaml.Controls.Control.Padding
winrt property

Windows.UI.Xaml.Controls.Control.Padding

-description

Gets or sets the padding inside a control.

-xaml-syntax

<control Padding="uniform"/>
- or -
<control Padding="left&right,top&bottom"/>
- or -
<control Padding="left,top,right,bottom"/>

-xaml-values

uniform
uniformA numeric value that specifies a uniform Thickness. The uniform value is applied to all four Thickness values (Left, Top, Right, Bottom).
left&right
left&rightA numeric value that specifies the Left and Right values of a symmetrical Thickness.
top&bottom
top&bottomA numeric value that specifies the Top and Bottom values of a symmetrical Thickness.
left,right,top,bottom
left,right,top,bottomNumeric values that specify the four possible dimension values of a Thickness structure (Left, Top, Right, Bottom).
## -property-value The amount of space between the content of a [Control](control.md) and its [Margin](../windows.ui.xaml/frameworkelement_margin.md) or [Border](border.md). The default is a [Thickness](../windows.ui.xaml/thickness.md) with values of 0 on all four sides.

-remarks

Each control might apply this property differently based on its visual template. This property only affects a control whose template uses the Padding property as a parameter. On other controls, this property has no effect. For more info about control templates, see the Template property.

A related property is Margin (a property of FrameworkElement). For many controls, margin and padding would typically blend together with the division between them not being apparent in the rendering. For such controls it's typical to specify a Margin or a Padding, but not both. For more info about the relationship between margin and padding, see Alignment, margin, and padding or Define layouts with XAML.

-examples

-see-also

Thickness, Alignment, margin, and padding