Trabalhar com comentários

Trabalhar com comentários

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell comentários (notas) em quadros de trabalho XLSX. Os comentarios são acessados através do sistema de CommentCollection em uma folha de cálculo e são representados como: Comment objetos que contêm o texto da nota, o nome do autor e as dimensões de exibição.

Resumo geral

Cada folha de trabalho expõe os seus comentários através da seguinte página: Worksheet.getComments(), que retorna um CommentCollection.Pode acrescentar um comentário através do endereço de telemóvel ou por: Índice de linha/coluna, obter comentários existentes por índice ou nome de célula e remova-os quando já não forem necessários.

A. - Não . Comment armazenar o texto da nota (getNote()/setNote()), o autor (getAuthor()/setAuthor()), a sua posição de ancoragem (getRow(), getColumn()), as suas dimensões de exibição (getWidth(), getHeight()), e se é visível por padrão (isVisible()/setVisible()).

Acesso aos comentários numa folha de cálculo

Recuperar o CommentCollection de qualquer Worksheet via: Worksheet.getComments().- Usar . CommentCollection.getCount() para determinar: O número de comentários apresentados. índice baseado em zero através de: CommentCollection.get(index) ou por nome da célula através de: CommentCollection.get(cellName).

Adicionar um comentário

Utilização: CommentCollection.add(cellName) ou a) CommentCollection.add(row, column) A Comissão Europeia tem de apresentar uma proposta para a aplicação do artigo 85.o, n.o 1, da Directiva 2000/60/CE. retorno a Comment Objeto. Defina o texto da nota e autor no retorno instância antes de salvar.

// Add a comment to cell B2 and configure it
Comment comment = ws.getComments().add("B2");
comment.setNote("Review this value before submission.");
comment.setAuthor("Analyst");
comment.setVisible(false);
comment.setWidth(180);
comment.setHeight(60);

Leitura de Conteúdo do Comentário

Iterar sobre todos os comentários usando a contagem:

CommentCollection comments = ws.getComments();
for (int i = 0; i < comments.getCount(); i++) {
    Comment c = comments.get(i);
    System.out.printf("Cell [%d,%d] author=%s note=%s%n",
        c.getRow(), c.getColumn(), c.getAuthor(), c.getNote());
}

Modificar um comentário existente

Obter o comentário por endereço celular e atualizar os campos diretamente:

Comment c = ws.getComments().get("B2");
if (c != null) {
    c.setNote("Updated note text.");
    c.setVisible(true);
}

Remover um comentário

Utilização: CommentCollection.removeAt(index) ou a) CommentCollection.removeAt(cellName) para apagar um comentário:

ws.getComments().removeAt("B2");

Dicas e melhores práticas

• Verifica sempre isso. CommentCollection.get(cellName) não volta . null antes de modificar um comentário a célula pode não ter nenhum comentários anexados.
• Set (s) Comment.setVisible(false) para anotações que só devem aparecer no Hover, que corresponde ao comportamento padrão do Excel.
• Utilização: Comment.setWidth() e a) Comment.setHeight() (em pixels) para assegurar que os dados de informação são utilizados em todos os sistemas. A caixa de notas é suficientemente grande para texto com várias linhas.
• Os nomes de autores são armazenados como strings simples; eles não são validados contra a lista de usuários do livro.
• Comentários sobreviver a uma carga / salvar ida e volta através XLSX quando não há modificações são feitos para: CommentCollection.

Problemas comuns

FAQ

Como adiciono um comentário a uma linha e coluna específicas?

Utilização: CommentCollection.add(row, column), em que ambos os valores são baseados no zero . O que é equivalente a: add(cellName) com a célula correspondente endereço.

Posso alterar o autor de um comentário existente?

Sim, retira o… Comment via: get(cellName) E chama-me. setAuthor(name) com a nova sequência de autor.

Como posso verificar se um comentário está visível?

Chama-me . Comment.isVisible().- Retornos de crédito . true se a caixa de comentários estiver sempre em: mostrado; false Se aparecer apenas no hover.

Os comentários são preservados na conversão para outros formatos?

Os comentários são preservados em XLSX de ida e volta. O comportamento de preservação para outros formatos depende do suporte ao formato na saída alvo.

Como contarei os comentários numa folha de cálculo?

Utilização: Worksheet.getComments().getCount().

Resumo de referência da API

Comentário:

CommentCollection

Ver também:

• Aspose.Cells for Java — Enterprise Documentation