DataGridViewColumn.GetPreferredWidth Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Calcula a largura ideal da coluna com base nos critérios especificados.

public:
 virtual int GetPreferredWidth(System::Windows::Forms::DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);

public virtual int GetPreferredWidth (System.Windows.Forms.DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);

abstract member GetPreferredWidth : System.Windows.Forms.DataGridViewAutoSizeColumnMode * bool -> int
override this.GetPreferredWidth : System.Windows.Forms.DataGridViewAutoSizeColumnMode * bool -> int

Public Overridable Function GetPreferredWidth (autoSizeColumnMode As DataGridViewAutoSizeColumnMode, fixedHeight As Boolean) As Integer

Parâmetros

autoSizeColumnMode: DataGridViewAutoSizeColumnMode

Um valor DataGridViewAutoSizeColumnMode que especifica um modo de dimensionamento automático.

fixedHeight: Boolean

true para calcular a largura da colina com base nas alturas de linha; false para calcular a largura com a expectativa de que as alturas de linha serão ajustadas.

Retornos

Int32

A largura ideal da coluna em pixels.

Exceções

ArgumentException

autoSizeColumnMode é NotSet, None ou Fill.

InvalidEnumArgumentException

autoSizeColumnMode não é um valor DataGridViewAutoSizeColumnMode válido.

Comentários

Essa propriedade é usada pelo recurso de dimensionamento automático baseado em conteúdo do DataGridView controle para determinar a largura ideal de uma coluna.

Um fixedHeight valor de parâmetro calcula a largura da false coluna com base em alturas de linha calculadas que alcançarão as taxas ideais de altura para largura da célula. Para que o conteúdo da célula seja encapsulado em várias linhas, o estilo de célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

Para obter mais informações sobre o dimensionamento automático, consulte Opções de dimensionamento no controle Windows Forms DataGridView.

Aplica-se a