Workbook.Colors - свойство

Статья
01/10/2014

Возвращает или задает цвета в палитре для книги.

Пространство имен: Microsoft.Office.Tools.Excel
Сборки: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
ReadOnly Property Colors As Workbook_ColorsType

Workbook_ColorsType Colors { get; }

Значение свойства

Тип: Microsoft.Office.Tools.Excel.Workbook_ColorsType
Значение цветовой схемы RGB в цветовой палитре для книги или массив, содержащий все 56 значений цветовой схемы RGB цветовой палитры для книги.

Заметки

Свойство Colors можно использовать со следующим параметром.

Параметр	Описание
Index	Номер индекса цвета в цветовой палитре книги (от 1 до 56). Если этот аргумент не указан, данное свойство возвращает массив, содержащий все 56 цветов в палитре.

При попытке использования свойства Colors без указания каких-либо параметров свойство Colors получит объект _ColorsType, который является частью средств разработки Office в инфраструктуре Visual Studio и не предназначен для использования непосредственно из кода.

Палитра книги содержит 56 записей, которым соответствуют значения схемы RGB.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода свойство Colors используется для задания значения «синий» для первого цвета цветовой палитры и последующего программного отображения диалогового окна Цветовая палитра Microsoft Office Excel для проверки внесенного изменения.

Эта версия предназначена для надстройки уровня приложения.

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();
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Workbook Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через