次の方法で共有


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 セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

NamedRange インターフェイス

Microsoft.Office.Tools.Excel 名前空間