https://docs.aspose.com/words/he/cpp/document-builder-overview/ Recent content in סקירת בונה מסמכים ב C++ on Documentation Hugo -- gohugo.io he https://docs.aspose.com/words/he/cpp/navigation-with-cursor/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/words/he/cpp/navigation-with-cursor/ <p>תוך כדי עבודה עם מסמך, גם אם הוא קצר או ארוך, יהיה עליך לנווט במסמך שלך. ניווט עם סמן וירטואלי מייצג את היכולת לנווט בין צמתים שונים במסמך.</p> <p>בתוך מסמך קצר, התנועה במסמך היא פשוטה מכיוון שאתה יכול להזיז את נקודת ההכנסה גם באמצעות מקשי החצים של המקלדת או על ידי לחיצה על העכבר כדי לאתר את נקודת ההכנסה בכל מקום שתרצה. אבל ברגע שיש לך מסמך גדול שיש בו דפים רבים, הטכניקות הבסיסיות הללו לא יספיקו.</p> <p>מאמר זה מסביר כיצד לנוע במסמך ולנווט עם סמן וירטואלי לחלקים שונים שלו.</p> <h2 id="זיהוי-הנוכחי-סמן-עמדה"> זיהוי הנוכחי סמן עמדה </h2> <p>לפני שתתחיל בתהליך הניווט במסמך שלך, יהיה עליך לקבל את הצומת שנבחר כעת. אתה יכול לקבל את המיקום המדויק של הסמן בצומת שנבחר באמצעות המאפיין <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/get_currentnode/">CurrentNode</a>. בנוסף, במקום לקבל את הצומת הנוכחי, אתה יכול לקבל את הפסקה שנבחרה כעת או את הקטע שנבחר כעת באמצעות המאפיינים <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/get_currentparagraph/">CurrentParagraph</a> ו <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/get_currentsection/">CurrentSection</a>.</p> <p>כל פעולות הוספה שתבצע באמצעות <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/">DocumentBuilder</a> יוכנסו לפני <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/get_currentnode/">CurrentNode</a>. כאשר הפסקה הנוכחית ריקה או שהסמן ממוקם ממש לפני סוף הפסקה, <strong>CurrentNode</strong> מחזיר אפס.</p> <h2 id="שיטות-ניווט-במסמך"> שיטות ניווט במסמך </h2> <p>כאשר אתה עורך טקסט, חשוב לדעת כיצד לנווט במסמך שלך ולאן בדיוק לנוע בו. Aspose.Words מאפשר לך לנוע במסמך ולנווט לחלקים ולחלקים השונים שלו-זה דומה לפונקציונליות של חלונית הניווט ב Microsoft Word כדי לעבור לדף או כותרת במסמך Word מבלי לגלול.</p> <p>השיטה העיקרית היא להיות מסוגל להעביר את מיקום הסמן לצומת ספציפי במסמך שלך, אתה יכול להשיג זאת באמצעות שיטת <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/moveto/">MoveTo</a>.</p> <p>דוגמת הקוד הבאה מראה כיצד להעביר את <strong>DocumentBuilder</strong> לצמתים שונים במסמך:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToNode.cpp"></script> <p>אבל מלבד השיטה הבסיסית <strong>MoveTo</strong>, יש יותר ספציפיים.</p> <h3 id="נווט-אל-התחלה-או-סוף-של-מסמך"> נווט אל התחלה או סוף של מסמך </h3> <p>אתה יכול ללכת להתחלה או לסוף המסמך שלך באמצעות שיטות <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetodocumentstart/">MoveToDocumentStart</a> ו <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetodocumentend/">MoveToDocumentEnd</a>.</p> <p>דוגמת הקוד הבאה מראה כיצד להעביר את מיקום הסמן לתחילת או לסוף של מסמך:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToDocumentStartEnd.cpp"></script> <h3 id="נווט-עם-סימניות"> נווט עם סימניות </h3> <p>אתה יכול לסמן מקום שאתה רוצה למצוא ולעבור אליו שוב בקלות. אתה יכול להכניס כמה סימניות למסמך שלך ואז לנווט בהן על ידי זיהוי הסימניות עם שמות ייחודיים. ניתן לעבור לסימנייה באמצעות שיטת <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetobookmark/">MoveToBookmark</a>.</p> <p>דוגמאות הקוד הבאות מראות כיצד להעביר מיקום סמן לסימניה:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToBookmark.cpp"></script> <h3 id="נווט-אל-תאי-טבלה"> נווט אל תאי טבלה </h3> <p>ניתן לעבור לתא טבלה באמצעות שיטת <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetocell/">MoveToCell</a>. שיטה זו תאפשר לך לנווט את הסמן לכל תא בטבלה ספציפית. בנוסף, ניתן לציין אינדקס כדי להזיז את הסמן לכל מיקום או תו שצוין בתא בתוך השיטה <strong>MoveToCell</strong>.</p> <p>דוגמת הקוד הבאה מראה כיצד להעביר מיקום סמן לתא טבלה שצוין:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToTableCell.cpp"></script> <h3 id="נווט-אל-שדה"> נווט אל שדה </h3> <p>ניתן לעבור לשדה מסוים במסמך באמצעות השיטה <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetofield/">MoveToField</a>. בנוסף, ניתן לעבור לשדה מיזוג ספציפי באמצעות שיטת <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetomergefield/">MoveToMergeField</a>.</p> <p>דוגמת הקוד הבאה מראה כיצד להעביר את סמן בונה המסמכים לשדה ספציפי:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToMergeField.cpp"></script> <h3 id="נווט-אל-כותרת-עליונה-או-תחתונה"> נווט אל כותרת עליונה או תחתונה </h3> <p>ניתן לעבור לתחילת כותרת עליונה או תחתונה באמצעות שיטת <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetoheaderfooter/">MoveToHeaderFooter</a>.</p> <p>דוגמת הקוד הבאה מראה כיצד להעביר את סמן בונה המסמכים לכותרת עליונה או תחתונה של מסמך:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderHeadersAndFooters.cpp"></script> <h3 id="נווט-אל-קטע-או-פסקה"> נווט אל קטע או פסקה </h3> <p>ניתן לעבור לקטע או פסקה ספציפיים באמצעות השיטות <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetoparagraph/">MoveToParagraph</a> או <a href="https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/movetosection/">MoveToSection</a>. בנוסף, ניתן לציין אינדקס כדי להזיז את הסמן לכל מיקום או תו שצוין בפסקה בשיטה <strong>MoveToParagraph</strong>.</p> <p>דוגמת הקוד הבאה מראה כיצד לעבור לקטע ספציפי ולפסקה ספציפית במסמך:</p> <script type="application/javascript" src="https://gist.github.com/aspose-words-gists/d55d8631947d283b1f0da99afa06c492.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToSectionParagraph.cpp"></script> https://docs.aspose.com/words/he/cpp/use-documentbuilder-to-insert-document-elements/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/words/he/cpp/use-documentbuilder-to-insert-document-elements/ <p><code>DocumentBuilder</code> משמש לשינוי מסמכים. מאמר זה מסביר ומתאר כיצד לבצע מספר משימות:</p> <h2 id="הוספת-מחרוזת-טקסט"> הוספת מחרוזת טקסט </h2> <p>כל שעליך לעשות הוא להעביר את מחרוזת הטקסט שעליך להכניס למסמך לשיטה <code>DocumentBuilder.Write</code>. עיצוב הטקסט נקבע על ידי המאפיין <code>Font</code>. אובייקט זה מכיל תכונות גופן שונות (שם גופן, גודל גופן, צבע וכן הלאה). כמה תכונות גופן חשובות מיוצגות גם על ידי DocumentBuilder מאפיינים כדי לאפשר לך לגשת אליהם ישירות. אלה הם תכונות בוליאניות <code>Font.Bold</code>, <code>Font.Italic</code>, ו <code>Font.Underline</code>.</p> <p>שים לב שעיצוב התווים שהגדרת יחול על כל הטקסט שהוכנס מהמיקום הנוכחי במסמך ואילך.</p> <p>לדוגמה, הוספת טקסט מעוצב באמצעות DocumentBuilder.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-WriteAndFont-WriteAndFont.cpp"></script> <h2 id="הוספת-פסקה"> הוספת פסקה </h2> <p><code>DocumentBuilder.Writeln</code> מוסיף מחרוזת טקסט גם למסמך, אך בנוסף, הוא מוסיף מעבר פסקה. עיצוב הגופן הנוכחי מוגדר גם על ידי המאפיין <code>DocumentBuilder.Font</code> ועיצוב הפסקה הנוכחי נקבע על ידי המאפיין <code>DocumentBuilder.ParagraphFormat</code>. להלן דוגמה מראה כיצד להכניס פסקה למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertParagraph-DocumentBuilderInsertParagraph.cpp"></script> <h2 id="הוספת-טבלה"> הוספת טבלה </h2> <p>האלגוריתם הבסיסי ליצירת טבלה באמצעות DocumentBuilder הוא פשוט:</p> <ol> <li>הפעל את הטבלה באמצעות <code>DocumentBuilder.StartTable</code>.</li> <li>הכנס תא באמצעות <code>DocumentBuilder.InsertCell</code>. פעולה זו מתחילה באופן אוטומטי שורה חדשה. במידת הצורך, השתמש במאפיין <code>DocumentBuilder.CellFormat</code> כדי לציין עיצוב תאים.</li> <li>הכנס תוכן תא בשיטות <code>DocumentBuilder</code>.</li> <li>חזור על שלבים 2 ו -3 עד להשלמת השורה.</li> <li>התקשר <code>DocumentBuilder.EndRow</code> לסיום השורה הנוכחית. במידת הצורך, השתמש במאפיין <code>DocumentBuilder.RowFormat</code> כדי לציין עיצוב שורות.</li> <li>חזור על שלבים 2-5 עד להשלמת הטבלה.</li> <li>התקשר <code>DocumentBuilder.EndTable</code> כדי לסיים את בניין השולחן. שיטות יצירת הטבלה המתאימות DocumentBuilder מתוארות להלן.</li> </ol> <h3 id="פתיחת-שולחן"> פתיחת שולחן </h3> <p>קריאה <code>DocumentBuilder.StartTable</code> היא הצעד הראשון בבניית טבלה. זה יכול להיקרא גם בתוך תא, ובמקרה זה הוא מתחיל שולחן מקונן. השיטה הבאה להתקשר היא <code>DocumentBuilder.InsertCell</code>.</p> <h3 id="הכנסת-תא"> הכנסת תא </h3> <p>לאחר שתתקשר <code>DocumentBuilder-&gt;InsertCell</code>, נוצר תא חדש וכל תוכן שתוסיף בשיטות אחרות של הכיתה <code>DocumentBuilder</code> יתווסף לתא הנוכחי. כדי להפעיל תא חדש באותה שורה, התקשר שוב <code>DocumentBuilder-&gt;InsertCell</code>. השתמש במאפיין <code>DocumentBuilder.CellFormat</code> כדי לציין עיצוב תאים. הוא מחזיר אובייקט <code>CellFormat</code> המייצג את כל העיצוב עבור תא טבלה.</p> <h3 id="סיום-שורה"> סיום שורה </h3> <p>התקשר <code>DocumentBuilder.EndRow</code> כדי לסיים את השורה הנוכחית. אם אתה מתקשר <code>DocumentBuilder-&gt;InsertCell</code> מיד לאחר מכן, הטבלה ממשיכה בשורה חדשה.</p> <p>השתמש במאפיין <code>DocumentBuilder.RowFormat</code> כדי לציין עיצוב שורות. הוא מחזיר אובייקט <code>RowFormat</code> המייצג את כל העיצוב עבור שורת טבלה.</p> <h3 id="סיום-שולחן"> סיום שולחן </h3> <p>התקשר <code>DocumentBuilder.EndTable</code> כדי לסיים את הטבלה הנוכחית. שיטה זו צריכה להיקרא רק פעם אחת אחרי <code>DocumentBuilder-&gt;EndRow</code> נקרא. כאשר נקרא, <code>DocumentBuilder.EndTable</code> מעביר את הסמן מהתא הנוכחי למצב ממש אחרי הטבלה. הדוגמה הבאה מדגימה כיצד לבנות טבלה מעוצבת המכילה 2 שורות ו -2 עמודות.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderBuildTable-DocumentBuilderBuildTable.cpp"></script> <h2 id="הוספת-הפסקה"> הוספת הפסקה </h2> <p>אם ברצונך להתחיל במפורש שורה, פסקה, עמודה, קטע או עמוד חדשים, התקשר <code>DocumentBuilder.InsertBreak</code>. העבירו לשיטה זו את סוג ההפסקה שעליכם להכניס המיוצג על ידי ספירת <code>BreakType</code>. להלן דוגמה מראה כיצד להוסיף מעברי דף למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertBreak-DocumentBuilderInsertBreak.cpp"></script> <h2 id="הוספת-תמונה"> הוספת תמונה </h2> <p>DocumentBuilder מספק מספר עומסי יתר של שיטת <code>DocumentBuilder-&gt;InsertImage</code> המאפשרת להכניס תמונה מוטבעת או צפה. אם התמונה היא EMF או WMF מטא-קובץ, היא תוכנס למסמך בפורמט מטא-קובץ. כל שאר התמונות יאוחסנו בפורמט PNG. שיטת <code>DocumentBuilder-&gt;InsertImage</code> יכולה להשתמש בתמונות ממקורות שונים:</p> <ul> <li>מקובץ או <code>URL</code> על ידי העברת פרמטר מחרוזת <code>DocumentBuilder-&gt;InsertImage</code>.</li> <li>מזרם על ידי העברת פרמטר <code>Stream</code> <code>DocumentBuilder-&gt;InsertImage</code>.</li> <li>מאובייקט תמונה על ידי העברת פרמטר תמונה <code>DocumentBuilder-&gt;InsertImage</code>.</li> <li>ממערך בתים על ידי העברת פרמטר מערך בתים <code>DocumentBuilder.InsertImage</code>.עבור כל אחת מהשיטות <code>DocumentBuilder-&gt;InsertImage</code>, ישנם עומסי יתר נוספים המאפשרים לך להוסיף תמונה עם האפשרויות הבאות:</li> <li>מוטבע או צף במיקום מסוים, למשל, <code>DocumentBuilder-&gt;InsertImage</code>.</li> <li>סולם אחוזים או גודל מותאם אישית, למשל, <code>DocumentBuilder.InsertImage</code>. יתר על כן, שיטת <code>DocumentBuilder-&gt;InsertImage</code> מחזירה אובייקט <code>Shape</code> שנוצר והוכנס זה עתה, כך שתוכל לשנות עוד יותר את מאפייני הצורה.</li> </ul> <h3 id="הוספת-תמונה-מוטבעת"> הוספת תמונה מוטבעת </h3> <p>העבר מחרוזת אחת המייצגת קובץ המכיל את התמונה ל - <code>DocumentBuilder-&gt;InsertImage</code> כדי להכניס את התמונה למסמך כגרפיקה מוטבעת. הדוגמה הבאה מראה כיצד להוסיף תמונה מוטבעת במיקום הסמן למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertImage-DocumentBuilderInsertInlineImage.cpp"></script> <h3 id="הוספת-תמונה-צפה-ממוקמת-לחלוטין"> הוספת תמונה צפה (ממוקמת לחלוטין) </h3> <p>דוגמה זו מכניסה תמונה צפה מקובץ או <code>URL</code> במיקום ובגודל מוגדרים.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertImage-DocumentBuilderInsertFloatingImage.cpp"></script> <h2 id="הוספת-סימניה"> הוספת סימניה </h2> <p>כדי להוסיף סימניה למסמך, עליך לבצע את הפעולות הבאות:</p> <ol> <li>התקשר <code>DocumentBuilder-&gt;StartBookmark</code> והעביר לו את השם הרצוי של הסימנייה.</li> <li>הכנס את טקסט הסימנייה בשיטות DocumentBuilder.</li> <li>התקשר <code>DocumentBuilder.EndBookmark</code> והעביר לו את אותו השם שבו השתמשת עם <strong>DocumentBuilder-&gt;StartBookmark</strong>.</li> <li>סימניות יכולות לחפוף ולפרוס כל טווח. כדי ליצור סימניה חוקית עליך להתקשר גם <code>DocumentBuilder-&gt;StartBookmark</code> וגם <code>DocumentBuilder-&gt;EndBookmark</code> עם אותו שם סימניה.</li> </ol> <div class="alert alert-primary" role="alert"> סימניות או סימניות שנוצרו בצורה גרועה עם שמות כפולים יתעלמו בעת שמירת המסמך. </div> <p>הדוגמה הבאה מראה כיצד להוסיף סימניה למסמך באמצעות בונה מסמכים.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertBookmark-DocumentBuilderInsertBookmark.cpp"></script> <h2 id="הוספת-שדה-form"> הוספת שדה &lt;code&gt;Form&lt;/code&gt; </h2> <p>שדות טופס הם מקרה מסוים של שדות Word המאפשר &ldquo;אינטראקציה&rdquo; עם המשתמש. שדות טופס ב Microsoft Word כוללים תיבת טקסט, תיבה משולבת ו checkbox.DocumentBuilder מספק שיטות מיוחדות להכנסת כל סוג של שדה טופס למסמך: <code>DocumentBuilder.InsertTextInput</code>, <code>DocumentBuilder-&gt;InsertCheckBox</code> ו <code>DocumentBuilder.InsertComboBox</code>. שים לב שאם אתה מציין שם לשדה הטופס, סימניה נוצרת אוטומטית עם אותו שם.</p> <h3 id="הוספת-קלט-טקסט"> הוספת קלט טקסט </h3> <p><code>DocumentBuilder.InsertTextInput</code> כדי להכניס תיבת טקסט למסמך. להלן דוגמה מראה כיצד להוסיף שדה טופס קלט טקסט למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertTextInputFormField.cpp"></script> <h3 id="הוספת-תיבת-סימון"> הוספת תיבת סימון </h3> <p>התקשר <code>DocumentBuilder.InsertCheckBox</code> כדי להכניס checkbox למסמך. הדוגמה הבאה מראה כיצד להוסיף שדה טופס checkbox למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertCheckBoxFormField.cpp"></script> <h3 id="הוספת-תיבה-משולבת"> הוספת תיבה משולבת </h3> <p>התקשר <code>DocumentBuilder.InsertComboBox</code> כדי להכניס תיבה משולבת למסמך. להלן דוגמא מראה כיצד להוסיף שדה טופס תיבה משולבת למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertComboBoxFormField.cpp"></script> <h2 id="הוספת-אזור-ברמת-השדה"> הוספת אזור ברמת השדה </h2> <p>לקוחות יכולים לציין אזור ברמת השדה כעת ויכולים להשיג שליטה טובה יותר. ניתן לשייך מזהי אזור לכל שדה בתוך DocumentBuilder. הדוגמאות שלהלן ממחישות כיצד להשתמש באפשרות זו.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Fields-SpecifylocaleAtFieldlevel-SpecifylocaleAtFieldlevel.cpp"></script> <h2 id="הוספת-קישור"> הוספת קישור </h2> <p>השתמש ב <code>DocumentBuilder.InsertHyperlink</code> כדי להכניס היפר-קישור למסמך. שיטה זו מקבלת שלושה פרמטרים: טקסט של הקישור שיוצג במסמך, יעד קישור (URL או שם של סימניה בתוך המסמך) ופרמטר בוליאני שאמור להיות נכון אם <code>URL</code> הוא שם של סימניה בתוך המסמך.DocumentBuilder.InsertHyperlink שיחות פנימיות <code>DocumentBuilder.InsertField</code>.השיטה תמיד מוסיפה אפוסטרופים בתחילת ובסוף URL. שים לב שעליך לציין עיצוב גופן עבור טקסט תצוגת ההיפר-קישור באופן מפורש באמצעות המאפיין <code>Font</code>. הדוגמה הבאה מכניסה קישור למסמך באמצעות DocumentBuilder.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertHyperlink.cpp"></script> <h2 id="הוספת-ole-אובייקט"> הוספת Ole אובייקט </h2> <p>אם אתה רוצה Ole שיחת אובייקט <code>DocumentBuilder.InsertOleObject</code>. לעבור לשיטה זו <code>ProgId</code> במפורש עם פרמטרים אחרים. הדוגמה הבאה מראה כיצד להוסיף Ole אובייקט למסמך.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertOleObject.cpp"></script> <h2 id="הגדר-שם-קובץ-וסיומת-בעת-הכנסת-ole-אובייקט"> הגדר שם קובץ וסיומת בעת הכנסת Ole אובייקט </h2> <p>OLE חבילה היא דרך מורשת ו&quot; לא מתועדת &quot; לאחסן אובייקט מוטבע אם OLE המטפל אינו ידוע. מוקדם Windows גרסאות כגון Windows 3.1, 95 ו 98 היה Packager.exe יישום שניתן להשתמש בו כדי להטביע כל סוג של נתונים במסמך. עכשיו, יישום זה אינו נכלל Windows אבל MS Word ויישומים אחרים עדיין להשתמש בו כדי להטביע נתונים אם OLE המטפל חסר או לא ידוע. OlePackage הכיתה מאפשרת גישה OLE Package מאפיינים. הדוגמה הבאה מראה כיצד להגדיר שם קובץ, סיומת ושם תצוגה עבור OLE Package.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-InsertOleObjectwithOlePackage.cpp"></script> <h2 id="הכנסת-html"> הכנסת HTML </h2> <p>ניתן להוסיף בקלות מחרוזת HTML המכילה קטע HTML או מסמך שלם HTML למסמך Word. פשוט העבירו את המחרוזת הזו לשיטת <code>DocumentBuilder-&gt;InsertHtml</code>. אחד היישומים השימושיים של השיטה הוא אחסון מחרוזת HTML במסד נתונים והכנסתו למסמך במהלך Mail Merge כדי להוסיף את התוכן המעוצב במקום לבנות אותו בשיטות שונות של בונה המסמכים. הדוגמה הבאה מציגה תוספות HTML למסמך באמצעות DocumentBuilder.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertElements-DocumentBuilderInsertHtml.cpp"></script> <h2 id="הכנס-כלל-אופקי-למסמך"> הכנס כלל אופקי למסמך </h2> <p>להיותlow code דוגמה מראה כיצד להוסיף צורת כלל אופקית למסמך בשיטה <code>DocumentBuilder-&gt;InsertHorizontalRule</code>.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderInsertHorizontalRule-DocumentBuilderInsertHorizontalRule.cpp"></script> https://docs.aspose.com/words/he/cpp/using-documentbuilder-to-modify-a-document-easily/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/words/he/cpp/using-documentbuilder-to-modify-a-document-easily/ <h2 id="ציון-עיצוב"> ציון עיצוב </h2> <h3 id="עיצוב-גופן"> עיצוב גופן </h3> <p>עיצוב הגופן הנוכחי מיוצג על ידי אובייקט <code>Font</code> שהוחזר על ידי המאפיין <code>DocumentBuilder.Font</code>. הכיתה <code>Font</code> מכילה מגוון רחב של מאפייני הגופן האפשריים ב Microsoft Word. להלן דוגמה מראה כיצד להגדיר עיצוב גופן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetFontFormatting.cpp"></script> <h3 id="עיצוב-פסקה"> עיצוב פסקה </h3> <p>עיצוב פסקה נוכחי מיוצג על ידי אובייקט <code>ParagraphFormat</code> המוחזר על ידי המאפיין <code>DocumentBuilder.ParagraphFormat</code>. אובייקט זה מכיל מאפיינים שונים של עיצוב פסקאות הזמינים ב Microsoft Word. אתה יכול לאפס בקלות את עיצוב הפסקה לברירת המחדל לסגנון רגיל, מיושר שמאלה, ללא כניסה, ללא ריווח, ללא גבולות וללא הצללה על ידי התקשרות <code>ParagraphFormat.ClearFormatting</code>. להלן דוגמה מראה כיצד להגדיר עיצוב פסקה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetParagraphFormatting.cpp"></script> <h3 id="עבודה-עם-טיפוגרפיה-אסיאתית"> עבודה עם טיפוגרפיה אסיאתית </h3> <h4 id="התאם-אוטומטית-את-הרווח-בין-טקסט-אסייתי-ללטיני-מספרים"> התאם אוטומטית את הרווח בין טקסט אסייתי ללטיני, מספרים </h4> <p>אם אתה מעצב תבנית עם טקסט מזרח אסייתי ולטיני כאחד, וברצונך לשפר את מראה תבנית הטופס על ידי שליטה ברווחים בין שני סוגי הטקסט, תוכל להגדיר את תבנית הטופס שלך כך שתתאים אוטומטית את הרווחים בין שני סוגי הטקסט הללו. אתה יכול להשתמש AddSpaceBetweenFarEastAndAlpha ו AddSpaceBetweenFarEastAndDigit מאפיינים של ParagraphFormat מחלקה כדי להשיג זאת.</p> <p>דוגמה לקוד הבא מראה כיצד להשתמש במאפיינים <code>ParagraphFormat.AddSpaceBetweenFarEastAndAlpha</code> ו <code>ParagraphFormat.AddSpaceBetweenFarEastAndDigit</code>.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetSpacebetweenAsianandLatintext.cpp"></script> <h4 id="שינוי-ריווח-פסקה-אסיה-וכניסות"> שינוי ריווח פסקה אסיה וכניסות </h4> <p>דוגמת הקוד הבאה מדגימה כיצד לשנות את המרווח בין פסקאות אסיה וכניסות.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetSpacebetweenAsianandLatintext.cpp"></script> <h4 id="הגדר-אפשרויות-מעבר-קו"> הגדר אפשרויות מעבר קו </h4> <p>לשונית טיפוגרפיה אסייתית של הדו-שיח <code>Paragraph</code> מאפיינים ב MS Word יש קבוצת מעבר שורה. ניתן להגדיר את האפשרויות של קבוצה זו באמצעות FarEastLineBreakControl, WordWrap, HangingPunctuation מאפיינים של ParagraphFormat כיתה. להיותlow code דוגמה מראה כיצד להשתמש במאפיינים אלה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-SetAsianTypographyLinebreakGroupProp.cpp"></script> <h3 id="עיצוב-תא"> עיצוב תא </h3> <p>עיצוב תאים משמש במהלך בניית טבלה. הוא מיוצג על ידי אובייקט <code>CellFormat</code> שהוחזר על ידי המאפיין <code>DocumentBuilder.CellFormat</code>. CellFormat מתמצת מאפייני תא טבלה שונים כמו רוחב או יישור אנכי. להלן דוגמה מראה כיצד ליצור טבלה המכילה תא מעוצב יחיד.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetTableCellFormatting.cpp"></script> <h3 id="עיצוב-שורה"> עיצוב שורה </h3> <p>עיצוב השורה הנוכחית נקבע על ידי אובייקט <code>RowFormat</code> המוחזר על ידי המאפיין <code>DocumentBuilder.RowFormat</code>. האובייקט מכיל מידע על כל עיצוב שורות הטבלה. להלן דוגמה מראה כיצד ליצור טבלה המכילה תא בודד ולהחיל עיצוב שורה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetTableRowFormatting.cpp"></script> <h3 id="עיצוב-רשימה"> עיצוב רשימה </h3> <p>Aspose.Words מאפשר יצירה קלה של רשימות על ידי יישום עיצוב רשימה. DocumentBuilder מספק את המאפיין <code>DocumentBuilder.ListFormat</code> שמחזיר אובייקט <code>ListFormat</code>. לאובייקט זה מספר שיטות להתחיל ולסיים רשימה ולהגדיל / להקטין את הכניסה. ישנם שני סוגים כלליים של רשימות ב Microsoft Word: תבליטים וממוספרים.</p> <ul> <li>כדי להתחיל רשימה עם תבליטים, התקשר <code>ListFormat.ApplyBulletDefault</code>.</li> <li>כדי להתחיל רשימה ממוספרת, התקשר <code>ListFormat.ApplyNumberDefault</code>.</li> </ul> <p>הכדור או המספר והעיצוב מתווספים לפסקה הנוכחית וכל הפסקאות הנוספות שנוצרו באמצעות <strong>DocumentBuilder</strong> עד <code>ListFormat.RemoveNumbers</code> נקרא להפסיק את עיצוב הרשימה עם תבליטים. ב Word מסמכים, רשימות עשויות להכיל עד תשע רמות. עיצוב רשימה עבור כל רמה מציין באיזה כדור או מספר משתמשים, כניסה שמאלית, רווח בין הכדור לטקסט וכו'.</p> <ul> <li>כדי להגדיל את רמת הרשימה של הפסקה הנוכחית ברמה אחת, התקשר <code>ListFormat.ListIndent</code>.</li> <li>כדי להקטין את רמת הרשימה של הפסקה הנוכחית ברמה אחת, התקשר <code>ListFormat.ListOutdent</code>.</li> </ul> <p>השיטות משנות את רמת הרשימה ומחילות את מאפייני העיצוב של הרמה החדשה.</p> <div class="alert alert-primary" role="alert"> אתה יכול גם להשתמש במאפיין <code>ListFormat.ListLevelNumber</code> כדי לקבל או להגדיר את רמת הרשימה עבור הפסקה. רמות הרשימה מסומנות 0 עד 8. </div> <p>להלן דוגמא מראה כיצד לבנות רשימה מדורגת.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetMultilevelListFormatting.cpp"></script> <h3 id="הגדרת-עמוד-ועיצוב-מקטעים"> הגדרת עמוד ועיצוב מקטעים </h3> <p>מאפייני הגדרת עמוד וקטע מכוסים באובייקט <code>PageSetup</code> המוחזר על ידי המאפיין <code>DocumentBuilder.PageSetup</code>. האובייקט מכיל את כל תכונות הגדרת העמוד של קטע (שוליים שמאליים, שוליים תחתונים, גודל נייר וכן הלאה) כמאפיינים. הדוגמה הבאה מראה כיצד להגדיר מאפיינים כגון גודל עמוד וכיוון עבור החלק הנוכחי.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderSetPageSetupAndSectionFormatting.cpp"></script> <h3 id="החלת-סגנון"> החלת סגנון </h3> <p>אובייקטים מסוימים בעיצוב כמו גופן או ParagraphFormat תומכים בסגנונות. סגנון מובנה יחיד או מוגדר על ידי משתמש מיוצג על ידי אובייקט <code>Style</code> המכיל את מאפייני הסגנון המתאימים כמו שם, סגנון בסיס, עיצוב גופן ופסקה של הסגנון וכן הלאה.</p> <p>יתר על כן, אובייקט <strong>Style</strong> מספק את המאפיין <code>Style.StyleIdentifier</code> שמחזיר מזהה סגנון שאינו תלוי באזור המיוצג על ידי ערך ספירה <strong>Style.StyleIdentifier</strong>. הנקודה היא ששמות הסגנונות המובנים ב Microsoft Word ממוקמים עבור שפות שונות. באמצעות מזהה סגנון, תוכל למצוא את הסגנון הנכון ללא קשר לשפת המסמך. ערכי הספירה מתאימים לסגנונות המובנים Microsoft Word כגון רגיל, Heading 1, Heading 2 וכו'. לכל הסגנונות המוגדרים על ידי המשתמש מוקצה <strong>StyleIdentifier.User value</strong>. להלן דוגמה מראה כיצד להחיל סגנון פסקה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderApplyParagraphStyle.cpp"></script> <h3 id="גבולות-והצללה"> גבולות והצללה </h3> <p>גבולות מיוצגים על ידי BorderCollection. זהו אוסף של אובייקטים הגבול כי הם נגישים על ידי אינדקס או לפי סוג הגבול. סוג הגבול מיוצג על ידי הספירה <code>BorderType</code>. ערכים מסוימים של הספירה חלים על מספר או רק אלמנט מסמך אחד. לדוגמה, <code>BorderType.Bottom</code> חל על פסקה או תא טבלה ואילו <code>BorderType.DiagonalDown</code> מציין את הגבול האלכסוני בתא טבלה בלבד.</p> <p>גם לאוסף הגבולות וגם לכל גבול נפרד יש תכונות דומות כמו צבע, סגנון קו, רוחב קו, מרחק מטקסט וצל אופציונלי. הם מיוצגים על ידי מאפיינים של אותו שם. ניתן להשיג סוגי גבולות שונים על ידי שילוב ערכי המאפיינים. בנוסף, הן <strong>BorderCollection</strong> והן <strong>Border</strong> אובייקטים מאפשרים לך לאפס ערכים אלה לברירת מחדל על ידי קריאה לשיטת <code>Border.ClearFormatting</code>. שים לב שכאשר מאפייני הגבול מאופסים לערכי ברירת המחדל, הגבול אינו נראה. הכיתה <code>Shading</code> מכילה תכונות הצללה עבור רכיבי מסמך. ניתן להגדיר את מרקם ההצללה הרצוי ואת הצבעים המוחלים על הרקע והחזית של האלמנט.</p> <p>מרקם ההצללה מוגדר בערך ספירה <code>TextureIndex</code> המאפשר יישום של דפוסים שונים על האובייקט <strong>Shading</strong>. לדוגמה, כדי להגדיר צבע רקע עבור אלמנט מסמך, השתמש בערך <code>TextureIndex.TextureSolid</code> והגדר את צבע הצללת החזית בהתאם לצורך. הדוגמה הבאה מראה כיצד להחיל גבולות והצללה על פסקה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-DocumentBuilderApplyBordersAndShadingToParagraph.cpp"></script> <h3 id="הצמד-לרשת"> הצמד לרשת </h3> <p>Aspose.Words מספק שני מאפיינים <code>ParagraphFormat.SnapToGrid</code> ו <code>Font.SnapToGrid</code> כדי לקבל ולהגדיר תכונת פסקה הצמד לרשת.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderSetFormatting-SetSnapToGrid.cpp"></script> <h2 id="הזזת-הסמן"> הזזת הסמן </h2> <h3 id="איתור-מיקום-הסמן-הנוכחי"> איתור מיקום הסמן הנוכחי </h3> <p>אתה יכול להשיג היכן הסמן של הקבלן ממוקם כעת בכל עת. המאפיין <code>DocumentBuilder.CurrentNode</code> מחזיר את הצומת שנבחר כעת בבונה זה. הצומת הוא ילד ישיר של פסקה. כל פעולות הוספה שתבצע באמצעות <code>DocumentBuilder</code> יכניסו לפני <code>DocumentBuilder.CurrentNode</code>. כאשר הפסקה הנוכחית ריקה או שהסמן ממוקם ממש לפני סוף הפסקה, <code>DocumentBuilder.CurrentNode</code> מחזיר אפס.</p> <p>כמו כן, אתה יכול להשתמש במאפיין <code>DocumentBuilder.CurrentParagraph</code>, שמקבל את הפסקה שנבחרה כרגע ב <strong>DocumentBuilder</strong> זה. הדוגמה הבאה מראה כיצד לגשת לצומת הנוכחי בבונה מסמכים. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderCursorPosition.cpp"></script> <h3 id="מעבר-לכל-צומת-פסקאות-וילדיהם"> מעבר לכל צומת (פסקאות וילדיהם) </h3> <p>אם יש לך צומת אובייקט מסמך, שהוא פסקה או ילד ישיר של פסקה, תוכל להפנות את סמן הבונה לצומת זה. השתמש בשיטת <code>DocumentBuilder.MoveTo</code> כדי לבצע זאת. להלן דוגמא מראה כיצד להעביר את מיקום סמן לצומת שצוין. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToNode.cpp"></script> <h3 id="מעבר-למסמך-התחלה--סיום"> מעבר למסמך התחלה / סיום </h3> <p>אם עליך לעבור לתחילת המסמך, התקשר <code>DocumentBuilder.MoveToDocumentStart</code>. אם עליך לעבור לסוף המסמך, התקשר <code>DocumentBuilder.MoveToDocumentEnd</code>. להלן דוגמא מראה כיצד להעביר את מיקום סמן להתחלה או הסוף של מסמך. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToDocumentStartEnd.cpp"></script> <h3 id="מעבר-לקטע"> מעבר לקטע </h3> <p>אם אתה עובד עם מסמך המכיל מספר קטעים, תוכל לעבור לקטע הרצוי באמצעות <code>DocumentBuilder.MoveToSection</code>. שיטה זו מעבירה את הסמן לתחילת קטע מסוים ומקבלת את האינדקס של החלק הנדרש. כאשר מדד החלקים גדול או שווה ל-0, הוא מציין אינדקס מתחילת המסמך כאשר 0 הוא החלק הראשון. כאשר אינדקס החלקים קטן מ-0, הוא מציין אינדקס מסוף המסמך כאשר -1 הוא החלק האחרון. להלן דוגמא מראה כיצד להעביר את מיקום סמן לקטע שצוין. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToSection.cpp"></script> <h3 id="מעבר-לכותרת-עליונה--תחתונה"> מעבר לכותרת עליונה / תחתונה </h3> <p>כאשר אתה צריך למקם נתונים מסוימים בכותרת עליונה או תחתונה, עליך לעבור לשם תחילה באמצעות <code>DocumentBuilder.MoveToHeaderFooter</code>. השיטה מקבלת ערך ספירה HeaderFooterType שמזהה את סוג הכותרת העליונה או התחתונה למקום שבו יש להזיז את הסמן. אם ברצונך ליצור כותרות עליונות ותחתונות שונות עבור העמוד הראשון, עליך להגדיר את המאפיין <code>PageSetup.DifferentFirstPageHeaderFooter</code> ל <strong>true</strong>. אם ברצונך ליצור כותרות עליונות ותחתונות שונות עבור דפים זוגיים ומשונים, עליך להגדיר <code>PageSetup.OddAndEvenPagesHeaderFooter</code> ל <strong>true</strong>.</p> <p>אם אתה צריך לחזור לסיפור הראשי, השתמש <strong>DocumentBuilder.MoveToSection</strong> כדי לצאת מהכותרת העליונה או התחתונה. הדוגמה הבאה יוצרת כותרות עליונות ותחתונות במסמך באמצעות DocumentBuilder.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderHeadersAndFooters.cpp"></script> <h3 id="מעבר-לפסקה"> מעבר לפסקה </h3> <p>השתמש ב <code>DocumentBuilder.MoveToParagraph</code> כדי להזיז את הסמן לפסקה הרצויה בסעיף הנוכחי. אתה צריך להעביר שני פרמטרים לשיטה זו: paragraphIndex (האינדקס של הפסקה כדי לעבור) ו characterIndex (האינדקס של התו בתוך הפסקה).</p> <p>הניווט מתבצע בתוך הסיפור הנוכחי של החלק הנוכחי. כלומר, אם העברת את הסמן לכותרת הראשית של החלק הראשון, אז paragraphIndex מציין את האינדקס של הפסקה בתוך הכותרת של אותו קטע.</p> <p>כאשר paragraphIndex גדול או שווה ל-0, הוא מציין אינדקס מתחילת הקטע כאשר 0 הוא הפסקה הראשונה. כאשר paragraphIndex הוא פחות מ-0, הוא מציין אינדקס מסוף הקטע כאשר -1 הוא הפסקה האחרונה.</p> <p>ניתן כרגע לציין את אינדקס התווים רק כ-0 כדי לעבור לתחילת הפסקה או -1 כדי לעבור לסוף הפסקה. להלן דוגמא מראה כיצד להעביר את מיקום סמן לפסקה שצוינה. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToParagraph.cpp"></script> <h3 id="מעבר-לתא-שולחן"> מעבר לתא שולחן </h3> <p>השתמש ב <code>DocumentBuilder.MoveToCell</code> אם עליך להעביר את הסמן לתא טבלה בקטע הנוכחי. שיטה זו מקבלת ארבעה פרמטרים:</p> <ul> <li>tableIndex - האינדקס של הטבלה כדי לעבור.</li> <li>rowIndex - אינדקס השורה בטבלה.</li> <li>columnIndex - אינדקס העמודה בטבלה.</li> <li>characterIndex - אינדקס התו בתוך התא.</li> </ul> <p>הניווט מתבצע בתוך הסיפור הנוכחי של החלק הנוכחי. עבור פרמטרי האינדקס, כאשר האינדקס גדול או שווה ל-0, הוא מציין אינדקס מההתחלה כאשר 0 הוא האלמנט הראשון. כאשר האינדקס קטן מ-0, הוא מציין אינדקס מהסוף כאשר -1 הוא האלמנט האחרון.</p> <p>כמו כן, שים לב ש characterIndex כרגע יכול לציין רק 0 כדי לעבור לתחילת התא או -1 כדי לעבור לסוף התא. להלן דוגמא מראה כיצד להעביר את מיקום סמן לתא הטבלה שצוין. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToTableCell.cpp"></script> <h3 id="מעבר-לסימנייה"> מעבר לסימנייה </h3> <p>סימניות משמשות לעתים קרובות כדי לסמן מקומות מסוימים במסמך שבו יש להוסיף אלמנטים חדשים. כדי לעבור לסימנייה, השתמש ב <code>DocumentBuilder.MoveToBookmark</code>. לשיטה זו שני עומסי יתר. הפשוטה ביותר לא מקבלת דבר מלבד שם הסימנייה שאליה יש להזיז את הסמן. להלן דוגמא מראה כיצד להעביר את מיקום סמן לסימנייה. ניתן להוריד קובץ תבנית של דוגמה זו מכאן.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToBookmark.cpp"></script> <p>עומס יתר זה מעביר את הסמן למיקום מיד לאחר תחילת הסימנייה עם השם שצוין. עומס יתר נוסף <code>DocumentBuilder.MoveToBookmark</code> מעביר את הסמן לסימניה בדיוק רב יותר. הוא מקבל שני פרמטרים בוליאניים נוספים:</p> <ul> <li>isStart קובע אם להזיז את הסמן להתחלה או לסוף הסימנייה.</li> <li>isAfter קובע אם להזיז את הסמן להיות אחרי מיקום ההתחלה או הסיום של הסימניה, או להזיז את הסמן להיות לפני מיקום ההתחלה או הסיום של הסימניה.</li> </ul> <p>להלן דוגמא מראה כיצד להעביר את מיקום סמן רק לאחר סיום הסימנייה.</p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToBookmarkEnd.cpp"></script> <p>ההשוואה לשתי השיטות אינה תלויה באותיות רישיות.</p> <p>הכנסת טקסט חדש בדרך זו אינה מחליפה את הטקסט הקיים של הסימנייה. שים לב שחלק מהסימניות במסמך מוקצות לשדות טופס. מעבר לסימנייה כזו והכנסת טקסט שם מכניס את הטקסט לקוד שדה הטופס. למרות שזה לא יבטל את שדה הטופס, הטקסט שהוכנס לא יהיה גלוי מכיוון שהוא הופך לחלק מקוד השדה.</p> <h2 id="כיצד-להמיר-בין-יחידות-מדידה"> כיצד להמיר בין יחידות מדידה </h2> <p>רוב מאפייני האובייקט המסופקים ב Aspose.Words API המייצגים מדידה מסוימת (רוחב/גובה, שוליים ומרחקים שונים) מקבלים ערכים בנקודות (1 אינץ ' שווה ל 72 נקודות). לפעמים זה לא נוח אז יש את הכיתה <code>ConvertUtil</code> המספקת פונקציות עוזר להמיר בין יחידות מדידה שונות. זה מאפשר המרת אינץ &lsquo;לנקודות, נקודות לאינץ&rsquo;, פיקסלים לנקודות ונקודות לפיקסלים. כאשר פיקסלים מומרים לנקודות ולהיפך, ניתן לבצע זאת ברזולוציות 96 נקודות לאינץ ' או ברזולוציית מדד המחירים לצרכן שצוינה. <strong>ConvertUtil</strong></p> <script type="application/javascript" src="https://gist.github.com/aspose-com-gists/518f03cac02abb105e02f55edb7de9f9.js?file=cpp-Programming-Documents-ConvertUtil-UtilityClasses-ConvertBetweenMeasurementUnits.cpp"></script>