DataGridTextBoxColumn Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Hospeda un control TextBox en una celda de DataGridColumnStyle para editar cadenas.

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

Herencia: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Ejemplos

En el ejemplo siguiente se crea un DataGridTextBoxColumn objeto y se agrega a GridColumnStylesCollection de .DataGrid Para ejecutar este ejemplo de código, péguelo en un formulario con un DataGrid nombre dataGrid1 y llámelo desde el constructor de 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

Comentarios

La DataGridTextBoxColumn clase deriva de la abstract clase DataGridColumnStyle. En tiempo de ejecución, DataGridTextBoxColumn hospeda un DataGridTextBox control que permite a los usuarios editar texto.

Las propiedades especiales agregadas a la clase incluyen Format, y HideEditBox. Estas propiedades permiten tener acceso al control hospedado DataGridTextBox y sus atributos, y establecer el formato para mostrar valores.

Si el origen de datos es un DataTable objeto contenedor DataColumn , la DataType propiedad de debe establecerse en un tipo de DataColumn datos que se pueda editar lógicamente en un control de cuadro de texto. Los siguientes tipos de datos se asocian automáticamente a DataGridTextBoxColumn : Byte, , Decimal Int32 Int16 Double DateTime, Int64 UInt32 UInt64 UInt16 Singley .String

Nota

Los tipos siguientes no son totalmente compatibles con Visual Basic: DateTime, UInt16, UInt32, UInt64y TimeSpan. (No se permiten operadores).

Constructores

DataGridTextBoxColumn()	Inicializa una nueva instancia de la clase DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor)	Inicializa una nueva instancia de la DataGridTextBoxColumn clase con un especificado PropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Inicializa una nueva instancia de la clase DataGridTextBoxColumn utilizando la clase PropertyDescriptor especificada. Especifica si DataGridTextBoxColumn es una columna predeterminada.
DataGridTextBoxColumn(PropertyDescriptor, String)	Inicializa una nueva instancia de la DataGridTextBoxColumn clase con el formato y especificados PropertyDescriptor .
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Inicializa una instancia nueva de la clase DataGridTextBoxColumn con el PropertyDescriptor y el formato especificados. Especifica si la columna es la columna predeterminada.

Propiedades

Alignment	Obtiene o establece la alineación de texto de una columna. (Heredado de DataGridColumnStyle)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DataGridTableStyle	Obtiene el DataGridTableStyle de la columna. (Heredado de DataGridColumnStyle)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
FontHeight	Obtiene el alto de la fuente de la columna. (Heredado de DataGridColumnStyle)
Format	Obtiene o establece el carácter o los caracteres que especifican cómo se aplica formato al texto.
FormatInfo	Obtiene o establece la información específica de la referencia cultural que se utiliza para determinar cómo se aplica formato a los valores.
HeaderAccessibleObject	Obtiene el AccessibleObject de la columna. (Heredado de DataGridColumnStyle)
HeaderText	Obtiene o establece el texto del encabezado de columna. (Heredado de DataGridColumnStyle)
MappingName	Obtiene o establece el nombre del miembro de datos para asignar el estilo de columna. (Heredado de DataGridColumnStyle)
NullText	Obtiene o establece el texto que se muestra cuando la columna contiene `null`. (Heredado de DataGridColumnStyle)
PropertyDescriptor	Obtiene o establece el objeto PropertyDescriptor para DataGridTextBoxColumn.
ReadOnly	Establece un valor que indica si la columna de un cuadro de texto es de sólo lectura.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
TextBox	Obtiene el control TextBox hospedado.
Width	Obtiene o establece el ancho de la columna. (Heredado de DataGridColumnStyle)

Métodos

Abort(Int32)	Inicia una solicitud para interrumpir un procedimiento de edición.
BeginUpdate()	Suspende el proceso de pintar la columna hasta que se llama al método EndUpdate(). (Heredado de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Se produce una excepción si DataGrid no tiene un origen de datos válido, o si esta columna no está asignada a una propiedad válida en el origen de datos. (Heredado de DataGridColumnStyle)
ColumnStartedEditing(Control)	Informa a DataGrid de que el usuario ha empezado a editar la columna. (Heredado de DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Inicia una solicitud para finalizar un procedimiento de edición.
ConcedeFocus()	Notifica a la columna que será la columna activa.
CreateHeaderAccessibleObject()	Obtiene el AccessibleObject de la columna. (Heredado de DataGridColumnStyle)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Prepara una celda para que pueda editarse. (Heredado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Prepara la celda para la edición con el CurrencyManager, el número de fila y los parámetros Rectangle especificados. (Heredado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Prepara una celda para que pueda editarse.
EndEdit()	Finaliza una operación de edición en DataGridColumnStyle.
EndUpdate()	Reinicia el proceso de pintar las columnas que se suspendió al llamar al método BeginUpdate(). (Heredado de DataGridColumnStyle)
EnterNullValue()	Inserta un Value en la columna.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Obtiene el valor de la fila especificada del CurrencyManager especificado. (Heredado de DataGridColumnStyle)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetMinimumHeight()	Obtiene el alto de una celda de DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Obtiene el alto y lo utiliza para cambiar automáticamente el tamaño de las columnas.
GetPreferredSize(Graphics, Object)	Devuelve el ancho y alto óptimos de la celda en una fila especificada con relación al valor especificado.
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HideEditBox()	Oculta el control DataGridTextBox y desplaza el foco al control DataGrid.
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Invalidate()	Vuelve a dibujar la columna y hace que se envíe un mensaje de pintura al control. (Heredado de DataGridColumnStyle)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Pinta DataGridColumnStyle con los valores especificados para Graphics, Rectangle, CurrencyManager y número de fila.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Pinta DataGridColumnStyle con los valores especificados de Graphics, Rectangle, CurrencyManager, número de fila y alineación.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Pinta DataGridColumnStyle con los valores especificados de Graphics, Rectangle, CurrencyManager, número de fila, Brush y color de primer plano.
PaintText(Graphics, Rectangle, String, Boolean)	Dibuja el texto y el rectángulo en la ubicación especificada con la alineación especificada.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Dibuja el texto y el rectángulo en la ubicación especificada con los colores y la alineación especificados.
ReleaseHostedControl()	Quita la referencia al control utilizado para editar datos que contiene DataGrid.
ResetHeaderText()	Restablece HeaderText a su valor predeterminado, `null`. (Heredado de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Establece el valor de una fila especificada con el valor de un CurrencyManager especificado. (Heredado de DataGridColumnStyle)
SetDataGrid(DataGrid)	Establece el control DataGrid al que pertenece esta columna. (Heredado de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Agrega un control TextBox al objeto DataGrid del control Control.ControlCollection.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
UpdateUI(CurrencyManager, Int32, String)	Actualiza la interfaz de usuario.

Eventos

AlignmentChanged	Se produce cuando cambia el valor de la propiedad Alignment. (Heredado de DataGridColumnStyle)
Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)
FontChanged	Aparece cuando cambia la fuente de la columna. (Heredado de DataGridColumnStyle)
HeaderTextChanged	Se produce cuando cambia el valor de la propiedad HeaderText. (Heredado de DataGridColumnStyle)
MappingNameChanged	Se produce cuando cambia el valor MappingName. (Heredado de DataGridColumnStyle)
NullTextChanged	Se produce cuando cambia el valor NullText. (Heredado de DataGridColumnStyle)
PropertyDescriptorChanged	Se produce cuando cambia el valor de la propiedad PropertyDescriptor. (Heredado de DataGridColumnStyle)
ReadOnlyChanged	Se produce cuando cambia el valor de la propiedad ReadOnly. (Heredado de DataGridColumnStyle)
WidthChanged	Se produce cuando cambia el valor de la propiedad Width. (Heredado de DataGridColumnStyle)

Implementaciones de interfaz explícitas

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Informa al control DataGrid de que el usuario ha empezado a editar la columna.

(Heredado de DataGridColumnStyle)

Se aplica a

Compartir vía