DataGridView.AutoSizeRowsMode Свойство

Определение

Получает или задает значение, указывающее, как определяется высота строки.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

Значение свойства

Значение DataGridViewAutoSizeRowsMode, указывающее режим изменения размеров.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. Значение по умолчанию — None.The default is None.

Исключения

Указанное при задании этого свойства значение не является допустимым значением DataGridViewAutoSizeRowsMode.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

Указанное значение при задании этого свойства равно AllHeaders или DisplayedHeaders, и заголовки строк скрыты.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.

Примеры

В следующем примере кода показано, как задать автоматическое изменение размера строки на основе содержимого заголовков строк и всех столбцов.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. Этот пример кода является частью большого примера, приведенного в разделе как автоматически изменять размер ячеек при изменении содержимого в элементе управления Windows Forms DataGridView.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

Комментарии

Это свойство позволяет настроить элемент управления таким образом, чтобы высота строк автоматически находилась в соответствии с содержимым при изменении содержимого.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. Если WrapMode включен, высота строк также корректируется при изменении ширины столбцов.If WrapMode is enabled, row heights are also adjusted whenever column widths change. Некоторые режимы изменения размеров позволяют ограничить корректировку размера для отображаемых в данный момент строк, чтобы повысить производительность.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Автоматически изменяется размер только строк со значением Visible свойства true, и изменение видимости строки не приводит к изменению размера.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. Кроме того, если для строк задано автоматическое изменение размера, пользователь не может изменить высоту строки с помощью мыши.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

Height значение автоматически изменяемой строки пересчитывается во время разметки, чтобы учитывать размер используемого шрифта.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. Чтобы получить правильный Height, следует получить значение в событии Layout формы, а не в конструкторе формы.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

Чтобы настроить высоту строк программным путем, используйте методы AutoResizeRow или AutoResizeRows или задайте свойство строки Height.To adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

Чтобы содержимое ячейки было перенесено на несколько строк при изменении размера строки, стиль ячейки, действующий для ячейки, должен иметь значение WrapMode свойства 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.

Дополнительные сведения об автоматическом изменении размера на основе содержимого см. в разделе Параметры изменения размера в элементе управления Windows Forms DataGridView.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

Применяется к

Дополнительно