NamedRange.Characters, propriété
Obtient un objet Microsoft.Office.Interop.Excel.Characters qui représente une plage de caractères dans le texte 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
ReadOnly Property Characters As NamedRange_CharactersType
NamedRange_CharactersType Characters { get; }
Valeur de propriété
Type : Microsoft.Office.Tools.Excel.NamedRange_CharactersType
Objet Microsoft.Office.Interop.Excel.Characters qui représente une plage de caractères dans le texte du contrôle NamedRange.
Notes
La propriété Characters doit être utilisée avec les paramètres suivants.
Paramètre |
Description |
|---|---|
Start |
Premier caractère à retourner.Si cet argument est 1 ou s'il est omis, cette propriété retourne une plage des caractères commençant par le premier caractère. |
Length |
Nombre de caractères à retourner.Si cet argument est omis, cette propriété retourne le reste de la chaîne (tout ce qui figure après le caractère Start). |
Si vous essayez d'utiliser Characters sans spécifier de paramètres, Characters obtiendra un objet NamedRange_CharactersType qui fait partie de l'infrastructure Visual Studio et n'est pas conçu pour être utilisé directement à partir de votre code.
Vous pouvez utiliser l'objet Microsoft.Office.Interop.Excel.Characters pour mettre en forme des caractères dans une chaîne de texte.L'objet Microsoft.Office.Interop.Excel.Characters n'est pas une collection.
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 crée un NamedRange et le remplit avec le mot "Smith".Il modifie ensuite le premier caractère du mot en le mettant en gras et lui affectant la taille 14.
Cette version est destinée à une personnalisation au niveau du document.
Private charactersRange As Microsoft.Office.Tools.Excel.NamedRange
Private Sub FormatCharacters()
charactersRange = Me.Controls.AddNamedRange( _
Me.Range("A1", "A1"), "charactersRange")
Me.charactersRange.Value2 = "Smith"
Me.charactersRange.Characters(1, 1).Font.Bold = True
Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub
Microsoft.Office.Tools.Excel.NamedRange charactersRange;
private void FormatCharacters()
{
charactersRange = this.Controls.AddNamedRange(
this.Range["A1", "A1"], "charactersRange");
this.charactersRange.Value2 = "Smith";
this.charactersRange.Characters[1, 1].Font.Bold = true;
this.charactersRange.Characters[1, 1].Font.Size = 14;
}
Cette version est destinée à un complément d'application.
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.