NEWGROUPS_BEGIN-NEWGROUPS_END

[アーティクル]
11/09/2009

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

The NEWGROUPS_BEGIN – NEWGROUPS_END section contains entries that define the command groups of a VSPackage.

グループ項目

グループには、コマンドやメニューをコンテナです。グループは [メニューやツールバー、あり区切り記号に自動的にグループ間で挿入されます。グループエントリには、プライマリメニューに [のグループが追加されますを指定します。 A group can be included on more than one menu or toolbar by using additional entries in the CMDPLACEMENT_SECTION-CMDPLACEMENT_END section.

グループのエントリはの NEWGROUPS_BEGIN - NEWGROUPS_END で定義しました。グループのエントリはコンマで区切られた 3 つのフィールドが。グループのエントリはセミコロンで終了します。構文を次の例に示します: グループの ID、メニュー ID、優先順位。

次の表でには、これらのフィールドについて説明します。グループのエントリを順番に表示されてする必要があります。最後のフィールドをセミコロンで終了する必要があります。詳細については、"グループの項目のフィールドを参照してください。ここ。

フィールド	説明
グループ ID	このグループを識別する GUID:ID ペアを指定します。
メニューの [ID	このグループが表示される、プライマリメニューを識別する GUID:ID ペアを指定します。
Priority	同じメニュー上の他のグループを基準にこのグループの位置を使用する値。

グループの使用例 (VB)

The following example shows theNEWGROUPS_BEGIN – NEWGROUPS_END section from the File Explorer sample. グループのコンテナは、メニューです。 The menu section format is described in MENUS_BEGIN-MENUS_END. グループメニューおよびボタンを含めることができます。 The button section format is described in BUTTONS_BEGIN-BUTTONS_END.

NEWGROUPS_BEGIN
// File Pane Toolbar Groups
    guidEUGrp:IDG_FILEPANE_COMMANDS   , guidEUGrp:IDM_TLB_FILESYSFILE     , 0x0010;
    guidEUGrp:IDG_FILEPANE_REFRESH    , guidEUGrp:IDM_TLB_FILESYSFILE     , 0x0020;
    guidEUGrp:IDG_FILEPANE_PROPS      , guidEUGrp:IDM_TLB_FILESYSFILE     , 0x0030;
    guidEUGrp:IDG_FILEPANE_FILTER     , guidEUGrp:IDM_TLB_FILESYSFILE     , 0x0040;

// File Pane Context Menu Groups
    guidEUGrp:IDG_FILEPANECTX_COMMANDS, guidEUGrp:IDM_CTX_FILESYSFILE     , 0x0010;
    guidEUGrp:IDG_FILEPANECTX_ARRANGE , guidEUGrp:IDM_CTX_FILESYSFILE     , 0x0020;

// File Pane Context Menu Arrange Cascading Menu Groups
    guidEUGrp:IDG_FILEPANE_SORT       , guidEUGrp:IDM_MNU_FILESYSFILE_SORT, 0x0010;

// Folder Pane Toolbar Groups
    guidEUGrp:IDG_FOLDERPANE_VIEW     , guidEUGrp:IDM_TLB_FILESYSFOLDER   , 0x0010;

// Folder Pane Context Menu Groups
    guidEUGrp:IDG_FOLDERCTX_SHORTCUT  , guidEUGrp:IDM_CTX_FILESYSFOLDER   , 0x0010;
    guidEUGrp:IDG_FOLDERCTX_PROPS     , guidEUGrp:IDM_CTX_FILESYSFOLDER   , 0xFF00;

// Shared Commands Group
    guidEUGrp:IDG_FILESYSCTX_COMMANDS , guidEUGrp:IDM_CTX_FILESYSFILE     , 0x0030;

// Shared Commands Cascading Menu Groups
    guidEUGrp:IDG_COMMANDS_LIST       , guidEUGrp:IDM_MNU_FILESYS_COMMANDS, 0x0010;

// Command Macro Context Menu Groups
    guidEUGrp:IDG_CMDCTX_FOLDER       , guidEUGrp:IDM_CTX_CMDMACRO        , 0x0010;
NEWGROUPS_END

グループの入力フィールド

Every entry in the NEWGROUPS_BEGIN – NEWGROUPS_END section must contain three fields. コンマのエントリ内のフィールドを区切るし、セミコロン (;) をエントリの末尾を示します。フィールドがとおりです。

Group ID

Group ID フィールドを作成する新しいグループを指定します。 Group ID は常に、GUID:ID ペアであり、グループを一意に識別。 "ファイルウィンドウツールバーグループ] で、Group ID フィールドの一部コード例は次の。
```
guidEUGrp:IDG_FILEPANE_COMMANDS
guidEUGrp:IDG_FILEPANE_REFRESH
guidEUGrp:IDG_FILEPANE_PROPS
guidEUGrp:IDG_FILEPANE_FILTER
```
Menu ID

Menu ID フィールドは、プライマリのメニューグループの追加を識別します。常に、Menu ID には、プライマリ] メニューの [一意に識別する GUID:ID 組み合わせを指定します。 "ファイルウィンドウツールバーグループ] で、Menu ID フィールドの一部コード例は次の。
```
guidEUGrp:IDM_TLB_FILESYSFILE
guidEUGrp:IDM_CTX_FILESYSFILE
guidEUGrp:IDM_MNU_FILESYSFILE_SORT
guidEUGrp:IDM_TLB_FILESYSFOLDER
guidEUGrp:IDM_CTX_FILESYSFOLDER
```
グループを作成するプライマリメニューをホストすることを指定せず、する必要がありますか、self-hosted、グループまたは、グループの GUID と ID 0 (ゼロ) がします。 Self-hosted means that the group uses its own Group ID in the Menu ID field, for example, as follows.

guidEUGrp:IDG_FILEPANE_COMMANDS, guidEUGrp:IDG_FILEPANE_COMMANDS, 0x0010;

次の例に、グループの GUID および 0 (ゼロ) の ID の使用方法を示します。

guidEUGrp:IDG_FILEPANE_COMMANDS, guidEUGrp:0, 0x0010;

If a group does not have a primary menu, it must be included on a menu with an entry in the CMDPLACEMENT_SECTION-CMDPLACEMENT_END section or it will not appear in the integrated development environment (IDE).
Priority

Priority フィールドには、メニューの [他のグループの基準に指定されたメニューの [グループの配置を指定します。低い優先度数であるアイテムが高い優先度数であるアイテムの前に表示されます。 "ファイルウィンドウツールバーグループ"内の Priority フィールドコード例を次のとおりです。
```
0x0010
0x0020
0x0030
0x0040
```
When the hosting of a group is defined by command placement, the Priority field that is specified in the group entry is ignored in favor of the Priority field that is specified by the CMDPLACEMENT_SECTION-CMDPLACEMENT_END section.