DataGridTextBoxColumn Classe

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 TextBox controle em uma célula de uma DataGridColumnStyle cadeia de caracteres de edição.

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 adiciona-o GridColumnStylesCollection ao de um DataGrid. Para executar este 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, os DataGridTextBoxColumn hosts hospedam um DataGridTextBox controle que permite aos usuários editar 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 deve ser definida como um tipo de DataColumn dados que pode 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, , Single, e String.

Note

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

Construtores

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

Propriedades

Nome	Description
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 gerar um evento. (Herdado de Component)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DataGridTableStyle	Obtém o DataGridTableStyle para a 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 anexados a isso 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 para a coluna. (Herdado de DataGridColumnStyle)
HeaderText	Obtém ou define o texto 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 exibido quando a coluna contém `null`. (Herdado de DataGridColumnStyle)
PropertyDescriptor	Obtém ou define o PropertyDescriptor para o 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 hospedado TextBox .
Width	Obtém ou define a largura da coluna. (Herdado de DataGridColumnStyle)

Métodos

Nome	Description
Abort(Int32)	Inicia uma solicitação para interromper um procedimento de edição.
BeginUpdate()	Suspende a pintura da coluna até que o EndUpdate() método seja chamado. (Herdado de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Gerará uma exceção se a DataGrid fonte de dados não tiver uma fonte de dados válida ou se essa coluna não for mapeada para uma propriedade válida na fonte de dados. (Herdado de DataGridColumnStyle)
ColumnStartedEditing(Control)	Informa que DataGrid 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 à coluna que o foco está sendo concedido.
CreateHeaderAccessibleObject()	Obtém o AccessibleObject para a 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, String, Boolean)	Prepara uma célula para edição.
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Prepara a célula para edição usando o número de linha e CurrencyManager os parâmetros especificadosRectangle. (Herdado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Prepara uma célula para edição. (Herdado de DataGridColumnStyle)
EndEdit()	Encerra uma operação de edição no DataGridColumnStyle.
EndUpdate()	Retoma a pintura de colunas suspensas chamando o BeginUpdate() método. (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 especificado CurrencyManager. (Herdado de DataGridColumnStyle)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa 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 colunas.
GetPreferredSize(Graphics, Object)	Retorna a largura e a altura ideais da célula em uma linha especificada em relação ao valor especificado.
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HideEditBox()	Oculta o DataGridTextBox controle e move o foco para o DataGrid controle.
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject)
Invalidate()	Redesenhe a coluna e faz com que uma mensagem de pintura seja enviada ao controle. (Herdado de DataGridColumnStyle)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Pinta um DataGridColumnStyle com o número de linha e o alinhamento especificadosGraphics Rectangle CurrencyManager.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Pinta um DataGridColumnStyle com a cor especificada Graphics, , Rectangle, CurrencyManagernúmero Brushde linha e primeiro plano.
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Pinta o a DataGridColumnStyle com o número de linha e o número de linha especificadosGraphics Rectangle CurrencyManager.
PaintText(Graphics, Rectangle, String, Boolean)	Desenha o texto e o retângulo no local especificado 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 especificados.
ReleaseHostedControl()	Remove a referência que a DataGrid retém no controle usado para editar dados.
ResetHeaderText()	Redefine o HeaderText valor `null`padrão. (Herdado de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Define o valor em uma linha especificada com o valor de um especificado CurrencyManager. (Herdado de DataGridColumnStyle)
SetDataGrid(DataGrid)	Define o DataGrid controle ao qual essa coluna pertence. (Herdado de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Adiciona um TextBox controle ao DataGrid controle.Control.ControlCollection
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

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

Implantações explícitas de interface

Nome	Description
IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)	Informa o DataGrid controle de que o usuário começou a editar a coluna. (Herdado de DataGridColumnStyle)

Aplica-se a

Confira também

Comentários

Esta página foi útil?