RibbonButton.Image 속성 (2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

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

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

구문

Public Property Image As Image

Dim instance As RibbonButton
Dim value As Image

value = instance.Image

instance.Image = value

public Image Image { get; set; }

속성 값

형식: System.Drawing.Image

단추에 표시되는 Image입니다.

설명

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

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

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

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

예제

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

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

Private Sub LoadImages()
    button1.ShowImage = True
    CustomerButton.ShowImage = True
    Button1.Image = My.Resources.Image1
    CustomerButton.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;
}