DataGridView.AutoSizeRowsMode Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą sposób określania wysokości wierszy.Gets or sets a value indicating how row heights are determined.

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

DataGridViewAutoSizeRowsModeWartość wskazująca tryb ustalania wielkości.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. Wartość domyślna to None.The default is None.

Wyjątki

Określona wartość, gdy ustawienie tej właściwości nie jest prawidłową DataGridViewAutoSizeRowsMode wartością.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

Określona wartość w przypadku ustawienia tej właściwości to AllHeaders lub DisplayedHeaders , a nagłówki wierszy są ukryte.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.

Przykłady

Poniższy przykład kodu demonstruje, jak ustawić wiersz, aby automatycznie zmieniać rozmiar na podstawie zawartości nagłówków wierszy i wszystkich kolumn.The following code example demonstrates how to set the row to automatically resize based on the contents of the row headers and all of the columns. Ten przykład kodu jest częścią większego przykładu : automatyczne zmienianie rozmiaru komórek przy zmianie zawartości w kontrolce DataGridView Windows Forms.This code example is part of a larger example provided in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

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ść wierszy była automatycznie dostosowywana do zawartości przy każdej zmianie zawartości.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. Jeśli WrapMode jest włączona, wysokość wierszy również jest dostosowywana przy każdej zmianie szerokości kolumn.If WrapMode is enabled, row heights are also adjusted whenever column widths change. Niektóre tryby określania rozmiaru pozwalają ograniczyć dopasowanie rozmiaru do aktualnie wyświetlanych wierszy w celu zwiększenia wydajności.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Rozmiar tylko wierszy z Visible wartością właściwości true jest zmieniany automatycznie, a zmiana widoczności wiersza nie powoduje zmiany rozmiaru.Only rows with a Visible property value of true are resized automatically, and changing the visibility of a row does not cause resizing to occur. Ponadto gdy wiersze są ustawione na wartość automatycznie Zmień rozmiar, użytkownik nie może dostosować wysokości wiersza za pomocą myszy.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

HeightWartość wiersza o rozmiarze automatycznym jest obliczana ponownie podczas układania do konta dla rozmiaru używanej czcionki.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. Aby uzyskać poprawne Height , należy pobrać wartość w Layout zdarzeniu formularza zamiast w Konstruktorze formularza.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

Aby programowo dostosować wysokość wierszy, użyj AutoResizeRow metod lub lub AutoResizeRows Ustaw Height Właściwość Row.To adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

Aby zawartość komórki była zawijana do wielu wierszy, gdy zmieniany jest rozmiar wiersza, styl komórki w efekcie dla komórki musi mieć WrapMode wartość właściwości True .For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Aby uzyskać więcej informacji na temat automatycznego ustalania rozmiarów opartych na zawartości, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

Dotyczy

Zobacz też