Propriedade NamedRange.Characters

Artigo
01/09/2014

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

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

NamedRange_CharactersType Characters { get; }

Valor de propriedade

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

Comentários

A propriedade de Characters destina-se a ser usada com os seguintes parâmetros.

Parâmetro	Descrição
Start	O primeiro caractere a ser retornado. Se esse argumento é 1 ou omitido, essa propriedade retorna um intervalo de caracteres que começam com o primeiro caractere.
Length	O número de caracteres a serem retornados. Se esse argumento é omitido, essa propriedade retorna o restante da cadeia de caracteres (tudo após o caractere de Start ).

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

Você pode usar o objeto de Microsoft.Office.Interop.Excel.Characters a caracteres de formato dentro de uma cadeia de caracteres de texto. O objeto de Microsoft.Office.Interop.Excel.Characters não é uma coleção.

Parâmetros Opcionais

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

Exemplos

O exemplo de código a seguir cria NamedRange e preenchê-los com a palavra Smith. Altera ao primeiro caractere na palavra fazendo as negrito e definindo o tamanho para 14.

Esta é uma versão para personalização de um documento nível.

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 é para um suplemento ao aplicativo.

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ável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via