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

Définition

Obtient ou définit la remarque de cellule associée à la cellule située dans l'angle supérieur gauche du contrôle NamedRange.

public string NoteText (object Text, object Start, object Length);

Paramètres

Text
Object

Texte à ajouter à la remarque (255 caractères maximum). Le texte est inséré à partir de la position Start, remplaçant le nombre de caractères indiqué par 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 le nombre de caractères indiqué par Length.

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). 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.

Retours

String

Exemples

L’exemple de code suivant montre comment définir différentes caractéristiques de mise en forme et d’affichage d’un NamedRange contrôle nommé NamedRange1 . En particulier, cet exemple utilise la NoteText méthode pour ajouter une note à NamedRange1 avec le texte This is a Formatting test .

Cet exemple est destiné à une personnalisation au niveau du document.

private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test");
    namedRange1.Value2 = "Martha";
    namedRange1.Font.Name = "Verdana";
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
    namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic);
    namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
        true, false, true, false, true, true);

    if (MessageBox.Show("Clear the formatting and notes?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}
Private Sub SetRangeFormats()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.NoteText("This is a Formatting test", , )
    namedRange1.Value2 = "Martha"
    namedRange1.Font.Name = "Verdana"
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
    namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
        Excel.XlColorIndex.xlColorIndexAutomatic, )
    namedRange1.AutoFormat( _
        Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
        True, False, True, False, True, True)

    If MessageBox.Show("Clear the formatting and notes?", _
        "Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
        namedRange1.ClearFormats()
        namedRange1.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' Comment objet.

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 réutilisez-la 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.

S’applique à