Propriedade NamedRange.Characters

Artigo
08/01/2011

Obtém um Microsoft.Office.Interop.Excel.Characters o objeto que representa um intervalo de caracteres dentro do texto da NamedRange de controle.

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

Sintaxe

'Declaração
ReadOnly Property Characters As NamedRange_CharactersType
    Get

NamedRange_CharactersType Characters { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_CharactersType
A Microsoft.Office.Interop.Excel.Characters o objeto que representa um intervalo de caracteres dentro do texto da NamedRange de controle.

Comentários

O Characters propriedade destina-se a ser usado com os seguintes parâmetros.

Parameter	Description
Start	O primeiro caractere a ser retornado. Se esse argumento for 1 ou omitido, essa propriedade retornará um intervalo de caracteres começando com o primeiro caractere.
Length	O número de caracteres a ser retornado. Se esse argumento for omitido, essa propriedade retornará o restante da seqüência (tudo após o Start caracteres).

Se você tentar usar Characters sem especificar quaisquer parâmetros, Characters obterá uma NamedRange_CharactersType o objeto que é parte da infra-estrutura de Visual Studio e não se destina a ser usado diretamente em seu código.

Você pode usar o Microsoft.Office.Interop.Excel.Characters o objeto para formatar caracteres dentro de uma seqüência de caracteres de texto. O Microsoft.Office.Interop.Excel.Characters o objeto é não uma coleção.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria um NamedRange e a preenche com a palavra Smith. Em seguida, ele altera o primeiro caractere da palavra tornando-o em negrito e definindo o tamanho 14.

Esta versão é para uma personalização em nível de 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;
}

Esta versão é um suplemento em nível de aplicativo.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via