Proprietà NamedRange.Characters

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Excel.Characters che rappresenta un intervallo di caratteri all'interno del testo del controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Characters As NamedRange_CharactersType
    Get

NamedRange_CharactersType Characters { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Excel.NamedRange_CharactersType
Oggetto Microsoft.Office.Interop.Excel.Characters che rappresenta un intervallo di caratteri all'interno del testo del controllo NamedRange.

Note

La proprietà Characters deve essere utilizzata con i parametri riportati di seguito.

Parametro	Oggetto di descrizione
Start	Primo carattere da restituire. Se questo argomento è impostato su 1 oppure viene omesso, questa proprietà restituirà un intervallo di caratteri che inizia con il primo carattere.
Length	Numero di caratteri da restituire. Se questo argomento viene omesso, la proprietà restituirà il resto della stringa, ovvero tutti i caratteri successivi a Start.

Se si tenta di utilizzare Characters senza specificare alcun parametro, Characters otterrà un oggetto NamedRange_CharactersType che fa parte dell'infrastruttura di Visual Studio e non può essere utilizzato direttamente dal codice.

È possibile utilizzare l'oggetto Microsoft.Office.Interop.Excel.Characters per formattare i caratteri all'interno di una stringa di testo. L'oggetto Microsoft.Office.Interop.Excel.Characters non è un insieme.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene creato un controllo NamedRange, successivamente compilato con la parola Smith. Il primo carattere della parola viene quindi modificato applicando la formattazione in grassetto e impostandone la dimensione su 14 punti.

Questa versione è valida per una personalizzazione a livello di documento.

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

Questa versione è valida per un componente aggiuntivo a livello di applicazione.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite