NamedRange.NoteText, méthode

Article
05/16/2013

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

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 illustre la définition de diverses caractéristiques de mise en forme et d'affichage d'un contrôle NamedRange appelé NamedRange1.Cet exemple utilise en particulier la méthode NoteText pour ajouter une remarque à NamedRange1 avec le texte This is a Formatting test.

Cet exemple illustre une personnalisation au niveau du document.

' <Snippet36>
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

' </Snippet35>

// <Snippet36>
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();
    }
}
// </Snippet35>

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

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via