DataGridViewColumn.AutoSizeMode Özellik

Tanım

Sütunun genişliğini otomatik olarak ayarladığı modu alır veya ayarlar.

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

Özellik Değeri

DataGridViewAutoSizeColumnMode Sütunun genişliğini otomatik olarak ayarlayıp ayarlamayacağını ve tercih edilen genişliğini nasıl belirleyeceğini belirleyen değer. Varsayılan değer: NotSet.

Özel durumlar

Bu özellik ayarlanırken belirtilen değer geçerli olmayan bir DataGridViewAutoSizeColumnMode değerdir.

Bu özellik ayarlanırken belirtilen değer, sütun başlıkları gizlendiğinde ColumnHeader görünür bir sütun için değeriyle sonuçlanırInheritedAutoSizeMode.

-veya-

Bu özellik ayarlanırken belirtilen değer, dondurulan Fill görünür bir sütun için değeriyle sonuçlanırInheritedAutoSizeMode.

Örnekler

Aşağıdaki kod örneği, bir sütunu genişliğini içeriğine sığacak şekilde otomatik olarak yeniden boyutlandırmaya zorlar. Bu kod örneği, sınıfı için DataGridViewColumn sağlanan daha büyük bir örneğin parçasıdır.

// 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

Açıklamalar

Sütunun otomatik boyutlandırma davranışı, özelliğin InheritedAutoSizeMode değeri tarafından belirlenir. Bu AutoSizeMode değer, özelliğin değeri yerine NotSetözelliğinden DataGridView.AutoSizeColumnsMode devralındığını gösterir.

InheritedAutoSizeMode Özellik değeri olduğundaFill, sütun bu modda diğer sütunlarla birlikte yeniden boyutlandırılır. Denetimdeki tüm doldurma modu sütunları, kullanılabilir alanı özellik değerlerine FillWeight göre belirlenen oranlarda böler. Doldurma modu için kullanılabilir 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 daha 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.

InheritedAutoSizeMode özelliği dışında Nonebaşka bir değere ayarlandığında, sütun genişliğini yöneterek hücre değerlerinin kırpma olmadan tam olarak görüntülenmesini sağlar. İç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ı yapılır. 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.

Yalnızca özellik değerine true sahip Visible sütunlar 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ı fareyle sütun genişliklerini ayarlayamaz.

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

İçerik tabanlı otomatik boyutlandırma hakkında daha fazla bilgi için Windows Forms DataGridView Denetimi'ndeki Boyutlandırma Seçenekleri'ne bakın.

Şunlara uygulanır

Ayrıca bkz.