RibbonBase.LoadImage イベント

定義

名前空間:

Microsoft.Office.Tools.Ribbon

アセンブリ:

Microsoft.Office.Tools.Common.v4.0.Utilities.dll

ImageName プロパティが 1 つ以上のコントロールに対して設定されている場合に、RibbonBase が読み込まれると発生します。

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;

public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;

member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 

Public Custom Event LoadImage As RibbonLoadImageEventHandler 

イベントの種類

RibbonLoadImageEventHandler

例

次の例では、2 つの RibbonButton コントロールのイメージをキャッシュします。

このコード例を実行するには、最初に次の手順を実行する必要があります。

• リボン (Visual Designer) を Office プロジェクトに追加します。

• Visual Basic プロジェクトを使用している場合は、リボン コード ファイルの先頭に次のステートメントを追加します。 Imports Microsoft.Office.Tools.Ribbon

その後、生成されたリボン クラスでこのコードを実行できます。

Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)  
   Select Case e.ImageName  
      Case "Button1Image"  
         e.Image = My.Resources.Image1  
      Case "Button2Image"  
         e.Image = My.Resources.Image2  
   End Select  
End Sub  

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)  
{  
    switch (e.ImageName)  
    {  
        case "Button1Image":  
            e.Image = Properties.Resources.Image1;  
            break;  
        case "Button2Image":  
            e.Image = Properties.Resources.Image2;  
            break;  
    }  
}  

注釈

LoadImageイベントを使用すると、リボンのカスタマイズでイメージをキャッシュできるため、パフォーマンスが向上します。

既定では、ユーザーがイメージを含むタブを表示するたびに、イメージがリボンに読み込まれます。 イメージは、イメージが表示されるコントロールのプロパティをプログラムで変更するたびに再読み込みされます。

イベントを LoadImage 使用して、コントロールにイメージを割り当てます。 ユーザーがリボンのタブを選択すると、Microsoft Office アプリケーションはキャッシュされたイメージを使用します。 実行時にコントロール プロパティを変更した場合、Microsoft Office アプリケーションはコントロールのイメージを再読み込みしません。 これにより、パフォーマンスが低下する可能性があります。

コントロールのイメージをキャッシュする場合は、コントロールの ImageName プロパティを設定します。 少なくとも 1 つのコントロールの ImageName プロパティを設定しない限り、イベントはLoadImage発生しません。