NamedRange.Characters-Eigenschaft

Artikel
08/10/2011

Ruft ein Microsoft.Office.Interop.Excel.Characters-Objekt ab, das einen Bereich von Zeichen im Text des NamedRange-Steuerelements darstellt.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Characters As NamedRange_CharactersType
    Get

NamedRange_CharactersType Characters { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Excel.NamedRange_CharactersType
Ein Microsoft.Office.Interop.Excel.Characters-Objekt, das einen Bereich von Zeichen im Text des NamedRange-Steuerelements darstellt.

Hinweise

Die Characters-Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.

Parameter	Beschreibungen
Start	Das erste Zeichen, das zurückgegeben werden soll. Wenn dieses Argument über den Wert 1 verfügt oder weggelassen wird, gibt diese Eigenschaft einen Bereich von Zeichen zurück, der mit dem ersten Zeichen beginnt.
Length	Die Anzahl von Zeichen, die zurückgegeben werden soll. Wenn dieses Argument weggelassen wurde, gibt diese Eigenschaft die restliche Zeichenfolge zurück (jedes Zeichen nach dem Start-Zeichen).

Wenn Sie versuchen, Characters zu verwenden, ohne Parameter anzugeben, ruft Characters ein NamedRange_CharactersType-Objekt ab, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.

Sie können das Microsoft.Office.Interop.Excel.Characters-Objekt verwenden, um Zeichen innerhalb einer Textzeichenfolge zu formatieren. Das Microsoft.Office.Interop.Excel.Characters-Objekt ist keine Auflistung.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt und mit dem Wort "Smith" aufgefüllt. Anschließend wird das erste Zeichen des Worts geändert, indem es fett formatiert und seine Größe auf 14 festgelegt wird.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene.

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;
}

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.

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;
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via