OfficeRibbon.LoadImage イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ImageName プロパティが 1 つ以上のコントロールに対して設定されている場合に、OfficeRibbon が読み込まれると発生します。
public:
event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler Event LoadImage As RibbonLoadImageEventHandler イベントの種類
注釈
イベント LoadImage を使用すると、リボンのカスタマイズでイメージをキャッシュできるため、パフォーマンスが向上します。
既定では、ユーザーがイメージを含むタブを表示するたびに、イメージがリボンに読み込まれます。 イメージは、イメージが表示されるコントロールのプロパティをプログラムで変更するたびに再読み込みされます。
イベントを LoadImage 使用して、コントロールにイメージを割り当てます。 ユーザーがリボンのタブを選択すると、Microsoft Office アプリケーションはキャッシュされたイメージを使用します。 実行時にコントロール プロパティを変更した場合、Microsoft Office アプリケーションはコントロールのイメージを再読み込みしません。 これにより、パフォーマンスが低下する可能性があります。
コントロールのイメージをキャッシュする場合は、コントロールの ImageName プロパティを設定します。 少なくとも 1 つのコントロールの ImageName プロパティを設定しない限り、イベントはLoadImage発生しません。