ハイパーリンクの追加または変更
Microsoft Word ドキュメントのハイパーリンクは HYPERLINK
フィールドです。 Aspose.Words では、ハイパーリンクは FieldHyperlink クラスを通じて実装されます。
ハイパーリンクの挿入
insert_hyperlink メソッドを使用して、ドキュメントにハイパーリンクを挿入します。このメソッドは 3 つのパラメータを受け入れます。
- 文書内に表示されるリンクのテキスト
- リンク先(文書内のURLまたはブックマーク名)
URL
がドキュメント内のブックマークの名前である場合は true である必要があるブール パラメーター
InsertHyperlink メソッドでは、URL の先頭と末尾に常にアポストロフィが追加されます。
Font
プロパティを使用して、ハイパーリンク表示テキストのフォント形式を明示的に指定する必要があることに注意してください。
次のコード例は、DocumentBuilder を使用してドキュメントにハイパーリンクを挿入する方法を示しています。
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
builder.write("Please make sure to visit ") | |
builder.font.color = drawing.Color.blue | |
builder.font.underline = aw.Underline.SINGLE | |
builder.insert_hyperlink("Aspose Website", "http:#www.aspose.com", False) | |
builder.font.clear_formatting() | |
builder.write(" for more information.") | |
doc.save(docs_base.artifacts_dir + "AddContentUsingDocumentBuilder.insert_hyperlink.docx") |
ハイパーリンクの置換または変更
Microsoft Word ドキュメントのハイパーリンクはフィールドです。 Word 文書のフィールドは、フィールド開始、フィールド コード、フィールド区切り文字、フィールド結果、フィールド終了を含む複数のノードで構成される複雑な構造です。フィールドはネストでき、豊富なコンテンツを含めることができ、文書内の複数の段落またはセクションにまたがることができます。
ハイパーリンクを置換または変更するには、ドキュメント内でハイパーリンクを検索し、そのテキスト、URL、またはその両方を置換する必要があります。
次のコード例は、Word 文書内のすべてのハイパーリンクを検索し、その URL
と表示名を変更する方法を示しています。
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document(docs_base.my_dir + "Hyperlinks.docx") | |
for field in doc.range.fields : | |
if field.type == aw.fields.FieldType.FIELD_HYPERLINK: | |
hyperlink = field.as_field_hyperlink() | |
# Some hyperlinks can be local (links to bookmarks inside the document), ignore these. | |
if hyperlink.sub_address != None : | |
continue | |
hyperlink.address = "http:#www.aspose.com" | |
hyperlink.result = "Aspose - The .net & Java Component Publisher" | |
doc.save(docs_base.artifacts_dir + "WorkingWithFields.replace_hyperlinks.docx") |