הוספה או שינוי של היפר-קישורים

היפר-קישור במסמכים 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 הוא שדה. שדה במסמך Word הוא מבנה מורכב המורכב ממספר צמתים הכוללים התחלת שדה, קוד שדה, מפריד שדה, תוצאת שדה וסוף שדה. ניתן לקנן שדות, להכיל תוכן עשיר ולפרוס מספר פסקאות או קטעים במסמך.

הכיתה FieldHyperlink מיישמת את השדה HYPERLINK.

דוגמת הקוד הבאה מראה כיצד למצוא את כל ההיפר-קישורים במסמך Word ומשנה את 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");