Share via

DataGridView.AutoSizeColumnsMode Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Sütun genişliklerinin nasıl belirlendiğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

DataGridViewAutoSizeColumnsMode

Bir DataGridViewAutoSizeColumnsMode değer. Varsayılan değer: None.

Özel durumlar

InvalidEnumArgumentException

Bu özellik ayarlanırken belirtilen değer geçerli DataGridViewAutoSizeColumnsMode bir değer değil.

InvalidOperationException

Bu özellik ayarlanırken belirtilen değer , ColumnHeadersütun üst bilgileri gizlidir ve en az bir AutoSizeMode görünür sütun özelliği değerine NotSetsahiptir.

-veya- Bu özellik ayarlanırken belirtilen değer ve Fill bir özellik değerine NotSet sahip en az bir AutoSizeMode görünür sütun dondurulur.

Örnekler

Aşağıdaki kod örneği, iki denetimin üst/alt ilişkideki iki DataGridView tablodan verileri görüntülediği bir ana/ayrıntı senaryosunda bu özelliğin nasıl kullanılacağını göstermektedir. Bu örnekte, ana denetimin sütun boyutlandırma modu şeklindedir Noneve sütun genişlikleri yüklenen değerlere uyacak şekilde program aracılığıyla başlatılır. Ayrıntılar denetimi, değerler her değiştiğinde (örneğin, kullanıcı üst tablodaki geçerli satırı değiştirdiğinde) sütunların otomatik olarak ayarlanması için otomatik sütun boyutlandırma moduna ayarlanır. Bu örnek, How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls (İki Windows Forms DataGridView Denetimi Kullanarak Ana/Ayrıntı Formu Oluşturma) bölümünde bulunan daha büyük bir örneğin bir parçasıdır.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

Açıklamalar

Bu özellik, denetimi, sütun genişliklerinin denetimi doldurmak veya hücre içeriğini sığdırmak için otomatik olarak ayarlanmasını sağlayacak şekilde yapılandırmanızı sağlar. Boyut ayarlamaları, denetimin genişliği her değiştiğinde doldurma modunda gerçekleşir. İçerik tabanlı boyutlandırma modlarında, hücre içeriği her değiştiğinde veya etkinleştirilirse WrapMode satır yükseklikleri her değiştiğinde boyut ayarlamaları gerçekleşir. Bazı içerik tabanlı boyutlandırma modları, performansı artırmak için boyut ayarlamasını şu anda görüntülenen satırlar ile sınırlamanıza olanak sağlar.

Tek bir sütunun boyutlandırma modunu değiştirmek için özelliğini ayarlayın AutoSizeMode . Bu özelliğin varsayılan değeri, NotSetsütunun davranışını ve InheritedAutoSizeMode özellik değerini denetimden devraldığını gösterir.

Doldurma modundaki sütunlar, kullanılabilir denetim genişliğini özellik değerleriyle FillWeight belirtilen oranlarda böler. Doldurma modu için kullanılabilen genişlik, diğer tüm sütunların genişlikleri denetimin istemci alanının genişliğinden çıkarılarak belirlenir. Bu genişlik tüm dolgu modu sütunlarının birleşik MinimumWidth değerlerinden küçükse, yatay kaydırma çubuğu görüntülenir, tüm dolgu modu sütunları en düşük genişlikleriyle gösterilir ve kullanıcı sütununu yeniden boyutlandırma devre dışı bırakılır. Sütun doldurma modu hakkında daha fazla bilgi için datagridview denetimi Windows Forms sütun doldurma modu bölümüne bakın.

Yalnızca özellik değerine true sahip Visible sütunlar otomatik olarak yeniden boyutlandırılır ve sütunun görünürlüğünü değiştirmek yeniden boyutlandırmanın gerçekleşmesine neden olmaz. Ayrıca, sütunlar otomatik olarak yeniden boyutlandıracak şekilde ayarlandığında, kullanıcı sütun genişliklerini fareyle ayarlayamaz.

Sütun genişliklerini program aracılığıyla ayarlamak için veya AutoResizeColumns yöntemlerini kullanın AutoResizeColumn veya column Width özelliğini ayarlayın.

İçerik tabanlı otomatik boyutlandırma hakkında daha fazla bilgi için bkz. datagridview denetimi Windows Forms boyutlandırma seçenekleri.

Şunlara uygulanır

Ayrıca bkz.