XPages とカスタムコントロールにコントロールを追加する

XPages またはカスタムコントロールにコントロールを追加し、[プロパティ] ビューでコントロールのプロパティを設定します。

始める前に

このタスクについて

XPage またはカスタムコントロールにコントロールを追加するには、XPages エディタの [設計] または [ソース] タブで希望する場所にカーソルを置いて、以下のいずれかを行います。

コアコントロールの場合は、[作成] > [コアコントロール] をクリックし、リストからコントロールを選択します。
コンテナコントロールの場合は、[作成] > [コンテナコントロール] をクリックし、リストからコントロールを選択します。

次のタスク

希望する場所にカーソルを置きダブルクリックするか、[コントロール] パレットからコントロールをドラッグして XPages エディタ上の [設計] または [ソース] タブにドロップすることによっても、 XPages とカスタムコントロールにコントロールを追加することができます。

以下の機能と制約に注意してください。

ビューパネルを除き、すべてのコンテナコントロールにコントロールを追加できます。
リンクコントロールを除いて、コアコントロールにコントロールを追加することはできません。リンクコントロールは子を持つため、この点ではコンテナコントロールのように機能します。コアコントロールにコントロールを追加すると (例えば、[ソース] タブにあるコントロールのすべてまたは一部を選択するか、コントロールソース内の任意の場所にカーソルを置くことによって)、新規のコントロールはページの既存のコントロールの上に追加されます。
[ソース] タブでは、コントロールをコンテナの開始タグまたは終了タグにドラッグするか、開始タグまたは終了タグにフォーカスを移動して [作成] メニューを使用するかダブルクリックすることで、コンテナコントロールの最初または最後の子にすることができます。
表では、セルのみにコントロールを追加できます。行や表コンテナ自体に追加することはできません。
ビューパネルにコントロールを追加することはできません。
データ表の列にコントロールを追加できます。または、[ソース] タブでコントロールを作成済みの場合、データ表 (またはデータ表の列) のヘッダー、フッターとして定義されているコンテナコントロールにそれらのコントロールを追加できます。コントロールをヘッダーまたはフッターとして定義するには、データ表または列内の xp:this.facets 要素にコントロールを追加します。例えば、次のデータ表にはスパンヘッダーを持つ列が含まれています。
```
<xp:dataTable>
 	<xp:column>
 	  <xp:this.facets>
  		  <xp:span xp:key="header"></xp:span>
    </xp:this.facets>
  	</xp:column>
 </xp:dataTable>
```
タブ付きパネルでは、タブのみにコントロールを追加できます。パネル自体に追加することはできません。ただし、[ソース] タブでタブ付きパネルの終了タグにコントロールをドラッグした場合、または終了タグにフォーカスを移動して [作成] メニューを使用するかダブルクリックした場合は、タブ付きパネルの最後のタブにコントロールが追加されます。
XPage に追加されているカスタムコントロールにコントロールを追加できるのは、そのカスタムコントロールに編集可能領域が定義されている場合のみです。編集可能領域にファセット名がある場合、追加できるコントロールは 1 つのみです。ファセット名を削除すると、複数のコントロールを追加できます。別のカスタムコントロール内にネストされているカスタムコントロールに、コントロールを追加することはできません。