XmlMappedRange.NoteText(Object, Object, Object) Metodo

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Ottiene o imposta la nota della cella associata al controllo XmlMappedRange.

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

Parametri

Text

Object

Testo da aggiungere alla nota (massimo 255 caratteri). Il testo viene inserito a partire dalla posizione Start, sostituendo Length i caratteri della nota esistente. Se questo argomento viene omesso, questo metodo restituisce il testo corrente della nota a partire dalla posizione Start, per Length i caratteri.

Start

Object

Posizione iniziale del testo impostato o restituito. Se si omette questo argomento, questo metodo verrà avviato in corrispondenza del primo carattere. Per aggiungere testo alla nota, specificare un numero superiore al numero di caratteri inclusi nella nota esistente.

Length

Object

Numero di caratteri da impostare o da restituire. Se si omette questo argomento, in Microsoft Office Excel verranno impostati o restituiti caratteri dalla posizione iniziale fino alla fine della nota (massimo 255 caratteri). Se sono presenti più di 255 caratteri dalla Start fine della nota, questo metodo restituisce solo 255 caratteri.

Restituisce

String

Esempio

Nell'esempio di codice seguente viene usato il NoteText metodo per aggiungere una nota a un oggetto XmlMappedRange , quindi viene richiesto all'utente di rimuovere la nota usando il ClearNotes metodo. In questo esempio di codice si presuppone che il foglio di codice corrente contenga un oggetto XmlMappedRange denominato CustomerLastNameCell .

private void SetNote()
{
    this.CustomerLastNameCell.NoteText("This cell contains customer " +
        "last names.");

    if (MessageBox.Show("Remove the note?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearNotes();
    }
}

Private Sub SetNote()
    Me.CustomerLastNameCell.NoteText("This cell contains customer " & _
        "last names.")

    If MessageBox.Show("Remove the note?", "Test", MessageBoxButtons.YesNo) = _
        DialogResult.Yes Then
        Me.CustomerLastNameCell.ClearNotes()
    End If
End Sub

Commenti

Le note delle celle sono state sostituite dai commenti di intervallo. Per ulteriori informazioni, vedere l' Comment oggetto.

Per aggiungere una nota contenente più di 255 caratteri, utilizzare questo metodo una volta per specificare i primi 255 caratteri, quindi utilizzarlo di nuovo per aggiungere la parte rimanente della nota (non più di 255 caratteri alla volta).

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.