FrameworkElement.Margin Propriedade

Definição

Obtém ou define a margem externa de um elemento.Gets or sets the outer margin of an element.

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.Provides margin values for the element. O valor padrão é um Thickness com todas as propriedades iguais a 0 (zero).The default value is a Thickness with all properties equal to 0 (zero).

Comentários

A margem é o espaço entre esse elemento e outros elementos que serão adjacentes quando o layout criar o UI (interface do usuário)user interface (UI).The margin is the space between this element and other elements that will be adjacent when layout creates the UI (interface do usuário)user interface (UI). 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.Shared elements might be peer elements (such as other elements in the collection of a common parent control), or might also be this element's parent.

Margin é definido como uma estrutura de Thickness, e não como um número para que a margem possa ser definida assimetricamente.Margin is set as a Thickness structure rather than as a number so that the margin can be set asymmetrically. A própria estrutura de Thickness dá suporte à conversão de tipo de cadeia de caracteres para que você possa especificar um Margin assimétrico na sintaxe XAMLXAML atributo também.The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML attribute syntax also.

Uma margem diferente de zero aplica espaço fora do ActualWidth do layout do elemento e ActualHeight.A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

As margens são aditivas para elementos irmãos em um layout; por exemplo, dois elementos adjacentes com uma margem de 30 definida na borda adjacente teriam 60 unidades de espaço entre eles.Margins are additive for sibling elements in a layout; for example, two adjacent elements both with a margin of 30 set on the adjoining edge would have 60 units of space between them.

Os elementos que têm margens definidas normalmente não restringirão o tamanho do Margin especificado se o espaço retângulo alocado não for grande o suficiente para a margem mais a área de conteúdo do elemento.Elements that have margins set will not typically constrain the size of the specified Margin if the allotted rectangle space is not large enough for the margin plus the element content area. A área de conteúdo do elemento será restrita em vez disso, quando o layout for calculado.The element content area will be constrained instead when layout is calculated. O único caso em que as margens seriam restritas também é se o conteúdo já estiver restrito até zero.The only case where margins would be constrained also is if the content is already constrained all the way to zero.

Uso do Atributo XAMLXAML Attribute Usage

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

- ou --or-

<object Margin="left,top"/>  

- ou --or-

<object Margin="thicknessReference"/>  

Uso do elemento propriedade XAMLXAML Property Element Usage

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

Valores XAMLXAML Values

esquerda, superior, direita, inferiorleft, top, right, bottom
Valores numéricos entre 0 e PositiveInfinity que especificam as quatro propriedades de dimensão possíveis de uma estrutura de Thickness.Number values between 0 and PositiveInfinity that specify the four possible dimension properties of a Thickness structure.

O uso do atributo também aceitará valores abreviados que se aplicam na ordem fornecida, de forma simétrica e lógica.The attribute usage will also accept abbreviated values that apply in the order provided, symmetrically and logically. Por exemplo, Margin="20" será interpretado para significar um Thickness com todas as propriedades definidas como 20.For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50" será interpretado para significar um Thickness com Left e Right definido como 20, e Top e Bottom definidos como 50.Margin="20,50" will be interpreted to mean a Thickness with Left and Right set to 20, and Top and Bottom set to 50.

A unidade padrão para uma medida de Thickness é unidade independente de dispositivo (1/96 polegada)device-independent unit (1/96th inch).The default unit for a Thickness measure is unidade independente de dispositivo (1/96 polegada)device-independent unit (1/96th inch). Você também pode especificar outras unidades acrescentando as cadeias de caracteres de tipo de unidade cm, inou pt a qualquer medida.You can also specify other units by appending the unit type strings cm, in, or pt to any measure.

Os valores numéricos fornecidos como atributos de XAMLXAML não precisam especificar pontos decimais (0 é aceitável, não precisa ser fornecido como 0,0).Number values provided as XAMLXAML attributes need not specify decimal points (0 is acceptable, does not have to be provided as 0.0). Para obter mais informações sobre o uso de XAML (linguagem XAML)Extensible Application Markup Language (XAML), consulte Thickness.For more information on XAML (linguagem XAML)Extensible Application Markup Language (XAML) usage, see Thickness.

thicknessReferencethicknessReference
Uma referência de objeto a um Thicknessexistente.An object reference to an existing Thickness. Isso pode ser uma referência }, uma ou }.This might be a }, a , or } reference. Para obter mais informações sobre o uso de XAML (linguagem XAML)Extensible Application Markup Language (XAML), consulte Thickness.For more information on XAML (linguagem XAML)Extensible Application Markup Language (XAML) usage, see Thickness.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field MarginProperty
Propriedades de metadados definidas como trueMetadata properties set to true AffectsMeasure

Aplica-se a

Veja também