NamedRange.NoteText メソッド
NamedRange コントロールの左上隅のセルに関連付けられるメモを取得または設定します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
Function NoteText ( _
Text As Object, _
Start As Object, _
Length As Object _
) As String
string NoteText(
Object Text,
Object Start,
Object Length
)
パラメーター
- Text
型 : System.Object
メモに追加するテキスト (最大 255 文字) です。テキストは、Start の位置から挿入され、既存のメモの Length 文字が置き換えられます。この引数を省略した場合、このメソッドは、メモの現在のテキストを、Start の位置から Length 文字分返します。
- Start
型 : System.Object
設定または返すテキストの開始位置です。この引数を省略した場合、最初の文字から開始されます。メモにテキストを追加するには、既存のメモの文字数より大きな数値を指定します。
- Length
型 : System.Object
設定または返す文字数です。この引数を省略した場合、Microsoft Office Excel は、開始位置からメモの末尾までの文字 (最大 255 文字) を設定または返します。 Start からメモの末尾までが 255 文字を超える場合、このメソッドは 255 文字のみを返します。
戻り値
型 : System.String
解説
セルのメモは範囲のコメントに置き換えられました。詳細については、「Comment オブジェクト」を参照してください。
255 文字を超えるメモを追加するには、このメソッドを 1 回使用して最初の 255 文字を指定し、再度使用して残りを追加します (1 回の追加が 255 文字以下となるようにします)。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
NamedRange1 という名前の NamedRange コントロールの書式設定および表示特性を設定するためのコード例を次に示します。この例では、NoteText メソッドを使用して、This is a Formatting test というテキストを持つメモを NamedRange1 に追加します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
' <Snippet36>
Private Sub SetRangeFormats()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
namedRange1.NoteText("This is a Formatting test", , )
namedRange1.Value2 = "Martha"
namedRange1.Font.Name = "Verdana"
namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
Excel.XlColorIndex.xlColorIndexAutomatic, )
namedRange1.AutoFormat( _
Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
True, False, True, False, True, True)
If MessageBox.Show("Clear the formatting and notes?", _
"Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
namedRange1.ClearFormats()
namedRange1.ClearNotes()
End If
End Sub
' </Snippet35>
// <Snippet36>
private void SetRangeFormats()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
namedRange1.NoteText("This is a Formatting test");
namedRange1.Value2 = "Martha";
namedRange1.Font.Name = "Verdana";
namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick,
Excel.XlColorIndex.xlColorIndexAutomatic);
namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
true, false, true, false, true, true);
if (MessageBox.Show("Clear the formatting and notes?", "Test",
MessageBoxButtons.YesNo) == DialogResult.Yes)
{
namedRange1.ClearFormats();
namedRange1.ClearNotes();
}
}
// </Snippet35>
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。