다음을 통해 공유


RibbonDropDown.OfficeImageId 속성

기본 제공 Microsoft Office 아이콘을 사용하려는 경우 RibbonDropDown에 표시할 이미지를 가져오거나 설정합니다.

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

구문

‘선언
Property OfficeImageId As String
    Get
    Set
string OfficeImageId { get; set; }

속성 값

형식: System.String
이 컨트롤의 아이콘 역할을 하는 기본 제공 Microsoft Office 아이콘의 ID입니다.

설명

OfficeImageId 속성은 컨트롤에 표시되는 Office 아이콘을 식별합니다. 속성 값은 선택된 아이콘의 imageMso 값을 식별하는 문자열입니다. 이 속성은 디자인 타임 또는 런타임에 설정할 수 있습니다. 런타임에 이 속성을 업데이트하는 경우 컨트롤의 모양이 업데이트되어 변경 내용이 반영됩니다.

사용할 수 있는 imageMso 값 목록을 보려면 Microsoft 다운로드 센터 페이지에서 2007 Office System Add-In: Icons Gallery를 참조하십시오.

Image 속성이 설정되어 있으면 이 속성은 무시됩니다. 이미지는 Office 응용 프로그램에서 캐시되므로 OfficeImageId 속성으로 식별된 이미지는 Image 속성으로 식별된 이미지보다 약간 더 빠르게 로드할 수 있습니다.

컨트롤에 이미지를 표시하려면 ShowImage 속성이 true여야 합니다. 디자인 타임에 OfficeImageId 속성을 설정할 때 Visual Studio은 ShowImage 속성을 true로 자동으로 설정됩니다. 런타임에 OfficeImageId 속성을 설정할 경우에는 사용자가 직접 코드에서 ShowImage 속성을 true로 설정해야 합니다.

예제

다음 예제에서는 드롭다운 상자에 Microsoft Office 아이콘을 할당합니다.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

  1. Office 프로젝트에 리본(비주얼 디자이너) 항목을 추가합니다.

  2. 그룹을 사용자 지정 탭에 추가합니다.

  3. 그룹에 드롭다운 상자를 추가합니다.

Private Sub SetDropDownImage()
    DropDown1.OfficeImageId = "FilterToggleFilter"
    DropDown1.ShowImage = True
End Sub
private void SetDropDownImage()
{
    dropDown1.OfficeImageId = "FilterToggleFilter";
    dropDown1.ShowImage = true;
}

.NET Framework 보안

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

참고 항목

참조

RibbonDropDown 인터페이스

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

기타 리소스

리본 개체 모델 개요