RibbonComboBox.ImageName プロパティ
コントロールのイメージを指定するために LoadImage イベント ハンドラーで使用できる名前を取得または設定します。
名前空間: Microsoft.Office.Tools.Ribbon
アセンブリ: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll 内)
構文
'宣言
Property ImageName As String
string ImageName { get; set; }
プロパティ値
型 : System.String
コントロールのイメージを指定するために LoadImage イベント ハンドラーで使用できる文字列。
解説
このプロパティは、特定の条件が満たされた場合にのみ、実行時に設定できます。詳細については、「リボン オブジェクト モデルの概要」を参照してください。
このプロパティの設定の詳細については、「リボン オブジェクト モデルの概要」を参照してください。
ImageName プロパティは、コントロールによって表示されるイメージを指定します。Office アプリケーションは、パフォーマンスを向上させるために、このイメージをソリューションから 1 度だけ取得します。このプロパティが示す画像は LoadImage イベントの間に読み込まれるので、このプロパティはデザイン時にのみ設定できます。LoadImage は、リボンが表示されるときに、イメージ名ごとに 1 回だけ発生します。その後は、このプロパティを使用してコントロールのイメージを変更することはできません。
イメージを読み込むには、コードを LoadImage イベント ハンドラーに追加します。RibbonLoadImageEventArgs の ImageName プロパティを確認し、RibbonLoadImageEventArgs オブジェクトの Image プロパティを読み込むイメージに設定します。
このプロパティは、Image プロパティまたは OfficeImageId プロパティが設定されている場合は無視されます。ImageName プロパティで示されるイメージは、Image プロパティで示されるイメージより、わずかに速く読み込まれます。これは、Office アプリケーションは、リボンが初めて表示されるときにのみ、ソリューションからイメージを取得するためです。
コントロールにイメージを表示するには、ShowImage プロパティを true に設定する必要があります。デザイン時に ImageName プロパティを設定する場合は、Visual Studio によって自動的に ShowImage プロパティが true に設定されます。実行時に ImageName プロパティを設定する場合は、コードで ShowImage プロパティを true に設定する必要があります。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
Microsoft.Office.Tools.Ribbon 名前空間