Compartilhar via


DataGridViewColumn.GetPreferredWidth Método

Definição

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

autoSizeColumnMode é NotSet, None ou Fill.

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

Confira também