RibbonGallery.OfficeImageId 속성
기본 제공 Microsoft Office 아이콘을 사용하려는 경우 컨트롤에 표시할 이미지를 가져오거나 설정합니다.
네임스페이스: 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 아이콘을 할당합니다.
이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.
리본(비주얼 디자이너) 항목을 Visual Studio에 있는 Office 프로젝트 템플릿을 사용하여 만든 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
그룹에 갤러리를 추가합니다.
Private Sub SetGalleryImage()
Gallery1.OfficeImageId = "PersonaStatusOnline"
Gallery1.ShowImage = True
End Sub
private void SetGalleryImage()
{
gallery1.OfficeImageId = "PersonaStatusOnline";
gallery1.ShowImage = true;
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.
참고 항목
참조
Microsoft.Office.Tools.Ribbon 네임스페이스