FrameworkElement.Margin Propiedad

Definición

Obtiene o establece el margen exterior 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 con Thickness 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 puede 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 de forma asimétrica. La Thickness propia estructura admite la conversión de tipos de cadena para que pueda especificar también una sintaxis de Margin atributo XAML asimétrica.

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 ambos con un margen de 30 establecido en el borde adyacente tendría 60 unidades de espacio entre ellos.

Los elementos que tienen márgenes establecidos no normalmente restringirán el tamaño del especificado Margin si el espacio de rectángulo asignado no es lo suficientemente grande como 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á para significar un Thickness elemento con todas las propiedades establecidas en 20. Margin="20,50" se interpretará como un Thickness valor con Left y Right establecido en 20 y TopBottom se establecerá en 50.

La unidad predeterminada de una Thickness medida es la 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 de marcado extensible de aplicaciones (XAML), consulta Thickness.

thicknessReference Referencia de objeto a un objeto existente Thickness. Puede ser una }referencia , o } . Para obtener más información sobre el uso del lenguaje de marcado extensible de aplicaciones (XAML), consulta Thickness.

Información de la propiedad dependency

Elemento Value
Campo identificador MarginProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a

Consulte también