OfficeRibbon.LoadImage イベント
ImageName プロパティが 1 つ以上のコントロールに対して設定されている場合に、OfficeRibbon が読み込まれるときに発生します。
名前空間: Microsoft.Office.Tools.Ribbon
アセンブリ: Microsoft.Office.Tools.Common.v4.0.Utilities (Microsoft.Office.Tools.Common.v4.0.Utilities.dll 内)
Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll 内)
構文
'宣言
Event LoadImage As RibbonLoadImageEventHandler
event RibbonLoadImageEventHandler LoadImage
解説
LoadImage イベントにより、リボンのカスタマイズでイメージをキャッシュできます。これにより、パフォーマンスを向上させることができます。
既定では、イメージを含むタブをユーザーが表示するたびに、リボンにイメージが読み込まれます。イメージは、イメージが表示されるコントロールのプロパティをプログラムで変更するたびに再度読み込まれます。
コントロールにイメージを割り当てるには、LoadImage イベントを使用します。ユーザーがリボン上のタブを選択すると、Microsoft Office アプリケーションはキャッシュされたイメージを使用します。実行時にコントロール プロパティを変更した場合、Microsoft Office アプリケーションでは、コントロールのイメージが再度読み込まれません。そのため、パフォーマンスが若干向上する可能性があります。
コントロールのイメージをキャッシュするには、コントロールの ImageName プロパティを設定します。LoadImage イベントは、少なくとも 1 つのコントロールの ImageName プロパティを設定しない限り発生しません。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。