PowerTools MultiRow for Windows Forms 8.0J
SetValue(Int32,Int32,Object) メソッド

セルのオーナー行の0から始まるインデックスを指定するSystem.Int32
セルのセルコレクション内での0から始まるインデックスを指定するSystem.Int32
セルに設定する新しい値を指定するSystem.Object
指定したセルに値を設定します。
構文
Public Overloads Sub SetValue( _
   ByVal rowIndex As Integer, _
   ByVal cellIndex As Integer, _
   ByVal value As Object _
) 
public void SetValue( 
   int rowIndex,
   int cellIndex,
   object value
)

パラメータ

rowIndex
セルのオーナー行の0から始まるインデックスを指定するSystem.Int32
cellIndex
セルのセルコレクション内での0から始まるインデックスを指定するSystem.Int32
value
セルに設定する新しい値を指定するSystem.Object
例外
例外解説
System.ArgumentOutOfRangeException

rowIndex0未満か、Rowの数 - 1を超えています。

または

cellIndex0未満か、RowCellの数 - 1を超えています。

解説

このメソッドは、指定されたセルのCell.Valueを、セルをインスタンス化せずに設定します。

セルおよび行のインスタンス化について:

既定では、GcMultiRowに含まれるすべてのCellRowはメモリを保有せず、その処理ロジックと描画はテンプレートRowおよびCellで実行されます。したがって、RowおよびCellで公開されているほとんどの仮想メソッドは、対応する処理ロジックを適切に実行できるように、SectionIndexパラメーターを受け取る必要があります。

一部の操作では、その実行後に特定のCellのデータを保存するため、該当するRowおよびCellをインスタンス化する必要があります(テンプレートとは異なるCellStyle.BackColorや、LinkLabelCellのLinkLabelCell.LinkVisitedプロパティなど)。RowまたはCellをインスタンス化するとより多くのメモリが必要となり、システムのパフォーマンスが低下する場合があるので、インスタンス化したメソッドやプロパティを使用することはできる限り避けてください。

以下のメソッド、プロパティ、またはアクションを使用すると、Rowがインスタンス化されます
CurrentRowプロパティを通じて現在の行にアクセスするとき
RowCollection.Itemプロパティを通じて特定の行にアクセスするとき
RowCollection.CopyToメソッドによってRowCollectionをコピーするとき
反復子(foreach)によってRowCollectionのメンバにアクセスするとき
ユーザーがデタッチされた行を通じて新しい行にアクセスするとき
ユーザーが[Ctrl]+[Del]キーを押して1つ以上の行を削除するとき
フィルタ関数によって1つ以上の行を非表示にするとき
1つのセルをインスタンス化すると、親行もインスタンス化される
以下のメソッド、プロパティ、またはアクションを使用すると、Cellがインスタンス化されます
CurrentCellプロパティを通じて現在のセルにアクセスするとき
Item(Int32,Int32)プロパティまたはItem(Int32,String)プロパティを通じて特定のセルにアクセスするとき
そのLinkLabelCell.TrackVisitedStateプロパティがtrueに設定された1つのLinkLabelCellをクリックするとき
以下のメソッドでは、CellまたはRowはインスタンス化されません
GetValue(Int32,Int32)メソッドまたはSetValue(Int32,Int32,Object)メソッドを呼び出すことによってCell.Valueを取得または設定するとき
GetFormattedValue(Int32,Int32)メソッドを呼び出すことによってCell.FormattedValueを取得するとき
GetEditedFormattedValue(Int32,Int32)メソッドを呼び出すことによってCell.EditedFormattedValueを取得するとき
CurrentCellプロパティまたはCurrentRowプロパティではなく、CurrentCellPositionプロパティにアクセスするとき
データソースを通じてデータを変更するとき

注意:上記のリストは、RowおよびCellのインスタンス化に関連するすべてのメソッドを示すものではありません。詳細については、個々のメソッドとプロパティの説明を参照してください。

参照

GcMultiRow クラス
GcMultiRow メンバ
オーバーロード一覧
GetValue(Int32,Int32) メソッド
GetValue(Int32,String) メソッド
Value プロパティ

 

 


© 2008-2015 GrapeCity inc. All rights reserved.