RibbonSplitButton.ImageName プロパティ

定義

名前空間:

Microsoft.Office.Tools.Ribbon

アセンブリ:

Microsoft.Office.Tools.Common.dll

コントロールのイメージを指定するために E:Microsoft.Office.Tools.Ribbon.LoadImage イベント ハンドラーで使うことができる名前を取得または設定します。

public:
 property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };

public string ImageName { get; set; }

member this.ImageName : string with get, set

Public Property ImageName As String

プロパティ値

String

コントロールのイメージを識別するために E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage イベント ハンドラーで使用できる文字列。

注釈

プロパティは ImageName 、コントロールによって表示されるイメージを識別します。 Office アプリケーションは、パフォーマンスを向上させるために、ソリューションからこのイメージを 1 回だけ取得します。 このプロパティは、それが識別するイメージがイベント中 LoadImage に読み込まれるため、デザイン時にのみ設定できます。 LoadImage は、リボンが表示されるときに、イメージ名ごとに 1 回だけ発生します。 その後、このプロパティを使用してコントロール イメージを変更することはできません。

イメージを読み込むには、イベント ハンドラーにコードを LoadImage 追加します。 の プロパティをImageName確認し、読み込むイメージにRibbonLoadImageEventArgsオブジェクトの プロパティを設定ImageRibbonLoadImageEventArgsします。

プロパティまたは プロパティが設定されている場合、ImageOfficeImageIdこのプロパティは無視されます。 Office アプリケーションは、リボンが初めて表示されるときにのみソリューションからイメージを取得するため、プロパティによって識別 ImageName されるイメージは、 プロパティによって Image 識別されるイメージよりも少し速く読み込むことができます。