XmlMappedRange.NoteText(Object, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

Obtiene o establece la nota de celda asociada al control XmlMappedRange.

public string NoteText (object Text, object Start, object Length);

abstract member NoteText : obj * obj * obj -> string

Public Function NoteText (Optional Text As Object, Optional Start As Object, Optional Length As Object) As String

Parámetros

Text

Object

Texto que se va a agregar a la nota (hasta 255 caracteres). El texto se inserta a partir de la posición Start, reemplazando Length los caracteres de la nota existente. Si se omite este argumento, este método devuelve el texto actual de la nota a partir de la posición Start, para Length los caracteres.

Start

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

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 de Start hasta el final de la nota, este método devuelve solo 255 caracteres.

Devoluciones

String

Ejemplos

En el ejemplo de código siguiente se usa el NoteText método para agregar una nota a y XmlMappedRange, a continuación, se pide al usuario que quite la nota mediante el ClearNotes método . En este ejemplo de código se supone que la hoja de cálculo actual contiene un XmlMappedRange denominado CustomerLastNameCell.

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

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

Comentarios

Las notas de celda se han reemplazado por comentarios de intervalo. Para obtener más información, vea el Comment objeto .

Para agregar una nota que contiene más de 255 caracteres, use este método una vez para especificar los primeros 255 caracteres y, a continuación, úselo 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 los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.