DataGridView.AutoResizeColumnHeadersHeight 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
調整資料行行首的高度，以適合行首的內容。
多載
| AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean) |
根據指定資料行中行首內容的變更來調整資料行行首的高度，並在預期接下來將調整資料行和/或資料列行首寬度的情況下，選擇性地計算高度。 |
| AutoResizeColumnHeadersHeight(Boolean, Boolean) |
調整資料行行首的高度以適合其內容，並在預期接下來將調整資料行和/或資料列行首寬度的情況下，選擇性地計算高度。 |
| AutoResizeColumnHeadersHeight() |
調整資料行行首的高度，以適合最大資料行行首的內容。 |
| AutoResizeColumnHeadersHeight(Int32) |
根據指定資料行中的行首內容之變更來調整資料行行首的高度。 |
AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean)
根據指定資料行中行首內容的變更來調整資料行行首的高度，並在預期接下來將調整資料行和/或資料列行首寬度的情況下，選擇性地計算高度。
protected:
void AutoResizeColumnHeadersHeight(int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);protected void AutoResizeColumnHeadersHeight (int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);member this.AutoResizeColumnHeadersHeight : int * bool * bool -> unitProtected Sub AutoResizeColumnHeadersHeight (columnIndex As Integer, fixedRowHeadersWidth As Boolean, fixedColumnWidth As Boolean)參數
- columnIndex
- Int32
資料行行首的索引，應該使用該行首的內容來判斷新的高度。
- fixedRowHeadersWidth
- Boolean
true 表示根據目前資料列標頭的寬度來計算新的高度； false 則表示在預期資料列標頭的寬度也將會調整的情況下計算高度。
- fixedColumnWidth
- Boolean
true 表示根據指定資料行的目前寬度來計算新的高度；false 則表示在預期資料行寬度也將會調整的情況下計算高度。
例外狀況
columnIndex 不在 0 到資料行數目減 1 的有效範圍內。
備註
如果您想要控制資料行標頭的大小是否只有指定資料行中標頭的內容因為使用者編輯或變更而變更系結資料來源，這個方法會很有用。 如果內容變更需要，資料行標頭的高度只會調整每個方法呼叫一次;如果稍後資料行標頭的內容有所變更，資料行標頭將不會自動調整。 若要設定資料行標頭在內容變更時自動調整大小，請使用 ColumnHeadersHeightSizeMode 屬性。
若要讓儲存格內容在重設資料行標題大小時換行到多行，儲存格的儲存格樣式必須具有 WrapMode 的屬性值 True 。
此多載受到保護，其設計目的是讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 fixedColumnWidth如果 或 fixedRowHeadersWidth 參數為 false ，則會計算資料行標頭的高度，並預期您將呼叫 方法，例如 AutoResizeColumns 和 AutoResizeRowHeadersWidth 下一個。
如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeColumnHeadersHeight(Boolean, Boolean)
調整資料行行首的高度以適合其內容，並在預期接下來將調整資料行和/或資料列行首寬度的情況下，選擇性地計算高度。
protected:
void AutoResizeColumnHeadersHeight(bool fixedRowHeadersWidth, bool fixedColumnsWidth);protected void AutoResizeColumnHeadersHeight (bool fixedRowHeadersWidth, bool fixedColumnsWidth);member this.AutoResizeColumnHeadersHeight : bool * bool -> unitProtected Sub AutoResizeColumnHeadersHeight (fixedRowHeadersWidth As Boolean, fixedColumnsWidth As Boolean)參數
- fixedRowHeadersWidth
- Boolean
true 表示根據目前資料列標頭的寬度來計算新的高度；false 則表示在預期資料列標頭的寬度也將會調整的情況下計算高度。
- fixedColumnsWidth
- Boolean
true 表示根據目前的資料行寬度來計算新的高度；false 則表示在預期資料行寬度也將會調整的情況下計算高度。
備註
如果您想要控制資料行標頭的大小調整，這個方法會很有用。 每個方法呼叫的資料行標頭高度只會調整一次;如果稍後資料行標頭的內容有所變更，資料行標頭將不會自動調整。 若要設定資料行標頭在內容變更時自動調整大小，請使用 ColumnHeadersHeightSizeMode 屬性。
若要讓儲存格內容在重設資料行標題大小時換行到多行，儲存格的儲存格樣式必須具有 WrapMode 的屬性值 True 。
此多載受到保護，其設計目的是讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 fixedColumnsWidth如果 或 fixedRowHeadersWidth 參數為 false ，則會計算資料行標頭的高度，並預期您將呼叫 方法，例如 AutoResizeColumns 和 AutoResizeRowHeadersWidth 下一個。
如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeColumnHeadersHeight()
調整資料行行首的高度，以適合最大資料行行首的內容。
public:
void AutoResizeColumnHeadersHeight();public void AutoResizeColumnHeadersHeight ();member this.AutoResizeColumnHeadersHeight : unit -> unitPublic Sub AutoResizeColumnHeadersHeight ()範例
下列程式碼範例示範如何根據按鈕點選來調整資料行標頭和資料列的大小。
void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Resize the height of the column headers.
dataGridView1->AutoResizeColumnHeadersHeight();
// Resize all the row heights to fit the contents of all non-header cells.
dataGridView1->AutoResizeRows(
DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void button1_Click(object sender, System.EventArgs e)
{
// Resize the height of the column headers.
dataGridView1.AutoResizeColumnHeadersHeight();
// Resize all the row heights to fit the contents of all non-header cells.
dataGridView1.AutoResizeRows(
DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles button1.Click
' Resize the height of the column headers.
dataGridView1.AutoResizeColumnHeadersHeight()
' Resize all the row heights to fit the contents of all
' non-header cells.
dataGridView1.AutoResizeRows( _
DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)
End Sub
備註
如果您想要控制資料行標頭調整大小時，這個方法很有用。 每個方法呼叫的資料行標頭高度只會調整一次;如果稍後資料行標頭的內容變更，則不會自動調整資料行標頭。 若要設定資料行標頭在內容變更時自動調整大小，請使用 ColumnHeadersHeightSizeMode 屬性。
若要在資料行標頭調整大小時將儲存格內容換行到多行，儲存格的儲存格樣式必須具有 WrapMode 屬性值 True 。
如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeColumnHeadersHeight(Int32)
根據指定資料行中的行首內容之變更來調整資料行行首的高度。
public:
void AutoResizeColumnHeadersHeight(int columnIndex);public void AutoResizeColumnHeadersHeight (int columnIndex);member this.AutoResizeColumnHeadersHeight : int -> unitPublic Sub AutoResizeColumnHeadersHeight (columnIndex As Integer)參數
- columnIndex
- Int32
包含已變更內容的行首之資料行的索引。
例外狀況
columnIndex 不在 0 到資料行數目減 1 的有效範圍內。
備註
如果您想要控制資料行標頭的大小是否只有指定資料行中標頭的內容因為使用者編輯或變更而變更系結資料來源，這個方法會很有用。 如果內容變更需要，資料行標頭的高度只會調整每個方法呼叫一次;如果稍後資料行標頭的內容有所變更，資料行標頭將不會自動調整。 若要設定資料行標頭在內容變更時自動調整大小，請使用 ColumnHeadersHeightSizeMode 屬性。
若要讓儲存格內容在重設資料行標題大小時換行到多行，儲存格的儲存格樣式必須具有 WrapMode 的屬性值 True 。
如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。