DataGridView.ClearSelection Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zruší výběr aktuálně vybraných buněk.

Přetížení

ClearSelection(Int32, Int32, Boolean)	Zruší výběr všech aktuálně vybraných buněk kromě té, která je uvedena, a volitelně zajistí, že je vybraná označená buňka.
ClearSelection()	Vymaže aktuální výběr zrušením výběru všech vybraných buněk.

ClearSelection(Int32, Int32, Boolean)

Zruší výběr všech aktuálně vybraných buněk kromě té, která je uvedena, a volitelně zajistí, že je vybraná označená buňka.

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)

Parametry

columnIndexException

Int32

Index sloupce, který chcete vyloučit.

rowIndexException

Int32

Index řádku, který chcete vyloučit.

selectExceptionElement

Boolean

true chcete-li vybrat vyloučenou buňku, řádek nebo sloupec; false zachovat původní stav.

Výjimky

ArgumentOutOfRangeException

columnIndexException je větší než nejvyšší index sloupce.

-nebo-

columnIndexExceptionje menší než -1, columnIndexException pokud SelectionMode je FullRowSelect; jinak je menší než 0.

-nebo-

rowIndexException je větší než index nejvyššího řádku.

-nebo-

rowIndexExceptionje menší než -1, rowIndexException pokud SelectionMode je FullColumnSelect; jinak je menší než 0.

Poznámky

rowIndexException Hodnota -1 představuje záhlaví sloupce a columnIndexException hodnota -1 představuje záhlaví řádku.

Tato metoda je užitečná k vymazání aktuálního výběru bez zrušení výběru buňky, řádku nebo sloupce označeného indexy výjimek.

SelectionMode Pokud hodnota vlastnosti umožňuje výběr jednotlivých buněk, tato metoda nastaví Selected vlastnost každé buňky na false, s výjimkou buňky v zadaném řádku a sloupci. SelectionMode Pokud hodnota vlastnosti umožňuje výběr celého řádku nebo sloupce, tato metoda také nastaví Selected vlastnost každého řádku nebo sloupce na false, s výjimkou řádku nebo sloupce obsahujícího zadanou buňku.

Vyloučená buňka, řádek nebo sloupec může nebo nemusí být ve vybraném stavu při zavolání této metody. Tato metoda ji vybere, pokud je truehodnota parametru selectExceptionElement . V závislosti na režimu výběru může být jako výsledek vybrán také celý řádek nebo sloupec.

Viz také

• SelectionMode
• Selected
• Selected
• DataGridView – ovládací prvek (Windows Forms)

ClearSelection()

Vymaže aktuální výběr zrušením výběru všech vybraných buněk.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Příklady

Následující příklad kódu vymaže výběr DataGridView. Pokud chcete spustit tento příklad, vložte kód do formuláře, který obsahuje DataGridView pojmenované dataGridView1 a pojmenované ButtonclearSelectionButton, a ujistěte se, že všechny události jsou přidružené k jejich obslužným rutinám událostí.

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

Poznámky

Při zavolání této metody je vlastnost každého sloupce a řádku nastavena Selected na falsehodnotu .

Viz také

• DataGridView – ovládací prvek (Windows Forms)