Proprietà Workbook.Colors

Articolo
08/11/2011

Ottiene o imposta i colori nella tavolozza per la cartella di lavoro.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Colors As Workbook_ColorsType
    Get

Workbook_ColorsType Colors { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Excel.Workbook_ColorsType
Valore di colore RGB nella tavolozza dei colori per la cartella di lavoro oppure matrice che contiene tutti i 56 valori di colore RGB nella tavolozza per la cartella di lavoro.

Note

La proprietà Colors può essere utilizzata con il seguente parametro.

Parametro	Oggetto di descrizione
Index	Numero di indice di un colore nella tavolozza dei colori della cartella di lavoro (da 1 a 56). Se questo argomento non è specificato, la proprietà restituisce una matrice che contiene tutti i 56 colori della tavolozza.

Se si tenta di utilizzare Colors senza specificare alcun parametro, Colors otterrà un oggetto _ColorsType che fa parte degli strumenti di sviluppo di Office nell'infrastruttura di Visual Studio e non può essere utilizzato direttamente dal codice.

La tavolozza dei colori della cartella di lavoro contiene 56 voci, ciascuna rappresentata da un valore RGB.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzata la proprietà Colors per impostare sul blu il primo colore nella tavolozza dei colori della cartella di lavoro. Viene quindi visualizzata a livello di codice la finestra di dialogo Tavolozza colori di Microsoft Office Excel per verificare che la modifica sia stata apportata.

Questa versione è valida per un componente aggiuntivo a livello di applicazione.

Private Sub SetFirstColorInPalette()
    Dim vstoWorkbook As Workbook = Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)
    vstoWorkbook.Colors(1) = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
    vstoWorkbook.Application.Dialogs( _
        Excel.XlBuiltInDialog.xlDialogColorPalette).Show()
End Sub

private void SetFirstColorInPalette()
{
    Workbook vstoWorkbook = Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);
    vstoWorkbook.Colors[1] = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);

    vstoWorkbook.Application.Dialogs[
        Excel.XlBuiltInDialog.xlDialogColorPalette].Show(
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Workbook Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite