次の方法で共有


CMDPLACEMENT_SECTION-CMDPLACEMENT_END

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]

The CMDPLACEMENT_SECTION – CMDPLACEMENT_END section allows buttons, groups, and menus to be placed into more than one group or menu. これにより、ユーザー インターフェイスの外観を変更する完全にこれらの項目を再定義する必要がなくなります。

The CMDPLACEMENT_SECTION – CMDPLACEMENT_END section is optional:コマンド、グループ、またはメニューのする必要がある場合、第 2 の場所に置いて、.ctc ファイルにこのセクションを含める必要はありません。

コマンドの配置項目

A command placement entry is defined in the CMDPLACEMENT_SECTION – CMDPLACEMENT_END section. コマンドの配置のエントリは次の 3 つのフィールド、コンマで区切られ、はセミコロンで終了を持ちます。 以下に例を示します。

Item ID, Parent ID, Priority;

次の表でには、これらのフィールドについて説明します。 各エントリの最後のフィールドをセミコロンで終了する必要があります。 コマンドの入力フィールド:"を表示します。 詳細の各フィールドについては「に」以降。

フィールド

説明

Item ID

コマンド、グループまたはこのエントリによって設定されているメニューを識別する GUID:ID ペア。

Parent ID

グループや、項目が配置されるメニューを識別する GUID:ID ペア。

Priority

親グループまたは] メニューの [その他のアイテムの基準にこの項目の位置に使用する値。 この値は、アイテムのコマンド エントリ、] メニューの [エントリやグループ エントリ自体の Priority フィールドをオーバーライドします。

コマンドの配置の例

The following code example from theFile Explorer sample shows the CMDPLACEMENT_SECTION – CMDPLACEMENT_END section.

CMDPLACEMENT_SECTION
// Commands appearing in multiple groups
    // Command                                 Parent                               Priority
    guidVSStd97:cmdidPropSheetOrProperties,    guidEUGrp:IDG_FILEPANE_PROPS,        0x0010;
    guidVSStd97:cmdidPropSheetOrProperties,    guidEUGrp:IDG_FOLDERPANE_PROPS,      0x0010;
    guidVSStd97:cmdidPropSheetOrProperties,    guidEUGrp:IDG_FOLDERCTX_PROPS,       0x0010;
    guidEUCmd:cmdidFilesOpenFile,              guidEUGrp:IDG_FILEPANECTX_COMMANDS,  0x0010;
    guidEUCmd:cmdidFilesPreviewFile,           guidEUGrp:IDG_FILEPANECTX_COMMANDS,  0x0015;

// Groups appearing in multiple menus
    guidEUGrp:IDG_FILEPANE_REFRESH,            guidEUGrp:IDM_CTX_FILESYSFILE,       0x0040;
    guidEUGrp:IDG_FILEPANE_PROPS,              guidEUGrp:IDM_CTX_FILESYSFILE,       0xFF00;
    guidEUGrp:IDG_FILESYSCTX_COMMANDS,         guidEUGrp:IDM_CTX_FILESYSFOLDER,     0x0040;
CMDPLACEMENT_END

コマンド入力フィールド

Each entry in the CMDPLACEMENT_SECTION-CMDPLACEMENT_END section contains three fields. すべてのフィールドを区切るコンマと、セミコロン (;) はそれぞれのエントリの末尾を示します。 順のフィールドは。

  • Item ID

    Item ID フィールドには、配置されている品目を識別するが、コマンド、] メニューの [かグループ。 Item ID フィールドは、常に、GUID:ID ペアです。

    使用例の一部の Item ID フィールドは。

    guidVSStd97:cmdidPropSheetOrProperties, // a command
    guidEUCmd:cmdidFilesOpenFile,           // a command
    guidEUGrp:IDG_FILEPANE_REFRESH,         // a group
    guidEUGrp:IDM_CTX_FILESYSFOLDER,        // a menu
    
  • Parent ID

    Parent ID フィールドは、グループまたはメニュー項目が配置されますを識別します。 Parent ID フィールドは、常に、GUID:ID ペアです。 アイテム可能性があります複数のセカンダリ場所に配置し、アイテムが配置場所の数に実用的な制限はありません。 ただし、次のルールを項目を配置すると確認する必要があります。

    • コマンドは、グループにのみ配置できます。 これらは、メニューに直接配置できません。

    • グループは、メニューにのみ配置できます。 別のグループにグループを配置することはできません。

    • メニューは、グループにのみ配置できます。 別のメニューにメニューを配置することはできません。

    使用例の一部の Parent ID フィールドは。

    ,guidEUGrp:IDG_FILEPANE_PROPS,        // A group
    ,guidEUGrp:IDG_FILEPANECTX_COMMANDS,  // A group
    ,guidEUGrp:IDM_CTX_FILESYSFILE,       // A menu
    
  • Priority

    Priority フィールドはその親コンテナ内の要素の相対位置を指定します。 小さい優先順位番号を持つアイテムは、大規模な優先順位番号を持つ前に表示されます。

    CMDPLACEMENT_SECTION - CMDPLACEMENT_END セクション エントリで指定された優先順位は、アイテムの定義の優先順位上書きされます。

    使用例の一部の Priority フィールドは。

    ,0x0010
    ,0x0015
    ,0xFF00
    

参照

概念

コマンド テーブル形式リファレンス

VSPackage の IDE にユーザー インターフェイス要素を追加する方法