XmlMappedRange.NoteText (Método)
Obtiene o establece la nota de celda asociada al control XmlMappedRange.
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 utiliza el método NoteText para agregar una nota a un control XmlMappedRange y, a continuación, se pide al usuario que quite la nota con el método ClearNotes.En este ejemplo de código se supone que la hoja de cálculo actual contiene un control XmlMappedRange denominado CustomerLastNameCell.
Private Sub SetNote()
Me.CustomerLastNameCell.NoteText("This cell contains customer " & _
"last names.")
If MessageBox.Show("Remove the note?", "Test", MessageBoxButtons.YesNo) = _
DialogResult.Yes Then
Me.CustomerLastNameCell.ClearNotes()
End If
End Sub
private void SetNote()
{
this.CustomerLastNameCell.NoteText("This cell contains customer " +
"last names.");
if (MessageBox.Show("Remove the note?", "Test",
MessageBoxButtons.YesNo) == DialogResult.Yes)
{
this.CustomerLastNameCell.ClearNotes();
}
}
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.