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