Método NamedRange.NoteText

Artigo
08/01/2011

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

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 nota (até 255 caracteres).O texto é inserido começando pela posição Start, substituindo Length caracteres da nota existente.Se esse argumento for omitido, esse método retorna o texto da nota, começando na posição atual Start, para Length caracteres.

Start
Tipo: System.Object
A posição inicial para o texto que é definida ou retornada.Se esse argumento for omitido, esse método inicia no primeiro caractere.Para anexar texto da nota, especifique um número maior do que o número de caracteres da nota existente.

Length
Tipo: System.Object
O número de caracteres a ser definida ou retornada.Se esse argumento for omitido, o Excel de Microsoft Office define ou retorna os caracteres da posição inicial até o final da nota (até 255 caracteres).Se houver mais de 255 caracteres de Start para o final da nota, este método retornará somente 255 caracteres.

Valor de retorno

Tipo: System.String

Comentários

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

Para adicionar uma anotação que contém mais de 255 caracteres, use esse método uma vez para especificar os primeiros 255 caracteres e usá-lo novamente para acrescentar o restante da nota (até 255 caracteres por vez).

Optional Parameters

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

Exemplos

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

Este exemplo é para uma personalização em nível de 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>

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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via