プロパティーコンポーネントは、プロパティーシートコンポーネントに含まれるプロパティーシートセクションコンポーネントに必ず含まれています。
新しいプロパティーコンポーネントをプロパティーシートに追加するには、「パレット」の「Woodstock レイアウト」カテゴリにあるプロパティーコンポーネント
をプロパティーシートのプロパティーシートセクションにドラッグします。プロパティーコンポーネントを内の「プロパティーシートセクション」ノード
にドロップすることもできます。あるいは、ビジュアルデザイナーまたは「ナビゲータ」ウィンドウでプロパティーシートセクションを右クリックし、「プロパティーを追加」を選択することもできます。
プロパティーコンポーネントは、ラベル、ヘルプテキスト (省略可能)、およびデフォルトの形式を持つコンテナです。プロパティーコンポーネントは、そのまま使用して読み取り専用データを表示するか、ほかのコンポーネントをドロップして、編集可能または選択可能にしたり、データの形式を変更したりできます。たとえば、プロパティーコンポーネントを編集可能にするには、テキストフィールドコンポーネントをドロップします。
プロパティーコンポーネントの「プロパティー」ウィンドウで「label」プロパティーを編集することで、プロパティーコンポーネントのラベルを設定できます。たとえば、プロパティーシートを使用してデータ入力フォームを配置できます。各プロパティーコンポーネントにドロップされたテキストフィールドを含むようなフォームです。ユーザーの名前の入力が必要なテキストフィールドに対して「名前」など、各プロパティーコンポーネントの「label」プロパティーを設定してテキストフィールドの説明を付けることができます。次のサンプルのデータ入力フォームへのリンクを参照してください。
プロパティーコンポーネントにテキストフィールドなどの入力コンポーネントが含まれていて、そのフィールドへの入力が必須であることを指定する場合は、入力コンポーネントの「required」プロパティーを設定します。入力コンポーネントの「required」プロパティーを設定すると、実行時にプロパティーコンポーネントのラベルに赤いアスタリスクアイコンが表示されます。プロパティーシートの上部にこのアイコンの簡単な説明を表示する場合は、プロパティーシートコンポーネントの「requiredFields」プロパティーを「true」に設定します。
は、必須フィールドを持つプロパティーシートコンポーネントを使用して作成されたデータ入力フォームの例を示します。