DataGridView.AutoResizeRowHeadersWidth Metoda

Definicja

Dostosowuje szerokość nagłówków wierszy w celu dopasowania do zawartości nagłówka.Adjusts the width of the row headers to fit the header contents.

Przeciążenia

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Dostosowuje szerokość nagłówków wierszy przy użyciu trybu określonego rozmiaru.Adjusts the width of the row headers using the specified size mode.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Dostosowuje szerokość nagłówków wierszy na podstawie zmian w zawartości nagłówka w określonym wierszu i przy użyciu trybu określonego rozmiaru.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Dostosowuje szerokość nagłówków wierszy przy użyciu określonego trybu rozmiaru, opcjonalnie obliczając szerokość przy zawieszeniu, że szerokość nagłówka wiersza i/lub kolumny zostanie następnie dopasowana.Adjusts the width of the row headers using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Dostosowuje szerokość nagłówków wierszy na podstawie zmian w zawartości nagłówka w określonym wierszu i przy użyciu określonego trybu rozmiaru, opcjonalnie obliczając szerokość przy założeniu, że szerokość nagłówka wiersza i/lub kolumny zostaną następnie dopasowane.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Dostosowuje szerokość nagłówków wierszy przy użyciu trybu określonego rozmiaru.Adjusts the width of the row headers using the specified size mode.

public:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parametry

Wyjątki

rowHeadersWidthSizeMode ma wartość EnableResizing lub DisableResizing .rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode nie jest prawidłową DataGridViewRowHeadersWidthSizeMode wartością.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować czas, w którym nagłówki wierszy są zmieniane.This method is useful if you want to control when the row headers resize. Szerokość nagłówków wierszy jest dostosowywana tylko raz dla wywołania metody; Jeśli zawartość nagłówków wierszy zostanie zmieniona później, nagłówki wierszy nie będą dostosowywane automatycznie.The width of the row headers is adjusted only once per method call; if the contents of the row headers later change, the row headers will not automatically adjust. Aby ustawić automatyczne zmienianie rozmiaru nagłówków wierszy w przypadku zmiany zawartości, użyj RowHeadersWidthSizeMode właściwości.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Ta metoda pozwala określić tryb ustalania rozmiarów, który oblicza nową szerokość na podstawie wartości w ograniczonym zestawie nagłówków, takich jak te w wyświetlanych wierszach.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.This improves performance when the control contains a large number of rows.

Aby uzyskać więcej informacji na temat zmiany rozmiarów, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Dotyczy

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Dostosowuje szerokość nagłówków wierszy na podstawie zmian w zawartości nagłówka w określonym wierszu i przy użyciu trybu określonego rozmiaru.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode.

public:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parametry

rowIndex
Int32

Indeks nagłówka wiersza z zmienioną zawartością.The index of the row header with the changed content.

Wyjątki

rowIndex nie jest w prawidłowym zakresie od 0 do liczby wierszy pomniejszonych o 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

rowHeadersWidthSizeMode ma wartość EnableResizing lub DisableResizingrowHeadersWidthSizeMode has the value EnableResizing or DisableResizing

rowHeadersWidthSizeMode nie jest prawidłową DataGridViewRowHeadersWidthSizeMode wartością.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Przykłady

Poniższy przykład kodu ilustruje sposób zmiany szerokości nagłówka wiersza w oparciu o zmiany zawartości pierwszego nagłówka wiersza.The following code example illustrates how to resize the row header widths based on changes to the contents of the first row header. Ten przykład kodu jest częścią większego przykładu przedstawionego w instrukcje: programowe Zmienianie rozmiaru komórek w celu dopasowania do zawartości w kontrolce DataGridView Windows Forms.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}


private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRowHeadersWidth(
        0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    DataGridView1.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)

End Sub

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy nagłówki wierszy są zmieniane, jeśli tylko zawartość nagłówka w określonym wierszu zmieniła się w wyniku modyfikacji użytkownika lub zmian w powiązanym źródle danych.This method is useful if you want to control when the row headers resize if only the contents of the header in the specified row have changed as a result of user edits or changes to a bound data source. Szerokość nagłówków wierszy jest dostosowywana tylko raz dla każdego wywołania metody, jeśli wymaga tego zmiana zawartości; Jeśli zawartość nagłówków wierszy zostanie zmieniona później, nagłówki wierszy nie będą dostosowywane automatycznie.The width of the row headers is adjusted only once per method call if the content change requires it; if the contents of the row headers later change, the row headers will not automatically adjust. Aby ustawić automatyczne zmienianie rozmiaru nagłówków wierszy w przypadku zmiany zawartości, użyj RowHeadersWidthSizeMode właściwości.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Ta metoda pozwala określić tryb ustalania rozmiarów, który oblicza nową szerokość na podstawie wartości w ograniczonym zestawie nagłówków, takich jak te w wyświetlanych wierszach.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.This improves performance when the control contains a large number of rows.

Aby uzyskać więcej informacji na temat zmiany rozmiarów, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Dotyczy

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Dostosowuje szerokość nagłówków wierszy przy użyciu określonego trybu rozmiaru, opcjonalnie obliczając szerokość przy zawieszeniu, że szerokość nagłówka wiersza i/lub kolumny zostanie następnie dopasowana.Adjusts the width of the row headers using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

protected:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)

Parametry

fixedColumnHeadersHeight
Boolean

true Aby obliczyć nową szerokość na podstawie bieżącej wysokości nagłówków kolumn; false Aby obliczyć szerokość przy zawieszeniu, że wysokość nagłówków kolumn również zostanie dopasowana.true to calculate the new width based on the current height of the column headers; false to calculate the width with the expectation that the height of the column headers will also be adjusted.

fixedRowsHeight
Boolean

true Aby obliczyć nową szerokość na podstawie wysokości bieżącego wiersza; false Aby obliczyć szerokość przy zawieszeniu, że wysokość wiersza również zostanie dopasowana.true to calculate the new width based on the current row heights; false to calculate the width with the expectation that the row heights will also be adjusted.

Wyjątki

rowHeadersWidthSizeMode ma wartość EnableResizing lub DisableResizing .rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode nie jest prawidłową DataGridViewRowHeadersWidthSizeMode wartością.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować czas, w którym nagłówki wierszy są zmieniane.This method is useful if you want to control when the row headers resize. Szerokość nagłówków wierszy jest dostosowywana tylko raz dla wywołania metody; Jeśli zawartość nagłówków wierszy zostanie zmieniona później, nagłówki wierszy nie będą dostosowywane automatycznie.The width of the row headers is adjusted only once per method call; if the contents of the row headers later change, the row headers will not automatically adjust. Aby ustawić automatyczne zmienianie rozmiaru nagłówków wierszy w przypadku zmiany zawartości, użyj RowHeadersWidthSizeMode właściwości.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Ta metoda pozwala określić tryb ustalania rozmiarów, który oblicza nową szerokość na podstawie wartości w ograniczonym zestawie nagłówków, takich jak te w wyświetlanych wierszach.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.This improves performance when the control contains a large number of rows.

To przeciążenie jest chronione i ma na celu umożliwienie osiągnięcia idealnego współczynnika wysokości komórek w DataGridView klasie pochodnej.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Jeśli fixedColumnHeadersHeight parametr lub fixedRowsHeight ma wartość false , Szerokość nagłówków wierszy będzie obliczana z oczekiwaniami, które będą wywoływały metody, takie jak AutoResizeRows i AutoResizeColumnHeadersHeight Next.If the fixedColumnHeadersHeight or fixedRowsHeight parameters are false, the width of the row headers will be calculated with the expectation that you will call methods such as AutoResizeRows and AutoResizeColumnHeadersHeight next.

Aby uzyskać więcej informacji na temat zmiany rozmiarów, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Dotyczy

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Dostosowuje szerokość nagłówków wierszy na podstawie zmian w zawartości nagłówka w określonym wierszu i przy użyciu określonego trybu rozmiaru, opcjonalnie obliczając szerokość przy założeniu, że szerokość nagłówka wiersza i/lub kolumny zostaną następnie dopasowane.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

protected:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)

Parametry

rowIndex
Int32

Indeks wiersza zawierający nagłówek z zmienioną zawartością.The index of the row containing the header with the changed content.

fixedColumnHeadersHeight
Boolean

true Aby obliczyć nową szerokość na podstawie bieżącej wysokości nagłówków kolumn; false Aby obliczyć szerokość przy zawieszeniu, że wysokość nagłówków kolumn również zostanie dopasowana.true to calculate the new width based on the current height of the column headers; false to calculate the width with the expectation that the height of the column headers will also be adjusted.

fixedRowHeight
Boolean

true Aby obliczyć nową szerokość na podstawie bieżącej wysokości określonego wiersza; false Aby obliczyć szerokość przy zawieszeniu, że wysokość wiersza również zostanie dopasowana.true to calculate the new width based on the current height of the specified row; false to calculate the width with the expectation that the row height will also be adjusted.

Wyjątki

rowIndex nie jest w prawidłowym zakresie od 0 do liczby wierszy pomniejszonych o 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

rowHeadersWidthSizeMode ma wartość EnableResizing lub DisableResizing .rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode nie jest prawidłową DataGridViewRowHeadersWidthSizeMode wartością.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Uwagi

Ta metoda jest przydatna, jeśli chcesz kontrolować, kiedy nagłówki wierszy są zmieniane, jeśli tylko zawartość nagłówka w określonym wierszu zmieniła się w wyniku modyfikacji użytkownika lub zmian w powiązanym źródle danych.This method is useful if you want to control when the row headers resize if only the contents of the header in the specified row have changed as a result of user edits or changes to a bound data source. Szerokość nagłówków wierszy jest dostosowywana tylko raz dla każdego wywołania metody, jeśli wymaga tego zmiana zawartości; Jeśli zawartość nagłówków wierszy zostanie zmieniona później, nagłówki wierszy nie będą dostosowywane automatycznie.The width of the row headers is adjusted only once per method call if the content change requires it; if the contents of the row headers later change, the row headers will not automatically adjust. Aby ustawić automatyczne zmienianie rozmiaru nagłówków wierszy w przypadku zmiany zawartości, użyj RowHeadersWidthSizeMode właściwości.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Ta metoda pozwala określić tryb ustalania rozmiarów, który oblicza nową szerokość na podstawie wartości w ograniczonym zestawie nagłówków, takich jak te w wyświetlanych wierszach.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Poprawia to wydajność, gdy kontrolka zawiera dużą liczbę wierszy.This improves performance when the control contains a large number of rows.

To przeciążenie jest chronione i ma na celu umożliwienie osiągnięcia idealnego współczynnika wysokości komórek w DataGridView klasie pochodnej.This overload is protected, and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Jeśli fixedColumnHeadersHeight parametr lub fixedRowHeight ma wartość false , Szerokość nagłówków wierszy będzie obliczana z oczekiwaniami, które będą wywoływały metody, takie jak AutoResizeRows i AutoResizeColumnHeadersHeight Next.If the fixedColumnHeadersHeight or fixedRowHeight parameters are false, the width of the row headers will be calculated with the expectation that you will call methods such as AutoResizeRows and AutoResizeColumnHeadersHeight next.

Aby uzyskać więcej informacji na temat zmiany rozmiarów, zobacz Opcje ustalania rozmiarów w kontrolce DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Dotyczy