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

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 à partir de 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 montre comment définir diverses 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 concerne 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’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.

S’applique à

Share via