Partager via


DataGridTextBoxColumn Classe

Définition

Attention

DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.

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

public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
Héritage
Attributs

Exemples

L’exemple suivant crée un DataGridTextBoxColumn élément et l’ajoute à l’objet GridColumnStylesCollectionDataGrid. Pour exécuter cet exemple de code, collez-le dans un formulaire nommé DataGriddataGrid1 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, le DataGridTextBoxColumn contrôle héberge un DataGridTextBox contrôle qui permet aux utilisateurs de modifier du 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é du fichier doit être définie sur un type de DataColumn données pouvant être modifié logiquement dans un contrôle de zone de texte. Les types de données suivants sont automatiquement associés à un : , , DoubleDecimalDateTime, , Int16, Int32Int64, , UInt16UInt32, UInt64, Single, et String. ByteDataGridTextBoxColumn

Note

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

Constructeurs

Nom Description
DataGridTextBoxColumn()
Obsolète.

Initialise une nouvelle instance de la classe DataGridTextBoxColumn.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)
Obsolète.

Initialise une nouvelle instance de la DataGridTextBoxColumn classe à l’aide du .PropertyDescriptor Spécifie si la DataGridTextBoxColumn colonne est une colonne par défaut.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)
Obsolète.

Initialise une nouvelle instance de la DataGridTextBoxColumn classe avec un format et un format spécifiés PropertyDescriptor . Spécifie si la colonne est la colonne par défaut.

DataGridTextBoxColumn(PropertyDescriptor, String)
Obsolète.

Initialise une nouvelle instance de la DataGridTextBoxColumn classe avec le format et le format spécifiés PropertyDescriptor .

DataGridTextBoxColumn(PropertyDescriptor)
Obsolète.

Initialise une nouvelle instance de la DataGridTextBoxColumn classe avec un .PropertyDescriptor

Propriétés

Nom Description
Alignment
Obsolète.

Obtient ou définit l’alignement du texte dans une colonne.

(Hérité de DataGridColumnStyle)
CanRaiseEvents
Obsolète.

Obtient une valeur indiquant si le composant peut déclencher un événement.

(Hérité de Component)
Container
Obsolète.

Obtient le IContainer fichier qui contient le Component.

(Hérité de Component)
DataGridTableStyle
Obsolète.

Obtient la DataGridTableStyle colonne.

(Hérité de DataGridColumnStyle)
DesignMode
Obsolète.

Obtient une valeur qui indique si la Component valeur est actuellement en mode création.

(Hérité de Component)
Events
Obsolète.

Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component.

(Hérité de Component)
FontHeight
Obsolète.

Obtient la hauteur de la police de la colonne.

(Hérité de DataGridColumnStyle)
Format
Obsolète.

Obtient ou définit le ou les caractères qui spécifient la mise en forme du texte.

FormatInfo
Obsolète.

Obtient ou définit les informations spécifiques à la culture utilisées pour déterminer la façon dont les valeurs sont mises en forme.

HeaderAccessibleObject
Obsolète.

Obtient la AccessibleObject colonne.

(Hérité de DataGridColumnStyle)
HeaderText
Obsolète.

Obtient ou définit le texte de l’en-tête de colonne.

(Hérité de DataGridColumnStyle)
MappingName
Obsolète.

Obtient ou définit le nom du membre de données sur lequel mapper le style de colonne.

(Hérité de DataGridColumnStyle)
NullText
Obsolète.

Obtient ou définit le texte affiché lorsque la colonne contient null.

(Hérité de DataGridColumnStyle)
PropertyDescriptor
Obsolète.

Obtient ou définit la PropertyDescriptor valeur pour le DataGridTextBoxColumn.

ReadOnly
Obsolète.

Définit une valeur indiquant si la colonne de zone de texte est en lecture seule.

ReadOnly
Obsolète.

Obtient ou définit une valeur indiquant si les données de la colonne peuvent être modifiées.

(Hérité de DataGridColumnStyle)
Site
Obsolète.

Obtient ou définit le ISiteComponent.

(Hérité de Component)
TextBox
Obsolète.

Obtient le contrôle hébergé TextBox .

Width
Obsolète.

Obtient ou définit la largeur de la colonne.

(Hérité de DataGridColumnStyle)

Méthodes

Nom Description
Abort(Int32)
Obsolète.

Lance une demande d’interruption d’une procédure d’édition.

BeginUpdate()
Obsolète.

Suspend la peinture de la colonne jusqu’à ce que la EndUpdate() méthode soit appelée.

(Hérité de DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)
Obsolète.

Lève une exception si la DataGrid source de données n’a pas de source de données valide ou si cette colonne n’est pas mappée à une propriété valide dans la source de données.

(Hérité de DataGridColumnStyle)
ColumnStartedEditing(Control)
Obsolète.

Informe que DataGrid l’utilisateur a commencé à modifier la colonne.

(Hérité de DataGridColumnStyle)
Commit(CurrencyManager, Int32)
Obsolète.

Lance une demande d’exécution d’une procédure d’édition.

ConcedeFocus()
Obsolète.

Informe la colonne que le focus est concédé.

ConcedeFocus()
Obsolète.

Avertit une colonne qu’elle doit abandonner le focus au contrôle qu’il héberge.

(Hérité de DataGridColumnStyle)
CreateHeaderAccessibleObject()
Obsolète.

Obtient la AccessibleObject colonne.

(Hérité de DataGridColumnStyle)
CreateObjRef(Type)
Obsolète.

Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()
Obsolète.

Libère toutes les ressources utilisées par le Component.

(Hérité de Component)
Dispose(Boolean)
Obsolète.

Libère les ressources non managées utilisées par les Component ressources gérées et libère éventuellement les ressources managées.

(Hérité de Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)
Obsolète.

Prépare une cellule pour modification.

Edit(CurrencyManager, Int32, Rectangle, Boolean, String)
Obsolète.

Prépare la cellule à modifier à l’aide du numéro de ligne et Rectangle des paramètres spécifiésCurrencyManager.

(Hérité de DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean)
Obsolète.

Prépare une cellule pour modification.

(Hérité de DataGridColumnStyle)
EndEdit()
Obsolète.

Termine une opération de modification sur le DataGridColumnStyle.

EndUpdate()
Obsolète.

Reprend la peinture des colonnes suspendues en appelant la BeginUpdate() méthode.

(Hérité de DataGridColumnStyle)
EnterNullValue()
Obsolète.

Entre un Value dans la colonne.

EnterNullValue()
Obsolète.

Entre une Value colonne.

(Hérité de DataGridColumnStyle)
Equals(Object)
Obsolète.

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetColumnValueAtRow(CurrencyManager, Int32)
Obsolète.

Obtient la valeur de la ligne spécifiée à partir de l’objet spécifié CurrencyManager.

(Hérité de DataGridColumnStyle)
GetHashCode()
Obsolète.

Sert 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 actuel qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetMinimumHeight()
Obsolète.

Obtient la hauteur d’une cellule dans un DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)
Obsolète.

Obtient la hauteur à utiliser pour le redimensionnement automatique des colonnes.

GetPreferredSize(Graphics, Object)
Obsolète.

Retourne la largeur et la hauteur optimales de la cellule dans une ligne spécifiée par rapport à la valeur spécifiée.

GetService(Type)
Obsolète.

Retourne un objet qui représente un service fourni par le Component ou par son Container.

(Hérité de Component)
GetType()
Obsolète.

Obtient la Type de l’instance actuelle.

(Hérité de Object)
HideEditBox()
Obsolète.

Masque le DataGridTextBox contrôle et déplace le focus sur le DataGrid contrôle.

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()
Obsolète.

Redessine la colonne et provoque l’envoi d’un message de peinture au contrôle.

(Hérité de DataGridColumnStyle)
MemberwiseClone()
Obsolète.

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
MemberwiseClone(Boolean)
Obsolète.

Crée une copie superficielle de l’objet actuel MarshalByRefObject .

(Hérité de MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)
Obsolète.

Peint un DataGridColumnStyle avec le numéro de RectangleCurrencyManagerligne, le numéro de ligne et l’alignement spécifiésGraphics.

Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)
Obsolète.

Peint une DataGridColumnStyle couleur avec la couleur de premier plan, le CurrencyManagerRectanglenuméro de ligne et le numéro Brushde ligne spécifiésGraphics.

Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)
Obsolète.

Peint un DataGridColumnStyle avec le numéro de RectangleCurrencyManagerligne, le numéro de ligne, la couleur d’arrière-plan, la couleur de premier plan et l’alignement spécifiésGraphics.

(Hérité de DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32)
Obsolète.

Peint l’un DataGridColumnStyle avec le numéro de ligne , et CurrencyManagerle numéro de ligne spécifiésGraphicsRectangle.

PaintText(Graphics, Rectangle, String, Boolean)
Obsolète.

Dessine le texte et le rectangle à l’emplacement donné avec l’alignement spécifié.

PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)
Obsolète.

Dessine le texte et le rectangle à l’emplacement spécifié avec les couleurs et l’alignement spécifiés.

ReleaseHostedControl()
Obsolète.

Supprime la référence que contient DataGrid le contrôle utilisé pour modifier les données.

ReleaseHostedControl()
Obsolète.

Permet à la colonne de libérer des ressources lorsque le contrôle qu’il héberge n’est pas nécessaire.

(Hérité de DataGridColumnStyle)
ResetHeaderText()
Obsolète.

Réinitialise la HeaderText valeur par défaut. null

(Hérité de DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)
Obsolète.

Définit la valeur dans une ligne spécifiée avec la valeur d’un élément spécifié CurrencyManager.

(Hérité de DataGridColumnStyle)
SetDataGrid(DataGrid)
Obsolète.

Définit le DataGrid contrôle auquel appartient cette colonne.

(Hérité de DataGridColumnStyle)
SetDataGridInColumn(DataGrid)
Obsolète.

Ajoute un TextBox contrôle à l’élément DataGridControl.ControlCollection.

SetDataGridInColumn(DataGrid)
Obsolète.

Définit la DataGrid colonne.

(Hérité de DataGridColumnStyle)
ToString()
Obsolète.

Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée.

(Hérité de Component)
UpdateUI(CurrencyManager, Int32, String)
Obsolète.

Met à jour l’interface utilisateur.

UpdateUI(CurrencyManager, Int32, String)
Obsolète.

Met à jour la valeur d’une ligne spécifiée avec le texte donné.

(Hérité de DataGridColumnStyle)

Événements

Nom Description
AlignmentChanged
Obsolète.

Se produit lorsque la valeur de propriété Alignment change.

(Hérité de DataGridColumnStyle)
Disposed
Obsolète.

Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode.

(Hérité de Component)
FontChanged
Obsolète.

Se produit lorsque la police de la colonne change.

(Hérité de DataGridColumnStyle)
HeaderTextChanged
Obsolète.

Se produit lorsque la valeur de propriété HeaderText change.

(Hérité de DataGridColumnStyle)
MappingNameChanged
Obsolète.

Se produit lorsque la MappingName valeur change.

(Hérité de DataGridColumnStyle)
NullTextChanged
Obsolète.

Se produit lorsque la NullText valeur change.

(Hérité de DataGridColumnStyle)
PropertyDescriptorChanged
Obsolète.

Se produit lorsque la valeur de propriété PropertyDescriptor change.

(Hérité de DataGridColumnStyle)
ReadOnlyChanged
Obsolète.

Se produit lorsque la valeur de propriété ReadOnly change.

(Hérité de DataGridColumnStyle)
WidthChanged
Obsolète.

Se produit lorsque la valeur de propriété Width change.

(Hérité de DataGridColumnStyle)

Implémentations d’interfaces explicites

Nom Description
IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)
Obsolète.

Informe le DataGrid contrôle que l’utilisateur a commencé à modifier la colonne.

(Hérité de DataGridColumnStyle)

S’applique à

Voir aussi