Image.NineGrid Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 suo 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à
Valore Di spessore che imposta le misurazioni Left, Top, Right, Bottom per la metafora del ridimensionamento di 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 conservare i dettagli sugli angoli dell'immagine quando un'immagine viene ridimensionata o estesa.
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 solo orizzontalmente e i lati (caselle 4 e 6) sono allungati solo verticalmente. Il centro (casella 5) è allungato in entrambe le dimensioni. Per usare il rendering a nove griglie, creare un elemento Image e specificare un valore per la proprietà NineGrid, ovvero i valori pixel per le lunghezze dei lati sinistro, superiore, destro e inferiore della griglia. In XAML si specifica il valore dell'attributo NineGrid come stringa che specifica i valori pixel per i lati in ordine superiore, destro, inferiore sinistro, destro. Internamente, questa sintassi crea un oggetto Thickness che rappresenta questo tipo di misura. Se si desidera un valore uniforme, è possibile specificare un solo valore applicato a tutti e quattro i bordi.
L'applicazione del rendering a nove griglie è molto utile quando l'immagine stessa include un tipo di bordo o decorazione bordo incorporata all'interno dell'origine dell'immagine. Si supponga, ad esempio, di usare un'origine immagine per un pulsante con il contorno come parte di un'immagine con trasparenza. È possibile che l'area centrale che contiene un'icona si allunga. Ma se si estendono gli angoli, è possibile ottenere artefatti di aliasing da angoli arrotondati. Oppure i lati del bordo potrebbero diventare troppo spessi e non sembrano buoni quando ridimensionati. Per evitare questo problema, è possibile usare nineGrid con valori uniformi che mantengono sempre le dimensioni del pixel del bordo le stesse dimensioni dell'origine dell'immagine.
Nel codice o in XAML, i valori per Spessore che usi per impostare la proprietà NineGrid sono valori di pixel indipendenti dal dispositivo.
Ecco un esempio di 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 è** None**).