إضافة أو تعديل الارتباطات التشعبية

الارتباط التشعبي في المستندات Microsoft Word هو حقل HYPERLINK. في Aspose.Words، يتم تنفيذ الارتباطات التشعبية من خلال فئة FieldHyperlink.

إدراج ارتباط تشعبي

استخدم طريقة InsertHyperlink لإدراج ارتباط تشعبي في المستند. تقبل هذه الطريقة ثلاث معلمات:

1. نص الرابط المراد عرضه في المستند
2. وجهة الارتباط (URL أو اسم إشارة مرجعية داخل المستند)
3. المعلمة المنطقية التي يجب أن تكون صحيحة إذا كان URL هو اسم إشارة مرجعية داخل المستند

تضيف طريقة InsertHyperlink دائما الفواصل العليا في بداية ونهاية URL.

لاحظ أنك تحتاج إلى تحديد تنسيق الخط لنص عرض الارتباط التشعبي بشكل صريح باستخدام خاصية Font.

يوضح مثال التعليمات البرمجية التالية كيفية إدراج ارتباط تشعبي في مستند باستخدام DocumentBuilder:

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

builder->Write(u"Please make sure to visit ");
builder->get_Font()->set_Color(System::Drawing::Color::get_Blue());
builder->get_Font()->set_Underline(Underline::Single);

builder->InsertHyperlink(u"Aspose Website", u"http://www.aspose.com", false);

builder->get_Font()->ClearFormatting();
builder->Write(u" for more information.");

doc->Save(ArtifactsDir + u"AddContentUsingDocumentBuilder.InsertHyperlink.docx");

استبدال أو تعديل الارتباطات التشعبية

الارتباط التشعبي في Microsoft Word المستندات هو حقل. الحقل في مستند ورد هو بنية معقدة تتكون من عقد متعددة تتضمن بداية الحقل ورمز الحقل وفاصل الحقل والنتيجة الميدانية ونهاية الحقل. يمكن أن تتداخل الحقول وتحتوي على محتوى غني وتمتد إلى عدة فقرات أو أقسام في مستند.

تنفذ فئة FieldHyperlink حقل HYPERLINK.

يوضح مثال الكود التالي كيفية العثور على جميع الارتباطات التشعبية في مستند ورد وتغيير URL واسم العرض:

//For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>(MyDir + u"Hyperlinks.docx");

for (const auto& field : System::IterateOver(doc->get_Range()->get_Fields()))
{
    if (field->get_Type() == FieldType::FieldHyperlink)
    {
        auto hyperlink = System::DynamicCast<FieldHyperlink>(field);

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink->get_SubAddress() != nullptr)
        {
            continue;
        }

        hyperlink->set_Address(u"http://www.aspose.com");
        hyperlink->set_Result(u"Aspose - The .NET & Java Component Publisher");
    }
}

doc->Save(ArtifactsDir + u"WorkingWithFields.ReplaceHyperlinks.docx");