RibbonToggleButton.Image プロパティ
コントロールに表示されるイメージを取得または設定します。
名前空間: Microsoft.Office.Tools.Ribbon
アセンブリ: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll 内)
構文
'宣言
Property Image As Image
Image Image { get; set; }
プロパティ値
型 : System.Drawing.Image
コントロールに表示される Image。
解説
PNG 形式はアルファ チャネルによる透過をサポートするので、推奨されるイメージ形式は PNG 形式です。
Image プロパティは、コントロールによって表示されるイメージを指定します。このプロパティは、デザイン時または実行時に設定できます。このプロパティを実行時に更新した場合、コントロールの外観は、変更を反映するように更新されます。
Image プロパティを設定した場合、OfficeImageId プロパティと ImageName プロパティは無視されます。Image プロパティを使用すると、他の 2 つのプロパティより制御を詳細に行うことができますが、コントロールが更新されるたびにイメージ オブジェクトが Office アプリケーションに送信されるため、反応が遅くなる可能性があります。
コントロールにイメージを表示するには、ShowImage プロパティを true に設定する必要があります。デザイン時に Image プロパティを設定する場合は、Visual Studio によって自動的に ShowImage プロパティが true に設定されます。実行時に Image プロパティを設定する場合は、コードで ShowImage プロパティを true に設定する必要があります。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
Microsoft.Office.Tools.Ribbon 名前空間