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

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

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

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

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

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

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

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

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

builder.Write("Please make sure to visit ");
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;

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

builder.Font.ClearFormatting();
builder.Write(" for more information.");

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

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

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

لاستبدال الارتباطات التشعبية أو تعديلها، يلزم العثور على الارتباطات التشعبية في المستند واستبدال النص أو عناوين URL الخاصة بها أو كليهما.

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

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

foreach (Field field in doc.Range.Fields)
{
    if (field.Type == FieldType.FieldHyperlink)
    {
        FieldHyperlink hyperlink = (FieldHyperlink) field;

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink.SubAddress != null)
            continue;

        hyperlink.Address = "http://www.aspose.com";
        hyperlink.Result = "Aspose - The .NET & Java Component Publisher";
    }
}

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