DataGridViewColumn.AutoSizeMode Właściwość

Definicja

Pobiera lub ustawia tryb, w którym kolumna automatycznie dostosowuje swoją szerokość.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

Wartość właściwości

DataGridViewAutoSizeColumnMode

Wartość określająca DataGridViewAutoSizeColumnMode , czy kolumna automatycznie dostosowuje swoją szerokość i jak będzie określać preferowaną szerokość.A DataGridViewAutoSizeColumnMode value that determines whether the column will automatically adjust its width and how it will determine its preferred width. Wartość domyślna to NotSet.The default is NotSet.

Wyjątki

Określona wartość w przypadku ustawienia tej właściwości jest DataGridViewAutoSizeColumnMode nieprawidłowa.The specified value when setting this property is a DataGridViewAutoSizeColumnMode that is not valid.

Określona wartość w przypadku ustawienia tej właściwości powoduje, że InheritedAutoSizeMode wartość ColumnHeader dla widocznej kolumny, gdy nagłówki kolumn są ukryte.The specified value when setting this property results in an InheritedAutoSizeMode value of ColumnHeader for a visible column when column headers are hidden.

-lub--or- Określona wartość w przypadku ustawienia tej właściwości powoduje InheritedAutoSizeMode Fill , że wartość dla widocznej kolumny jest zamrożona.The specified value when setting this property results in an InheritedAutoSizeMode value of Fill for a visible column that is frozen.

Przykłady

Poniższy przykład kodu wymusza na kolumnie automatyczne zmienianie rozmiaru szerokości w celu dopasowania jej do zawartości.The following code example forces a column to automatically resize its width to fit its contents. Ten przykład kodu jest częścią większego przykładu dostarczonego dla DataGridViewColumn klasy.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

Uwagi

Zachowanie automatycznej zmiany wielkości kolumny jest określane przez wartość InheritedAutoSizeMode właściwości, która jest taka sama jak wartość AutoSizeMode właściwości dla wszystkich wartości z wyjątkiem NotSet , która wskazuje, że wartość jest dziedziczona z DataGridView.AutoSizeColumnsMode właściwości.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.

Gdy InheritedAutoSizeMode wartość właściwości to Fill , rozmiar kolumny zostanie zmieniony wraz z innymi kolumnami w tym trybie.When the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode. Wszystkie kolumny trybu wypełniania w formancie dzielą dostępne miejsce w proporcjach określone przez ich FillWeight wartości właściwości.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. Szerokość dostępna dla trybu wypełnienia jest określana przez odjęcie szerokości wszystkich innych kolumn od szerokości obszaru klienckiego kontrolki.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. Jeśli ta szerokość jest mniejsza niż łączna MinimumWidth wartość wszystkich kolumn trybu wypełniania, zostanie wyświetlony poziomy pasek przewijania, wszystkie kolumny trybu wypełniania są wyświetlane z minimalnymi szerokościami, a zmiany rozmiaru kolumny użytkownika są wyłączone.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. Aby uzyskać więcej informacji na temat trybu wypełniania kolumn, zobacz tryb wypełniania kolumn w kontrolce DataGridView Windows Forms.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

Gdy InheritedAutoSizeMode Właściwość jest ustawiona na inną wartość, z wyjątkiem None , kolumna będzie zarządzać jej szerokością tak, aby wartości komórek były w pełni wyświetlane bez obcinania.When 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. W przypadku trybów ustalania rozmiaru na podstawie zawartości, zmiany rozmiaru są wykonywane zawsze wtedy, gdy WrapMode jest włączona, gdy jest włączone, po zmianie wysokości wierszy.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. Niektóre tryby ustalania rozmiaru na podstawie zawartości pozwalają ograniczyć dopasowanie rozmiaru do aktualnie wyświetlanych wierszy w celu zwiększenia wydajności.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Tylko kolumny z Visible wartością właściwości o true rozmiarze są zmieniane, a zmiana widoczności kolumny nie spowoduje wystąpienia zmiany rozmiaru.Only columns with a Visible property value of true are resized, and changing the visibility of a column does not cause resizing to occur. Ponadto jeśli kolumny są ustawione na automatyczne zmienianie rozmiaru, użytkownik nie może dostosować szerokości kolumn za pomocą myszy.Additionally, when columns are set to automatically resize, the user cannot adjust the column widths with the mouse.

Aby programowo dopasować szerokości kolumn, użyj DataGridView kontrolki AutoResizeColumn lub AutoResizeColumns metod lub ustaw Width Właściwość Column.To adjust column widths programmatically, use the DataGridView control's AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

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ż