Workbook.Colors 속성
통합 문서의 색상표에 있는 색을 가져오거나 설정합니다.
네임스페이스: 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 속성은 다음 매개 변수와 함께 사용할 수 있습니다.
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();
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.