列の移動と交換

このトピックの内容

列を移動するには:
列を交換するには:
グループの移動および交換
ColPosChanged イベント

WinGrid には、列を移動、交換できる組み込み機能があります。デフォルトで、列の移動は行レイアウトモード以外では有効です。行レイアウトモードでは、AllowColMoving を WithinBand に設定して明示的に列の移動を有効にする必要があります。列の交換はデフォルトで有効ではありません。これを有効にするには、AllowColSwapping を WithinBand に設定しなければなりません。

Note	注：ここでは少なくとも 1 行のデータを含むバウンドグリッドがフォーム上にあるものとします。必要であれば、上記のプロパティも設定してください。

ランタイムに列を移動するには、列を選択し、クリックして新しい場所へドラッグします。

列を移動するには:

プログラムを実行します。
列を選択するために列ヘッダをクリックします。列ヘッダをクリックしてドラッグすると、複数の列を選択できます。
ひとつ以上の列を選択した後、再度列ヘッダをクリックしてマウスをドラッグします。マウスを列ヘッダの上で動かしていくと、マウスボタンを離したときに列が配置される場所を赤色の矢印が示します。
マウスボタンを離して列を新しい場所にドロップします。
次のスナップショットは列が移動している動作を示しています。

列を交換するには:

列の交換機能によって 2 つの列の位置を交換できます。デフォルトで、列の交換は無効になっています。

コードの記述を開始する前にコードビハインドに使用/インポートのディレクティブを配置します。そうすれば、メンバは完全に記述された名前を常に入力する必要がなくなります。

Visual Basic の場合：
```
Imports Infragistics.Win.UltraWinGrid
```
C# の場合：
```
using Infragistics.Win.UltraWinGrid;
```
列の交換を有効にするには、まず override オブジェクトの AllowColSwapping プロパティを設定する必要があります。これは通常 InitializeLayout イベントで行います。

Visual Basic の場合：
```
Me.UltraGrid1.DisplayLayout.Override.AllowColSwapping = _
    AllowColSwapping.WithinBand
```
C# の場合： this.ultraGrid1.DisplayLayout.Override.AllowColSwapping = AllowColSwapping.WithinBand;
プログラムが実行されると、各行の列ヘッダがドロップダウン矢印を表示します。列を交換するには、ドロップダウン矢印をドロップし、交換対象の列を選択します。
リストから項目が選択されるとすぐに、2 つの列がその位置を交換します。
次のスナップショットは交換ドロップダウンを示しています。どの列ヘッダにも右側に小さなドロップダウン矢印があるので、注意してください。

グループの移動および交換

グリッド内で列グループを定義していた場合、列グループは列とまったく同じ方法で移動および交換できます。AllowGroupMoving プロパティと AllowGroupSwapping プロパティを適切に設定する必要があります。次いで、列のヘッダではなく、グループのヘッダを選択して上記と同じように進めます。なお、グループを選択すると、自動的にそのグループ内の列はすべて選択されます。

ColPosChanged イベント

UI を使用して列を移動または交換すると、BeforeColPosChanged および AfterColPosChanged イベントが発生します。同様に、UltraGridGroup を移動/交換すると、BeforeGroupPosChanged および AfterGroupPosChanged イベントが発生します。

この相互作用をリッスンするには、ColumnPosChangedType が PosChangedType になることをトラップします。次のコードに示すように、イベント引数に Moved または Swapped を追加します。

C# の場合:

private void UltraGrid1_AfterColPosChanged(object sender, AfterColPosChangedEventArgs e)
{
    bool hasMovedChanged = (e.ColumnPosChangedType & PosChangedType.Moved) == PosChangedType.Moved;
    if(hasMovedChanged)
    {
        //コードを追加
    }
}

Visual Basic の場合:

Private Sub UltraGrid1_AfterColPosChanged(sender As Object, e As AfterColPosChangedEventArgs)
    Dim hasMovedChanged As Boolean = (e.ColumnPosChangedType And PosChangedType.Moved) = PosChangedType.Moved
    If hasMovedChanged Then
        'コードを追加
    End If
End Sub

Windows Forms | ヘルプ トピック