NamedRange.NoteText (Método)
Obtiene o establece la nota de la celda asociada a la celda de la esquina superior izquierda del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function NoteText ( _
Text As Object, _
Start As Object, _
Length As Object _
) As String
string NoteText(
Object Text,
Object Start,
Object Length
)
Parámetros
- Text
Tipo: System.Object
Texto que se va a agregar a la nota (hasta 255 caracteres).El texto se inserta a partir de la posición Start y reemplaza tantos caracteres de la nota existente como se establece en Length.Si se omite este argumento, este método devuelve el texto actual de la nota a partir de la posición Start, con el número de caracteres establecido por Length.
- Start
Tipo: System.Object
Posición de inicio del texto que se establece o devuelve.Si se omite este argumento, este método empieza por el primer carácter.Para anexar el texto a la nota, especifique un número mayor que el número de caracteres de la nota existente.
- Length
Tipo: System.Object
Número de caracteres que se va a establecer o devolver.Si se omite este argumento, Microsoft Office Excel establece o devuelve caracteres desde la posición de inicio hasta el final de la nota (255 caracteres como máximo).Si hay más de 255 caracteres desde Start hasta final de la nota, este método devuelve sólo 255 caracteres.
Valor devuelto
Tipo: System.String
Comentarios
Se han reemplazado las notas de celda por comentarios de rango. Para obtener más información, vea el objeto Comment.
Para agregar una nota que contenga más de 255 caracteres, utilice este método una vez para especificar los primeros 255 caracteres y, a continuación, utilícelo de nuevo para anexar el resto de la nota (no más de 255 caracteres a la vez).
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el siguiente ejemplo de código se indica cómo se establecen diversas características de presentación y formato de un control NamedRange denominado NamedRange1. En particular, este ejemplo utiliza el método NoteText para agregar una nota a NamedRange1 con el texto This is a Formatting test.
Se trata de un ejemplo para una personalización en el nivel del documento.
' <Snippet36>
Private Sub SetRangeFormats()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
namedRange1.NoteText("This is a Formatting test", , )
namedRange1.Value2 = "Martha"
namedRange1.Font.Name = "Verdana"
namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
Excel.XlColorIndex.xlColorIndexAutomatic, )
namedRange1.AutoFormat( _
Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
True, False, True, False, True, True)
If MessageBox.Show("Clear the formatting and notes?", _
"Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
namedRange1.ClearFormats()
namedRange1.ClearNotes()
End If
End Sub
' </Snippet35>
// <Snippet36>
private void SetRangeFormats()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
namedRange1.NoteText("This is a Formatting test", missing, missing);
namedRange1.Value2 = "Martha";
namedRange1.Font.Name = "Verdana";
namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick,
Excel.XlColorIndex.xlColorIndexAutomatic, missing);
namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
true, false, true, false, true, true);
if (MessageBox.Show("Clear the formatting and notes?", "Test",
MessageBoxButtons.YesNo) == DialogResult.Yes)
{
namedRange1.ClearFormats();
namedRange1.ClearNotes();
}
}
// </Snippet35>
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.