FrameworkElement.Margin Proprietà

Definizione

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

Valore della proprietà

Specifica i valori dei margini per l'elemento. Il valore predefinito è un oggetto Thickness con tutte le proprietà uguali a 0 (zero).

Commenti

Il margine è lo spazio tra questo elemento e altri elementi che saranno adiacenti quando il layout crea l'interfaccia utente. Gli elementi condivisi possono essere elementi peer (ad esempio altri elementi nella raccolta di un controllo padre comune) o potrebbero anche essere elementi padre di questo elemento.

Margin è impostato come Thickness struttura anziché come numero in modo che il margine possa essere impostato in modo asimmetrico. La struttura stessa supporta la Thickness conversione dei tipi di stringa in modo da poter specificare anche una sintassi dell'attributo XAML asimmetrica Margin .

Un margine diverso da zero applica spazio all'esterno del layout dell'elemento ActualWidth e ActualHeight.

I margini sono additivi per gli elementi di pari livello in un layout; ad esempio, due elementi adiacenti con un margine di 30 impostato sul bordo adiacente avrebbero 60 unità di spazio tra di esse.

Gli elementi con set di margini non vincolano in genere le dimensioni dell'oggetto specificato Margin se lo spazio del rettangolo assegnato non è sufficientemente grande per il margine più l'area del contenuto dell'elemento. L'area del contenuto dell'elemento verrà vincolata al momento del calcolo del layout. L'unico caso in cui i margini sarebbero vincolati è anche se il contenuto è già vincolato fino a zero.

Uso della sintassi XAML per gli attributi

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

-oppure-

<object Margin="left,top"/>  

-oppure-

<object Margin="thicknessReference"/>  

Utilizzo della sintassi XAML per elementi proprietà

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

Valori XAML

sinistra, superiore, destra, inferiore
Valori numerici compresi tra 0 e PositiveInfinity che specificano le quattro possibili proprietà della dimensione di una Thickness struttura.

L'utilizzo dell'attributo accetterà anche valori abbreviati che si applicano nell'ordine fornito, simmetricamente e logicamente. Ad esempio, Margin="20" verrà interpretato in modo che un Thickness oggetto con tutte le proprietà impostate su 20. Margin="20,50" verrà interpretato in modo che un Thickness con Left e Right impostato su 20 e Top impostato Bottom su 50.

L'unità predefinita per una Thickness misura è un'unità indipendente dal dispositivo (1/96 pollici). È anche possibile specificare altre unità aggiungendo le stringhe cmdi tipo unità , ino pt a qualsiasi misura.

I valori numerici forniti come attributi XAML non devono specificare i punti decimali (0 è accettabile, non è necessario specificare come 0,0). Per altre informazioni sull'utilizzo xaml (Extensible Application Markup Language), vedere Thickness.

thicknessReference
Riferimento all'oggetto a un oggetto esistente Thickness. Può trattarsi di , }un riferimento o } . Per altre informazioni sull'utilizzo xaml (Extensible Application Markup Language), vedere Thickness.

Informazioni proprietà di dipendenza

Campo Identificatore MarginProperty
Proprietà dei metadati impostate su true AffectsMeasure

Si applica a

Vedi anche