Condividi tramite


Metodo XmlMappedRange.NoteText

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

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String
string NoteText(
    Object Text,
    Object Start,
    Object Length
)

Parametri

  • Text
    Tipo: System.Object
    Testo da aggiungere alla nota (massimo 255 caratteri).Il testo viene inserito a partire dalla posizione Start e sostituisce i caratteri Length della nota esistente.Se si omette questo argomento, questo metodo restituirà il testo corrente della nota a partire dalla posizione Start per i caratteri Length.
  • Start
    Tipo: System.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
    Tipo: System.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 il numero di caratteri compresi tra la posizione Start e la fine della nota è superiore a 255, il metodo restituirà solo 255 caratteri.

Valore restituito

Tipo: System.String

Note

Le note della cella sono state sostituite dai commenti dell'intervallo.Per ulteriori informazioni, vedere l'oggetto Comment.

Per aggiungere una nota costituita da più di 255 caratteri, utilizzare questo metodo una volta per specificare i primi 255 caratteri, quindi utilizzarlo nuovamente per aggiungere il resto della nota (mai più di 255 caratteri alla volta).

Parametri facoltativi

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

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo NoteText per aggiungere una nota a un controllo XmlMappedRange. Viene quindi chiesto all'utente di rimuovere la nota utilizzando il metodo ClearNotes.Nell'esempio si presuppone che il foglio di lavoro corrente contenga un controllo XmlMappedRange denominato CustomerLastNameCell.

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

XmlMappedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel