NamedRange.Columns プロパティ
NamedRange コントロール内の 1 つ以上の列を表す Microsoft.Office.Interop.Excel.Range コレクションを取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Columns As Range
Range Columns { get; }
プロパティ値
型 : Microsoft.Office.Interop.Excel.Range
NamedRange コントロール内の 1 つ以上の列を表す Microsoft.Office.Interop.Excel.Range。
解説
このプロパティは、パラメーターなしで使用されるとき、名前付き範囲内のすべての列を含む Range オブジェクトを返します。
このプロパティは、次の省略可能なパラメーターで名前付き範囲の特定の列を取得するために使用できます。パラメーターを指定してこのプロパティを使用する場合、戻り値は、Range にキャストする必要があるオブジェクトです。
パラメーター |
説明 |
---|---|
RowIndex |
取得する 1 つ以上の列のインデックス。 1 つの列を取得するには、このパラメーターに次のオブジェクトのいずれかを渡します。
連続した複数の列を取得するには、"first column letter:last column letter" という形式の文字列を渡します。たとえば、列 A ~ E を取得するには、"A:E" を渡します。
メモ
このパラメーターの名前は誤解しやすい名前です。このパラメーターは、行でなく、取得する列のインデックスを指定します。
|
ColumnIndex |
このパラメーターは使用しないでください。このパラメーターに値を渡そうとすると、このプロパティは COMException をスローします。 |
例
次のコード例は、NamedRange を作成し、Columns プロパティを使用して、範囲内の最初の列のすべてのセルのフォントの色、名前、サイズ、太字の濃さを設定します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。このコードを実行するには、プロジェクト内のワークシート クラスの 1 つにコピーします。
Private Sub SetFirstColumnFont()
Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
"TestRange")
testRange.Select()
Dim fillColumn As Excel.Range = TryCast(testRange.Columns("A"), Excel.Range)
With fillColumn.Font
' Set the font color to blue (RGB value 00 00 FF), and set other font properties.
.Color = &HFF0000
.Name = "Arial"
.Size = 14
.Bold = False
End With
' Test the changes by writing a value to all the column cells.
fillColumn.Value2 = "This is a test"
End Sub
private void SetFirstColumnFont()
{
Microsoft.Office.Tools.Excel.NamedRange testRange =
this.Controls.AddNamedRange(this.Range["A1", "J10"],
"TestRange");
testRange.Select();
Excel.Range fillColumn = (Excel.Range)testRange.Columns["A"];
Excel.Font columnsFont = fillColumn.Font;
// Set the font color to blue (RGB value 00 00 FF), and set other font properties.
columnsFont.Color = 0xFF0000;
columnsFont.Name = "Arial";
columnsFont.Size = 14;
columnsFont.Bold = false;
// Test the changes by writing a value to all the column cells.
fillColumn.Value2 = "This is a test";
}
次のコード例は、NamedRange を作成し、Columns プロパティを使用して、範囲内に存在する列の数を判断します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。このコードを実行するには、プロジェクト内のワークシート クラスの 1 つにコピーします。
Private compositeRange As Microsoft.Office.Tools.Excel.NamedRange
Private Sub DisplayRangeComposition()
compositeRange = Me.Controls.AddNamedRange( _
Me.Range("B2", "E5"), "compositeRange")
compositeRange.Cells.Interior.Color = &HFF00
MessageBox.Show("The range has " & _
compositeRange.Count & " cells.")
MessageBox.Show("The range has " & _
compositeRange.Columns.Count & " columns.")
MessageBox.Show("The range has " & _
compositeRange.Rows.Count & " rows.")
End Sub
Microsoft.Office.Tools.Excel.NamedRange compositeRange;
private void DisplayRangeComposition()
{
compositeRange = this.Controls.AddNamedRange(
this.Range["B2", "E5"], "compositeRange");
compositeRange.Cells.Interior.Color = 0xFF00;
MessageBox.Show("The range has " + compositeRange.Count +
" cells.");
MessageBox.Show("The range has " +
compositeRange.Columns.Count + " columns.");
MessageBox.Show("The range has " +
compositeRange.Rows.Count + " rows.");
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。