NamedRange.NoteText(Object, Object, Object) Metode

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Excel

Rakitan:: Microsoft.Office.Tools.Excel.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur catatan sel yang terkait dengan sel di sudut kiri atas NamedRange kontrol.

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

Parameter

Text: Object

Teks yang akan ditambahkan ke catatan (hingga 255 karakter). Teks disisipkan mulai dari posisi Start, mengganti Length karakter catatan yang ada. Jika argumen ini dihilangkan, metode ini mengembalikan teks catatan saat ini yang dimulai dari posisi Start, untuk Length karakter.

Start: Object

Posisi awal untuk teks yang diatur atau dikembalikan. Jika argumen ini dihilangkan, metode ini dimulai pada karakter pertama. Untuk menambahkan teks ke catatan, tentukan angka yang lebih besar dari jumlah karakter dalam catatan yang ada.

Length: Object

Jumlah karakter yang akan diatur atau dikembalikan. Jika argumen ini dihilangkan, Microsoft Office Excel mengatur atau mengembalikan karakter dari posisi awal hingga akhir catatan (hingga 255 karakter). Jika ada lebih dari 255 karakter dari Start hingga akhir catatan, metode ini hanya mengembalikan 255 karakter.

Mengembalikan

String

Contoh

Contoh kode berikut menunjukkan cara mengatur berbagai karakteristik NamedRange pemformatan dan tampilan kontrol bernama NamedRange1. Secara khusus, contoh ini menggunakan NoteText metode untuk menambahkan catatan dengan NamedRange1 teks This is a Formatting test.

Contoh ini untuk kustomisasi tingkat dokumen.

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

Keterangan

Catatan sel telah digantikan oleh komentar rentang. Untuk informasi selengkapnya, lihat Comment objek .

Untuk menambahkan catatan yang berisi lebih dari 255 karakter, gunakan metode ini sekali untuk menentukan 255 karakter pertama, lalu gunakan lagi untuk menambahkan sisa catatan (tidak lebih dari 255 karakter sekaligus).

Parameter Opsional

Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.

Berlaku untuk

Bagikan melalui