次の方法で共有


RibbonSplitButton.OfficeImageId プロパティ

Microsoft Office の組み込みアイコンを使用する場合に、RibbonSplitButton コントロールに表示するイメージを取得または設定します。

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

構文

'宣言
Property OfficeImageId As String
string OfficeImageId { get; set; }

プロパティ値

型 : System.String
このコントロールのアイコンとして使用する Microsoft Office の組み込みアイコンの ID。

解説

OfficeImageId プロパティは、コントロールによって表示される Office アイコンを指定します。プロパティ値は、選択されたアイコンの imageMso 値を指定する文字列です。このプロパティは、デザイン時または実行時に設定できます。このプロパティを実行時に更新した場合、コントロールの外観は、変更を反映するように更新されます。

imageMso の値の一覧については、Microsoft ダウンロード センターのページ Office 2010 のアドイン: ギャラリー アイコンを参照してください。

このプロパティは、Image プロパティが設定されている場合には無視されます。OfficeImageId プロパティによって指定されたイメージは、Image プロパティによって指定されたイメージよりもわずかに速く読み込まれます。これは、イメージが Office アプリケーションにキャッシュされるためです。

次の例では、Microsoft Office アイコンを分割ボタンに割り当てます。

このコード例を実行するには、最初に次の手順を実行する必要があります。

  1. [リボン (ビジュアル デザイナー)] アイテムを、Visual Studio で Office 開発ツールを使用して作成されたプロジェクトに追加します。

  2. カスタム タブにグループを追加します。

  3. グループに分割ボタンを追加します。

Private Sub SetSplitButtonImage()
    SplitButton1.OfficeImageId = "HighImportance"
End Sub
private void SetSplitButtonImage()
{
    splitButton1.OfficeImageId = "HighImportance";
}

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

RibbonSplitButton インターフェイス

Microsoft.Office.Tools.Ribbon 名前空間

その他の技術情報

リボン オブジェクト モデルの概要