DataGridTextBoxColumn Classe

Definição

Atenção

DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.

Hospeda um TextBox controlo numa célula de a DataGridColumnStyle para editar strings.

public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
Herança
Atributos

Exemplos

O exemplo seguinte cria um DataGridTextBoxColumn e adiciona-o ao GridColumnStylesCollection de um DataGrid. Para executar este exemplo de código, cole-o numa forma que tenha um DataGrid nome dataGrid1 e chame-o a partir 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

Observações

A DataGridTextBoxColumn classe deriva da abstract classe DataGridColumnStyle. Em tempo de execução, o DataGridTextBoxColumn host apresenta um DataGridTextBox controlo que permite aos utilizadores editar texto.

Propriedades especiais adicionadas à classe incluem Format, e HideEditBox. Estas propriedades permitem-lhe aceder ao controlo alojado DataGridTextBox e aos seus atributos, e definir o formato para mostrar valores.

Se a fonte de dados for um DataTable objeto contém DataColumn , a DataType propriedade de deve DataColumn ser definida para um tipo de dado que possa ser editado logicamente num controlo de caixa de texto. Os seguintes tipos de dados estão automaticamente associados a um DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64UInt16UInt32UInt64Single, , e .String

Note

Os seguintes tipos não são totalmente suportados por Visual Basic: DateTime, UInt16, UInt32, UInt64 e TimeSpan. (Operadores não são permitidos.)

Construtores

Name Description
DataGridTextBoxColumn()
Obsoleto.

Inicializa uma nova instância da DataGridTextBoxColumn classe.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)
Obsoleto.

Inicializa uma nova instância da DataGridTextBoxColumn classe usando o especificado PropertyDescriptor. Especifica se é DataGridTextBoxColumn uma coluna padrão.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)
Obsoleto.

Inicializa uma nova instância da DataGridTextBoxColumn classe com um formato especificado PropertyDescriptor e . Especifica se a coluna é a coluna padrão.

DataGridTextBoxColumn(PropertyDescriptor, String)
Obsoleto.

Inicializa uma nova instância da DataGridTextBoxColumn classe com o especificado PropertyDescriptor e formato.

DataGridTextBoxColumn(PropertyDescriptor)
Obsoleto.

Inicializa uma nova instância da DataGridTextBoxColumn classe com um .PropertyDescriptor

Propriedades

Name Description
Alignment
Obsoleto.

Obtém ou define o alinhamento do texto numa coluna.

(Herdado de DataGridColumnStyle)
CanRaiseEvents
Obsoleto.

Obtém um valor que indica se o componente pode gerar um evento.

(Herdado de Component)
Container
Obsoleto.

Obtém o IContainer que contém o Component.

(Herdado de Component)
DataGridTableStyle
Obsoleto.

Recebe o DataGridTableStyle para a coluna.

(Herdado de DataGridColumnStyle)
DesignMode
Obsoleto.

Obtém um valor que indica se o Component está atualmente em modo de design.

(Herdado de Component)
Events
Obsoleto.

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
FontHeight
Obsoleto.

Obtém a altura da fonte da coluna.

(Herdado de DataGridColumnStyle)
Format
Obsoleto.

Obtém ou define o(s) caractere(s) que especificam como o texto é formatado.

FormatInfo
Obsoleto.

Obtém ou define a informação específica da cultura usada para determinar como os valores são formatados.

HeaderAccessibleObject
Obsoleto.

Recebe o AccessibleObject para a coluna.

(Herdado de DataGridColumnStyle)
HeaderText
Obsoleto.

Obtém ou define o texto do cabeçalho da coluna.

(Herdado de DataGridColumnStyle)
MappingName
Obsoleto.

Obtém ou define o nome do elemento de dados para mapear o estilo da coluna.

(Herdado de DataGridColumnStyle)
NullText
Obsoleto.

Obtém ou define o texto que é apresentado quando a coluna contém null.

(Herdado de DataGridColumnStyle)
PropertyDescriptor
Obsoleto.

Obtém ou define para PropertyDescriptor o DataGridTextBoxColumn.

ReadOnly
Obsoleto.

Define um valor que indica se a coluna da caixa de texto é apenas de leitura.

ReadOnly
Obsoleto.

Recebe ou define um valor que indica se os dados na coluna podem ser editados.

(Herdado de DataGridColumnStyle)
Site
Obsoleto.

Obtém ou define o ISite do Component.

(Herdado de Component)
TextBox
Obsoleto.

Fica com o controlo hospedado TextBox .

Width
Obsoleto.

Obtém ou define a largura da coluna.

(Herdado de DataGridColumnStyle)

Métodos

Name Description
Abort(Int32)
Obsoleto.

Inicia um pedido para interromper um procedimento de edição.

BeginUpdate()
Obsoleto.

Suspende a pintura da coluna até que o EndUpdate() método seja chamado.

(Herdado de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)
Obsoleto.

Lança uma exceção se não DataGrid tiver uma fonte de dados válida, ou se esta coluna não estiver mapeada para uma propriedade válida na fonte de dados.

(Herdado de DataGridColumnStyle)
ColumnStartedEditing(Control)
Obsoleto.

Informa DataGrid que o utilizador começou a editar a coluna.

(Herdado de DataGridColumnStyle)
Commit(CurrencyManager, Int32)
Obsoleto.

Inicia um pedido para completar um procedimento de edição.

ConcedeFocus()
Obsoleto.

Informa a coluna que o foco está a ser concedido.

ConcedeFocus()
Obsoleto.

Notifica uma coluna que deve ceder o foco ao controlo que está a hospedar.

(Herdado de DataGridColumnStyle)
CreateHeaderAccessibleObject()
Obsoleto.

Recebe o AccessibleObject para a coluna.

(Herdado de DataGridColumnStyle)
CreateObjRef(Type)
Obsoleto.

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()
Obsoleto.

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)
Obsoleto.

Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos.

(Herdado de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)
Obsoleto.

Prepara uma célula para edição.

Edit(CurrencyManager, Int32, Rectangle, Boolean, String)
Obsoleto.

Prepara a célula para edição usando o número de linha e CurrencyManager parâmetros especificadosRectangle.

(Herdado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean)
Obsoleto.

Prepara uma célula para edição.

(Herdado de DataGridColumnStyle)
EndEdit()
Obsoleto.

Termina uma operação de edição no DataGridColumnStyle.

EndUpdate()
Obsoleto.

Retoma a pintura de colunas suspensas ao chamar o BeginUpdate() método.

(Herdado de DataGridColumnStyle)
EnterNullValue()
Obsoleto.

Entra a Value na coluna.

EnterNullValue()
Obsoleto.

Entra a Value na coluna.

(Herdado de DataGridColumnStyle)
Equals(Object)
Obsoleto.

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetColumnValueAtRow(CurrencyManager, Int32)
Obsoleto.

Obtém o valor na linha especificada a partir do especificado CurrencyManager.

(Herdado de DataGridColumnStyle)
GetHashCode()
Obsoleto.

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetMinimumHeight()
Obsoleto.

Obtém a altura de uma célula em um DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)
Obsoleto.

Obtém a altura a ser usada para redimensionar automaticamente as colunas.

GetPreferredSize(Graphics, Object)
Obsoleto.

Devolve a largura e altura ótimas da célula numa linha especificada em relação ao valor especificado.

GetService(Type)
Obsoleto.

Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.

(Herdado de Component)
GetType()
Obsoleto.

Obtém o Type da instância atual.

(Herdado de Object)
HideEditBox()
Obsoleto.

Esconde o DataGridTextBox controlo e move o foco para o controlo DataGrid .

InitializeLifetimeService()
Obsoleto.

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
Invalidate()
Obsoleto.

Redesenha a coluna e faz com que seja enviada uma mensagem de pintura para o controlo.

(Herdado de DataGridColumnStyle)
MemberwiseClone()
Obsoleto.

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)
Obsoleto.

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)
Obsoleto.

Pinta a DataGridColumnStyle com os especificados Graphics, Rectangle, CurrencyManager, número de linha e alinhamento.

Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)
Obsoleto.

Pinta a DataGridColumnStyle com as especificadas Graphics, Rectangle, CurrencyManager, número de linha, Brush, e cor em primeiro plano.

Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)
Obsoleto.

Pinta a DataGridColumnStyle com o especificado Graphics, Rectangle, CurrencyManager, número de linha, cor de fundo, cor do primeiro plano e alinhamento.

(Herdado de DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32)
Obsoleto.

Pinta o a DataGridColumnStyle com o número especificado Graphics, Rectangle, CurrencyManager, e de linha.

PaintText(Graphics, Rectangle, String, Boolean)
Obsoleto.

Desenha o texto e o retângulo na localização indicada com o alinhamento especificado.

PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)
Obsoleto.

Desenha o texto e o retângulo no local especificado com as cores e alinhamento especificados.

ReleaseHostedControl()
Obsoleto.

Remove a referência que o DataGrid detém ao controlo usado para editar dados.

ReleaseHostedControl()
Obsoleto.

Permite à coluna libertar recursos quando o controlo que aloja não é necessário.

(Herdado de DataGridColumnStyle)
ResetHeaderText()
Obsoleto.

Reinicia o HeaderText para o seu valor padrão, null.

(Herdado de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)
Obsoleto.

Define o valor numa linha especificada com o valor de um determinado CurrencyManager.

(Herdado de DataGridColumnStyle)
SetDataGrid(DataGrid)
Obsoleto.

Define o DataGrid controlo a que esta coluna pertence.

(Herdado de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)
Obsoleto.

Adiciona um TextBox controlo ao DataGridControl.ControlCollection.

SetDataGridInColumn(DataGrid)
Obsoleto.

Define para DataGrid a coluna.

(Herdado de DataGridColumnStyle)
ToString()
Obsoleto.

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)
UpdateUI(CurrencyManager, Int32, String)
Obsoleto.

Atualiza a interface do utilizador.

UpdateUI(CurrencyManager, Int32, String)
Obsoleto.

Atualiza o valor de uma linha especificada com o texto indicado.

(Herdado de DataGridColumnStyle)

evento

Name Description
AlignmentChanged
Obsoleto.

Ocorre quando o valor da Alignment propriedade muda.

(Herdado de DataGridColumnStyle)
Disposed
Obsoleto.

Ocorre quando o componente é eliminado por uma chamada ao Dispose() método.

(Herdado de Component)
FontChanged
Obsoleto.

Ocorre quando a fonte da coluna muda.

(Herdado de DataGridColumnStyle)
HeaderTextChanged
Obsoleto.

Ocorre quando o valor da HeaderText propriedade muda.

(Herdado de DataGridColumnStyle)
MappingNameChanged
Obsoleto.

Ocorre quando o MappingName valor muda.

(Herdado de DataGridColumnStyle)
NullTextChanged
Obsoleto.

Ocorre quando o NullText valor muda.

(Herdado de DataGridColumnStyle)
PropertyDescriptorChanged
Obsoleto.

Ocorre quando o valor da PropertyDescriptor propriedade muda.

(Herdado de DataGridColumnStyle)
ReadOnlyChanged
Obsoleto.

Ocorre quando o valor da ReadOnly propriedade muda.

(Herdado de DataGridColumnStyle)
WidthChanged
Obsoleto.

Ocorre quando o valor da Width propriedade muda.

(Herdado de DataGridColumnStyle)

Implementações de Interface Explícita

Name Description
IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)
Obsoleto.

Informa o DataGrid controlo que o utilizador começou a editar a coluna.

(Herdado de DataGridColumnStyle)

Aplica-se a

Ver também