DataGridTextBoxColumn Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Contiene un controllo TextBox in una cella di un oggetto DataGridColumnStyle per la modifica delle stringhe.

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à: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Esempio

Nell'esempio seguente viene creato un oggetto DataGridTextBoxColumn e lo aggiunge all'oggetto GridColumnStylesCollection di un DataGridoggetto . Per eseguire questo esempio di codice, incollarlo in un modulo con un DataGrid nome dataGrid1 e chiamarlo dal costruttore di 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 dalla abstract classe DataGridColumnStyle. In fase di esecuzione, l'host DataGridTextBoxColumn ospita un DataGridTextBox controllo che consente agli utenti di modificare il testo.

Proprietà speciali aggiunte alla classe includono Format, e HideEditBox. Queste proprietà consentono di accedere al controllo ospitato DataGridTextBox e ai relativi attributi e impostare il formato per la visualizzazione dei valori.

Se l'origine dati è un DataTable oggetto contenente DataColumn , la DataType proprietà dell'oggetto DataColumn deve essere impostata su un tipo di dati che può essere modificato logicamente in un controllo casella di testo. I tipi di dati seguenti vengono associati automaticamente a un DataGridTextBoxColumn oggetto : DateTime Byte, Double Int16 Int64 Int32 Decimal UInt32 UInt64 UInt16 Singlee .String

Nota

I tipi seguenti non sono completamente supportati da Visual Basic: DateTime, UInt16, UInt32, UInt64e TimeSpan. Gli operatori non sono consentiti.

Costruttori

DataGridTextBoxColumn()	Inizializza una nuova istanza della classe DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor)	Inizializza una nuova istanza della DataGridTextBoxColumn classe con un oggetto specificato PropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Inizializza una nuova istanza della classe DataGridTextBoxColumn usando il PropertyDescriptor specificato. Specifica se l'oggetto DataGridTextBoxColumn è una colonna predefinita.
DataGridTextBoxColumn(PropertyDescriptor, String)	Inizializza una nuova istanza della DataGridTextBoxColumn classe con il formato e specificato PropertyDescriptor .
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Inizializza una nuova istanza della classe DataGridTextBoxColumn con un oggetto PropertyDescriptor e un formato specificati. Specifica se la colonna è predefinita.

Proprietà

Alignment	Ottiene o imposta l'allineamento del testo in una colonna. (Ereditato da DataGridColumnStyle)
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DataGridTableStyle	Ottiene l'oggetto DataGridTableStyle per la colonna. (Ereditato da DataGridColumnStyle)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
FontHeight	Ottiene l'altezza del tipo di carattere della colonna. (Ereditato da DataGridColumnStyle)
Format	Ottiene o imposta i caratteri che specificano la formattazione del testo.
FormatInfo	Ottiene o imposta le informazioni specifiche per le impostazioni cultura necessarie per la determinazione della formattazione dei valori.
HeaderAccessibleObject	Ottiene l'oggetto AccessibleObject per la colonna. (Ereditato da DataGridColumnStyle)
HeaderText	Ottiene o imposta il testo dell'intestazione della colonna. (Ereditato da DataGridColumnStyle)
MappingName	Ottiene o imposta il nome del membro dati in base al quale eseguire il mapping dello stile di colonna. (Ereditato da DataGridColumnStyle)
NullText	Ottiene o imposta il testo visualizzato quando la colonna contiene un valore `null`. (Ereditato da DataGridColumnStyle)
PropertyDescriptor	Ottiene o imposta l'oggetto PropertyDescriptor per DataGridTextBoxColumn.
ReadOnly	Imposta un valore che indica se la colonna della casella di testo è di sola lettura.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
TextBox	Ottiene il controllo TextBox contenuto.
Width	Ottiene o imposta la larghezza della colonna. (Ereditato da DataGridColumnStyle)

Metodi

Abort(Int32)	Avvia una richiesta di interruzione di una routine di modifica.
BeginUpdate()	Sospende il disegno della colonna fino alla chiamata del metodo EndUpdate(). (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. (Ereditato da DataGridColumnStyle)
ColumnStartedEditing(Control)	Informa l'oggetto DataGrid che l'utente ha iniziato a modificare la colonna. (Ereditato da DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Avvia una richiesta di completamento di una routine di modifica.
ConcedeFocus()	Comunica alla colonna che è stato concesso lo stato attivo.
CreateHeaderAccessibleObject()	Ottiene l'oggetto AccessibleObject per la colonna. (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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Prepara una cella per la modifica. (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. (Ereditato da DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Prepara una cella per la modifica.
EndEdit()	Termina un'operazione di modifica in DataGridColumnStyle.
EndUpdate()	Riprende il disegno delle colonne sospeso chiamando il metodo BeginUpdate(). (Ereditato da DataGridColumnStyle)
EnterNullValue()	Immette un valore Value nella colonna.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Ottiene il valore nella riga specificata dall'oggetto CurrencyManager specificato. (Ereditato da DataGridColumnStyle)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetMinimumHeight()	Ottiene l'altezza di una cella in un oggetto DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Ottiene l'altezza da utilizzare per il ridimensionamento automatico delle colonne.
GetPreferredSize(Graphics, Object)	Restituisce la larghezza e l'altezza ottimali della cella in una riga specificata in relazione al valore specificato.
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HideEditBox()	Nasconde il controllo DataGridTextBox e sposta lo stato attivo al controllo DataGrid.
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
Invalidate()	Ridisegna la colonna e fa sì che venga inviato un messaggio di disegno al controllo. (Ereditato da DataGridColumnStyle)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Disegna l'oggetto DataGridColumnStyle con gli oggetti Graphics, Rectangle, CurrencyManager e il numero di riga specificati.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Disegna un oggetto DataGridColumnStyle con gli oggetti Graphics, Rectangle, CurrencyManager, il numero di riga e l'allineamento specificati.
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.
PaintText(Graphics, Rectangle, String, Boolean)	Disegna il testo e il rettangolo nella posizione data con l'allineamento specificato.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Disegna il testo e il rettangolo nella posizione data, con i colori e l'allineamento specificati.
ReleaseHostedControl()	Rimuove il riferimento al controllo utilizzato per modificare i dati contenuto nell'oggetto DataGrid.
ResetHeaderText()	Reimposta la proprietà HeaderText sul valore predefinito `null`. (Ereditato da DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Imposta il valore in una riga specificata con il valore di un oggetto CurrencyManager. specificato. (Ereditato da DataGridColumnStyle)
SetDataGrid(DataGrid)	Imposta il controllo DataGrid a cui appartiene la colonna. (Ereditato da DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Aggiunge un controllo TextBox all'oggetto DataGrid del controllo Control.ControlCollection.
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
UpdateUI(CurrencyManager, Int32, String)	Consente di aggiornare l'interfaccia utente.

Eventi

AlignmentChanged	Si verifica quando il valore della proprietà Alignment cambia. (Ereditato da DataGridColumnStyle)
Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
FontChanged	Si verifica quando il tipo di carattere della colonna cambia. (Ereditato da DataGridColumnStyle)
HeaderTextChanged	Si verifica quando il valore della proprietà HeaderText cambia. (Ereditato da DataGridColumnStyle)
MappingNameChanged	Si verifica quando il valore dell'oggetto MappingName cambia. (Ereditato da DataGridColumnStyle)
NullTextChanged	Si verifica quando il valore dell'oggetto NullText cambia. (Ereditato da DataGridColumnStyle)
PropertyDescriptorChanged	Si verifica quando il valore della proprietà PropertyDescriptor cambia. (Ereditato da DataGridColumnStyle)
ReadOnlyChanged	Si verifica quando il valore della proprietà ReadOnly cambia. (Ereditato da DataGridColumnStyle)
WidthChanged	Si verifica quando il valore della proprietà Width cambia. (Ereditato da DataGridColumnStyle)

Implementazioni dell'interfaccia esplicita

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Informa il controllo DataGrid che l'utente ha iniziato a modificare la colonna.

(Ereditato da DataGridColumnStyle)

Si applica a