ניווט עם Cursor
בעת עבודה עם מסמך, גם אם הוא קצר או ארוך, תצטרך לנווט דרך המסמך שלך. ניווט עם קידוד וירטואלי מייצג את היכולת לנווט בין נקודות שונות במסמך.
בתוך מסמך קצר, נע סביב במסמך הוא פשוט כפי שאתה יכול להעביר את נקודת ההכנסה גם על ידי שימוש במפתחי החצים של המקלדת או על ידי לחיצה על העכבר כדי לאתר את נקודת הפתיחה בכל מקום שתרצה. אבל ברגע שיש לך מסמך גדול שיש לו דפים רבים, הטכניקות הבסיסיות האלה לא מספיקות.
מאמר זה מסביר כיצד לנוע סביב במסמך לנווט עם cursor וירטואלי לחלקים שונים ממנו.
המונחים: Current Cursor
לפני שתתחיל בתהליך של ניווט דרך המסמך שלך, תצטרך לקבל את הצומת שנבחר כרגע. אתה יכול לקבל את המיקום המדויק של cursor בצומת נבחר על ידי שימוש current_node רכוש. בנוסף, במקום לקבל את הצומת הנוכחי, אתה יכול לקבל את הסעיף שנבחר כרגע או את החלק שנבחר על ידי שימוש בסעיף שנבחר כיום על ידי שימוש current_paragraph ו current_section תכונות.
כל פעולות כניסה שאתה מבצע באמצעות DocumentBuilder יוכנס לפני current_node. כאשר הסעיף הנוכחי ריק או הcursor ממוקם ממש לפני סוף הסעיף, הסעיף. current_node לא חוזר אף אחד.
שיטות ניווט במסמך
כאשר אתה עורך טקסט, חשוב לדעת כיצד לנווט את המסמך שלך והיכן בדיוק לעבור בו. Aspose.Words מאפשר לך לנוע סביב במסמך לנווט לחלקים השונים שלה וחלקים - זה דומה לפונקציונליות של הפנינה הניווט ב Microsoft Word ללכת לדף או לכותרת במסמך Word מבלי לגלול.
השיטה העיקרית היא להיות מסוגל להעביר את מיקום cursor לצומת מסוים במסמך שלך, אתה יכול להשיג את זה על ידי שימוש move_to שיטה.
דוגמה לקוד הבא מראה כיצד להעביר את DocumentBuilder נקודות שונות במסמך:
חוץ מהבסיס move_to שיטה, יש יותר ספציפיים.
ניווט להתחלה או לסוף מסמך
אתה יכול ללכת להתחלה או לסוף המסמך שלך באמצעות move_to_document_start ו move_to_document_end שיטות.
הדוגמה הבאה של הקוד מראה כיצד להעביר את מיקום הcursor להתחלה או לסוף המסמך:
ניווט עם סימניות
אתה יכול לסמן מקום שאתה רוצה למצוא אותו שוב בקלות. אתה יכול להוסיף כמה סימניות רבות לתוך המסמך שלך כפי שאתה רוצה, ולאחר מכן לנווט דרכם באמצעות זיהוי סימני הספר עם שמות ייחודיים. אתה יכול לעבור לסימן על ידי שימוש move_to_bookmark שיטה.
דוגמאות הקוד הבאות מראות כיצד להעביר מיקום cursor לסימן ספר:
ניווט לתאי שולחן
אתה יכול לעבור לתא שולחן באמצעות move_to_cell שיטה. שיטה זו תאפשר לך לנווט את הcursor לתוך כל תא בטבלה מסוימת. בנוסף, אתה יכול לציין אינדקס כדי להעביר את הcursor לכל עמדה או אופי שצוין בתא בתוך התא בתוך התא. move_to_cell שיטה.
דוגמה הקוד הבא מראה כיצד להעביר מיקום cursor לתא שולחן מוגדר:
לנווט לשדה
אתה יכול לעבור לשדה מסוים במסמך שלך על ידי שימוש move_to_field שיטה. בנוסף, אתה יכול לעבור לשדה מיזוג מסוים על ידי שימוש move_to_merge_field שיטה.
הדוגמה הקודית הבאה מראה כיצד להעביר את בונה המסמך לשדה ספציפי:
לנווט אל ראש או רגל
אתה יכול לעבור לתחילת ראש או רגל על ידי שימוש move_to_header_footer שיטה
הדוגמה הבאה של הקוד מראה כיצד להעביר את בונה המסמך cursor אל מנהל מסמך או רגל:
ניווט לסעיף או לפסקה
אתה יכול לעבור לסעיף מסוים או לפסקה על ידי שימוש move_to_paragraph או move_to_section שיטות. בנוסף, באפשרותך לציין אינדקס כדי להעביר את הcursor לכל עמדה או דמות מוגדרת בפסקה בתוך הסעיף בתוך הסעיף. move_to_paragraph שיטה.
הדוגמה הבאה של הקוד מראה כיצד לעבור לסעיף מסוים ופסקה מסוימת במסמך: