RibbonButton.Image 속성

아티클
08/10/2011

단추에 표시되는 이미지를 가져오거나 설정합니다.

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

구문

‘선언
Property Image As Image
    Get
    Set

Image Image { get; set; }

속성 값

형식: System.Drawing.Image
단추에 표시되는 Image입니다.

설명

권장 이미지 형식은, 알파 채널을 통해 투명도를 지원하는 PNG입니다.

Image 속성은 컨트롤에 표시되는 이미지를 식별합니다. 이 속성은 디자인 타임 또는 런타임에 설정할 수 있습니다. 런타임에 이 속성을 업데이트하는 경우 컨트롤의 모양이 업데이트되어 변경 내용이 반영됩니다.

Image 속성이 설정되어 있으면 OfficeImageId 및 ImageName 속성은 무시됩니다. Image 속성은 다른 두 개의 속성보다 세밀하게 제어할 수 있지만 컨트롤이 업데이트될 때마다 이미지 개체가 Office 응용 프로그램에 보내지므로 속도는 더 느릴 수 있습니다.

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

예제

다음 예제에서는 두 단추의 Image 속성을 설정합니다. 이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

리본(비주얼 디자이너) 항목을 Visual Studio에 있는 Office 개발 도구를 사용하여 만든 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
두 개의 단추를 그룹에 추가합니다.
두 개의 이미지를 프로젝트 리소스에 추가합니다. 자세한 내용은 방법: 리소스 추가 또는 제거을 참조하십시오.

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}