DataGridView.ClearSelection Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Seçili durumdaki hücrelerin seçimini iptal eder.

Aşırı Yüklemeler

ClearSelection(Int32, Int32, Boolean)	Belirtilen hücre dışında seçili durumdaki tüm hücrelerin seçimini iptal eder ve isteğe bağlı olarak belirtilen hücrenin seçili olduğundan emin olur.
ClearSelection()	Seçili tüm hücrelerin seçimini kaldırarak geçerli seçimi temizler.

ClearSelection(Int32, Int32, Boolean)

Belirtilen hücre dışında seçili durumdaki tüm hücrelerin seçimini iptal eder ve isteğe bağlı olarak belirtilen hücrenin seçili olduğundan emin olur.

protected:
 void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

protected void ClearSelection (int columnIndexException, int rowIndexException, bool selectExceptionElement);

member this.ClearSelection : int * int * bool -> unit

Protected Sub ClearSelection (columnIndexException As Integer, rowIndexException As Integer, selectExceptionElement As Boolean)

Parametreler

columnIndexException

Int32

Hariç tutulacak sütun dizini.

rowIndexException

Int32

Dışlanması gereken satır dizini.

selectExceptionElement

Boolean

true dışlanan hücreyi, satırı veya sütunu seçmek için; false özgün durumunu korumak için.

Özel durumlar

ArgumentOutOfRangeException

columnIndexException en yüksek sütun dizininden büyüktür.

-veya- columnIndexException olduğunda -1'den SelectionMode küçüktür FullRowSelect; değilse, columnIndexException 0'dan küçüktür.

-veya- rowIndexException en yüksek satır dizininden büyüktür.

-veya- rowIndexException olduğunda -1'den SelectionMode küçüktür FullColumnSelect; değilse, rowIndexException 0'dan küçüktür.

Açıklamalar

rowIndexException-1 değeri bir sütun üst bilgisini, columnIndexException -1 değeri ise satır üst bilgisini temsil eder.

Bu yöntem, özel durum dizinleri tarafından belirtilen hücre, satır veya sütunun seçimini iptal etmeden geçerli seçimi temizlemek için yararlıdır.

SelectionMode Özellik değeri tek tek hücre seçimine izin veriyorsa, bu yöntem belirtilen satır ve sütundaki hücre hariç olmak üzere her hücrenin özelliğini olarak falseayarlarSelected. SelectionMode Özellik değeri tam satır veya sütun seçimine izin veriyorsa, bu yöntem her satırın veya sütunun falseözelliğini olarak ayarlarSelected; belirtilen hücreyi içeren satır veya sütun hariçtir.

Bu yöntem çağrıldığında dışlanan hücre, satır veya sütun seçili durumda olabilir veya olmayabilir. Parametre değeri ise selectExceptionElement truebu yöntem bunu seçer. Seçim moduna bağlı olarak, sonuç olarak satır veya sütunun tamamı da seçilebilir.

Ayrıca bkz.

• SelectionMode
• Selected
• Selected
• DataGridView Denetimi (Windows Forms)

ClearSelection()

Seçili tüm hücrelerin seçimini kaldırarak geçerli seçimi temizler.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Örnekler

Aşağıdaki kod örneği, öğesinin DataGridViewseçimini temizler. Bu örneği çalıştırmak için, kodu adlandırılmış ve Button adlandırılmış dataGridView1 clearSelectionButtoniçeren bir DataGridView forma yapıştırın ve tüm olayların olay işleyicileriyle ilişkilendirildiğinden emin olun.

private void clearSelectionButton_Click(object sender, EventArgs e)
{
    dataGridView1.ClearSelection();
}

Private Sub clearSelectionButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles clearSelectionButton.Click

    dataGridView1.ClearSelection()

End Sub

Açıklamalar

Bu yöntem çağrıldığında, her sütun ve satırın Selected özelliği olarak falseayarlanır.

Ayrıca bkz.

• DataGridView Denetimi (Windows Forms)