複数のプロパティの一括登録

提供: RAD Studio
移動先: 案内検索

プロパティのカテゴリ への移動


複数のプロパティを一度に登録してプロパティ カテゴリと関連付けるには、グローバル ルーチン RegisterPropertiesInCategory を使用します。RegisterPropertiesInCategory には 3 つのオーバーロード ルーチンがあり、それぞれ異なる基準でカスタム コンポーネントのプロパティを識別してプロパティ カテゴリに関連付けます。

第 1 のオーバーロード ルーチンでは、プロパティをプロパティの名前または型で識別できます。リストを定数の配列として渡します。次の例では、"Text" という名前か付いているか TEdit 型のクラスに属するプロパティを 'Localizable' カテゴリに登録しています。

RegisterPropertiesInCategory('Localizable', ['Text', TEdit]);
RegisterPropertiesInCategory("Localizable", ARRAYOFCONST("Text", __typeinfo(TEdit)));

第 2 のオーバーロード ルーチンでは、登録されるプロパティを、特定のコンポーネントに属するものに限定できます。登録されるプロパティのリストには名前のみ含まれ、型は含まれません。たとえば、次のコードでは、すべてのコンポーネントのいくつかのプロパティを 'Help and Hints' カテゴリに登録しています。

RegisterPropertiesInCategory('Help and Hints', TComponent, ['HelpContext', 'Hint', 'ParentShowHint', 'ShowHint']);
RegisterPropertyInCategory("Help and Hints", __classid(TComponent), ARRAYOFCONST("HelpContext", "Hint", "ParentShowHint"));

第 3 のオーバーロード ルーチンでは、登録されるプロパティを、特定の型を持つものに限定できます。第 2 のオーバーロード ルーチンと同様に、登録されるプロパティのリストには、次のように、名前のみ含まれます。

RegisterPropertiesInCategory('Localizable', TypeInfo(String), ['Text', 'Caption']);
RegisterPropertiesInCategory("Localizable", __typeinfo(TStrings), ARRAYOFCONST("Lines", "Commands"));

使用可能なプロパティ カテゴリの一覧と用途の概要については、「プロパティ カテゴリの指定」を参照してください。