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à

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 quando il layout crea la 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 struttura di Thickness 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 struttura Thickness stessa supporta la conversione di tipi stringa, in modo che sia possibile specificare una Margin asimmetrica anche nella sintassi XAMLXAML attributo.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 del ActualWidth e ActualHeightdel layout dell'elemento.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 del Margin specificato se lo spazio rettangolare assegnato non è sufficiente per il margine più 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 struttura di Thickness.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 una 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 come un 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 misura Thickness è 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à accodando le stringhe del tipo di unità cm, ino 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'utilizzo di Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), vedere Thickness.For more information on Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) usage, see Thickness.

thicknessReferencethicknessReference
Riferimento a un oggetto Thicknessesistente.An object reference to an existing Thickness. Potrebbe trattarsi di un riferimento }, a o }.This might be a }, a , or } reference. Per ulteriori informazioni sull'utilizzo di Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), 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