Esta documentación está archivada y no tiene mantenimiento.

FrameworkElement.Margin (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el margen exterior de un elemento. Se trata de una propiedad de dependencia.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/xaml/presentation

public Thickness Margin { get; set; }
/** @property */
public Thickness get_Margin()
/** @property */
public  void set_Margin(Thickness value)

public function get Margin () : Thickness
public function set Margin (value : Thickness)
<object>
  <object.Margin>
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>
  </object.Margin>
</object>
<object Margin="left,top,right,bottom"/>
- or -
<object Margin="left,top"/>
- or -
<object Margin="thicknessReference"/>
left, right, top, bottom
                    Valores numéricos entre 0 y PositiveInfinity que especifican las cuatro posibles propiedades de dimensión de una estructura Thickness.
                
                    El uso de atributos también acepta valores abreviados que se aplican en el orden proporcionado, simétricamente y lógicamente. Por ejemplo, se interpretará que Margin="20" significa Thickness con todas las propiedades establecidas en 20. Se interpretará que Margin="20,50" significa Thickness con Left y Right establecidas en 20 y Top y Bottom establecidas en 50.
                
                    La unidad predeterminada para una medida de Thickness es unidad independiente de dispositivo (1/96 de pulgada). También puede especificar otras unidades si anexa cadenas de tipo de unidad cm, ino pt a cualquier medida.
                
                    Los valores numéricos que se proporcionan como atributos XAML no necesitan especificar los separadores decimales (0 es aceptable; no debe proporcionarse como 0,0). Para obtener más información sobre el uso de Lenguaje de marcado de aplicaciones extensible (XAML), vea Thickness.
                thicknessReference
                    Referencia a un objeto Thickness existente. Podría ser una referencia {extensión de marcado Binding}}, {extensión de marcado StaticResource} o {extensión de marcado DynamicResource}}. Para obtener más información sobre el uso de Lenguaje de marcado de aplicaciones extensible (XAML), vea Thickness.
                

Valor de propiedad

Tipo: System.Windows.Thickness
Proporciona los valores de margen para el elemento. El valor predeterminado es Thickness con todas las propiedades igual a 0 (cero).

Campo identificador

MarginProperty

Propiedades de metadatos establecidas en true

AffectsMeasure

El margen es el espacio entre este elemento y otros elementos que serán adyacentes cuando se cree la interfaz de usuario (UI). Los elementos compartidos podrían ser del mismo nivel (como otros elementos en la colección de un control primario común) o también podrían ser el elemento primario de este elemento.

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

Un margen distinto de cero aplica espacio fuera de las propiedades ActualWidth y ActualHeight del diseño del elemento.

Los márgenes son adicionales para los elementos relacionados de un diseño; por ejemplo, dos elementos adyacentes con un margen de 30 establecido en el borde inmediato tendrían 60 unidades de espacio entre ellos.

Los elementos que tienen márgenes no restringen normalmente el tamaño de Margin especificado si el espacio del rectángulo asignado no es grande bastante para el margen más el área de contenido del elemento. En su ligar, el área de contenido del elemento se restringe cuando se calcula el diseño. El único caso en el que se restringirían los márgenes también es cuando el contenido ya se ha restringido hasta cero.

En este ejemplo se describe cómo establecer la propiedad Margin, cambiando cualquier valor de la propiedad existente para el margen en el código subyacente. La propiedad Margin es una propiedad del elemento base FrameworkElement, por lo que la heredan diversos controles y otros elementos. Para obtener el ejemplo completo, vea Ejemplo Setting Margins.

Este ejemplo está escrito en Lenguaje de marcado de aplicaciones extensible (XAML), con un archivo de código subyacente al que hace referencia el marcado XAML. El subyacente se muestra en versión C# y en versión Microsoft Visual Basic .NET.

<Button Click="OnClick" Margin="10" Name="btn1">
Click To See Change!!</Button>


void OnClick(object sender, RoutedEventArgs e)
{
    // Get the current value of the property.
    Thickness marginThickness = btn1.Margin;
    // If the current leftlength value of margin is set to 10 then change it to a new value.
    // Otherwise change it back to 10.
    if(marginThickness.Left == 10)
    {
         btn1.Margin = new Thickness(60);
    } else {
         btn1.Margin = new Thickness(10);
    }
}


Para obtener el ejemplo completo, vea Ejemplo Setting Margins.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0
Mostrar: