DataGridViewRow.GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) DataGridViewRow.GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) DataGridViewRow.GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) DataGridViewRow.GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) Method

定義

指定した基準に基づいて、指定した行の適切な高さを計算します。Calculates the ideal height of the specified row based on the specified criteria.

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

パラメーター

rowIndex
Int32 Int32 Int32 Int32

適切な高さを計算する行のインデックス。The index of the row whose preferred height is calculated.

autoSizeRowMode
DataGridViewAutoSizeRowMode DataGridViewAutoSizeRowMode DataGridViewAutoSizeRowMode DataGridViewAutoSizeRowMode

自動サイズ設定モードを指定する DataGridViewAutoSizeRowModeA DataGridViewAutoSizeRowMode that specifies an automatic sizing mode.

fixedWidth
Boolean Boolean Boolean Boolean

固定のセル幅に対する適切な高さを計算する場合は true。それ以外の場合は falsetrue to calculate the preferred height for a fixed cell width; otherwise, false.

戻り値

行の適切な高さ (ピクセル単位)。The ideal height of the row, in pixels.

例外

rowIndex が有効な範囲 (0 ~ コントロールの行数 - 1) 内にありません。The rowIndex is not in the valid range of 0 to the number of rows in the control minus 1.

次のコード例ではGetPreferredHeight 、メソッドを使用して、サイズが変更された行の新しい埋め込みを決定します。The following code example uses the GetPreferredHeight method to determine the new padding for a row that has been resized. このコード例は、次の方法で提供される大規模な例の一部です。Windows フォーム DataGridView コントロールの行の外観をカスタマイズします。This code example is part of a larger example provided in How to: Customize the Appearance of Rows in the Windows Forms DataGridView Control.

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

注釈

このプロパティは、 DataGridViewコントロールのコンテンツベースの自動サイズ調整機能によって、行の最適な高さを決定するために使用されます。This property is used by the content-based automatic sizing feature of the DataGridView control to determine the ideal height of a row. rowIndex値を使用すると、共有行の実際の行インデックスを指定できます。The rowIndex value lets you specify the actual row index of a shared row. (共有行のIndexプロパティ値は-1 です)。(Shared rows have Index property values of -1.)

fixedWidthfalseパラメーター値は、計算列の幅に基づいて行の高さを計算します。これにより、セルの高さと幅の最適な比率が得られます。A fixedWidth parameter value of false calculates the row height based on calculated column widths that will achieve ideal cell height-to-width ratios.

セルの内容が複数の行に折り返されるようにするには、セルに対してWrapMode有効なセルTrueスタイルのプロパティ値がである必要があります。For cell contents to wrap onto multiple lines, the cell style in effect for the cell must have a WrapMode property value of True.

自動サイズ変更の詳細については、「 Windows フォーム DataGridView コントロールのサイズ変更オプション」を参照してください。For more information about automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

適用対象

こちらもご覧ください