DataGridView.AutoResizeRow Metoda

Definicja

Dostosowuje wysokość określonego wiersza, aby dopasować zawartość komórek.

Przeciążenia

AutoResizeRow(Int32)

Dostosowuje wysokość określonego wiersza, aby dopasować zawartość wszystkich jego komórek, w tym komórki nagłówka.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Dostosowuje wysokość określonego wiersza przy użyciu określonego trybu rozmiaru.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

Dostosowuje wysokość określonego wiersza przy użyciu określonego trybu rozmiaru, opcjonalnie oblicza wysokość z oczekiwaniami, że szerokość kolumny zostanie później dostosowana.

AutoResizeRow(Int32)

Dostosowuje wysokość określonego wiersza, aby dopasować zawartość wszystkich jego komórek, w tym komórki nagłówka.

public:
 void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)

Parametry

rowIndex
Int32

Indeks wiersza do zmiany rozmiaru.

Wyjątki

rowIndex nie znajduje się w prawidłowym zakresie od 0 do liczby wierszy pomniejszonej o 1.

Przykłady

Poniższy przykład kodu zmienia rozmiar trzeciego wiersza w obiekcie DataGridView , aby dopasować zawartość kolumny. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie Jak programowo zmieniać rozmiar komórek w celu dopasowania zawartości w kontrolce DataGridView Windows Forms.

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy wiersz zmienia rozmiar. Wysokość wiersza jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość wiersza zostanie później zmieniona, wiersz nie zostanie automatycznie dostosowany. Aby zmienić rozmiar wszystkich wierszy, użyj AutoResizeRows metody . Aby ustawić wiersz do automatycznego zmieniania rozmiaru przy każdej zmianie jego zawartości, użyj AutoSizeRowsMode właściwości .

Aby zawartość komórki zawijała wiele wierszy po zmianie rozmiaru wiersza, styl komórki w efekcie komórki musi mieć WrapMode wartość Truewłaściwości .

Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.

Zobacz też

Dotyczy

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Dostosowuje wysokość określonego wiersza przy użyciu określonego trybu rozmiaru.

public:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);
public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)

Parametry

rowIndex
Int32

Indeks wiersza do zmiany rozmiaru.

autoSizeRowMode
DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode Jedna z wartości.

Wyjątki

autoSizeRowModema wartość i RowHeadersVisible ma falsewartość RowHeader .

autoSizeRowMode jest nieprawidłową DataGridViewAutoSizeRowMode wartością.

rowIndex nie znajduje się w prawidłowym zakresie od 0 do liczby wierszy pomniejszonej o 1.

Przykłady

Poniższy przykład kodu zmienia rozmiar trzeciego wiersza w obiekcie DataGridView , aby dopasować zawartość kolumny. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie Jak programowo zmieniać rozmiar komórek w celu dopasowania zawartości w kontrolce DataGridView Windows Forms.

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy wiersz zmienia rozmiar. Wysokość wiersza jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość wiersza zostanie później zmieniona, wiersz nie zostanie automatycznie dostosowany. Aby zmienić rozmiar wszystkich wierszy, użyj AutoResizeRows metody . Aby ustawić wiersz do automatycznego zmieniania rozmiaru przy każdej zmianie jego zawartości, użyj AutoSizeRowsMode właściwości .

Aby zawartość komórki zawijała wiele wierszy po zmianie rozmiaru wiersza, styl komórki w efekcie komórki musi mieć WrapMode wartość Truewłaściwości .

To przeciążenie umożliwia określenie trybu ustalania rozmiaru, który oblicza nową wysokość na podstawie wartości w ograniczonym zestawie komórek, takich jak te w wyświetlanych wierszach. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.

Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.

Zobacz też

Dotyczy

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

Dostosowuje wysokość określonego wiersza przy użyciu określonego trybu rozmiaru, opcjonalnie oblicza wysokość z oczekiwaniami, że szerokość kolumny zostanie później dostosowana.

protected:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parametry

rowIndex
Int32

Indeks wiersza do zmiany rozmiaru.

autoSizeRowMode
DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode Jedna z wartości.

fixedWidth
Boolean

true aby obliczyć nową wysokość na podstawie bieżącej szerokości kolumn; false aby obliczyć wysokość z oczekiwaniami, że szerokość kolumny również zostanie dostosowana.

Wyjątki

autoSizeRowModema wartość i RowHeadersVisible ma falsewartość RowHeader .

autoSizeRowMode jest nieprawidłową DataGridViewAutoSizeRowMode wartością.

rowIndex nie znajduje się w prawidłowym zakresie od 0 do liczby wierszy pomniejszonej o 1.

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy wiersz zmienia rozmiar. Wysokość wiersza jest dostosowywana tylko raz na wywołanie metody; jeśli zawartość wiersza zostanie później zmieniona, wiersz nie zostanie automatycznie dostosowany. Aby zmienić rozmiar wszystkich wierszy, użyj AutoResizeRows metody . Aby ustawić wiersz do automatycznego zmieniania rozmiaru przy każdej zmianie jego zawartości, użyj AutoSizeRowsMode właściwości .

Aby zawartość komórki zawijała wiele wierszy po zmianie rozmiaru wiersza, styl komórki w efekcie komórki musi mieć WrapMode wartość Truewłaściwości .

To przeciążenie umożliwia określenie trybu ustalania rozmiaru, który oblicza nową wysokość na podstawie wartości w ograniczonym zestawie komórek, takich jak te w wyświetlanych wierszach. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.

To przeciążenie jest chronione i ma na celu umożliwienie osiągnięcia idealnych współczynników wysokości do szerokości komórek w klasie pochodnej DataGridView . Jeśli fixedWidth parametr ma falsewartość , wysokość wiersza zostanie obliczona z oczekiwaniami, że wywołasz metodę lub AutoResizeColumns w następnej AutoResizeColumn kolejności.

Aby uzyskać więcej informacji na temat zmiany rozmiaru programowego, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.

Zobacz też

Dotyczy