DataGridView.AutoSizeRowsMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą sposób określania wysokości wierszy.

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }
member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set
Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Wartość właściwości

DataGridViewAutoSizeRowsMode

Wartość DataGridViewAutoSizeRowsMode wskazująca tryb ustalania rozmiaru. Wartość domyślna to None.

Wyjątki

InvalidEnumArgumentException

Określona wartość podczas ustawiania tej właściwości nie jest prawidłową DataGridViewAutoSizeRowsMode wartością.

InvalidOperationException

Określona wartość podczas ustawiania tej właściwości to AllHeaders lub DisplayedHeaders nagłówki wierszy są ukryte.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić wiersz tak, aby automatycznie zmieniał rozmiar na podstawie zawartości nagłówków wierszy i wszystkich kolumn. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control (Jak automatycznie zmieniać rozmiar komórek po zmianie zawartości w kontrolce DataGridView).

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Uwagi

Ta właściwość umożliwia skonfigurowanie kontrolki tak, aby wysokości wierszy zostały automatycznie dostosowane do ich zawartości po zmianie zawartości. Jeśli WrapMode jest włączona, wysokość wierszy jest również dostosowywana za każdym razem, gdy zmienią się szerokości kolumn. Niektóre tryby ustalania rozmiaru umożliwiają ograniczenie dostosowania rozmiaru do aktualnie wyświetlanych wierszy w celu zwiększenia wydajności.

Tylko wiersze o Visible wartości właściwości są true zmieniane automatycznie, a zmiana widoczności wiersza nie powoduje zmiany rozmiaru. Ponadto po ustawieniu automatycznego zmieniania rozmiaru wierszy użytkownik nie może dostosować wysokości wierszy za pomocą myszy.

Wartość Height wiersza o automatycznym rozmiarze jest ponownie obliczana podczas układu, aby uwzględnić rozmiar używanej czcionki. Aby uzyskać poprawną Heightwartość , należy pobrać wartość w zdarzeniu formularza Layout zamiast w konstruktorze formularza.

Aby programowo dostosować wysokość wierszy, użyj AutoResizeRow metod lub AutoResizeRows ustaw właściwość wiersza Height .

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

Aby uzyskać więcej informacji na temat automatycznego określania rozmiaru opartego na zawartości, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms.

Dotyczy

Zobacz też