Método NamedRange.NoteText

Artigo
01/09/2014

Obtém ou define a nota da célula associada com a célula no canto superior esquerdo do controle de NamedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
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
O texto para adicionar a serem observados (até 255 caracteres).O texto é iniciar inserido na posição Start, substituindo caracteres de Length de nota existente.Se esse argumento é omitido, retornos desse método texto atual de nota começando na posição Start, para caracteres de Length .

Start
Tipo: System.Object
A posição inicial para o texto que é definido ou retornado.Se esse argumento é omitido, inicia este método no primeiro caractere.Para acrescentar texto a serem observados, especifique um número maior que o número de caracteres na definição existente.

Length
Tipo: System.Object
O número de caracteres a ser definidos ou retornado.Se esse argumento é omitido, Microsoft Office Excel define ou retorna caracteres da posição inicial ao final de nota (até 255 caracteres).Se houver mais de 255 caracteres de Start ao final de nota, retornos desse método apenas 255 caracteres.

Valor de retorno

Tipo: System.String

Comentários

As notas da célula foram substituídas por comentários do intervalo. Para obter mais informações, consulte o objeto de Comment .

Para adicionar uma nota que contém mais de 255 caracteres, use este método uma vez para especificar os primeiros 255 caracteres, e em seguida novamente para acrescentar o restante de nota (não mais de 255 caracteres de cada vez.)

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código demonstra como definir uma variedade de características de formatação e exibição de um controle de NamedRange chamado NamedRange1. Em particular, este exemplo usa o método de NoteText para adicionar uma nota a NamedRange1 com o texto Este é um teste de formatação.

Este exemplo é para uma personalização de um documento nível.

' <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");
    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();
    }
}
// </Snippet35>

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via