DataGridViewRow.GetPreferredHeight Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen ölçütlere göre belirtilen satırın ideal yüksekliğini hesaplar.

public:
 virtual int GetPreferredHeight(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);

public virtual int GetPreferredHeight (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);

abstract member GetPreferredHeight : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> int
override this.GetPreferredHeight : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> int

Public Overridable Function GetPreferredHeight (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean) As Integer

Parametreler

rowIndex: Int32

Tercih edilen yüksekliği hesaplanan satırın dizini.

autoSizeRowMode: DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode Otomatik boyutlandırma modunu belirten bir.

fixedWidth: Boolean

true sabit hücre genişliği için tercih edilen yüksekliği hesaplamak için; aksi takdirde , false.

Döndürülenler

Int32

Satırın piksel cinsinden ideal yüksekliği.

Özel durumlar

InvalidEnumArgumentException

autoSizeRowMode geçerli DataGridViewAutoSizeRowMode bir değer değil.

ArgumentOutOfRangeException

rowIndex, denetimdeki satır sayısı eksi 1 olan geçerli 0 aralığında değildir.

Örnekler

Aşağıdaki kod örneği, yeniden boyutlandırılmış bir satırın yeni doldurmasını belirlemek için yöntemini kullanır GetPreferredHeight . Bu kod örneği, Nasıl yapılır: Windows Forms DataGridView Denetimindeki Satırların Görünümünü Özelleştirme bölümünde sağlanan daha büyük bir örneğin parçasıdır.

// Adjusts the padding when the user changes the row height so that 
// the normal cell content is fully displayed and any extra
// height is used for the content that spans multiple columns.
void dataGridView1_RowHeightChanged(object sender,
    DataGridViewRowEventArgs e)
{
    // Calculate the new height of the normal cell content.
    Int32 preferredNormalContentHeight =
        e.Row.GetPreferredHeight(e.Row.Index, 
        DataGridViewAutoSizeRowMode.AllCellsExceptHeader, true) -
        e.Row.DefaultCellStyle.Padding.Bottom;

    // Specify a new padding.
    Padding newPadding = e.Row.DefaultCellStyle.Padding;
    newPadding.Bottom = e.Row.Height - preferredNormalContentHeight;
    e.Row.DefaultCellStyle.Padding = newPadding;
}

' Adjusts the padding when the user changes the row height so that 
' the normal cell content is fully displayed and any extra
' height is used for the content that spans multiple columns.
Sub dataGridView1_RowHeightChanged(ByVal sender As Object, _
    ByVal e As DataGridViewRowEventArgs) _
    Handles dataGridView1.RowHeightChanged

    ' Calculate the new height of the normal cell content.
    Dim preferredNormalContentHeight As Int32 = _
        e.Row.GetPreferredHeight(e.Row.Index, _
        DataGridViewAutoSizeRowMode.AllCellsExceptHeader, True) - _
        e.Row.DefaultCellStyle.Padding.Bottom()

    ' Specify a new padding.
    Dim newPadding As Padding = e.Row.DefaultCellStyle.Padding
    newPadding.Bottom = e.Row.Height - preferredNormalContentHeight
    e.Row.DefaultCellStyle.Padding = newPadding

End Sub

Açıklamalar

Bu özellik, bir satırın ideal yüksekliğini belirlemek için denetimin DataGridView içerik tabanlı otomatik boyutlandırma özelliği tarafından kullanılır. değeri, rowIndex paylaşılan bir satırın gerçek satır dizinini belirtmenize olanak tanır. (Paylaşılan satırlar -1 özellik değerlerine sahiptir Index .)

fixedWidth parametresinin false parametre değeri, ideal hücre yüksekliği-genişlik oranları elde edecek hesaplanmış sütun genişliklerine göre satır yüksekliğini hesaplar.

Hücre içeriğinin birden çok satıra kaydırılabilmesi için, hücrenin geçerli hücre stilinin özellik değeri TrueolmalıdırWrapMode.

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

Aracılığıyla paylaş