RibbonMenu.OfficeImageId 속성 (2007 시스템)
업데이트: 2007년 11월
기본 제공 Microsoft Office 아이콘을 사용하려는 경우 메뉴에 표시할 이미지를 가져오거나 설정합니다.
네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)
구문
Public Property OfficeImageId As String
Dim instance As RibbonMenu
Dim value As String
value = instance.OfficeImageId
instance.OfficeImageId = value
public 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 Tools for Office에서는 ShowImage 속성을 자동으로 true로 설정합니다. 런타임에 OfficeImageId 속성을 설정할 경우에는 사용자가 직접 코드에서 ShowImage 속성을 true로 설정해야 합니다.
예제
다음 예제에서는 메뉴에 Microsoft Office 아이콘을 할당합니다.
이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.
리본(비주얼 디자이너) 항목을 Visual Studio Tools for Office 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
그룹에 메뉴를 추가합니다.
메뉴의 Dynamic 속성을 true로 설정합니다.
Private Sub SetMenuImage()
Menu1.OfficeImageId = "HighImportance"
Menu1.ShowImage = True
End Sub
private void SetMenuImage()
{
menu1.OfficeImageId = "HighImportance";
menu1.ShowImage = true;
}
권한
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.