FrameworkElement.Margin Propiedad

Definición

Obtiene o establece el margen externo de un elemento.

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. El valor predeterminado es un elemento Thickness con todas las propiedades iguales a 0 (cero).

Comentarios

El margen es el espacio entre este elemento y otros elementos que serán adyacentes cuando el diseño cree la interfaz de usuario (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.

Margin se establece como una Thickness estructura en lugar de como un número para que el margen se pueda establecer asimétricamente. La Thickness propia estructura admite la conversión de tipos de cadena para poder especificar también una sintaxis de atributo XAML asimétrica Margin .

Un margen distinto de cero aplica espacio fuera del diseño del ActualWidth elemento y 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.

Los elementos que tienen márgenes establecidos no suelen restringir el tamaño del especificado Margin si el espacio de rectángulo asignado no es lo suficientemente grande para el margen más el área de contenido del elemento. El área de contenido del elemento se restringirá en su lugar cuando se calcule el diseño. El único caso en el que los márgenes se restringirían también es si el contenido ya está restringido hasta cero.

Uso de atributos XAML

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

o bien

<object Margin="left,top"/>  

o bien

<object Margin="thicknessReference"/>  

Uso de elementos de propiedad XAML

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

Valores XAML

left, top, right, bottom
Número de valores entre 0 y PositiveInfinity que especifican las cuatro posibles propiedades de dimensión de una Thickness estructura.

El uso del atributo también aceptará valores abreviados que se aplican en el orden proporcionado, simétrica y lógicamente. Por ejemplo, Margin="20" se interpretará como un Thickness valor con todas las propiedades establecidas en 20. Margin="20,50" se interpretará para significar un Thickness con Left y Right establecido en 20 y Top establecido Bottom en 50.

La unidad predeterminada de una Thickness medida es una unidad independiente del dispositivo (1/96 pulgadas). También puede especificar otras unidades anexando las cadenas cmde tipo de unidad , ino pt a cualquier medida.

Los valores numéricos proporcionados como atributos XAML no necesitan especificar puntos decimales (0 es aceptable, no es necesario proporcionarlos como 0,0). Para obtener más información sobre el uso del lenguaje xaml (Extensible Application Markup Language), consulta Thickness.

thicknessReference
Referencia de objeto a un objeto existente Thickness. Puede tratarse de una }referencia , o } . Para obtener más información sobre el uso del lenguaje xaml (Extensible Application Markup Language), consulta Thickness.

Información sobre propiedades de dependencia

Campo identificador MarginProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a

Consulte también