O Microsoft Excel oferece a opção de adicionar comentários em arquivos do Excel. Pode haver vários motivos para adicionar comentários, como explicar uma fórmula ou adicionar informações contextuais que podem ser úteis para o leitor. Os comentários também podem ser usados para sugerir edições na planilha. Além disso, você pode definir o tamanho da fonte, altura, largura, etc., dos comentários. Neste artigo, você aprenderá como adicionar comentários a planilhas do Excel programaticamente usando C++.
- API C++ para adicionar comentários em planilhas do Excel
- Adicionar comentários em uma planilha do Excel usando C++
- Aplicar formatação a comentários em uma planilha do Excel usando C++
API C++ para adicionar comentários em planilhas do Excel
Aspose.Cells for C++ é uma biblioteca nativa de C++ que permite trabalhar com arquivos do Excel. Com a API, você pode facilmente criar, ler e modificar arquivos do Excel. Além disso, você pode adicionar comentários às suas planilhas do Excel. Para começar, instale a API por meio do NuGet ou baixe-a diretamente da seção Downloads.
PM> Install-Package Aspose.Cells.Cpp
Adicionar comentários em uma planilha do Excel usando C++
A seguir estão as etapas para adicionar um comentário a uma célula em uma planilha do Excel.
- Carregue o arquivo Excel usando a classe IWorkbook.
- Recupere a planilha onde você deseja adicionar o comentário.
- Adicione o comentário usando IWorksheet->GetIComments()->Add(intrusiveptrAspose::Cells::Systems::String cellName) método.
- Recupere o comentário adicionado na etapa anterior usando o método IWorksheet->GetIComments()->GetObjectByIndex (Aspose::Cells::Systems::Int32 index).
- Defina a nota do comentário usando o IComment->SetNote(intrusiveptrAspose::Cells::Systems::String valor) método.
- Salve o arquivo do Excel usando o IWorkbook->Save(intrusiveptrAspose::Cells::Systems::String fileName) método.
O código de exemplo a seguir mostra como adicionar um comentário a uma célula em uma planilha do Excel usando C++.
// Caminho do diretório de origem.
StringPtr srcDir = new String("SourceDirectory\\Excel\\");
// Caminho do diretório de saída.
StringPtr outDir = new String("OutputDirectory\\");
// Carregar o arquivo Excel de origem
intrusive_ptr<IWorkbook> workbook = Factory::CreateIWorkbook(srcDir->StringAppend(new String("Sample1.xlsx")));
// Recupere a primeira planilha
intrusive_ptr<IWorksheet> worksheet = workbook->GetIWorksheets()->GetObjectByIndex(0);
// Adicionar comentário à célula F5
int commentIndex = worksheet->GetIComments()->Add(new String("F5"));
// Recuperar o comentário adicionado à célula F5
intrusive_ptr<IComment> comment = worksheet->GetIComments()->GetObjectByIndex(commentIndex);
// Definir a nota de comentário
comment->SetNote(new String("Hello Aspose!"));
// Salve o arquivo Excel
workbook->Save(outDir->StringAppend(new String("AddComment_out.xlsx")));
Imagem mostrando o comentário adicionado à célula F5
Aplicar formatação a comentários em uma planilha do Excel usando C++
A seguir estão as etapas para aplicar formatação a comentários em uma planilha do Excel usando C++.
- Carregue o arquivo Excel usando a classe IWorkbook.
- Recupere a planilha onde você deseja adicionar o comentário.
- Adicione o comentário usando IWorksheet->GetIComments()->Add(intrusiveptrAspose::Cells::Systems::String cellName) método.
- Recupere o comentário adicionado na etapa anterior usando o método IWorksheet->GetIComments()->GetObjectByIndex (Aspose::Cells::Systems::Int32 index).
- Defina a nota do comentário usando o IComment->SetNote(intrusiveptrAspose::Cells::Systems::String valor) método.
- Defina a formatação do comentário de acordo com suas necessidades.
- Salve o arquivo do Excel usando o IWorkbook->Save(intrusiveptrAspose::Cells::Systems::String fileName) método.
O código de exemplo a seguir mostra como aplicar a formatação a um comentário em uma planilha do Excel usando C++.
// Caminho do diretório de origem.
StringPtr srcDir = new String("SourceDirectory\\Excel\\");
// Caminho do diretório de saída.
StringPtr outDir = new String("OutputDirectory\\");
// Carregar o arquivo Excel de origem
intrusive_ptr<IWorkbook> workbook = Factory::CreateIWorkbook(srcDir->StringAppend(new String("Sample1.xlsx")));
// Recupere a primeira planilha
intrusive_ptr<IWorksheet> worksheet = workbook->GetIWorksheets()->GetObjectByIndex(0);
// Adicionar comentário à célula F5
int commentIndex = worksheet->GetIComments()->Add(new String("F5"));
// Recuperar o comentário adicionado à célula F5
intrusive_ptr<IComment> comment = worksheet->GetIComments()->GetObjectByIndex(commentIndex);
// Definir a nota de comentário
comment->SetNote(new String("Hello Aspose!"));
// Defina o tamanho da fonte
comment->GetIFont()->SetSize(14);
// Defina o peso da fonte
comment->GetIFont()->SetBold(true);
// Defina a altura em CM
comment->SetHeightCM(10);
// Defina a largura em CM
comment->SetWidthCM(2);
// Salve o arquivo Excel
workbook->Save(outDir->StringAppend(new String("ApplyFormattingToComment_out.xlsx")));
Imagem mostrando o comentário com formatação personalizada adicionada à célula F5
Obtenha uma licença gratuita
Para experimentar a API sem limitações de avaliação, você pode solicitar uma licença temporária gratuita.
Conclusão
Neste artigo, você aprendeu como adicionar comentários em uma planilha do Excel usando C++. Além disso, você viu como aplicar formatação a comentários usando a API Aspose.Cells for C++, simples de usar. A API fornece vários recursos adicionais para trabalhar com arquivos do Excel que você pode explorar em detalhes visitando a documentação oficial. Em caso de dúvidas, sinta-se à vontade para entrar em contato conosco em nosso fórum de suporte gratuito.