NamedRange.NoteText(Object, Object, Object) Méthode
Définition
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);
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
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.