次の方法で共有


方法: カスタム オプション ページを作成する

[オプション] ダイアログ ボックスには、Visual Studio の個々の構成要素に関するさまざまなページが表示されます。 「オプション設定の制御」に概要を示したように、既存のオプション ページを制御できます。また、独自のカスタム ページを作成することもできます。 カスタム ページを使用して、独自のアドインまたは他のプログラムの設定をユーザーが変更できるようにします。

ページの定義がレジストリ キーではなく XML ファイルに保存されているので、独自のカスタム オプション ページを作成するためにアドインを使用する必要はありません。 したがって、Visual Studio 統合開発環境 (IDE: Integrated Development Environment) だけでなくマクロ IDE からもアクセスできるオプション ページを作成できます。

次の手順では、カスタム オプション ページとして機能するカスタム ユーザー コントロールを作成し、そのコントロールを参照するように .addin ファイルを変更する方法について説明します。

注意

実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 ここに記載されている手順は、全般的な開発設定が適用されているものとして記述されています。 設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。 詳細については、「設定の操作」を参照してください。

カスタム オプション ページを作成するには

  1. 新しい Windows コントロール ライブラリ プロジェクトを作成します。 それに ToolsOptionsLibrary.dll という名前を付けます。

  2. 必要なコントロールおよび機能を追加します。

    このユーザー コントロールがカスタム オプション ページになります。 コントロールが [オプション] ダイアログ ボックスのクライアント領域全体に表示されるようにコントロールのサイズを変更します。

  3. プロジェクトをビルドします。

    Visual Studio は、起動時にすべての共有 .addin ファイルを検索し、存在するファイルを読み込みます。 [アドイン/マクロ セキュリティ] という名前のオプション ページでは、.addin ファイルのパス用にトークンのセットが定義されています。 次のトークンが含まれています。

    • %ALLUSERSPROFILE%

    • %APPDATA%

    • %USERPROFILE%

    • %VSAPPDATA%

    • %VSCOMMONAPPDATA%

    Visual Studio が .addin ファイルの検索を開始すると、これらのトークンは次のパス文字列に置き換えられます。

    トークン

    パス

    %ALLUSERSPROFILE%

    .. \Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\

    %APPDATA%

    .. \Documents and Settings\ユーザー名\Microsoft\MSEnvShared\Addins\

    %USERPROFILE%

    .. \Documents and Settings\ユーザー名\My Documents\Visual Studio 2010\Addins\

    %VSAPPDATA%

    .. \Documents and Settings\ユーザー名\Addins\

    %VSCOMMONAPPDATA%

    .. \Documents and Settings\All Users\Addins

    アドインの登録方法の詳細については、「アドインのセキュリティ」を参照してください。

  4. これらのディレクトリのいずれかに、新しいオプション ページを参照する .addin ファイルを作成します。

    次のコードをテンプレートとして使用できます。

    <?xml version="1.0" encoding="UTF-16" standalone="no"?>
    <Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
        <HostApplication>
            <Name>Microsoft Visual Studio Macros</Name>
            <Version>10.0</Version>
        </HostApplication>
        <HostApplication>
            <Name>Microsoft Visual Studio</Name>
            <Version>10.0</Version>
        </HostApplication>
        <ToolsOptionsPage>
            <Category Name="Environment">
                <SubCategory Name="My Tools Options Page">
                    <Assembly><dll location></Assembly>
                    <FullClassName>ToolsOptionsLibrary.UserControl1
                    </FullClassName>
                </SubCategory>
            </Category>
        </ToolsOptionsPage>
    </Extensibility>
    
  5. <Assembly></Assembly> タグの <dll location> は、ToolsOptionsLibrary.dll のパスに置き換えます。

  6. ユーザー コントロールの具体的な内容を反映するように、<ToolsOptionsPage> の設定 (Category Name、SubCategory Name など) を変更します。

    たとえば、ユーザー コントロール名が "NewPage" でそのプロジェクト名が "MyTOLib" である場合、FullClassName タグは MyTOLib.NewPage になります。 Assembly は、オプション DLL が格納されている場所です。 Category Name は、カスタム ページを配置する [オプション] ダイアログ ボックス内のノードです ("環境"、"デバッグ"、"プロジェクト" など)。

    存在しない名前を指定した場合は、その名前のノードが作成されます。 SubCategory は、ノードの下に表示される名前です。 レベルの最大数は 2 です。 第 3 レベルのノードは追加できません。

  7. 前に説明したアドイン ファイル フォルダーのいずれかに、.addin ファイル名拡張子を持つテキスト ファイルとしてファイルを保存します。 既定のディレクトリは、.. \Documents and Settings\ユーザー名\Application Data\Microsoft\MSEnvShared\Addins\ です。

    Visual Studio は、起動時にカスタム オプション ページの定義を検出するためにこのディレクトリを検索し、見つかった定義を読み込みます。 アドイン ディレクトリを変更または追加するには、[オプション] ダイアログ ボックスの [環境] ノードの下にある [アドイン/マクロ セキュリティ] を使用します。

  8. Visual Studio を起動し、[ツール] メニューの [オプション] をクリックします。

    新しい [オプション] ページが表示されます。

参照

処理手順

方法 : ウィンドウの特性を変更する

概念

オプション設定の制御

アドインの登録

オートメーション オブジェクト モデルの階層図

その他の技術情報

環境ウィンドウの作成と制御

オートメーションと機能拡張のリファレンス