RibbonComboBox.ImageName プロパティ (2007 System)

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

コントロールのイメージを指定するために LoadImage イベントハンドラで使用できる名前を取得または設定します。

名前空間 : Microsoft.Office.Tools.Ribbon
アセンブリ : Microsoft.Office.Tools.Common.v9.0 (Microsoft.Office.Tools.Common.v9.0.dll 内)

構文

'宣言
Public Property ImageName As String
'使用
Dim instance As RibbonComboBox
Dim value As String

value = instance.ImageName

instance.ImageName = value

public 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 Tools for Office が ShowImage プロパティを自動的に true に設定します。実行時に ImageName プロパティを設定する場合は、コードで ShowImage プロパティを true に設定する必要があります。