RibbonBase.LoadImage イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 イベントの種類
例
次の例では、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発生しません。