NamedRange.NoteText(Object, Object, Object) メソッド

定義

名前空間:

Microsoft.Office.Tools.Excel

アセンブリ:

Microsoft.Office.Tools.Excel.dll

NamedRange コントロールの左上隅のセルに関連付けられるメモを取得または設定します。

public string NoteText (object Text, object Start, object Length);

abstract member NoteText : obj * obj * obj -> string

Public Function NoteText (Optional Text As Object, Optional Start As Object, Optional Length As Object) As String

パラメーター

Text

Object

メモに追加するテキスト (最大 255 文字) です。 テキストは、既存のノートの文字を置き換えるLength位置Startから挿入されます。 この引数を省略した場合、このメソッドは文字の位置 Startから始まるノートの現在のテキストを Length 返します。

Start

Object

設定または返すテキストの開始位置です。 この引数を省略した場合、最初の文字から開始されます。 メモにテキストを追加するには、既存のメモの文字数より大きな数値を指定します。

Length

Object

設定または返す文字数です。 この引数を省略した場合、Microsoft Office Excel は、開始位置からメモの末尾までの文字 (最大 255 文字) を設定または返します。 ノートの末尾から Start 末尾までの文字数が 255 文字を超える場合、このメソッドは 255 文字のみを返します。

戻り値

String

例

次のコード例では、 という名前NamedRange1のコントロールのさまざまな書式設定と表示特性を設定する方法をNamedRange示します。 特に、この例では、 メソッドを NoteText 使用して、 というテキストで に NamedRange1 メモを追加します This is a Formatting test。

この例は、ドキュメント レベルのカスタマイズ用です。

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();
    }
}

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

注釈

セルノートは範囲コメントに置き換えられました。 詳細については、 オブジェクトを Comment 参照してください。

255 文字を超えるメモを追加するには、このメソッドを 1 回使用して最初の 255 文字を指定し、もう一度使用してメモの残りの部分を追加します (一度に 255 文字以内)。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。