Share via


Workbook.Colors 속성

통합 문서의 색상표에 있는 색을 가져오거나 설정합니다.

네임스페이스:  Microsoft.Office.Tools.Excel
어셈블리:  Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
ReadOnly Property Colors As Workbook_ColorsType
    Get
Workbook_ColorsType Colors { get; }

속성 값

형식: Microsoft.Office.Tools.Excel.Workbook_ColorsType
통합 문서의 색상표에 있는 한 개의 RGB 색상 값이거나, 통합 문서의 색상표에 있는 56개의 RGB 색상 값이 모두 들어 있는 배열입니다.

설명

Colors 속성은 다음 매개 변수와 함께 사용할 수 있습니다.

Parameter

설명

Index

통합 문서 색상표에 있는 색의 인덱스 번호(1-56)를 나타냅니다. 이 인수를 지정하지 않으면 이 속성은 색상표의 56개 색이 모두 들어 있는 배열을 반환합니다.

매개 변수를 지정하지 않고 Colors를 사용하려고 하면 Colors는 Visual Studio 인프라에서 Office 개발 도구에 속하며 사용자 코드에서 직접 사용할 수 없는 _ColorsType 개체를 가져옵니다.

통합 문서 색상표에는 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(
        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);
}

.NET Framework 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

Workbook 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스