NamedRange.Characters, propriété

Article
08/10/2011

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
    Get

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.

Private charactersRange As NamedRange

Private Sub FormatCharacters()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    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 =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]); ;
    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;
}

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