XmlMappedRange.NoteText, méthode

Article
05/16/2013

Obtient ou définit la remarque de cellule associée au contrôle XmlMappedRange.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

string NoteText(
    Object Text,
    Object Start,
    Object Length
)

Paramètres

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

Start
Type : System.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
Type : System.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).Si le nombre de caractères compris entre Start et la fin de la remarque est supérieur à 255, cette méthode retourne uniquement 255 caractères.

Valeur de retour

Type : System.String

Notes

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

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

Paramètres optionnels

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

Exemples

L'exemple de code suivant utilise la méthode NoteText pour ajouter une remarque à XmlMappedRange, puis invite l'utilisateur à supprimer celle-ci à l'aide de la méthode ClearNotes.Cet exemple de code suppose que la feuille de calcul active contient un contrôle XmlMappedRange nommé 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();
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XmlMappedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via