RibbonDropDownItem.OfficeImageId プロパティ

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

名前空間:  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 の組み込みアイコンを使用する場合に、RibbonDropDownItem 上に表示するイメージ。

解説

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

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

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

例

次の例では、Microsoft Office アイコンをドロップダウン ボックスの 2 つの項目に割り当てます。

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

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

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

3. ドロップダウン ボックスをグループに追加します。

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub

private void PopulateDropDown()
{
    RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

.NET Framework セキュリティ

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

参照

関連項目

RibbonDropDownItem インターフェイス

Microsoft.Office.Tools.Ribbon 名前空間

その他の技術情報

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