DataGridTextBoxColumn Classe

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.

Hospeda um controle TextBox em uma célula de um DataGridColumnStyle para edição de cadeias de caracteres.

public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle

public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle

type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle

Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle

Herança: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Exemplos

O exemplo a seguir cria um DataGridTextBoxColumn e o adiciona ao GridColumnStylesCollection de um DataGrid. Para executar esse exemplo de código, cole-o em um formulário que tenha um DataGrid nome dataGrid1 e chame-o do construtor do Form.

private:
   void AddColumn()
   {
      DataTable^ myTable = gcnew DataTable;
      
      // Add a new DataColumn to the DataTable.
      DataColumn^ myColumn = gcnew DataColumn( "myTextBoxColumn" );
      myColumn->DataType = System::Type::GetType( "System::String" );
      myColumn->DefaultValue = "default string";
      myTable->Columns->Add( myColumn );
      
      // Get the CurrencyManager for the DataTable.
      CurrencyManager^ cm = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
      
      // Use the CurrencyManager to get the PropertyDescriptor for the new column.
      System::ComponentModel::PropertyDescriptor^ pd = cm->GetItemProperties()[ "myTextBoxColumn" ];
      DataGridTextBoxColumn^ myColumnTextColumn;
      
      // Create the DataGridTextBoxColumn with the PropertyDescriptor.
      myColumnTextColumn = gcnew DataGridTextBoxColumn( pd );
      
      // Add the new DataGridColumn to the GridColumnsCollection.
      dataGrid1->DataSource = myTable;
      dataGrid1->TableStyles->Add( gcnew DataGridTableStyle );
      dataGrid1->TableStyles[ 0 ]->GridColumnStyles->Add( myColumnTextColumn );
   }

private void AddColumn()
{
     DataTable myTable= new DataTable();
 
     // Add a new DataColumn to the DataTable.
     DataColumn myColumn = new DataColumn("myTextBoxColumn");
     myColumn.DataType = System.Type.GetType("System.String");
     myColumn.DefaultValue="default string";
     myTable.Columns.Add(myColumn);
     // Get the CurrencyManager for the DataTable.
     CurrencyManager cm = (CurrencyManager)this.BindingContext[myTable];
     // Use the CurrencyManager to get the PropertyDescriptor for the new column.
     PropertyDescriptor pd = cm.GetItemProperties()["myTextBoxColumn"];
     DataGridTextBoxColumn myColumnTextColumn;
     // Create the DataGridTextBoxColumn with the PropertyDescriptor.
     myColumnTextColumn = new DataGridTextBoxColumn(pd);
     // Add the new DataGridColumn to the GridColumnsCollection.
     dataGrid1.DataSource= myTable;
     dataGrid1.TableStyles.Add(new DataGridTableStyle());
     dataGrid1.TableStyles[0].GridColumnStyles.Add(myColumnTextColumn);
 }

Private Sub AddColumn()
    Dim myTable As New DataTable()
    
    ' Add a new DataColumn to the DataTable.
    Dim myColumn As New DataColumn("myTextBoxColumn")
    myColumn.DataType = System.Type.GetType("System.String")
    myColumn.DefaultValue = "default string"
    myTable.Columns.Add(myColumn)
    ' Get the CurrencyManager for the DataTable.
    Dim cm As CurrencyManager = CType(Me.BindingContext(myTable), CurrencyManager)
    ' Use the CurrencyManager to get the PropertyDescriptor for the new column.
    Dim pd As PropertyDescriptor = cm.GetItemProperties()("myTextBoxColumn")
    Dim myColumnTextColumn As DataGridTextBoxColumn
    ' Create the DataGridTextBoxColumn with the PropertyDescriptor.
    myColumnTextColumn = New DataGridTextBoxColumn(pd)
    ' Add the new DataGridColumn to the GridColumnsCollection.
    dataGrid1.DataSource = myTable
    dataGrid1.TableStyles.Add(New DataGridTableStyle())
    dataGrid1.TableStyles(0).GridColumnStyles.Add(myColumnTextColumn)
End Sub

Comentários

A DataGridTextBoxColumn classe deriva da abstract classe DataGridColumnStyle. Em tempo de execução, o DataGridTextBoxColumn hospeda um DataGridTextBox controle que permite que os usuários editem texto.

As propriedades especiais adicionadas à classe incluem Formate HideEditBox. Essas propriedades permitem que você acesse o controle hospedado DataGridTextBox e seus atributos e defina o formato para exibir valores.

Se a fonte de dados for um DataTable objeto que DataColumn contém, a DataType propriedade do deverá ser definida como um tipo de DataColumn dados que possa ser editado logicamente em um controle de caixa de texto. Os seguintes tipos de dados são automaticamente associados a : DataGridTextBoxColumn Byte, DateTime, Decimal, Double, Int16, Int32, Int64, UInt16, , UInt32, UInt64, Singlee String.

Observação

Os seguintes tipos não são totalmente compatíveis com o Visual Basic: DateTime, UInt16, UInt32, , UInt64e TimeSpan. (Operadores não são permitidos.)

Construtores

DataGridTextBoxColumn()	Inicializa uma nova instância da classe DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor)	Inicializa uma nova instância da DataGridTextBoxColumn classe com um especificado PropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Inicializa uma nova instância da classe DataGridTextBoxColumn usando o PropertyDescriptor especificado. Especifica se o DataGridTextBoxColumn é uma coluna padrão.
DataGridTextBoxColumn(PropertyDescriptor, String)	Inicializa uma nova instância da DataGridTextBoxColumn classe com o formato e especificados PropertyDescriptor .
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Inicializa uma nova instância da classe DataGridTextBoxColumn com um PropertyDescriptor e formato especificados. Especifica se a coluna é a coluna padrão.

Propriedades

Alignment	Obtém ou define o alinhamento do texto em uma coluna. (Herdado de DataGridColumnStyle)
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DataGridTableStyle	Obtém o DataGridTableStyle da coluna. (Herdado de DataGridColumnStyle)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
FontHeight	Obtém a altura da fonte da coluna. (Herdado de DataGridColumnStyle)
Format	Obtém ou define os caracteres que especificam como o texto é formatado.
FormatInfo	Obtém ou define as informações específicas da cultura usadas para determinar como os valores são formatados.
HeaderAccessibleObject	Obtém o AccessibleObject da coluna. (Herdado de DataGridColumnStyle)
HeaderText	Obtém ou define o contexto do cabeçalho da coluna. (Herdado de DataGridColumnStyle)
MappingName	Obtém ou define o nome do membro de dados para o qual mapear o estilo da coluna. (Herdado de DataGridColumnStyle)
NullText	Obtém ou define o texto que é exibido quando a coluna contém `null`. (Herdado de DataGridColumnStyle)
PropertyDescriptor	Obtém ou define o PropertyDescriptor do DataGridTextBoxColumn.
ReadOnly	Define um valor que indica se a coluna da caixa de texto é somente leitura.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
TextBox	Obtém o controle TextBox hospedado.
Width	Obtém ou define a largura da coluna. (Herdado de DataGridColumnStyle)

Métodos

Abort(Int32)	Inicia uma solicitação para interromper um procedimento de edição.
BeginUpdate()	Suspende a pintura da coluna até que o método EndUpdate() seja chamado. (Herdado de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Gera uma exceção se o DataGrid não tem uma fonte de dados válido ou se essa coluna não está mapeada para uma propriedade válida na fonte de dados. (Herdado de DataGridColumnStyle)
ColumnStartedEditing(Control)	Informa ao DataGrid que o usuário começou a editar a coluna. (Herdado de DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Inicia uma solicitação para concluir um procedimento de edição.
ConcedeFocus()	Informa a coluna de que o foco está sendo concedido.
CreateHeaderAccessibleObject()	Obtém o AccessibleObject da coluna. (Herdado de DataGridColumnStyle)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Prepara uma célula para edição. (Herdado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Prepara a célula para edição usando o CurrencyManager, o número da linha e os parâmetros Rectangle especificados. (Herdado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Prepara uma célula para edição.
EndEdit()	Encerra a operação de edição no DataGridColumnStyle.
EndUpdate()	Retoma a pintura de colunas suspensa chamando o método BeginUpdate(). (Herdado de DataGridColumnStyle)
EnterNullValue()	Insere um Value na coluna.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Obtém o valor na linha especificada do CurrencyManager especificado. (Herdado de DataGridColumnStyle)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetMinimumHeight()	Obtém a altura de uma célula em um DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Obtém a altura a ser usada para redimensionar automaticamente as colunas.
GetPreferredSize(Graphics, Object)	Retorna a largura e a altura ideal da célula em uma linha especificada em relação ao valor indicado.
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HideEditBox()	Oculta o controle DataGridTextBox e move o foco para o controle DataGrid.
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Invalidate()	Redesenha a coluna e faz com que uma mensagem de pintura seja enviada para o controle. (Herdado de DataGridColumnStyle)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Pinta o DataGridColumnStyle com o Graphics, Rectangle, CurrencyManager e o número de linha especificados.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Pinta um DataGridColumnStyle com o Graphics, Rectangle, CurrencyManager, número de linha e alinhamento especificados.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Pinta um DataGridColumnStyle com o Graphics, Rectangle, CurrencyManager, número de linha, Brush e cor de primeiro plano especificados.
PaintText(Graphics, Rectangle, String, Boolean)	Desenha o texto e o retângulo no local fornecido com o alinhamento especificado.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Desenha o texto e o retângulo no local especificado com as cores e o alinhamento indicados.
ReleaseHostedControl()	Remove a referência que o DataGrid mantém no controle usado para editar os dados.
ResetHeaderText()	Redefine o HeaderText para seu valor padrão, `null`. (Herdado de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Define o valor em uma linha especificada com o valor de um CurrencyManager especificado. (Herdado de DataGridColumnStyle)
SetDataGrid(DataGrid)	Define o controle DataGrid ao qual esta coluna pertence. (Herdado de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Adiciona um controle TextBox ao Control.ControlCollection do controle DataGrid.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)
UpdateUI(CurrencyManager, Int32, String)	Atualiza a interface do usuário.

Eventos

AlignmentChanged	Ocorre quando o valor da propriedade Alignment muda. (Herdado de DataGridColumnStyle)
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
FontChanged	Ocorre quando a fonte da coluna é alterada. (Herdado de DataGridColumnStyle)
HeaderTextChanged	Ocorre quando o valor da propriedade HeaderText muda. (Herdado de DataGridColumnStyle)
MappingNameChanged	Ocorre quando o valor MappingName é alterado. (Herdado de DataGridColumnStyle)
NullTextChanged	Ocorre quando o valor NullText é alterado. (Herdado de DataGridColumnStyle)
PropertyDescriptorChanged	Ocorre quando o valor da propriedade PropertyDescriptor muda. (Herdado de DataGridColumnStyle)
ReadOnlyChanged	Ocorre quando o valor da propriedade ReadOnly muda. (Herdado de DataGridColumnStyle)
WidthChanged	Ocorre quando o valor da propriedade Width muda. (Herdado de DataGridColumnStyle)

Implantações explícitas de interface

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Informa ao controle DataGrid que o usuário começou a editar a coluna.

(Herdado de DataGridColumnStyle)

Aplica-se a

Partilhar via