Insérer, modifier, supprimer des notes dans des feuilles de calcul—SpreadProcessing

Consultez cet article de blog pour obtenir un aperçu de la fonctionnalité Notes dans SpreadProcessing.
L’un des nouveaux ajouts à la bibliothèque SpreadProcessing est la prise en charge de Notes. Les notes vous aident à annoter les données à l’intérieur des cellules ou à les rendre plus claires en incluant des informations supplémentaires pour le contenu de la cellule. L’API SpreadProcessing vous permet d’itérer toutes les notes d’un document, de les modifier ou d’en créer de nouvelles.
Que vous ayez besoin d’ajouter, de supprimer ou de modifier une note, tous les objets SpreadsheetNote sont accessibles via le Remarques collecte de votre Feuille de travail. La collection expose des méthodes simples pour ajouter ou supprimer une note ainsi qu’un indexeur, vous permettant d’itérer toutes les notes qui se trouvent actuellement dans le document.
Le code dans l’extrait suivant montre comment vous pouvez ouvrir un document XLSX et supprimer toutes les notes dans la première feuille de travail :
Workbook workbook;
using
(Stream str = File.OpenRead(sampleFilePath))
{
XlsxFormatProvider provider =
new
XlsxFormatProvider();
workbook = provider.Import(str);
}
workbook.Worksheets[0].Notes.Clear();
D’ACCORD. C’était assez facile, mais qu’en est-il de la création d’une note ou de la modification d’une note existante ? Ne vous inquiétez pas, c’est aussi simple.
Tout ce que vous devez spécifier lors de l’insertion d’une nouvelle note est la cellule à laquelle la note fait référence et la position de la note. Créons un simple document de feuille de calcul pour le démontrer.
// Create document
Workbook workbook =
new
Workbook();
Worksheet worksheet = workbook.Worksheets.Add();
CellIndex a1Index =
new
CellIndex(0, 0);
worksheet.Cells[a1Index].SetValue(
"Example here"
);
worksheet.Cells[a1Index].SetIsWrapped(
true
);
// Create and add a note
// The index of the cell the note is associated to. (A1 in this case)
CellIndex relatedCellIndex = a1Index;
// The index of the cell the note will be visualized on when all notes are shown. (C3 in this case)
CellIndex cellIndex =
new
CellIndex(2, 2);
string
author =
"John Doe"
;
string
text =
"My First Comment Content"
;
worksheet.Notes.Add(relatedCellIndex, cellIndex, author, text);
// Save document
using
(Stream stream = File.OpenWrite(
"InsertNote.xlsx"
))
{
XlsxFormatProvider provider =
new
XlsxFormatProvider();
provider.Export(workbook, stream);
}
Une fois que vous ouvrez le fichier généré par le code ci-dessus, vous verrez le petit triangle rouge dans le coin supérieur droit de la cellule indiquant qu’il y a une note sur cette cellule. Survoler la cellule vous montrera la note que nous venons d’insérer :
Si vous le souhaitez, vous pouvez également afficher les commentaires dans votre feuille de calcul, ce qui garantit qu’ils sont toujours visibles et que les utilisateurs n’ont pas besoin de survoler une cellule pour les voir sur leurs positions organisées.
L’extrait et l’image suivants montrent comment rendre les notes visibles et à quoi cela ressemblera dans le document :
worksheet.Notes.ShowAll();
Comme vous pouvez le voir sur l’image, la note est positionnée sur l’index que nous lui avons initialement appliqué.
L’API SpreadProcessing expose différentes possibilités pour manipuler ou supprimer des notes existantes ainsi que pour en ajouter de nouvelles. Vous pouvez modifier le contenu, la position, la taille, la visibilité de la note, etc. Si vous êtes curieux de toutes les explorer, rendez-vous sur la page de documentation de cette fonctionnalité : Traitement de propagation | Rubrique Remarques.
Essayez-le et partagez vos commentaires
Que vous soyez déjà familiarisé avec le traitement de documents Telerik ou que vous rencontriez les bibliothèques pour la première fois, dépêchez-vous et obtenez les derniers éléments afin de pouvoir profiter des différentes possibilités de gestion de documents qu’elles offrent :
Et je suis sûr que je vous ai dit à plusieurs reprises que votre contribution est précieuse. Nous écoutons. Alors, ne soyez pas timide et écrivez-nous pour partager vos commentaires dans la section des commentaires ci-dessous ou directement dans notre Portail de commentaires des bibliothèques de traitement de documents.
Source link