DataGridTextBoxColumn Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Héberge un contrôle TextBox dans une cellule de DataGridColumnStyle pour modifier des chaînes.

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

Héritage: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Exemples

L’exemple suivant crée un DataGridTextBoxColumn et l’ajoute GridColumnStylesCollection au d’un DataGrid. Pour exécuter cet exemple de code, collez-le dans un formulaire qui a un DataGrid nommé dataGrid1 et appelez-le à partir du constructeur du 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

Remarques

La DataGridTextBoxColumn classe dérive de la abstract classe DataGridColumnStyle. Au moment de l’exécution, héberge un DataGridTextBox contrôle qui permet aux utilisateurs de modifier du DataGridTextBoxColumn texte.

Les propriétés spéciales ajoutées à la classe incluent Format, et HideEditBox. Ces propriétés vous permettent d’accéder au contrôle hébergé DataGridTextBox et à ses attributs, et de définir le format d’affichage des valeurs.

Si la source de données est un DataTable objet contenant DataColumn , la DataType propriété de doit DataColumn être définie sur un type de données qui peut logiquement être modifié dans un contrôle de zone de texte. Les types de données suivants sont automatiquement associés à un DataGridTextBoxColumn : Byte, DateTime Decimal, Double, Int16, Int64 UInt16 UInt32 UInt64 Int32, Singleet .String

Notes

Les types suivants ne sont pas entièrement pris en charge par Visual Basic : DateTime, UInt16, UInt32, UInt64et TimeSpan. (Les opérateurs ne sont pas autorisés.)

Constructeurs

DataGridTextBoxColumn()	Initialise une nouvelle instance de la classe DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor)	Initialise une nouvelle instance de la DataGridTextBoxColumn classe avec un spécifiéPropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Initialise une nouvelle instance de la classe DataGridTextBoxColumn à l'aide du PropertyDescriptor spécifié. Spécifie si DataGridTextBoxColumn est une colonne par défaut.
DataGridTextBoxColumn(PropertyDescriptor, String)	Initialise une nouvelle instance de la DataGridTextBoxColumn classe avec le format et spécifiésPropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Initialise une nouvelle instance de la classe DataGridTextBoxColumn avec le PropertyDescriptor et le format spécifiés. Spécifie si une colonne est la colonne par défaut.

Propriétés

Alignment	Obtient ou définit l'alignement du texte dans une colonne. (Hérité de DataGridColumnStyle)
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DataGridTableStyle	Obtient le DataGridTableStyle pour la colonne. (Hérité de DataGridColumnStyle)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
FontHeight	Obtient la hauteur de la police de la colonne. (Hérité de DataGridColumnStyle)
Format	Obtient ou définit le ou les caractères qui spécifient comment le texte est mis en forme.
FormatInfo	Obtient ou définit les informations de culture spécifiques utilisées pour déterminer comment les valeurs sont mises en forme.
HeaderAccessibleObject	Obtient le AccessibleObject pour la colonne. (Hérité de DataGridColumnStyle)
HeaderText	Obtient ou définit le texte de l'en-tête de colonne. (Hérité de DataGridColumnStyle)
MappingName	Obtient ou définit le nom des données membres avec lesquelles le style de colonne est mis en correspondance. (Hérité de DataGridColumnStyle)
NullText	Obtient ou définit le texte affiché quand la colonne contient `null`. (Hérité de DataGridColumnStyle)
PropertyDescriptor	Obtient ou définit PropertyDescriptor pour DataGridTextBoxColumn.
ReadOnly	Définit une valeur indiquant si la colonne de la zone de texte est en lecture seule.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
TextBox	Obtient le contrôle TextBox hébergé.
Width	Obtient ou définit la largeur de la colonne. (Hérité de DataGridColumnStyle)

Méthodes

Abort(Int32)	Lance une demande d'interruption d'une procédure de modification.
BeginUpdate()	Suspend la peinture de la colonne jusqu'à ce que la méthode EndUpdate() soit appelée. (Hérité de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Lève une exception si la DataGrid ne possède pas une source de données valide, ou si cette colonne n'est pas mappée avec une propriété valide dans la source de données. (Hérité de DataGridColumnStyle)
ColumnStartedEditing(Control)	Indique à DataGrid que l'utilisateur a commencé la modification de la colonne. (Hérité de DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Lance une demande de fin d'une procédure de modification.
ConcedeFocus()	Informe la colonne que le focus est concédé.
CreateHeaderAccessibleObject()	Obtient le AccessibleObject pour la colonne. (Hérité de DataGridColumnStyle)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Prépare une cellule pour modification. (Hérité de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Prépare la cellule pour modification en utilisant le CurrencyManager, le numéro de ligne et les paramètres de Rectangle spécifiés. (Hérité de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Prépare une cellule pour modification.
EndEdit()	Termine une opération de modification sur DataGridColumnStyle.
EndUpdate()	Reprend la peinture des colonnes suspendues en appelant la méthode BeginUpdate(). (Hérité de DataGridColumnStyle)
EnterNullValue()	Entre Value dans la colonne.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Obtient la valeur dans la ligne spécifiée à partir du CurrencyManager spécifié. (Hérité de DataGridColumnStyle)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMinimumHeight()	Obtient la hauteur d'une cellule dans DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Obtient la hauteur à utiliser pour redimensionner automatiquement les colonnes.
GetPreferredSize(Graphics, Object)	Retourne la largeur et la hauteur optimales de la cellule sur une ligne spécifiée par rapport à la valeur donnée.
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
HideEditBox()	Masque le contrôle DataGridTextBox et passe le focus au contrôle DataGrid.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Invalidate()	Redessine la colonne et provoque l'envoi d'un message de peinture au contrôle. (Hérité de DataGridColumnStyle)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Peint le DataGridColumnStyle avec les Graphics, Rectangle, CurrencyManager et numéro de ligne spécifiés.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Peint un DataGridColumnStyle avec les Graphics, Rectangle, CurrencyManager, numéro de ligne et alignement spécifiés.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Peint un DataGridColumnStyle avec les Graphics, Rectangle, CurrencyManager, numéro de ligne, Brush et couleur de premier plan spécifiés.
PaintText(Graphics, Rectangle, String, Boolean)	Dessine le texte et le rectangle à l'emplacement donné selon l'alignement spécifié.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Dessine le texte et le rectangle à l'emplacement spécifié avec les couleurs et l'alignement indiqués.
ReleaseHostedControl()	Supprime la référence de DataGrid au contrôle permettant de modifier les données.
ResetHeaderText()	Rétablit la valeur par défaut HeaderText de la propriété, `null`. (Hérité de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Affecte la valeur d'un CurrencyManager spécifié dans une ligne spécifiée. (Hérité de DataGridColumnStyle)
SetDataGrid(DataGrid)	Définit le contrôle DataGrid auquel la colonne appartient. (Hérité de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Ajoute un contrôle TextBox au DataGrid du contrôle Control.ControlCollection.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)
UpdateUI(CurrencyManager, Int32, String)	Met à jour l'interface utilisateur.

Événements

AlignmentChanged	Se produit quand la valeur de la propriété Alignment change. (Hérité de DataGridColumnStyle)
Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)
FontChanged	Se produit lorsque la police de la colonne change. (Hérité de DataGridColumnStyle)
HeaderTextChanged	Se produit quand la valeur de la propriété HeaderText change. (Hérité de DataGridColumnStyle)
MappingNameChanged	Se produit quand la valeur MappingName est modifiée. (Hérité de DataGridColumnStyle)
NullTextChanged	Se produit quand la valeur NullText est modifiée. (Hérité de DataGridColumnStyle)
PropertyDescriptorChanged	Se produit quand la valeur de la propriété PropertyDescriptor change. (Hérité de DataGridColumnStyle)
ReadOnlyChanged	Se produit quand la valeur de la propriété ReadOnly change. (Hérité de DataGridColumnStyle)
WidthChanged	Se produit quand la valeur de la propriété Width change. (Hérité de DataGridColumnStyle)

Implémentations d’interfaces explicites

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Indique au contrôle DataGrid que l'utilisateur a commencé la modification de la colonne.

(Hérité de DataGridColumnStyle)

S’applique à

Partager via