DataGridView.SetCurrentCellAddressCore メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridView.SetCurrentCellAddressCore メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在アクティブなセルを設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 SetCurrentCellAddressCore ( _
    columnIndex As Integer, _
    rowIndex As Integer, _
    setAnchorCellAddress As Boolean, _
    validateCurrentCell As Boolean, _
    throughMouseClick As Boolean _
) As Boolean

Visual Basic (使用法)

Dim columnIndex As Integer
Dim rowIndex As Integer
Dim setAnchorCellAddress As Boolean
Dim validateCurrentCell As Boolean
Dim throughMouseClick As Boolean
Dim returnValue As Boolean

returnValue = Me.SetCurrentCellAddressCore(columnIndex, rowIndex,
 setAnchorCellAddress, validateCurrentCell, throughMouseClick)

C#

protected virtual bool SetCurrentCellAddressCore
 (
    int columnIndex,
    int rowIndex,
    bool setAnchorCellAddress,
    bool validateCurrentCell,
    bool throughMouseClick
)

C++

protected:
virtual bool SetCurrentCellAddressCore (
    int columnIndex, 
    int rowIndex, 
    bool setAnchorCellAddress, 
    bool validateCurrentCell, 
    bool throughMouseClick
)

J#

protected boolean SetCurrentCellAddressCore (
    int columnIndex, 
    int rowIndex, 
    boolean setAnchorCellAddress, 
    boolean validateCurrentCell, 
    boolean throughMouseClick
)

JScript

protected function SetCurrentCellAddressCore
 (
    columnIndex : int, 
    rowIndex : int, 
    setAnchorCellAddress : boolean, 
    validateCurrentCell : boolean, 
    throughMouseClick : boolean
) : boolean

パラメータ

columnIndex

セルを含む列のインデックス。

rowIndex

セルを含む行のインデックス。

setAnchorCellAddress

新たにアクティブになったセルを、Shift キーを使用して後続の複数セルを選択するためのアンカー セルにする場合は true。それ以外の場合は false。

validateCurrentCell

古いセルの値を検証して、検証が失敗したら変更をキャンセルする場合は true。それ以外の場合は false。

throughMouseClick

現在のセルがマウス クリックの結果として設定されている場合は true。それ以外の場合は false。

戻り値
現在のセルが正常に設定された場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentOutOfRangeException	columnIndex が 0 未満か、コントロールの列数 -1 を上回っており、rowIndex が -1 ではありません。 または rowIndex が 0 未満か、コントロールの行数 -1 を上回っており、columnIndex が -1 ではありません。
InvalidOperationException	指定されたセルの Visible プロパティ値は false です。 または このメソッドは、基になるデータ ソースのリセット以外の理由で呼び出され、現在は別のスレッドがこのメソッドを実行しています。
InvalidCastException	新たにアクティブになったセルが編集モードに移行しようとしましたが、このセルの EditType プロパティには、IDataGridViewEditingControl を実装する、Control の派生クラスが指定されていません。

解説

現在のセルが変更されるたびに、DataGridView コントロールはこのメソッドを使用します。このメソッドは、選択を変更せずに現在のセルを変更します。前のセルの検証、または選択アンカー セルの変更を省略することもできます。アンカー セルは複数セルのブロックの最初のセルであり、ユーザーは Shift キーを押しながらブロックの最後のセルをクリックすることにより、このブロックを選択できます。

rowIndex と columnIndex の両方が -1 の場合、CurrentCell プロパティは null 参照 (Visual Basic では Nothing) を返します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)