DataGridTextBoxColumn Classe
Definição
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.
Cuidado
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 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
[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 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: DataGridTextBoxColumnByte, , DateTime, Decimal, Double, Int16, , Int32, Int64, UInt16, , UInt32, UInt64, , Single, e String.
Observação
Os seguintes tipos não são totalmente compatíveis com o Visual Basic: DateTime, , UInt16, UInt32, e UInt64TimeSpan. (Os operadores não são permitidos.)
Construtores
| Nome | Description |
|---|---|
| DataGridTextBoxColumn() |
Obsoleto.
Inicializa uma nova instância da classe DataGridTextBoxColumn. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Obsoleto.
Inicializa uma nova instância da DataGridTextBoxColumn classe usando a especificada PropertyDescriptor. Especifica se a DataGridTextBoxColumn coluna é padrão. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
Obsoleto.
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) |
Obsoleto.
Inicializa uma nova instância da DataGridTextBoxColumn classe com o PropertyDescriptor formato especificado. |
| DataGridTextBoxColumn(PropertyDescriptor) |
Obsoleto.
Inicializa uma nova instância da DataGridTextBoxColumn classe com uma especificada PropertyDescriptor. |
Propriedades
| Nome | Description |
|---|---|
| Alignment |
Obsoleto.
Obtém ou define o alinhamento do texto em uma 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.
Obtém o DataGridTableStyle para a coluna. (Herdado de DataGridColumnStyle) |
| DesignMode |
Obsoleto.
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
| Events |
Obsoleto.
Obtém a lista de manipuladores de eventos anexados a isso Component. (Herdado de Component) |
| FontHeight |
Obsoleto.
Obtém a altura da fonte da coluna. (Herdado de DataGridColumnStyle) |
| Format |
Obsoleto.
Obtém ou define os caracteres que especificam como o texto é formatado. |
| FormatInfo |
Obsoleto.
Obtém ou define as informações específicas da cultura usadas para determinar como os valores são formatados. |
| HeaderAccessibleObject |
Obsoleto.
Obtém 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 membro de dados para o qual mapear o estilo da coluna. (Herdado de DataGridColumnStyle) |
| NullText |
Obsoleto.
Obtém ou define o texto exibido quando a coluna contém |
| PropertyDescriptor |
Obsoleto.
Obtém ou define o PropertyDescriptor para o DataGridTextBoxColumn. |
| ReadOnly |
Obsoleto.
Define um valor que indica se a coluna da caixa de texto é somente leitura. |
| ReadOnly |
Obsoleto.
Obtém ou define um valor que indica se os dados na coluna podem ser editados. (Herdado de DataGridColumnStyle) |
| Site |
Obsoleto.
Obtém ou define o ISiteComponent. (Herdado de Component) |
| TextBox |
Obsoleto.
Obtém o controle hospedado TextBox . |
| Width |
Obsoleto.
Obtém ou define a largura da coluna. (Herdado de DataGridColumnStyle) |
Métodos
| Nome | Description |
|---|---|
| Abort(Int32) |
Obsoleto.
Inicia uma solicitação 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.
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) |
Obsoleto.
Informa que DataGrid o usuário começou a editar a coluna. (Herdado de DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Obsoleto.
Inicia uma solicitação para concluir um procedimento de edição. |
| ConcedeFocus() |
Obsoleto.
Informa à coluna que o foco está sendo concedido. |
| ConcedeFocus() |
Obsoleto.
Notifica uma coluna de que ela deve abrir mão do foco para o controle que está hospedando. (Herdado de DataGridColumnStyle) |
| CreateHeaderAccessibleObject() |
Obsoleto.
Obtém o AccessibleObject para a coluna. (Herdado de DataGridColumnStyle) |
| CreateObjRef(Type) |
Obsoleto.
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() |
Obsoleto.
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Obsoleto.
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) |
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 Rectangle os parâmetros especificadosCurrencyManager. (Herdado de DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Obsoleto.
Prepara uma célula para edição. (Herdado de DataGridColumnStyle) |
| EndEdit() |
Obsoleto.
Encerra uma operação de edição no DataGridColumnStyle. |
| EndUpdate() |
Obsoleto.
Retoma a pintura de colunas suspensas chamando o BeginUpdate() método. (Herdado de DataGridColumnStyle) |
| EnterNullValue() |
Obsoleto.
Insere um Value na coluna. |
| EnterNullValue() |
Obsoleto.
Insere um 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 do especificado CurrencyManager. (Herdado de DataGridColumnStyle) |
| GetHashCode() |
Obsoleto.
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 tempo de vida para essa instância. (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 colunas. |
| GetPreferredSize(Graphics, Object) |
Obsoleto.
Retorna a largura e a altura ideais da célula em uma linha especificada em relação ao valor especificado. |
| GetService(Type) |
Obsoleto.
Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container. (Herdado de Component) |
| GetType() |
Obsoleto.
Obtém o Type da instância atual. (Herdado de Object) |
| HideEditBox() |
Obsoleto.
Oculta o DataGridTextBox controle e move o foco para o DataGrid controle. |
| InitializeLifetimeService() |
Obsoleto.
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() |
Obsoleto.
Redesenhe a coluna e faz com que uma mensagem de pintura seja enviada ao controle. (Herdado de DataGridColumnStyle) |
| MemberwiseClone() |
Obsoleto.
Cria uma cópia superficial do Objectatual. (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 um DataGridColumnStyle com o número de linha e o alinhamento especificadosRectangleGraphicsCurrencyManager. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Obsoleto.
Pinta um DataGridColumnStyle com a cor especificada Graphics, , Rectangle, CurrencyManagernúmero Brushde linha e primeiro plano. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Obsoleto.
Pinta um DataGridColumnStyle com o número de linha, RectangleCurrencyManagero número da linha, a cor da tela de fundo, a cor do primeiro plano e o alinhamento especificadosGraphics. (Herdado de DataGridColumnStyle) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Obsoleto.
Pinta o a DataGridColumnStyle com o número de linha e o número de linha especificadosRectangleGraphicsCurrencyManager. |
| PaintText(Graphics, Rectangle, String, Boolean) |
Obsoleto.
Desenha o texto e o retângulo no local especificado 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 o alinhamento especificados. |
| ReleaseHostedControl() |
Obsoleto.
Remove a referência que a DataGrid retém no controle usado para editar dados. |
| ReleaseHostedControl() |
Obsoleto.
Permite que a coluna libere recursos quando o controle que ele hospeda não é necessário. (Herdado de DataGridColumnStyle) |
| ResetHeaderText() |
Obsoleto.
Redefine o HeaderText valor |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Obsoleto.
Define o valor em uma linha especificada com o valor de um especificado CurrencyManager. (Herdado de DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Obsoleto.
Define o DataGrid controle ao qual essa coluna pertence. (Herdado de DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Obsoleto.
Adiciona um TextBox controle ao DataGrid controle.Control.ControlCollection |
| SetDataGridInColumn(DataGrid) |
Obsoleto.
Define o DataGrid para a coluna. (Herdado de DataGridColumnStyle) |
| ToString() |
Obsoleto.
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) |
Obsoleto.
Atualiza a interface do usuário. |
| UpdateUI(CurrencyManager, Int32, String) |
Obsoleto.
Atualiza o valor de uma linha especificada com o texto fornecido. (Herdado de DataGridColumnStyle) |
Eventos
| Nome | Description |
|---|---|
| AlignmentChanged |
Obsoleto.
Ocorre quando o valor da Alignment propriedade é alterado. (Herdado de DataGridColumnStyle) |
| Disposed |
Obsoleto.
Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component) |
| FontChanged |
Obsoleto.
Ocorre quando a fonte da coluna é alterada. (Herdado de DataGridColumnStyle) |
| HeaderTextChanged |
Obsoleto.
Ocorre quando o valor da HeaderText propriedade é alterado. (Herdado de DataGridColumnStyle) |
| MappingNameChanged |
Obsoleto.
Ocorre quando o MappingName valor é alterado. (Herdado de DataGridColumnStyle) |
| NullTextChanged |
Obsoleto.
Ocorre quando o NullText valor é alterado. (Herdado de DataGridColumnStyle) |
| PropertyDescriptorChanged |
Obsoleto.
Ocorre quando o valor da PropertyDescriptor propriedade é alterado. (Herdado de DataGridColumnStyle) |
| ReadOnlyChanged |
Obsoleto.
Ocorre quando o valor da ReadOnly propriedade é alterado. (Herdado de DataGridColumnStyle) |
| WidthChanged |
Obsoleto.
Ocorre quando o valor da Width propriedade é alterado. (Herdado de DataGridColumnStyle) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Obsoleto.
Informa o DataGrid controle de que o usuário começou a editar a coluna. (Herdado de DataGridColumnStyle) |