FrameworkElement.Margin FrameworkElement.Margin FrameworkElement.Margin FrameworkElement.Margin Property

Definición

Obtiene o establece el margen externo de un elemento.Gets or sets the outer margin of an element.

public:
 property System::Windows::Thickness Margin { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };
public System.Windows.Thickness Margin { get; set; }
member this.Margin : System.Windows.Thickness with get, set
Public Property Margin As Thickness

Valor de propiedad

Proporciona valores de margen para el elemento.Provides margin values for the element. El valor predeterminado es un elemento Thickness con todas las propiedades iguales a 0 (cero).The default value is a Thickness with all properties equal to 0 (zero).

Comentarios

El margen es el espacio entre este elemento y otros elementos que serán adyacentes cuando el diseño cree interfaz de usuario (UI)user interface (UI)el.The margin is the space between this element and other elements that will be adjacent when layout creates the interfaz de usuario (UI)user interface (UI). Los elementos compartidos pueden ser elementos del mismo nivel (como otros elementos de la colección de un control primario común), o también pueden ser el elemento primario de este elemento.Shared elements might be peer elements (such as other elements in the collection of a common parent control), or might also be this element's parent.

Marginse establece como una Thickness estructura, en lugar de como un número, de modo que el margen se pueda establecer asimétricamente.Margin is set as a Thickness structure rather than as a number so that the margin can be set asymmetrically. La Thickness estructura en sí es compatible con la conversión de tipo de cadena, Margin por XAMLXAML lo que también puede especificar una sintaxis de atributo asimétrico.The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML attribute syntax also.

Un margen distinto de cero aplica espacio fuera del y ActualWidth ActualHeightdel diseño del elemento.A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

Los márgenes son aditivos para los elementos del mismo nivel en un diseño; por ejemplo, dos elementos adyacentes con un margen de 30 establecido en el borde adyacente tendrían 60 unidades de espacio entre ellos.Margins are additive for sibling elements in a layout; for example, two adjacent elements both with a margin of 30 set on the adjoining edge would have 60 units of space between them.

Los elementos que tienen márgenes establecidos no limitarán normalmente el tamaño del especificado Margin si el espacio del rectángulo asignado no es suficientemente grande para el margen más el área de contenido del elemento.Elements that have margins set will not typically constrain the size of the specified Margin if the allotted rectangle space is not large enough for the margin plus the element content area. El área de contenido del elemento se restringe en su lugar cuando se calcula el diseño.The element content area will be constrained instead when layout is calculated. El único caso en el que los márgenes también se pueden restringir es si el contenido ya está restringido hasta cero.The only case where margins would be constrained also is if the content is already constrained all the way to zero.

Uso de atributos XAMLXAML Attribute Usage

<object Margin="left,top,right,bottom"/>  

o bien-or-

<object Margin="left,top"/>  

O bien-or-

<object Margin="thicknessReference"/>  

Uso de elementos de propiedad XAMLXAML Property Element Usage

<object>  
  <object.Margin>  
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>  
  </object.Margin>  
</object>  

Valores XAMLXAML Values

izquierda, superior, derecha, inferiorleft, top, right, bottom
Valores numéricos entre 0 PositiveInfinity y que especifican las cuatro propiedades de dimensión Thickness posibles de una estructura.Number values between 0 and PositiveInfinity that specify the four possible dimension properties of a Thickness structure.

El uso de atributos también aceptará valores abreviados que se aplican en el orden proporcionado, de forma simétrica y lógica.The attribute usage will also accept abbreviated values that apply in the order provided, symmetrically and logically. Por ejemplo, Margin="20" se interpretará como una Thickness con todas las propiedades establecidas en 20.For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50"se interpretará como un Thickness con Left y Right establecido en 20, y Top y Bottom se establecerá en 50.Margin="20,50" will be interpreted to mean a Thickness with Left and Right set to 20, and Top and Bottom set to 50.

La unidad predeterminada para una Thickness medida es unidad independiente de dispositivo (1/96 de pulgada)device-independent unit (1/96th inch).The default unit for a Thickness measure is unidad independiente de dispositivo (1/96 de pulgada)device-independent unit (1/96th inch). También puede especificar otras unidades anexando las cadenas cmde tipo de unidad, ino pt a cualquier medida.You can also specify other units by appending the unit type strings cm, in, or pt to any measure.

Los valores numéricos XAMLXAML proporcionados como atributos no necesitan especificar puntos decimales (0 es aceptable, no tiene que proporcionarse como 0,0).Number values provided as XAMLXAML attributes need not specify decimal points (0 is acceptable, does not have to be provided as 0.0). Para obtener más información Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) sobre el uso Thickness, vea.For more information on Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) usage, see Thickness.

thicknessReferencethicknessReference
Referencia a un objeto existente Thickness.An object reference to an existing Thickness. Puede ser una }referencia de o } .This might be a }, a , or } reference. Para obtener más información Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) sobre el uso Thickness, vea.For more information on Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) usage, see Thickness.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field MarginProperty
Propiedades de metadatos establecidas entrueMetadata properties set to true AffectsMeasure

Se aplica a

Consulte también: