DataGridTextBoxColumn Classe

Definizione

Contiene un controllo TextBox in una cella di un oggetto DataGridColumnStyle per la modifica delle stringhe.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
Ereditarietà

Esempi

Nell'esempio seguente viene creato DataGridTextBoxColumn un oggetto e viene aggiunto GridColumnStylesCollection all'oggetto DataGriddi un oggetto.The following example creates a DataGridTextBoxColumn and adds it to the GridColumnStylesCollection of a DataGrid. Per eseguire questo esempio di codice, incollarlo in un form con un DataGrid oggetto dataGrid1 denominato e chiamarlo dal costruttore dell'oggetto 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

Commenti

La DataGridTextBoxColumn classe deriva abstract dalla classe DataGridColumnStyle.The DataGridTextBoxColumn class derives from the abstract class DataGridColumnStyle. In fase di esecuzione, DataGridTextBoxColumn ospita un DataGridTextBox controllo che consente agli utenti di modificare il testo.At run time, the DataGridTextBoxColumn hosts a DataGridTextBox control that allows users to edit text.

Le proprietà speciali aggiunte alla classe sono Format, e HideEditBox.Special properties added to the class include Format, and HideEditBox. Queste proprietà consentono di accedere al controllo ospitato DataGridTextBox e ai relativi attributi e di impostare il formato per la visualizzazione dei valori.These properties allow you to access the hosted DataGridTextBox control and its attributes, and set the format for displaying values.

Se l'origine dati è un DataTable oggetto DataColumn contenitore DataColumn , la DataType proprietà di deve essere impostata su un tipo di dati che può essere modificato logicamente in un controllo casella di testo.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. I tipi di DataGridTextBoxColumn dati seguenti vengono associati automaticamente a: Byte, DateTime Decimal,, Double, Int16, Int32, Int64, UInt16, ,UInt32 UInt64 , Singlee .StringThe following data types are automatically associated with a DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, and String.

Nota

I tipi seguenti non sono completamente supportati da Visual Basic: DateTime UInt32, UInt16,, UInt64e TimeSpan.The following types are not fully supported by Visual Basic: DateTime, UInt16, UInt32, UInt64, and TimeSpan. Gli operatori non sono consentiti.(Operators are not allowed.)

Costruttori

DataGridTextBoxColumn()

Inizializza una nuova istanza della classe DataGridTextBoxColumn.Initializes a new instance of the DataGridTextBoxColumn class.

DataGridTextBoxColumn(PropertyDescriptor)

Inizializza una nuova istanza di un oggetto DataGridTextBoxColumn con un PropertyDescriptor specificato.Initializes a new instance of a DataGridTextBoxColumn with a specified PropertyDescriptor.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)

Inizializza una nuova istanza della classe DataGridTextBoxColumn usando il PropertyDescriptor specificato.Initializes a new instance of the DataGridTextBoxColumn class using the specified PropertyDescriptor. Specifica se l'oggetto DataGridTextBoxColumn è una colonna predefinita.Specifies whether the DataGridTextBoxColumn is a default column.

DataGridTextBoxColumn(PropertyDescriptor, String)

Inizializza una nuova istanza di un oggetto DataGridTextBoxColumn avente PropertyDescriptor e formato specificati.Initializes a new instance of a DataGridTextBoxColumn with the specified PropertyDescriptor and format.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)

Inizializza una nuova istanza della classe DataGridTextBoxColumn con un oggetto PropertyDescriptor e un formato specificati.Initializes a new instance of the DataGridTextBoxColumn class with a specified PropertyDescriptor and format. Specifica se la colonna è predefinita.Specifies whether the column is the default column.

Proprietà

Alignment

Ottiene o imposta l'allineamento del testo in una colonna.Gets or sets the alignment of text in a column.

(Ereditato da DataGridColumnStyle)
CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DataGridTableStyle

Ottiene l'oggetto DataGridTableStyle per la colonna.Gets the DataGridTableStyle for the column.

(Ereditato da DataGridColumnStyle)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
FontHeight

Ottiene l'altezza del carattere della colonna.Gets the height of the column's font.

(Ereditato da DataGridColumnStyle)
Format

Ottiene o imposta i caratteri che specificano la formattazione del testo.Gets or sets the character(s) that specify how text is formatted.

FormatInfo

Ottiene o imposta le informazioni specifiche per le impostazioni cultura necessarie per la determinazione della formattazione dei valori.Gets or sets the culture specific information used to determine how values are formatted.

HeaderAccessibleObject

Ottiene l'oggetto AccessibleObject per la colonna.Gets the AccessibleObject for the column.

(Ereditato da DataGridColumnStyle)
HeaderText

Ottiene o imposta il testo dell'intestazione della colonna.Gets or sets the text of the column header.

(Ereditato da DataGridColumnStyle)
MappingName

Ottiene o imposta il nome del membro dati in base al quale eseguire il mapping dello stile di colonna.Gets or sets the name of the data member to map the column style to.

(Ereditato da DataGridColumnStyle)
NullText

Ottiene o imposta il testo visualizzato quando la colonna contiene un valore null.Gets or sets the text that is displayed when the column contains null.

(Ereditato da DataGridColumnStyle)
PropertyDescriptor

Ottiene o imposta l'oggetto PropertyDescriptor per DataGridTextBoxColumn.Gets or sets the PropertyDescriptor for the DataGridTextBoxColumn.

ReadOnly

Imposta un valore che indica se la colonna della casella di testo è di sola lettura.Sets a value indicating whether the text box column is read-only.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
TextBox

Ottiene il controllo TextBox contenuto.Gets the hosted TextBox control.

Width

Ottiene o imposta la larghezza della colonna.Gets or sets the width of the column.

(Ereditato da DataGridColumnStyle)

Metodi

Abort(Int32)

Avvia una richiesta di interruzione di una routine di modifica.Initiates a request to interrupt an edit procedure.

BeginUpdate()

Sospende il disegno della colonna fino alla chiamata del metodo EndUpdate().Suspends the painting of the column until the EndUpdate() method is called.

(Ereditato da DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)

Genera un'eccezione se il controllo DataGrid non dispone di un'origine dati valida o se su questa colonna non è stato effettuato il mapping a una proprietà valida nell'origine dati.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.

(Ereditato da DataGridColumnStyle)
ColumnStartedEditing(Control)

Informa l'oggetto DataGrid che l'utente ha iniziato a modificare la colonna.Informs the DataGrid that the user has begun editing the column.

(Ereditato da DataGridColumnStyle)
Commit(CurrencyManager, Int32)

Avvia una richiesta di completamento di una routine di modifica.Initiates a request to complete an editing procedure.

ConcedeFocus()

Comunica alla colonna che è stato concesso lo stato attivo.Informs the column that the focus is being conceded.

CreateHeaderAccessibleObject()

Ottiene l'oggetto AccessibleObject per la colonna.Gets the AccessibleObject for the column.

(Ereditato da DataGridColumnStyle)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Ereditato da Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)

Prepara una cella per la modifica.Prepares a cell for editing.

(Ereditato da DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)

Prepara la cella per la modifica mediante i parametri dell'oggetto CurrencyManager, del numero di riga e dell'oggetto Rectangle specificati.Prepares the cell for editing using the specified CurrencyManager, row number, and Rectangle parameters.

(Ereditato da DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)

Prepara una cella per la modifica.Prepares a cell for editing.

EndEdit()

Termina un'operazione di modifica in DataGridColumnStyle.Ends an edit operation on the DataGridColumnStyle.

EndUpdate()

Riprende il disegno delle colonne sospeso chiamando il metodo BeginUpdate().Resumes the painting of columns suspended by calling the BeginUpdate() method.

(Ereditato da DataGridColumnStyle)
EnterNullValue()

Immette un valore Value nella colonna.Enters a Value in the column.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetColumnValueAtRow(CurrencyManager, Int32)

Ottiene il valore nella riga specificata dall'oggetto CurrencyManager specificato.Gets the value in the specified row from the specified CurrencyManager.

(Ereditato da DataGridColumnStyle)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetMinimumHeight()

Ottiene l'altezza di una cella in un oggetto DataGridColumnStyle.Gets the height of a cell in a DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)

Ottiene l'altezza da utilizzare per il ridimensionamento automatico delle colonne.Gets the height to be used in for automatically resizing columns.

GetPreferredSize(Graphics, Object)

Restituisce la larghezza e l'altezza ottimali della cella in una riga specificata in relazione al valore specificato.Returns the optimum width and height of the cell in a specified row relative to the specified value.

GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
HideEditBox()

Nasconde il controllo DataGridTextBox e sposta lo stato attivo al controllo DataGrid.Hides the DataGridTextBox control and moves the focus to the DataGrid control.

InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
Invalidate()

Ridisegna la colonna e fa sì che venga inviato un messaggio di disegno al controllo.Redraws the column and causes a paint message to be sent to the control.

(Ereditato da DataGridColumnStyle)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)

Disegna l'oggetto DataGridColumnStyle con gli oggetti Graphics, Rectangle, CurrencyManager e il numero di riga specificati.Paints the a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, and row number.

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

Disegna un oggetto DataGridColumnStyle con gli oggetti Graphics, Rectangle, CurrencyManager, il numero di riga e l'allineamento specificati.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, and alignment.

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

Disegna un oggetto DataGridColumnStyle con gli oggetti Graphics, Rectangle, CurrencyManager, il numero di riga, Brush e il colore di primo piano specificati.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, Brush, and foreground color.

PaintText(Graphics, Rectangle, String, Boolean)

Disegna il testo e il rettangolo nella posizione data con l'allineamento specificato.Draws the text and rectangle at the given location with the specified alignment.

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

Disegna il testo e il rettangolo nella posizione data, con i colori e l'allineamento specificati.Draws the text and rectangle at the specified location with the specified colors and alignment.

ReleaseHostedControl()

Rimuove il riferimento al controllo utilizzato per modificare i dati contenuto nell'oggetto DataGrid.Removes the reference that the DataGrid holds to the control used to edit data.

ResetHeaderText()

Reimposta la proprietà HeaderText sul valore predefinito null.Resets the HeaderText to its default value, null.

(Ereditato da DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)

Imposta il valore in una riga specificata con il valore dell'oggetto CurrencyManager indicato.Sets the value in a specified row with the value from a specified CurrencyManager.

(Ereditato da DataGridColumnStyle)
SetDataGrid(DataGrid)

Imposta il controllo DataGrid a cui appartiene la colonna.Sets the DataGrid control that this column belongs to.

(Ereditato da DataGridColumnStyle)
SetDataGridInColumn(DataGrid)

Aggiunge un controllo TextBox all'oggetto DataGrid del controllo Control.ControlCollection.Adds a TextBox control to the DataGrid control's Control.ControlCollection.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)
UpdateUI(CurrencyManager, Int32, String)

Consente di aggiornare l'interfaccia utente.Updates the user interface.

Eventi

AlignmentChanged

Si verifica quando il valore della proprietà Alignment cambia.Occurs when the Alignment property value changes.

(Ereditato da DataGridColumnStyle)
Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)
FontChanged

Viene generato quando viene modificato il carattere della colonna.Occurs when the column's font changes.

(Ereditato da DataGridColumnStyle)
HeaderTextChanged

Si verifica quando il valore della proprietà HeaderText cambia.Occurs when the HeaderText property value changes.

(Ereditato da DataGridColumnStyle)
MappingNameChanged

Si verifica quando il valore dell'oggetto MappingName cambia.Occurs when the MappingName value changes.

(Ereditato da DataGridColumnStyle)
NullTextChanged

Si verifica quando il valore dell'oggetto NullText cambia.Occurs when the NullText value changes.

(Ereditato da DataGridColumnStyle)
PropertyDescriptorChanged

Si verifica quando il valore della proprietà PropertyDescriptor cambia.Occurs when the PropertyDescriptor property value changes.

(Ereditato da DataGridColumnStyle)
ReadOnlyChanged

Si verifica quando il valore della proprietà ReadOnly cambia.Occurs when the ReadOnly property value changes.

(Ereditato da DataGridColumnStyle)
WidthChanged

Si verifica quando il valore della proprietà Width cambia.Occurs when the Width property value changes.

(Ereditato da DataGridColumnStyle)

Implementazioni dell'interfaccia esplicita

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Informa il controllo DataGrid che l'utente ha iniziato a modificare la colonna.Informs the DataGrid control that the user has begun editing the column.

(Ereditato da DataGridColumnStyle)

Si applica a

Vedi anche