Workbook.Colors Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

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

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Colors As Workbook..::._ColorsType
'Применение
Dim instance As Workbook
Dim value As Workbook..::._ColorsType

value = instance.Colors

[BrowsableAttribute(false)]
public virtual Workbook..::._ColorsType Colors { get; }

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

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

Заметки

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

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

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

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

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

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

Примеры

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

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

Private Sub SetFirstColorInPalette()
    Me.Colors(1) = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
    Me.Application.Dialogs( _
        Excel.XlBuiltInDialog.xlDialogColorPalette).Show()
End Sub

private void SetFirstColorInPalette()
{
    this.Colors[1] = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);

    this.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);
}

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

Private Sub SetFirstColorInPalette()
    Dim vstoWorkbook As Workbook = Me.Application.ActiveWorkbook.GetVstoObject()
    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 = this.Application.ActiveWorkbook.GetVstoObject();
    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);
}

Разрешения

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

См. также

Ссылки

Workbook Класс

Workbook - члены

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

Журнал изменений

Дата	Журнал	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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