DataGridTextBoxColumn Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
type DataGridTextBoxColumn = class
inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
- Herança
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, Int64UInt16UInt64UInt32Single, , 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() |
Inicializa uma nova instância da DataGridTextBoxColumn classe. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Inicializa uma nova instância da DataGridTextBoxColumn classe usando o especificado PropertyDescriptor. Especifica se é DataGridTextBoxColumn uma coluna padrão. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
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) |
Inicializa uma nova instância da DataGridTextBoxColumn classe com o especificado PropertyDescriptor e formato. |
| DataGridTextBoxColumn(PropertyDescriptor) |
Inicializa uma nova instância da DataGridTextBoxColumn classe com um .PropertyDescriptor |
Propriedades
| Name | Description |
|---|---|
| Alignment |
Obtém ou define o alinhamento do texto numa 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 |
Recebe o DataGridTableStyle para a coluna. (Herdado de DataGridColumnStyle) |
| DesignMode |
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| FontHeight |
Obtém a altura da fonte da coluna. (Herdado de DataGridColumnStyle) |
| Format |
Obtém ou define o(s) caractere(s) que especificam como o texto é formatado. |
| FormatInfo |
Obtém ou define a informação específica da cultura usada para determinar como os valores são formatados. |
| HeaderAccessibleObject |
Recebe 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 elemento de dados para mapear o estilo da coluna. (Herdado de DataGridColumnStyle) |
| NullText |
Obtém ou define o texto que é apresentado quando a coluna contém |
| PropertyDescriptor |
Obtém ou define para PropertyDescriptor o DataGridTextBoxColumn. |
| ReadOnly |
Define um valor que indica se a coluna da caixa de texto é apenas de leitura. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| TextBox |
Fica com o controlo hospedado TextBox . |
| Width |
Obtém ou define a largura da coluna. (Herdado de DataGridColumnStyle) |
Métodos
| Name | Description |
|---|---|
| Abort(Int32) |
Inicia um pedido 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) |
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) |
Informa DataGrid que o utilizador começou a editar a coluna. (Herdado de DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Inicia um pedido para completar um procedimento de edição. |
| ConcedeFocus() |
Informa a coluna que o foco está a ser concedido. |
| CreateHeaderAccessibleObject() |
Recebe o AccessibleObject para a coluna. (Herdado de DataGridColumnStyle) |
| CreateObjRef(Type) |
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() |
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
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) |
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 Rectangle parâmetros especificadosCurrencyManager. (Herdado de DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Prepara uma célula para edição. (Herdado de DataGridColumnStyle) |
| EndEdit() |
Termina uma operação de edição no DataGridColumnStyle. |
| EndUpdate() |
Retoma a pintura de colunas suspensas ao chamar o BeginUpdate() método. (Herdado de DataGridColumnStyle) |
| EnterNullValue() |
Entra a 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 a partir do especificado CurrencyManager. (Herdado de DataGridColumnStyle) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
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() |
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) |
Devolve a largura e altura ótimas da célula numa linha especificada em relação ao valor especificado. |
| GetService(Type) |
Devolve 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() |
Esconde o DataGridTextBox controlo e move o foco para o controlo DataGrid . |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| Invalidate() |
Redesenha a coluna e faz com que seja enviada uma mensagem de pintura para o controlo. (Herdado de DataGridColumnStyle) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean) |
Pinta a DataGridColumnStyle com os especificados Graphics, Rectangle, CurrencyManager, número de linha e alinhamento. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Pinta a DataGridColumnStyle com as especificadas Graphics, Rectangle, CurrencyManager, número de linha, Brush, e cor em primeiro plano. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Pinta o a DataGridColumnStyle com o número especificado Graphics, Rectangle, CurrencyManager, e de linha. |
| PaintText(Graphics, Rectangle, String, Boolean) |
Desenha o texto e o retângulo na localização indicada 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 alinhamento especificados. |
| ReleaseHostedControl() |
Remove a referência que o DataGrid detém ao controlo usado para editar dados. |
| ResetHeaderText() |
Reinicia o HeaderText para o seu valor padrão, |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Define o valor numa linha especificada com o valor de um determinado CurrencyManager. (Herdado de DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Define o DataGrid controlo a que esta coluna pertence. (Herdado de DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Adiciona um TextBox controlo ao DataGridControl.ControlCollection. |
| ToString() |
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) |
Atualiza a interface do utilizador. |
evento
| Name | Description |
|---|---|
| AlignmentChanged |
Ocorre quando o valor da Alignment propriedade muda. (Herdado de DataGridColumnStyle) |
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |
| FontChanged |
Ocorre quando a fonte da coluna muda. (Herdado de DataGridColumnStyle) |
| HeaderTextChanged |
Ocorre quando o valor da HeaderText propriedade muda. (Herdado de DataGridColumnStyle) |
| MappingNameChanged |
Ocorre quando o MappingName valor muda. (Herdado de DataGridColumnStyle) |
| NullTextChanged |
Ocorre quando o NullText valor muda. (Herdado de DataGridColumnStyle) |
| PropertyDescriptorChanged |
Ocorre quando o valor da PropertyDescriptor propriedade muda. (Herdado de DataGridColumnStyle) |
| ReadOnlyChanged |
Ocorre quando o valor da ReadOnly propriedade muda. (Herdado de DataGridColumnStyle) |
| WidthChanged |
Ocorre quando o valor da Width propriedade muda. (Herdado de DataGridColumnStyle) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Informa o DataGrid controlo que o utilizador começou a editar a coluna. (Herdado de DataGridColumnStyle) |