プロパティ ウィンドウのボタン
開発言語や製品の種類に応じて、[プロパティ] ウィンドウのツールバーには特定のボタンが既定で表示されます。 どの場合でも、[項目別]、[アルファベット順]、[プロパティ]、[プロパティ ページ] ボタンが表示されます。 Visual C# と Visual Basic では、[イベント] ボタンも表示されます。 特定の Visual C++ プロジェクトでは、[VC++ メッセージ] および [VC オーバーライド] ボタンが表示されます。 他のプロジェクトの種類では、追加のボタンが表示される可能性があります。 [プロパティ] ウィンドウのボタンの詳細については、「プロパティ ウィンドウ」を参照してください。
プロパティ ウィンドウのボタンの実装
[項目別] ボタンをクリックすると、Visual Studio では、フォーカスのあるオブジェクトの ICategorizeProperties インターフェイスを呼び出して、そのプロパティをカテゴリ別に並べ替えます。 ICategorizeProperties は、[プロパティ] ウィンドウに表示される IDispatch
オブジェクトに実装されます。
定義済みのプロパティ カテゴリが 11 個あり、これらは負の値を持っています。 カスタム カテゴリを定義できますが、定義済みのカテゴリと区別するために、これには正の値を割り当てることをお勧めします。
MapPropertyToCategory メソッドは、指定されたプロパティの適切なプロパティ カテゴリ値を返します。 GetCategoryName メソッドは、カテゴリ名を含む文字列を返します。 標準のプロパティ カテゴリ値は Visual Studio によって認識されているため、ユーザーは、カスタム カテゴリ値のサポートを提供するだけで済みます。
[アルファベット順] ボタンをクリックすると、プロパティが名前のアルファベット順に表示されます。 これらの名前は、ローカライズされた並べ替えアルゴリズムに従って IDispatch
によって取得されます。
[プロパティ] ウィンドウが開いているとき、[プロパティ] ボタンは自動的に選択済みとして表示されます。 環境の他の部分にも同じボタンが表示されるため、それをクリックして [プロパティ] ウィンドウを表示できます。
選択されたオブジェクトに対して ISpecifyPropertyPages
が実装されていない場合、[プロパティ ページ] ボタンは使用できません。 プロパティ ページには、通常はソリューションやプロジェクトに関連付けられている、構成に依存するプロパティが表示されますが、これらのプロパティを (たとえば、Visual C++ の) プロジェクト項目に関連付けることもできます。
Note
アンマネージド コードを使用して [プロパティ] ウィンドウにツールバー ボタンを追加することはできません。 ツールバー ボタンを追加するには、PropertyTab から派生するマネージド オブジェクトを作成する必要があります。