Compartilhar via


FrameworkElement.Margin Propriedade

Definição

Obtém ou define a margem externa de um 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 da propriedade

Fornece valores de margem para o elemento. O valor padrão é um Thickness com todas as propriedades iguais a 0 (zero).

Comentários

A margem é o espaço entre esse elemento e outros elementos que serão adjacentes quando o layout criar a interface do usuário. Elementos compartilhados podem ser elementos pares (como outros elementos na coleção de um controle pai comum) ou também podem ser o pai desse elemento.

Margin é definido como uma Thickness estrutura em vez de como um número para que a margem possa ser definida de forma assimétrica. A Thickness própria estrutura dá suporte à conversão de tipo de cadeia de caracteres para que você também possa especificar uma sintaxe de atributo XAML assimétrica Margin .

Uma margem diferente de zero aplica espaço fora do layout do ActualWidth elemento e ActualHeight.

As margens são aditivas para elementos irmãos em um layout; Por exemplo, dois elementos adjacentes com uma margem de 30 definidos na borda adjacente teriam 60 unidades de espaço entre eles.

Elementos que têm margens definidas normalmente não restringirão o tamanho do especificado Margin se o espaço de retângulo alocado não for grande o suficiente para a margem mais a área de conteúdo do elemento. A área de conteúdo do elemento será restrita quando o layout for calculado. O único caso em que as margens seriam restritas também é se o conteúdo já estiver restrito até zero.

Uso do Atributo XAML

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

- ou -

<object Margin="left,top"/>  

- ou -

<object Margin="thicknessReference"/>  

Uso do elemento propriedade XAML

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

Valores XAML

esquerda, superior, direita, inferior
Valores numéricos entre 0 e PositiveInfinity que especificam as quatro propriedades de dimensão possíveis de uma Thickness estrutura.

O uso do atributo também aceitará valores abreviados que se aplicam na ordem fornecida, simétrica e logicamente. Por exemplo, Margin="20" será interpretado como um Thickness com todas as propriedades definidas como 20. Margin="20,50" será interpretado como um Thickness com Left e Right definido como 20 e Top e Bottom definido como 50.

A unidade padrão para uma Thickness medida é a unidade independente do dispositivo (1/96 polegada). Você também pode especificar outras unidades acrescentando as cadeias de caracteres cmde tipo de unidade , inou pt a qualquer medida.

Os valores numéricos fornecidos como atributos XAML não precisam especificar pontos decimais (0 é aceitável, não precisa ser fornecido como 0,0). Para obter mais informações sobre o uso de XAML (Extensible Application Markup Language), consulte Thickness.

thicknessReference
Uma referência de objeto a um existente Thickness. Pode ser uma }referência , } ou . Para obter mais informações sobre o uso de XAML (Extensible Application Markup Language), consulte Thickness.

Informações da propriedade de dependência

Campo Identificador MarginProperty
Propriedades de metadados definidas como true AffectsMeasure

Aplica-se a

Confira também