DataGridViewColumn.AutoSizeMode Свойство

Определение

Возвращает или задает режим, в котором автоматически изменяется ширина столбца.Gets or sets the mode by which the column automatically adjusts its width.

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

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

Значение DataGridViewAutoSizeColumnMode, определяющее, изменяется ли автоматически ширина столбца и как определяется ее предпочтительное значение.A DataGridViewAutoSizeColumnMode value that determines whether the column will automatically adjust its width and how it will determine its preferred width. Значение по умолчанию — NotSet.The default is NotSet.

Исключения

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

Указанное значение, когда установка этого свойства приводит к тому, что свойство InheritedAutoSizeMode видимого столбца получает значение ColumnHeader, в то время как заголовки видимых столбцов скрыты.The specified value when setting this property results in an InheritedAutoSizeMode value of ColumnHeader for a visible column when column headers are hidden.

- или --or- Указанное значение, когда установка этого свойства приводит к тому, что свойство InheritedAutoSizeMode видимого столбца получает значение Fill, в то время как видимые столбцы заморожены.The specified value when setting this property results in an InheritedAutoSizeMode value of Fill for a visible column that is frozen.

Примеры

Следующий пример кода заставляет столбец автоматически изменять ширину в соответствии с содержимым.The following code example forces a column to automatically resize its width to fit its contents. Этот пример кода является частью большого примера, DataGridViewColumn приведенного для класса.This code example is part of a larger example provided for the DataGridViewColumn class.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}


// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}
' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Комментарии

Автоматическое изменение размера столбца определяется значением InheritedAutoSizeMode свойства, которое совпадает со значением AutoSizeMode свойства для всех значений, за исключением NotSet, которое указывает, что значение унаследовано от элемента DataGridView.AutoSizeColumnsModeвместо этого свойства.The automatic sizing behavior of the column is determined by the value of the InheritedAutoSizeMode property, which is the same as the value of the AutoSizeMode property for all values except NotSet, which indicates that the value is inherited from the DataGridView.AutoSizeColumnsMode property instead.

Если значение Fillсвойства равно, то размер столбца изменяется вместе с другими столбцами в этом режиме. InheritedAutoSizeModeWhen the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode. Все столбцы с заполнением в элементе управления делят доступное пространство в пропорциях, определяемых FillWeight значениями их свойств.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. Ширина, доступная для режима заливки, определяется путем вычитания ширины всех остальных столбцов из ширины клиентской области элемента управления.The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. Если эта ширина меньше, чем Объединенные MinimumWidth значения всех столбцов в режиме заполнения, отображается горизонтальная полоса прокрутки, все столбцы с заполнением отображаются с минимальной шириной, а пользовательское изменение размера столбца отключено.If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. Дополнительные сведения о режиме заполнения столбца см. в разделе режим заполнения столбца в элементе управления Windows Forms DataGridView.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

Если для Noneсвойства задано любое другое значение, за исключением, столбец будет управлять его шириной, чтобы значения ячеек полностью отображались без усечения. InheritedAutoSizeModeWhen the InheritedAutoSizeMode property is set to any other value except None, the column will manage its width so that its cell values are fully displayed without clipping. В режимах изменения размеров на основе содержимого изменения размера происходят при изменении содержимого ячейки или, WrapMode если включен, при изменении высоты строк.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. Некоторые режимы изменения размеров на основе содержимого позволяют ограничить корректировку размера для отображаемых в данный момент строк, чтобы повысить производительность.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Изменяются размеры Visible только столбцов со true значением свойства, и изменение видимости столбца не приводит к изменению размера.Only columns with a Visible property value of true are resized, and changing the visibility of a column does not cause resizing to occur. Кроме того, если для столбцов настроено автоматическое изменение размера, пользователь не может изменить ширину столбцов с помощью мыши.Additionally, when columns are set to automatically resize, the user cannot adjust the column widths with the mouse.

Чтобы настроить ширину DataGridView столбцов программно, используйте методы AutoResizeColumn элемента управления или AutoResizeColumns задайте свойство Column. WidthTo adjust column widths programmatically, use the DataGridView control's AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

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

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

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