کار با نشانک ها
نشانک‌ها در سند Microsoft Word مکان‌ها یا قطعاتی را که نام‌گذاری می‌کنید و برای مراجعات بعدی شناسایی می‌کنید، شناسایی می‌کنند. برای مثال، ممکن است از یک نشانک برای شناسایی متنی که می‌خواهید بعداً آن را اصلاح کنید، استفاده کنید. به جای پیمایش در سند برای مکان یابی متن، می توانید با استفاده از کادر محاوره ای نشانک به آن بروید.
اقداماتی که می توان با بوکمارک ها با استفاده از Aspose.Words انجام داد، همان اقداماتی است که می توانید با استفاده از Microsoft Word انجام دهید. می توانید یک نشانک جدید وارد کنید، حذف کنید، به یک نشانک منتقل کنید، یک نام نشانک دریافت کنید یا تنظیم کنید، متن محصور در آن را دریافت یا تنظیم کنید.
یک نشانک درج کنید
از StartBookmark و EndBookmark برای ایجاد یک نشانک با علامت گذاری شروع و پایان آن به ترتیب استفاده کنید. فراموش نکنید که یک نام نشانک را به هر دو روش ارسال کنید. نشانک‌ها در یک سند می‌توانند همپوشانی داشته باشند و در هر محدوده‌ای قرار بگیرند. نشانک‌های بد شکل یا نشانک‌هایی با نام‌های تکراری هنگام ذخیره سند نادیده گرفته می‌شوند.
مثال کد زیر نحوه ایجاد یک نشانک جدید را نشان می دهد:
بوک مارک ها را دریافت کنید
گاهی اوقات لازم است یک مجموعه نشانک برای تکرار از طریق نشانک ها یا برای اهداف دیگر به دست آورید. از ویژگی Node.Range استفاده کنید که توسط هر گره سندی که یک شی Range را نشان می دهد که بخشی از سند موجود در این گره را نشان می دهد، در معرض دید قرار می گیرد. از این شی برای بازیابی BookmarkCollection استفاده کنید و سپس از نمایه ساز مجموعه برای دریافت یک نشانک خاص استفاده کنید.
مثال کد زیر نحوه به دست آوردن نشانک ها از مجموعه نشانک ها را نشان می دهد:
مثال کد زیر نحوه دریافت یا تنظیم نام و متن نشانک را نشان می دهد:
مثال کد زیر نحوه نشانک کردن جدول را نشان می دهد:
اگر نام یک نشانک را به نامی که قبلاً در سند وجود دارد تغییر دهید، هیچ خطایی ایجاد نخواهد شد و تنها اولین نشانک زمانی که سند را ذخیره می کنید ذخیره می شود.
توجه داشته باشید که برخی از نشانک ها در سند به شکل فیلدها اختصاص داده شده اند. حرکت به چنین نشانکی و درج متن در آنجا، متن را در کد فیلد فرم وارد می کند. اگرچه این کار فیلد فرم را باطل نمی کند، متن درج شده قابل مشاهده نخواهد بود زیرا بخشی از کد فیلد می شود.
مثال کد زیر نحوه دسترسی به ستون های جدول نشانک شده را نشان می دهد:
به یک نشانک انتقال دهید
اگر نیاز به درج محتوای غنی (نه فقط متن ساده) در یک نشانک دارید، باید از MoveToBookmark برای انتقال مکان نما به نشانک و سپس از روش ها و ویژگی های DocumentBuilder’s برای درج محتوا استفاده کنید.
نمایش مخفی کردن محتوای نشانک
کل نشانک (شامل محتوای نشانک شده) را می توان در قسمت True فیلد IF با استفاده از Aspose.Words کپسوله کرد. می تواند به گونه ای باشد که فیلد IF حاوی یک فیلد Merge تو در تو در عبارت (سمت چپ اپراتور) باشد و بسته به مقدار Merge Field، فیلد IF محتوای Bookmark را در Word Document نشان دهد یا پنهان کند.
مثال کد زیر نحوه نمایش/پنهان کردن نشانک ها را نشان می دهد: