DataGridTextBoxColumn Clase

Definición

Hospeda un control TextBox en una celda de DataGridColumnStyle para editar cadenas.Hosts a TextBox control in a cell of a DataGridColumnStyle for editing 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
Herencia

Ejemplos

En el ejemplo siguiente se crea un DataGridTextBoxColumn y se agrega a la GridColumnStylesCollection de DataGrid .The following example creates a DataGridTextBoxColumn and adds it to the GridColumnStylesCollection of a DataGrid. Para ejecutar este ejemplo de código, péguelo en un formulario que tenga un DataGrid denominado dataGrid1 y llámelo desde el constructor de Form .To run this code example, paste it into a form that has a DataGrid named dataGrid1 and call it from the constructor of the 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 se deriva de la abstract clase DataGridColumnStyle .The DataGridTextBoxColumn class derives from the abstract class DataGridColumnStyle. En tiempo de ejecución, DataGridTextBoxColumn hospeda un DataGridTextBox control que permite a los usuarios editar texto.At run time, the DataGridTextBoxColumn hosts a DataGridTextBox control that allows users to edit text.

Las propiedades especiales agregadas a la clase incluyen Format , y HideEditBox .Special properties added to the class include Format, and HideEditBox. Estas propiedades le permiten tener acceso al control hospedado DataGridTextBox y sus atributos, y establecer el formato para mostrar valores.These properties allow you to access the hosted DataGridTextBox control and its attributes, and set the format for displaying values.

Si el origen de datos es DataTable un DataColumn objeto que contiene objetos, la DataType propiedad de DataColumn se debe establecer en un tipo de datos que se pueda editar lógicamente en un control de cuadro de texto.If the data source is a DataTable containing DataColumn objects, the DataType property of the DataColumn should be set to a data type that can logically be edited in a text box control. Los siguientes tipos de datos se asocian automáticamente a DataGridTextBoxColumn : Byte , DateTime , Decimal , Double , Int16 , Int32 , Int64 , UInt16 ,,, UInt32 UInt64 Single y String .The following data types are automatically associated with a DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, and String.

Nota

Los tipos siguientes no son totalmente compatibles con Visual Basic: DateTime , UInt16 , UInt32 , UInt64 y TimeSpan .The following types are not fully supported by Visual Basic: DateTime, UInt16, UInt32, UInt64, and TimeSpan. (No se permiten operadores).(Operators are not allowed.)

Constructores

DataGridTextBoxColumn()

Inicializa una nueva instancia de la clase DataGridTextBoxColumn.Initializes a new instance of the DataGridTextBoxColumn class.

DataGridTextBoxColumn(PropertyDescriptor)

Inicializa una nueva instancia de DataGridTextBoxColumn con un PropertyDescriptor especificado.Initializes a new instance of a DataGridTextBoxColumn with a specified PropertyDescriptor.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)

Inicializa una nueva instancia de la clase DataGridTextBoxColumn con la clase PropertyDescriptor especificada.Initializes a new instance of the DataGridTextBoxColumn class using the specified PropertyDescriptor. Especifica si DataGridTextBoxColumn es una columna predeterminada.Specifies whether the DataGridTextBoxColumn is a default column.

DataGridTextBoxColumn(PropertyDescriptor, String)

Inicializa una nueva instancia de DataGridTextBoxColumn con el PropertyDescriptor y formato especificados.Initializes a new instance of a DataGridTextBoxColumn with the specified PropertyDescriptor and format.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)

Inicializa una instancia nueva de la clase DataGridTextBoxColumn con el PropertyDescriptor y el formato especificados.Initializes a new instance of the DataGridTextBoxColumn class with a specified PropertyDescriptor and format. Especifica si la columna es la columna predeterminada.Specifies whether the column is the default column.

Propiedades

Alignment

Obtiene o establece la alineación de texto de una columna.Gets or sets the alignment of text in a column.

(Heredado de DataGridColumnStyle)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Heredado de Component)
DataGridTableStyle

Obtiene el DataGridTableStyle de la columna.Gets the DataGridTableStyle for the column.

(Heredado de DataGridColumnStyle)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
FontHeight

Obtiene el alto de la fuente de la columna.Gets the height of the column's font.

(Heredado de DataGridColumnStyle)
Format

Obtiene o establece el carácter o los caracteres que especifican cómo se aplica formato al texto.Gets or sets the character(s) that specify how text is formatted.

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.Gets or sets the culture specific information used to determine how values are formatted.

HeaderAccessibleObject

Obtiene el AccessibleObject de la columna.Gets the AccessibleObject for the column.

(Heredado de DataGridColumnStyle)
HeaderText

Obtiene o establece el texto del encabezado de columna.Gets or sets the text of the column header.

(Heredado de DataGridColumnStyle)
MappingName

Obtiene o establece el nombre del miembro de datos para asignar el estilo de columna.Gets or sets the name of the data member to map the column style to.

(Heredado de DataGridColumnStyle)
NullText

Obtiene o establece el texto que se muestra cuando la columna contiene null.Gets or sets the text that is displayed when the column contains null.

(Heredado de DataGridColumnStyle)
PropertyDescriptor

Obtiene o establece el objeto PropertyDescriptor para DataGridTextBoxColumn.Gets or sets the PropertyDescriptor for the DataGridTextBoxColumn.

ReadOnly

Establece un valor que indica si la columna de un cuadro de texto es de sólo lectura.Sets a value indicating whether the text box column is read-only.

Site

Obtiene o establece ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
TextBox

Obtiene el control TextBox hospedado.Gets the hosted TextBox control.

Width

Obtiene o establece el ancho de la columna.Gets or sets the width of the column.

(Heredado de DataGridColumnStyle)

Métodos

Abort(Int32)

Inicia una solicitud para interrumpir un procedimiento de edición.Initiates a request to interrupt an edit procedure.

BeginUpdate()

Suspende el proceso de pintar la columna hasta que se llama al método EndUpdate().Suspends the painting of the column until the EndUpdate() method is called.

(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.Throws an exception if the DataGrid does not have a valid data source, or if this column is not mapped to a valid property in the data source.

(Heredado de DataGridColumnStyle)
ColumnStartedEditing(Control)

Informa a DataGrid de que el usuario ha empezado a editar la columna.Informs the DataGrid that the user has begun editing the column.

(Heredado de DataGridColumnStyle)
Commit(CurrencyManager, Int32)

Inicia una solicitud para finalizar un procedimiento de edición.Initiates a request to complete an editing procedure.

ConcedeFocus()

Notifica a la columna que será la columna activa.Informs the column that the focus is being conceded.

CreateHeaderAccessibleObject()

Obtiene el AccessibleObject de la columna.Gets the AccessibleObject for the column.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)

Prepara una celda para que pueda editarse.Prepares a cell for editing.

(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.Prepares the cell for editing using the specified CurrencyManager, row number, and Rectangle parameters.

(Heredado de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)

Prepara una celda para que pueda editarse.Prepares a cell for editing.

EndEdit()

Finaliza una operación de edición en DataGridColumnStyle.Ends an edit operation on the DataGridColumnStyle.

EndUpdate()

Reinicia el proceso de pintar las columnas que se suspendió al llamar al método BeginUpdate().Resumes the painting of columns suspended by calling the BeginUpdate() method.

(Heredado de DataGridColumnStyle)
EnterNullValue()

Inserta un Value en la columna.Enters a Value in the column.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetColumnValueAtRow(CurrencyManager, Int32)

Obtiene el valor de la fila especificada del CurrencyManager especificado.Gets the value in the specified row from the specified CurrencyManager.

(Heredado de DataGridColumnStyle)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetMinimumHeight()

Obtiene el alto de una celda de DataGridColumnStyle.Gets the height of a cell in a DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)

Obtiene el alto y lo utiliza para cambiar automáticamente el tamaño de las columnas.Gets the height to be used in for automatically resizing columns.

GetPreferredSize(Graphics, Object)

Devuelve el ancho y alto óptimos de la celda en una fila especificada con relación al valor especificado.Returns the optimum width and height of the cell in a specified row relative to the specified value.

GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
HideEditBox()

Oculta el control DataGridTextBox y desplaza el foco al control DataGrid.Hides the DataGridTextBox control and moves the focus to the DataGrid control.

InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
Invalidate()

Vuelve a dibujar la columna y hace que se envíe un mensaje de pintura al control.Redraws the column and causes a paint message to be sent to the control.

(Heredado de DataGridColumnStyle)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)

Pinta DataGridColumnStyle con los valores especificados para Graphics, Rectangle, CurrencyManager y número de fila.Paints the a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, and row number.

Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)

Pinta DataGridColumnStyle con los valores especificados de Graphics, Rectangle, CurrencyManager, número de fila y alineación.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, and alignment.

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.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, Brush, and foreground color.

PaintText(Graphics, Rectangle, String, Boolean)

Dibuja el texto y el rectángulo en la ubicación especificada con la alineación especificada.Draws the text and rectangle at the given location with the specified alignment.

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.Draws the text and rectangle at the specified location with the specified colors and alignment.

ReleaseHostedControl()

Quita la referencia al control utilizado para editar datos que contiene DataGrid.Removes the reference that the DataGrid holds to the control used to edit data.

ResetHeaderText()

Restablece HeaderText a su valor predeterminado, null.Resets the HeaderText to its default value, null.

(Heredado de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)

Establece el valor de una fila especificada con el valor de un CurrencyManager especificado.Sets the value in a specified row with the value from a specified CurrencyManager.

(Heredado de DataGridColumnStyle)
SetDataGrid(DataGrid)

Establece el control DataGrid al que pertenece esta columna.Sets the DataGrid control that this column belongs to.

(Heredado de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)

Agrega un control TextBox al objeto DataGrid del control Control.ControlCollection.Adds a TextBox control to the DataGrid control's Control.ControlCollection.

ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Heredado de Component)
UpdateUI(CurrencyManager, Int32, String)

Actualiza la interfaz de usuario.Updates the user interface.

Eventos

AlignmentChanged

Se produce cuando cambia el valor de la propiedad Alignment.Occurs when the Alignment property value changes.

(Heredado de DataGridColumnStyle)
Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)
FontChanged

Aparece cuando cambia la fuente de la columna.Occurs when the column's font changes.

(Heredado de DataGridColumnStyle)
HeaderTextChanged

Se produce cuando cambia el valor de la propiedad HeaderText.Occurs when the HeaderText property value changes.

(Heredado de DataGridColumnStyle)
MappingNameChanged

Se produce cuando cambia el valor MappingName.Occurs when the MappingName value changes.

(Heredado de DataGridColumnStyle)
NullTextChanged

Se produce cuando cambia el valor NullText.Occurs when the NullText value changes.

(Heredado de DataGridColumnStyle)
PropertyDescriptorChanged

Se produce cuando cambia el valor de la propiedad PropertyDescriptor.Occurs when the PropertyDescriptor property value changes.

(Heredado de DataGridColumnStyle)
ReadOnlyChanged

Se produce cuando cambia el valor de la propiedad ReadOnly.Occurs when the ReadOnly property value changes.

(Heredado de DataGridColumnStyle)
WidthChanged

Se produce cuando cambia el valor de la propiedad Width.Occurs when the Width property value changes.

(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.Informs the DataGrid control that the user has begun editing the column.

(Heredado de DataGridColumnStyle)

Se aplica a

Consulte también