הערות משמשות בדרך כלל לשגיאות שהוזכרו במסמכים או לדיון בתוכנן. עם הערות, אתה יכול להימנע מדיונים ארוכים ובלתי נגמרים בתוך שרשורי אימייל. במאמר זה, תלמד כיצד להוסיף ולהסיר הערות באופן פרוגרמטי לסימון מסמכי Word ב-Java.
להלן הנושאים הנידונים בקצרה להלן:
Java API להערות וסימון קבצי Word
GroupDocs.Annotation מספק את ה-API של Java כדי להתמודד עם ההערות. ה-API מאפשר הוספה, הסרה וחילוץ של הערות ממסמכי Word ופורמטים רבים אחרים של קבצים. פורמטי מסמכים נתמכים כוללים; גיליונות אלקטרוניים, מצגות, תמונות, קבצי PDF, דפי אינטרנט, הודעות דואר אלקטרוני, ציורי Visio.
הורד או הגדר
הורד את קובץ ה-JAR מקטע ההורדות, או פשוט קבל את תצורות המאגר והתלות העדכניות ביותר עבור ה-pom.xml של יישומי Java המבוססים על maven.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>21.7.2</version>
</dependency>
הוסף הערות ל-Word ב-Java
בואו נוסיף סוגים שונים של הערות למסמכי Word. הערות הן מסוגים רבים, אז נתייחס כאן רק לכמה.
הוסף הערת חץ ל-Word ב-Java
להלן השלבים להוספת הערת חץ למסמך Word ב-Java.
- טען את המסמך באמצעות המחלקה Annotator.
- אתחול הערת חץ עם המחלקה ArrowAnnotation.
- התאם את המיקום, הגודל, מספר העמוד של הערת החץ.
- הוסף את הערת החץ שנוצרה באמצעות שיטת add().
- שמור את מסמך ה-Word המוער לנתיב באמצעות שיטת save() המתאימה.
דוגמת הקוד של Java הבאה מראה כיצד להוסיף הערת חץ למסמך Word.
// הוסף הערת חץ למסמכי Word ב-Java
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
הוסף הערת מלבן או אזור ל-Word ב-Java
להלן השלבים להוספת הערת מלבן או אזור למסמך DOC/DOCX עם כמה התאמות אישיות. זה דומה להוספת הערות חץ אבל הוא משתמש ב-AreaAnnotation.
- טען את מסמך Word DOC/DOCX באמצעות המחלקה Annotator.
- אתחול הערת מלבן באמצעות המחלקה AreaAnnotation.
- התאם את המיקום, הגודל והצבע של המלבן.
- הגדר מאפיינים אחרים כמו מספר עמוד, רקע, אטימות, סגנון, רוחב עט, הודעות וזמן.
- הוסף את הערת המלבן שנוצרה ל-Annotator.
- שמור את מסמך ה-Word המוער לנתיב באמצעות שיטת save().
דוגמת הקוד הבאה של Java מראה כיצד להוסיף הערת מלבן/אזור למסמך Word.
// הוסף הערת אזור או מלבן במסמכי Word ב-Java
final Annotator annotator = new Annotator("path/document.docx");
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
הוסף הערת אליפסה או אליפסה ל-Word ב-Java
להלן השלבים להוספת ביאור אליפסה/אליפסה למסמך ב-Java.
- טען את מסמך DOC/DOCX באמצעות המחלקה Annotator.
- אתחול הערת אליפסה באמצעות המחלקה EllipseAnnotation.
- הגדר את המיקום והגודל של הערת האליפסה המאותחלת.
- הוסף את הערת האליפסה שנוצרה ל-Annotator.
- שמור את קובץ ה-Word המוער באמצעות שיטת save() המתאימה.
דגימת קוד ה-Java הבאה מראה כיצד להוסיף הערת אליפסה/אליפסה לכל מסמך Word.
// הוסף הערת אליפסה או אליפסה במסמכי Word ב-Java
final Annotator annotator = new Annotator("path/document.docx");
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
הוסף הערת מרחק ל-Word ב-Java
באופן דומה, ניתן לציין את המרחק בין שתי נקודות באמצעות הערת המרחק. להלן השלבים להוספת הערת מרחק למסמך ב-Java.
- לאחר טעינת מסמך Word, אתחל הערת מרחק באמצעות המחלקה DistanceAnnotation.
- הגדר את מראה ההערה.
- הוסף את הערת המרחק לאובייקט המציין.
- שמור את המסמך המוער במיקום הנתון או השתמש בשיטת save() הנכונה,
דגימת קוד ה-Java הבאה מראה כיצד להוסיף הערת מרחק למסמך DOC/DOCX.
// הוסף הערת מרחק למסמכי Word ב-Java
final Annotator annotator = new Annotator("path/document.docx");
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
הסר הערות מקובצי Word DOC/DOCX ב-Java
ישנן דרכים רבות להסיר הערות ממסמכי Word. אתה יכול להסיר הערות ספציפיות על ידי אספקת האינדקסים להסרת ההערות הספציפיות. בנוסף, תוכל להסיר את כל ההערות בבת אחת. פרטים וקוד מקור Java להסרת הערות נדונים במאמר נפרד.
להלן השלבים להסרת כל ההערות מקובץ Word.
- טען את המסמך.
- אתחול אפשרויות שמירה.
- הגדר את סוג ההערה ל-None.
- שמור את קובץ ה-Word. זה יהיה נקי מהערות.
הקוד הבא מראה כיצד להסיר הערות מקובץ Word ב-Java.
// הסר את כל ההערות ממסמך Word ב-Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
סיכום
לסיכום, למדת כיצד להוסיף הערות למסמכי Word בתוך יישומי Java. באופן ספציפי, הוספנו הערות חץ, אליפסה, שטח ומרחק לקובץ Word DOC/DOCX באמצעות GroupDocs.Annotation for Java.יתר על כן, ראית גם כיצד להסיר את כל ההערות מכל קובץ וורד. כעת, אתה יכול לנסות לבנות אפליקציית Java משלך לעורך מסמכים.
למידע נוסף על ה-API מתיעוד וממאגרי GitHub.לשאלות נוספות, צור קשר עם התמיכה בפורום.