DataGridViewRow.GetPreferredHeight Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Calcola l'altezza ideale della riga specificata in base ai criteri specificati.

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

Parametri

rowIndex
Int32

Indice della riga di cui viene calcolata l'altezza preferenziale.

autoSizeRowMode
DataGridViewAutoSizeRowMode

Classe DataGridViewAutoSizeRowMode che specifica una modalità di dimensionamento automatico.

fixedWidth
Boolean

true per calcolare l'altezza preferita per una larghezza di cella fissa; in caso contrario, false.

Restituisce

Int32

Altezza ideale della riga, in pixel.

Eccezioni

InvalidEnumArgumentException

autoSizeRowMode non è un valore valido di DataGridViewAutoSizeRowMode.

ArgumentOutOfRangeException

Il parametro rowIndex non è incluso nell'intervallo valido compreso tra 0 e il numero di righe nel controllo meno 1.

Esempio

Nell'esempio di codice seguente viene usato il GetPreferredHeight metodo per determinare la nuova spaziatura interna per una riga ridimensionata. Questo esempio di codice fa parte di un esempio più grande fornito in Procedura: Personalizzare l'aspetto delle righe nel controllo DataGridView Windows Forms.

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

Commenti

Questa proprietà viene usata dalla funzionalità di ridimensionamento automatico basata sul contenuto del DataGridView controllo per determinare l'altezza ideale di una riga. Il rowIndex valore consente di specificare l'indice di riga effettivo di una riga condivisa. Le righe condivise hanno Index valori di proprietà di -1.

Un fixedWidth valore di parametro di false calcola l'altezza della riga in base alle larghezze di colonna calcolate che otterranno rapporti di altezza-larghezza di cella ideali.

Per il wrapping del contenuto della cella su più righe, lo stile della cella in effetti per la cella deve avere un WrapMode valore di proprietà di True.

Per altre informazioni sul ridimensionamento automatico, vedere Opzioni di ridimensionamento nell'Windows Forms Controllo DataGridView.

Si applica a

Vedi anche