RibbonDialogLauncher.Image プロパティ

[アーティクル]
08/09/2011

この RibbonDialogLauncher をクイックアクセスツールバーに追加したときに表示されるイメージを取得または設定します。

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

構文

'宣言
Property Image As Image
    Get
    Set

Image Image { get; set; }

プロパティ値

型: System.Drawing.Image
この RibbonDialogLauncher をクイックアクセスツールバーに追加したときに表示されるイメージ。

解説

PNG 形式はアルファチャネルによる透過をサポートするので、推奨されるイメージ形式は PNG 形式です。

RibbonDialogLauncher がリボン上のグループ内に表示される場合、Image プロパティには目に見える効果はありません。一方、ユーザーが RibbonDialogLauncher をクイックアクセスツールバーに追加するときは、表示されるイメージの動作をこのプロパティが制御します。

Image プロパティは、コントロールによって表示されるイメージを指定します。このプロパティは、デザイン時または実行時に設定できます。このプロパティを実行時に更新した場合、コントロールの外観は、変更を反映するように更新されます。

Image プロパティを設定した場合、OfficeImageId プロパティと ImageName プロパティは無視されます。 Image プロパティを使用すると、他の 2 つのプロパティより制御を詳細に行うことができますが、コントロールが更新されるたびにイメージオブジェクトが Office アプリケーションに送信されるため、反応が遅くなる可能性があります。