DataGridTextBoxColumn クラス

定義

文字列の編集に使用する、TextBox のセル内の DataGridColumnStyle コントロールをホストします。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
継承

次の例では、DataGridTextBoxColumn を作成し、それを DataGridGridColumnStylesCollection に追加します。The following example creates a DataGridTextBoxColumn and adds it to the GridColumnStylesCollection of a DataGrid. このコード例を実行するには、dataGrid1 という名前の DataGrid を持つフォームに貼り付け、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

注釈

DataGridTextBoxColumn クラスは、abstract クラス DataGridColumnStyleから派生します。The DataGridTextBoxColumn class derives from the abstract class DataGridColumnStyle. 実行時に、DataGridTextBoxColumn は、ユーザーがテキストを編集できるようにする DataGridTextBox コントロールをホストします。At run time, the DataGridTextBoxColumn hosts a DataGridTextBox control that allows users to edit text.

クラスに追加された特殊なプロパティには、Format、および HideEditBoxがあります。Special properties added to the class include Format, and HideEditBox. これらのプロパティを使用すると、ホストされている DataGridTextBox コントロールとその属性にアクセスし、値の表示形式を設定できます。These properties allow you to access the hosted DataGridTextBox control and its attributes, and set the format for displaying values.

データソースが DataColumn オブジェクトを含む DataTable の場合、DataColumnDataType プロパティは、テキストボックスコントロールで論理的に編集できるデータ型に設定する必要があります。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. 次のデータ型は、DataGridTextBoxColumn (ByteDateTimeDecimalDoubleInt16Int32Int64UInt16UInt32UInt64SingleString) に自動的に関連付けられます。The following data types are automatically associated with a DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, and String.

注意

次の型は Visual Basic によって完全にはサポートされていません: DateTimeUInt16UInt32UInt64、および TimeSpanThe following types are not fully supported by Visual Basic: DateTime, UInt16, UInt32, UInt64, and TimeSpan. (演算子は使用できません)。(Operators are not allowed.)

コンストラクター

DataGridTextBoxColumn() DataGridTextBoxColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridTextBoxColumn class.
DataGridTextBoxColumn(PropertyDescriptor)

DataGridTextBoxColumn を指定して、PropertyDescriptor の新しいインスタンスを初期化します。Initializes a new instance of a DataGridTextBoxColumn with a specified PropertyDescriptor.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)

指定した DataGridTextBoxColumn を使用して PropertyDescriptor クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridTextBoxColumn class using the specified PropertyDescriptor. DataGridTextBoxColumn が既定の列かどうかを指定します。Specifies whether the DataGridTextBoxColumn is a default column.

DataGridTextBoxColumn(PropertyDescriptor, String)

DataGridTextBoxColumn および書式を指定して、PropertyDescriptor の新しいインスタンスを初期化します。Initializes a new instance of a DataGridTextBoxColumn with the specified PropertyDescriptor and format.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)

指定した DataGridTextBoxColumn と書式を使用して、PropertyDescriptor クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridTextBoxColumn class with a specified PropertyDescriptor and format. 列が既定の列かどうかを指定します。Specifies whether the column is the default column.

プロパティ

Alignment

列内のテキストの配置について値を取得または設定します。Gets or sets the alignment of text in a column.

(継承元 DataGridColumnStyle)
CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
DataGridTableStyle

列の DataGridTableStyle を取得します。Gets the DataGridTableStyle for the column.

(継承元 DataGridColumnStyle)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
FontHeight

列のフォントの高さを取得します。Gets the height of the column's font.

(継承元 DataGridColumnStyle)
Format

テキストの書式指定方法を指定する 1 文字以上の文字を取得または設定します。Gets or sets the character(s) that specify how text is formatted.

FormatInfo

値の書式指定方法を決定するために使用する、カルチャ固有の情報を取得または設定します。Gets or sets the culture specific information used to determine how values are formatted.

HeaderAccessibleObject

列の AccessibleObject を取得します。Gets the AccessibleObject for the column.

(継承元 DataGridColumnStyle)
HeaderText

列ヘッダーのテキストを取得または設定します。Gets or sets the text of the column header.

(継承元 DataGridColumnStyle)
MappingName

列スタイルの割り当て先のデータ メンバーの名前を取得または設定します。Gets or sets the name of the data member to map the column style to.

(継承元 DataGridColumnStyle)
NullText

列が null を格納している場合に表示されるテキストを取得または設定します。Gets or sets the text that is displayed when the column contains null.

(継承元 DataGridColumnStyle)
PropertyDescriptor

PropertyDescriptorDataGridTextBoxColumn を取得または設定します。Gets or sets the PropertyDescriptor for the DataGridTextBoxColumn.

ReadOnly

テキスト ボックスの列が読み取り専用かどうかを示す値を設定します。Sets a value indicating whether the text box column is read-only.

Site

ISiteComponent を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
TextBox

ホストされている TextBox コントロールを取得します。Gets the hosted TextBox control.

Width

列の幅を取得または設定します。Gets or sets the width of the column.

(継承元 DataGridColumnStyle)

メソッド

Abort(Int32)

編集プロシージャを中断する要求を実行します。Initiates a request to interrupt an edit procedure.

BeginUpdate()

EndUpdate() メソッドが呼び出されるまで、列の描画を中断します。Suspends the painting of the column until the EndUpdate() method is called.

(継承元 DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)

DataGrid が有効なデータ ソースを保持していない場合、またはこの列がデータ ソースの有効なプロパティにマップされていない場合は、例外がスローされます。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.

(継承元 DataGridColumnStyle)
ColumnStartedEditing(Control)

ユーザーが列の編集を開始したことを DataGrid に通知します。Informs the DataGrid that the user has begun editing the column.

(継承元 DataGridColumnStyle)
Commit(CurrencyManager, Int32)

編集プロシージャを完了する要求を実行します。Initiates a request to complete an editing procedure.

ConcedeFocus()

フォーカスが与えられたことを列に通知します。Informs the column that the focus is being conceded.

CreateHeaderAccessibleObject()

列の AccessibleObject を取得します。Gets the AccessibleObject for the column.

(継承元 DataGridColumnStyle)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(継承元 Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)

編集するためにセルを準備します。Prepares a cell for editing.

(継承元 DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)

指定した CurrencyManager、行番号、および Rectangle パラメーターを使用して、編集するためにセルを準備します。Prepares the cell for editing using the specified CurrencyManager, row number, and Rectangle parameters.

(継承元 DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)

編集するためにセルを準備します。Prepares a cell for editing.

EndEdit()

DataGridColumnStyle の編集操作を終了します。Ends an edit operation on the DataGridColumnStyle.

EndUpdate()

BeginUpdate() メソッドを呼び出して中断されていた列の描画を再開します。Resumes the painting of columns suspended by calling the BeginUpdate() method.

(継承元 DataGridColumnStyle)
EnterNullValue()

Value を列に入力します。Enters a Value in the column.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetColumnValueAtRow(CurrencyManager, Int32)

指定した CurrencyManager から、指定した行の値を取得します。Gets the value in the specified row from the specified CurrencyManager.

(継承元 DataGridColumnStyle)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetMinimumHeight()

DataGridColumnStyle のセルの高さを取得します。Gets the height of a cell in a DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)

列のサイズを自動的に変更するために使用する高さを取得します。Gets the height to be used in for automatically resizing columns.

GetPreferredSize(Graphics, Object)

指定した値を基準にして、指定した行のセルの最適な幅および高さを返します。Returns the optimum width and height of the cell in a specified row relative to the specified value.

GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
HideEditBox()

DataGridTextBox コントロールを非表示にして、フォーカスを DataGrid コントロールに移します。Hides the DataGridTextBox control and moves the focus to the DataGrid control.

InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
Invalidate()

列を再描画し、描画メッセージがコントロールに送信されます。Redraws the column and causes a paint message to be sent to the control.

(継承元 DataGridColumnStyle)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)

指定した DataGridColumnStyleGraphicsRectangle、および行番号を使用して CurrencyManager を描画します。Paints the a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, and row number.

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

指定した DataGridColumnStyleGraphicsRectangle、行番号、および配置を使用して CurrencyManager を描画します。Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, and alignment.

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

指定した DataGridColumnStyleGraphicsRectangle、行番号、CurrencyManager、および前景色を使用して Brush を描画します。Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, Brush, and foreground color.

PaintText(Graphics, Rectangle, String, Boolean)

指定した位置に、テキストと四角形を指定した配置で描画します。Draws the text and rectangle at the given location with the specified alignment.

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

指定した位置に、テキストと四角形を指定した色と配置で描画します。Draws the text and rectangle at the specified location with the specified colors and alignment.

ReleaseHostedControl()

DataGrid が保持している、データの編集に使用されるコントロールへの参照を削除します。Removes the reference that the DataGrid holds to the control used to edit data.

ResetHeaderText()

HeaderText を既定値 null にリセットします。Resets the HeaderText to its default value, null.

(継承元 DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)

指定した CurrencyManager からの値を使用して、指定した行の値を設定します。Sets the value in a specified row with the value from a specified CurrencyManager.

(継承元 DataGridColumnStyle)
SetDataGrid(DataGrid)

この列が属する DataGrid コントロールを設定します。Sets the DataGrid control that this column belongs to.

(継承元 DataGridColumnStyle)
SetDataGridInColumn(DataGrid)

TextBox コントロールを DataGrid コントロールの Control.ControlCollection に追加します。Adds a TextBox control to the DataGrid control's Control.ControlCollection.

ToString()

String の名前 (存在する場合) を格納する Component を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(継承元 Component)
UpdateUI(CurrencyManager, Int32, String)

ユーザー インターフェイスを更新します。Updates the user interface.

イベント

AlignmentChanged

Alignment プロパティの値が変化すると発生します。Occurs when the Alignment property value changes.

(継承元 DataGridColumnStyle)
Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)
FontChanged

列のフォントが変更されたときに発生します。Occurs when the column's font changes.

(継承元 DataGridColumnStyle)
HeaderTextChanged

HeaderText プロパティの値が変化すると発生します。Occurs when the HeaderText property value changes.

(継承元 DataGridColumnStyle)
MappingNameChanged

MappingName 値が変更されたときに発生します。Occurs when the MappingName value changes.

(継承元 DataGridColumnStyle)
NullTextChanged

NullText 値が変更されたときに発生します。Occurs when the NullText value changes.

(継承元 DataGridColumnStyle)
PropertyDescriptorChanged

PropertyDescriptor プロパティの値が変化すると発生します。Occurs when the PropertyDescriptor property value changes.

(継承元 DataGridColumnStyle)
ReadOnlyChanged

ReadOnly プロパティの値が変化すると発生します。Occurs when the ReadOnly property value changes.

(継承元 DataGridColumnStyle)
WidthChanged

Width プロパティの値が変化すると発生します。Occurs when the Width property value changes.

(継承元 DataGridColumnStyle)

明示的なインターフェイスの実装

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

ユーザーが列の編集を開始したことを DataGrid コントロールに通知します。Informs the DataGrid control that the user has begun editing the column.

(継承元 DataGridColumnStyle)

適用対象

こちらもご覧ください