Image.NineGrid Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore per una metafora a nove griglie che controlla la modalità di ridimensionamento dell'immagine. La metafora a nove griglie consente di estendere i bordi e gli angoli di un'immagine in modo diverso rispetto al centro. Per altre info e un'illustrazione, vedi La sezione Osservazioni.

public:
 property Thickness NineGrid { Thickness get(); void set(Thickness value); };

Thickness NineGrid();

void NineGrid(Thickness value);

public Thickness NineGrid { get; set; }

var thickness = image.nineGrid;
image.nineGrid = thickness;

Public Property NineGrid As Thickness

<Image NineGrid="left,top,right,bottom" />

Valore della proprietà

Thickness

Valore Spessore che imposta le misurazioni Left, Top, Right, Bottom per la metafora di ridimensionamento a nove griglie.

Commenti

Quando si usa il rendering a nove griglie, è possibile specificare la modalità di estensione delle diverse aree dell'immagine. Questa funzionalità è utile per mantenere i dettagli sugli angoli dell'immagine quando un'immagine si ridimensiona o si estende.

Il rendering a nove griglie divide un'immagine in una griglia di nove sezioni:

Il rendering a nove griglie consente di mantenere le dimensioni originali degli angoli (caselle 1, 3, 7 e 9). I lati superiore e inferiore (caselle 2 e 8) sono estesi orizzontalmente e i lati (caselle 4 e 6) sono estesi solo verticalmente. Il centro (casella 5) è allungato in entrambe le dimensioni. Per usare il rendering a nove griglie, creare un oggetto

L'applicazione del rendering a nove griglie è molto utile quando l'immagine stessa include un tipo di bordo o una decorazione del bordo incorporata all'interno dell'origine dell'immagine. Si supponga, ad esempio, di usare un'origine immagine per un controllo Button con il contorno come parte di un'immagine con trasparenza. È possibile che l'area centrale che contiene un'icona da estendere. Tuttavia, se si estendono gli angoli, è possibile ottenere artefatti di aliasing da angoli arrotondati. Oppure i lati del bordo potrebbero essere troppo spessi e non sembrano buoni quando vengono ridimensionati. Per evitare questo problema, è possibile usare NineGrid con valori uniformi che mantengono sempre le dimensioni in pixel del bordo le stesse dimensioni dell'origine dell'immagine.

Nel codice o in XAML, i valori per Spessore usato per impostare la proprietà NineGrid sono valori pixel indipendenti dal dispositivo.

Ecco un esempio xaml per un elemento Image usando un valore NineGrid:

<Image Source="Images/9grid.bmp" NineGrid="30,20,30,20" />

Un valore NineGrid è rilevante solo per il rendering delle immagini se l'immagine non ha valori specifici impostati per Width e/o Height e dove l'immagine viene estesa (viene eseguito il rendering dell'immagine in uno spazio contenitore più grande e il valore per Stretch non è** Nessuno**).

Vedi anche

• Thickness
• Esempio di immagini XAML