NamedRange.Characters, propriété (System 2007)

Mise à jour : Juillet 2008

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.v9.0 (dans Microsoft.Office.Tools.Excel.v9.0.dll)

Syntaxe

<BrowsableAttribute(False)> _
Public ReadOnly Property Characters As NamedRange..::._CharactersType

Dim instance As NamedRange
Dim value As NamedRange..::._CharactersType

value = instance.Characters

[BrowsableAttribute(false)]
public 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.

Si vous essayez d'utiliser Characters sans spécifier de paramètres, Characters obtient un objet NamedRange._CharactersType qui fait partie de l'infrastructure de Visual Studio Tools pour Office 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 Fonctionnement des 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.

Private charactersRange As NamedRange

Private Sub FormatCharacters()
    Dim vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    charactersRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.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

NamedRange charactersRange;
private void FormatCharacters()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    charactersRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", "A1"], "charactersRange");
    charactersRange.Value2 = "Smith";
    charactersRange.Characters[1, 1].Font.Bold = true;
    charactersRange.Characters[1, 1].Font.Size = 14;
}

Autorisations

• 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, classe

Membres NamedRange

Microsoft.Office.Tools.Excel, espace de noms

Historique des modifications