NamedRange.Characters (Propiedad)
Obtiene un objeto Microsoft.Office.Interop.Excel.Characters que representa un intervalo de caracteres dentro del texto del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
ReadOnly Property Characters As NamedRange_CharactersType
Get
NamedRange_CharactersType Characters { get; }
Valor de propiedad
Tipo: Microsoft.Office.Tools.Excel.NamedRange_CharactersType
Objeto Microsoft.Office.Interop.Excel.Characters que representa un intervalo de caracteres dentro del texto del control NamedRange.
Comentarios
La propiedad Characters está pensada para utilizarse con los parámetros siguientes.
Parámetro |
Descripción |
|---|---|
Start |
El primer carácter que se devolverá. Si el argumento es 1 o se omite, esta propiedad devuelve un intervalo de caracteres que empieza por el primer carácter. |
Length |
Número de caracteres que se devolverán. Si se omite el argumento, esta propiedad devuelve el resto de la cadena (todo lo que figura después del carácter Start). |
Si intenta usar Characters sin especificar parámetros, Characters obtendrá un objeto NamedRange_CharactersType que forma parte de la infraestructura de Visual Studio y que no está diseñado para usarlo directamente en el código.
Puede utilizar el objeto Microsoft.Office.Interop.Excel.Characters para dar formato a los caracteres dentro de una cadena de texto. El objeto Microsoft.Office.Interop.Excel.Characters no es una colección.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente crea un NamedRange y lo rellena con la palabra Smith. Cambia, a continuación, el primer carácter de la palabra aplicándole formato de negrita y estableciendo el tamaño en 14 puntos.
Se trata de una versión para una personalización en el nivel del 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;
}
Se trata de una versión para un complemento en el nivel de la aplicación.
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;
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.