バージョン

AddNewBox プロパティ (AddNewBoxUIElement)

AddNewBoxオブジェクトは、新しいデータ行をグリッドに入力するためのAddNewBoxインターフェイスを表します。
シンタックス
'宣言
 
Public ReadOnly Property AddNewBox As AddNewBox
public AddNewBox AddNewBox {get;}
解説

フラットなレコードセットを表示するためにグリッドが使用されている時に、データ追加の従来のアプローチは、グリッドの一番下にある空行を配置することでした。この行に新しいデータを入力すると、データソースにデータが追加されます。 その後、新規データ入力用に予約されていた行はクリアされ、下に移動して新しく追加された行として表示されます。しかし、階層レコードセットの場合、この比喩は有効ではありません。データの複数のバンドは行の独立したグリッドとして表され、行のどのグループに新しいデータが入力されるかが重要になります。単純に新しいデータをバンドの最後の行に追加しても、新しいレコードをバンドの親レコードセットに対して正しい位置に配置できません。

階層レコードセットに新しいデータを効率的に追加するため、UltraGrid には、「AddNew ボックス」という新しいインターフェイスが実装されています。[AddNew]ボックスは、新しいデータの追加を実行するために使用する1つ以上のボタンを表示します。ボタンの数は表示される階層バンドの数に対応します。各バンドには独自の [AddNew] ボタンがあり、ボタン間をリンクする線によってバンドのデータの階層関係が表されます。

[AddNew] ボックスを使用するには、最初にバンドでデータを追加する 1 つの行またはセルにフォーカスします。階層のどの位置にレコードを追加するのかを決定して、その位置に対応するレコードを選択します。新しいデータを追加するバンドの<AddNew>ボタンをクリックすると、空のデータ入力行がバンドで選択した場所に表示されます。たとえば、顧客/発注の階層があり、新しい発注のデータを追加する場合、最初に発注した顧客を探し、顧客のレコード (またはその顧客の既存の発注レコード) を選択してから、発注バンドの<AddNew>ボタンをクリックします。その顧客の既存のすべての発注の下に空の行が表示されます。

AddNewBox オブジェクトには、[AddNew] ボックス インターフェイスのさまざまな属性を制御するプロパティが含まれます。たとえば、AddNewBox オブジェクトの Hidden プロパティを使用すると、インターフェイスを選択的に表示したり非表示にしたりすることにより、ユーザーのデータ入力の有効/無効を切り替えることができます。また、このオブジェクトを使用して、[AddNew] ボタンの外観を制御したり、その他の書式機能を指定したりできます。

参照