Metodo XmlMappedRange.NoteText

Articolo
08/11/2011

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.", missing, missing);

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

XmlMappedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite