FrameworkElement.Margin Propriedade

Definição

Obtém ou define a margem exterior 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 de Propriedade

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

Observações

A margem é o espaço entre este elemento e outros elementos que ficarão adjacentes quando o layout cria a interface do utilizador (UI). Os elementos partilhados podem ser elementos pares (como outros elementos na coleção de um controlo parental comum), ou também podem ser o pai deste elemento.

Margin é definido como uma Thickness estrutura em vez de um número, de modo que a margem pode ser definida assimetricamente. A Thickness estrutura em si suporta conversão de tipos de string para que também possas especificar um assimétrico Margin na sintaxe de atributos XAML.

Uma margem não nula aplica espaço fora da disposição ActualWidth dos elementos e ActualHeight.

As margens são aditivas para elementos irmãos num layout; por exemplo, dois elementos adjacentes, ambos com uma margem de 30 na aresta adjacente, teriam 60 unidades de espaço entre eles.

Elementos com margens definidas normalmente não limitam o tamanho do especificado Margin se o espaço retangular atribuído não for suficientemente grande para a margem mais a área de conteúdo dos elementos. A área de conteúdo dos elementos será restrita quando o layout for calculado. O único caso em que as margens também seriam limitadas é se o conteúdo já estiver restrito até zero.

Uso de atributos XAML

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

-ou-

<object Margin="left,top"/>

-ou-

<object Margin="thicknessReference"/>

Uso do elemento de propriedade XAML

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

Valores XAML

esquerda, cima, direita, baixo Valores numéricos entre 0 e PositiveInfinity que especificam as quatro possíveis propriedades dimensionais de uma Thickness estrutura.

A utilização 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 em 20. Margin="20,50" será interpretado como significando a Thickness com Left e Right definido em 20, e Top e definido Bottom como 50.

A unidade padrão para uma Thickness medida é a unidade independente do dispositivo (1/96 de polegada). Também pode especificar outras unidades adicionando as cadeias cmde tipo de unidade , in, ou pt a qualquer medida.

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

espessuraReferência Uma referência de objeto a um .Thickness Isto pode ser um }, um , ou } uma referência. Para mais informações sobre o uso da Extensible Application Markup Language (XAML), veja Thickness.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador MarginProperty
Propriedades dos metadados definidas como true AffectsMeasure

Aplica-se a

Ver também