NamedRange.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 la celda asociada a la celda de la esquina superior izquierda del control NamedRange.

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 muestra cómo establecer una variedad de características de formato y visualización de un NamedRange control denominado NamedRange1. En concreto, en este ejemplo se usa el NoteText método para agregar una nota a NamedRange1 con el texto This is a Formatting test.

Este ejemplo es para una personalización de nivel de documento.

private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.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(missing, 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)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}

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

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.