Método XmlMappedRange.NoteText

Artigo
05/21/2013

Obtém ou define a nota da célula associada com o controle de XmlMappedRange .

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 a adicionar ao nó (até 255 caracteres).O texto é iniciar inserido na posição Start, substituindo caracteres de Length de nota existente.Se esse argumento for omitido, este método retornará o texto atual de observe que começa 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 for omitido, inicia este método no primeiro caractere.Para acrescentar texto ao nó, especifique um número maior que o número de caracteres na observação existente.

Length
Tipo: System.Object
O número de caracteres a ser definidos ou retornado.Se esse argumento for 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, este método retornará 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 anexar 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 a seguir usa o método de NoteText para adicionar uma nota a XmlMappedRange, e solicita ao usuário para remover a observação usando o método de ClearNotes .Este exemplo de código a seguir pressupõe que a planilha atual contiver 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.");

    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