FrameworkElement.Margin Proprietà

Definizione

Ottiene o imposta il margine esterno di un 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

Valore della proprietà

Thickness

Specifica i valori dei margini per l'elemento.Provides margin values for the element. Il valore predefinito è un oggetto Thickness con tutte le proprietà uguali a 0 (zero).The default value is a Thickness with all properties equal to 0 (zero).

Commenti

Il margine è lo spazio tra questo elemento e gli altri elementi che saranno adiacenti al momento della creazione del layout interfaccia utenteuser interface (UI) .The margin is the space between this element and other elements that will be adjacent when layout creates the interfaccia utenteuser interface (UI). Gli elementi condivisi possono essere elementi peer, ad esempio altri elementi nella raccolta di un controllo padre comune, oppure possono anche essere elementi padre di questo 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 viene impostato come una Thickness struttura anziché come numero, in modo che il margine possa essere impostato in modo asimmetrico.Margin is set as a Thickness structure rather than as a number so that the margin can be set asymmetrically. La Thickness struttura stessa supporta la conversione del tipo stringa, in modo che sia possibile specificare Margin XAMLXAML anche una sintassi di attributo asimmetrica.The Thickness structure itself supports string type conversion so that you can specify an asymmetric Margin in XAMLXAML attribute syntax also.

Un margine diverso da zero applica uno spazio al di fuori delle e del layout dell'elemento ActualWidth ActualHeight .A non-zero margin applies space outside the element layout's ActualWidth and ActualHeight.

I margini sono additivi per gli elementi di pari livello in un layout. ad esempio, due elementi adiacenti, entrambi con un margine di 30 impostati sul bordo adiacente, avranno 60 unità di spazio tra di essi.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.

Gli elementi con margini impostati non vincolano in genere le dimensioni dell'oggetto specificato Margin se lo spazio del rettangolo allocato non è sufficientemente grande per il margine e l'area del contenuto dell'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. Quando il layout viene calcolato, l'area del contenuto dell'elemento verrà vincolata.The element content area will be constrained instead when layout is calculated. L'unico caso in cui i margini verrebbero vincolati è anche se il contenuto è già vincolato fino a zero.The only case where margins would be constrained also is if the content is already constrained all the way to zero.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

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

-oppure--or-

<object Margin="left,top"/>  

-oppure--or-

<object Margin="thicknessReference"/>  

Utilizzo della sintassi XAML per elementi proprietàXAML Property Element Usage

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

Valori XAMLXAML Values

a sinistra, in alto, a destra, in bassoleft, top, right, bottom
Valori numerici compresi tra 0 e PositiveInfinity che specificano le quattro proprietà della dimensione possibili di una Thickness struttura.Number values between 0 and PositiveInfinity that specify the four possible dimension properties of a Thickness structure.

L'utilizzo dell'attributo accetterà anche valori abbreviati che si applicano nell'ordine specificato, in modo simmetrico e logico.The attribute usage will also accept abbreviated values that apply in the order provided, symmetrically and logically. Ad esempio, Margin="20" verrà interpretato come un oggetto Thickness con tutte le proprietà impostate su 20.For instance, Margin="20" will be interpreted to mean a Thickness with all properties set to 20. Margin="20,50" verrà interpretato per indicare un oggetto Thickness con Left e Right impostato su 20 e Top e Bottom impostato su 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.

L'unità predefinita per una Thickness misura è unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch) .The default unit for a Thickness measure is unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch). È anche possibile specificare altre unità aggiungendo le stringhe del tipo di unità cm , in o pt a qualsiasi misura.You can also specify other units by appending the unit type strings cm, in, or pt to any measure.

I valori numerici specificati come XAMLXAML attributi non devono specificare i separatori decimali (0 è accettabile, non deve essere specificato come 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). Per ulteriori informazioni sull' Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) utilizzo di, vedere Thickness .For more information on Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) usage, see Thickness.

thicknessReferencethicknessReference
Riferimento a un oggetto esistente Thickness .An object reference to an existing Thickness. Potrebbe trattarsi di un } riferimento, o } .This might be a }, a , or } reference. Per ulteriori informazioni sull' Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) utilizzo di, vedere Thickness .For more information on Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) usage, see Thickness.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field MarginProperty
Proprietà dei metadati impostate su trueMetadata properties set to true AffectsMeasure

Si applica a

Vedi anche