Método XmlMappedRange.NoteText

Artigo
08/01/2011

Obtém ou define a nota de célula associada com o XmlMappedRange 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 seguinte exemplo de código usa a NoteText método para adicionar uma nota a um XmlMappedRange, e solicita que o usuário remova a anotação usando o ClearNotes método. Este exemplo de código pressupõe que a planilha atual contém um XmlMappedRange chamado 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.", missing, missing);

    if (MessageBox.Show("Remove the note?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearNotes();
    }
}

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

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via