עבודה עם סימניות

סימניות מזהות ב Microsoft Word לתעד את המיקומים או השברים שאתה שם ומזהה לעיון עתידי. לדוגמה, תוכל להשתמש בסימנייה כדי לזהות טקסט שברצונך לשנות מאוחר יותר. במקום לגלול במסמך כדי לאתר את הטקסט, תוכל לעבור אליו באמצעות תיבת הדו-שיח סימניות.

הפעולות שניתן לבצע באמצעות סימניות באמצעות Aspose.Words זהות לאלה שניתן לבצע באמצעות Microsoft Word. ניתן להוסיף סימניה חדשה, למחוק, לעבור לסימניה, לקבל או להגדיר שם סימניה, לקבל או להגדיר טקסט המצורף בה. עם Aspose.Words, אתה יכול גם להשתמש בסימניות בדוחות או במסמכים כדי להכניס נתונים מסוימים לסימניה או להחיל עיצוב מיוחד על תוכנו. אתה יכול גם להשתמש בסימניות כדי לאחזר טקסט ממיקום מסוים במסמך שלך.

הכנס סימניה

השתמש StartBookmark ו EndBookmark כדי ליצור סימניה על ידי סימון ההתחלה והסיום שלה, בהתאמה. אל תשכח להעביר את אותו שם סימניה לשתי השיטות. סימניות במסמך יכולות לחפוף ולפרוס כל טווח. סימניות או סימניות שנוצרו בצורה גרועה עם שמות כפולים יתעלמו בעת שמירת המסמך.

דוגמת הקוד הבאה מראה כיצד ליצור סימניה חדשה:

השג סימניות

לפעמים יש צורך להשיג אוסף סימניות כדי לחזור על עצמו באמצעות סימניות או למטרות אחרות. השתמש במאפיין Node.Range שנחשף על ידי כל צומת מסמך שמחזיר אובייקט Range המייצג את החלק של המסמך הכלול בצומת זה. השתמש באובייקט זה כדי לאחזר BookmarkCollection ולאחר מכן השתמש באינדקס האוסף כדי לקבל סימניה ספציפית.

דוגמת הקוד הבאה מראה כיצד להשיג סימניות מאוסף סימניות:

דוגמת הקוד הבאה מראה כיצד לקבל או להגדיר שם וטקסט של סימניה:

דוגמת הקוד הבאה מראה כיצד לסמן טבלה:

אם תשנה את שם הסימנייה לשם שכבר קיים במסמך, לא תיווצר שגיאה ורק הסימנייה הראשונה תישמר בעת שמירת המסמך.

שים לב שחלק מהסימניות במסמך מוקצות לשדות טופס. מעבר לסימנייה כזו והכנסת טקסט שם מכניס את הטקסט לקוד שדה הטופס. למרות שזה לא יבטל את שדה הטופס, הטקסט שהוכנס לא יהיה גלוי מכיוון שהוא הופך לחלק מקוד השדה.

מעבר לסימנייה

אם אתה צריך להכניס תוכן עשיר (לא רק טקסט רגיל) לסימניה, עליך להשתמש ב MoveToBookmark כדי להזיז את הסמן לסימניה ולאחר מכן להשתמש ב DocumentBuilder’s שיטות ומאפיינים כדי להוסיף תוכן.

הצג הסתר תוכן סימניות

כל הסימנייה (including the bookmarked content) יכולה להיות מכוסה בחלק האמיתי של השדה IF באמצעות Aspose.Words. זה יכול להיות בצורה כזו ששדה IF מכיל שדה מיזוג מקונן בביטוי (Left of Operator) ובהתאם לערך שדה המיזוג, השדה IF מציג או מסתיר את תוכן הסימנייה במסמך Word.

דוגמת הקוד הבאה מראה כיצד להציג / להסתיר סימניות: