XmlMappedRange.NoteText(Object, Object, Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Obtient ou définit la remarque de cellule associée au contrôle 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

Paramètres

Text

Object

Texte à ajouter à la remarque (255 caractères maximum). Le texte est inséré à partir de la position Start, en remplaçant les Length caractères de la note existante. Si cet argument est omis, cette méthode retourne le texte actuel de la note en commençant à la position Start, pour les Length caractères.

Start

Object

Position de départ du texte défini ou retourné. Si cet argument est omis, cette méthode commence au premier caractère. Pour ajouter un texte à la remarque, spécifiez un nombre supérieur au nombre de caractères de la remarque existante.

Length

Object

Nombre de caractères à définir ou à retourner. Si cet argument est omis, Microsoft Office Excel définit ou retourne des caractères à partir de la position de départ jusqu'à la fin de la remarque (255 caractères au maximum). S’il y a plus de 255 caractères de Start la fin de la note, cette méthode ne retourne que 255 caractères.

Retours

String

Exemples

L’exemple de code suivant utilise la NoteText méthode pour ajouter une note à un XmlMappedRange, puis invite l’utilisateur à supprimer la note à l’aide de la ClearNotes méthode . Cet exemple de code suppose que la feuille de calcul actuelle contient un XmlMappedRange nommé 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

Remarques

Les notes de cellule ont été remplacées par des commentaires de plage. Pour plus d’informations, consultez l’objet Comment .

Pour ajouter une note contenant plus de 255 caractères, utilisez cette méthode une fois pour spécifier les 255 premiers caractères, puis utilisez-la à nouveau pour ajouter le reste de la note (pas plus de 255 caractères à la fois).

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.