Thêm chú giải công cụ vào văn bản trong tệp PDF
Hướng dẫn này sẽ hướng dẫn bạn quy trình thêm chú giải công cụ vào văn bản trong tệp PDF bằng Aspose.PDF cho .NET. Mã nguồn C# được cung cấp thể hiện các bước cần thiết.
Yêu cầu
Trước khi bắt đầu, hãy đảm bảo rằng bạn có những điều sau:
- Visual Studio hoặc bất kỳ trình biên dịch C# nào khác được cài đặt trên máy của bạn.
- Aspose.PDF cho thư viện .NET. Bạn có thể tải xuống từ trang web chính thức của Aspose hoặc sử dụng trình quản lý gói như NuGet để cài đặt nó.
Bước 1: Thiết lập dự án
- Tạo một dự án C# mới trong môi trường phát triển ưa thích của bạn.
- Thêm tham chiếu đến thư viện Aspose.PDF for .NET.
Bước 2: Nhập các không gian tên bắt buộc
Trong tệp mã mà bạn muốn thêm chú giải công cụ vào văn bản, hãy thêm các lệnh sử dụng sau vào đầu tệp:
using Aspose.Pdf;
using Aspose.Pdf.Forms;
using Aspose.Pdf.Text;
Bước 3: Thiết lập thư mục tài liệu
Trong mã, xác định dòng có nội dungstring dataDir = "YOUR DOCUMENT DIRECTORY"; và thay thế"YOUR DOCUMENT DIRECTORY" với đường dẫn đến thư mục nơi tài liệu của bạn được lưu trữ.
Bước 4: Tạo một tài liệu mẫu có văn bản
Tạo một cái mớiDocument đối tượng và thêm các trang có đoạn văn bản. Trong mã được cung cấp, hai đoạn văn bản được thêm vào tài liệu cùng với văn bản chú giải công cụ tương ứng.
Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a tooltip"));
doc.Pages[1].Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a very long tooltip"));
doc.Save(outputFile);
Bước 5: Mở tài liệu và tìm các đoạn văn bản
Tải tài liệu đã tạo bằng cách sử dụngDocument hàm tạo và tìm các đoạn văn bản cần chú giải công cụ bằng cách sử dụngTextFragmentAbsorber.
Document document = new Document(outputFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a tooltip");
document.Pages.Accept(absorb);
TextFragmentCollection textFragments = absorb.TextFragments;
Bước 6: Thêm chú giải công cụ vào đoạn văn bản
Lặp lại các đoạn văn bản được trích xuất và tạo các nút vô hình tại vị trí của chúng. Gán văn bản chú giải công cụ mong muốn choAlternateName tài sản củaButtonField. Thêm các trường nút vào biểu mẫu của tài liệu.
foreach(TextFragment fragment in textFragments)
{
ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
field. AlternateName = "Tooltip for text.";
document.Form.Add(field);
}
Bước 7: Lặp lại cho các đoạn văn bản bổ sung có chú giải công cụ dài
Lặp lại bước 5 và 6 cho các đoạn văn bản có chú giải công cụ dài. Sửa đổi tiêu chí tìm kiếm và văn bản chú giải công cụ cho phù hợp.
absorb = new TextFragmentAbsorber("Move the mouse cursor here to display a very long tooltip");
document.Pages.Accept(absorb);
textFragments = absorb.TextFragments;
foreach(TextFragment fragment in textFragments)
{
ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
field. AlternateName = "Long tooltip text goes here...";
document.Form.Add(field);
}
Bước 8: Lưu tài liệu đã sửa đổi
Lưu tài liệu PDF đã sửa đổi bằng cách sử dụngSave phương pháp củaDocument sự vật.
document. Save(outputFile);
Mã nguồn mẫu cho Thêm chú giải công cụ vào văn bản bằng Aspose.PDF cho .NET
// Đường dẫn đến thư mục tài liệu.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string outputFile = dataDir + "Tooltip_out.pdf";
// Tạo tài liệu mẫu bằng văn bản
Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a tooltip"));
doc.Pages[1].Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a very long tooltip"));
doc.Save(outputFile);
// Mở tài liệu bằng văn bản
Document document = new Document(outputFile);
// Tạo đối tượng TextAbsorber để tìm tất cả các cụm từ khớp với biểu thức chính quy
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a tooltip");
// Chấp nhận phần hấp thụ cho các trang tài liệu
document.Pages.Accept(absorber);
// Lấy các đoạn văn bản được trích xuất
TextFragmentCollection textFragments = absorber.TextFragments;
// Lặp lại các mảnh vỡ
foreach (TextFragment fragment in textFragments)
{
// Tạo nút vô hình trên vị trí đoạn văn bản
ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
// Giá trị AlternateName sẽ được ứng dụng xem hiển thị dưới dạng chú giải công cụ
field.AlternateName = "Tooltip for text.";
// Thêm trường nút vào tài liệu
document.Form.Add(field);
}
// Tiếp theo sẽ là sapmle của chú giải công cụ rất dài
absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a very long tooltip");
document.Pages.Accept(absorber);
textFragments = absorber.TextFragments;
foreach (TextFragment fragment in textFragments)
{
ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
// Đặt văn bản rất dài
field.AlternateName = "Lorem ipsum dolor sit amet, consectetur adipiscing elit," +
" sed do eiusmod tempor incididunt ut labore et dolore magna" +
" aliqua. Ut enim ad minim veniam, quis nostrud exercitation" +
" ullamco laboris nisi ut aliquip ex ea commodo consequat." +
" Duis aute irure dolor in reprehenderit in voluptate velit" +
" esse cillum dolore eu fugiat nulla pariatur. Excepteur sint" +
" occaecat cupidatat non proident, sunt in culpa qui officia" +
" deserunt mollit anim id est laborum.";
document.Form.Add(field);
}
// Lưu tài liệu
document.Save(outputFile);
Phần kết luận
Bạn đã thêm thành công chú giải công cụ vào văn bản trong tài liệu PDF bằng Aspose.PDF cho .NET. Bây giờ có thể tìm thấy tệp PDF kết quả tại đường dẫn tệp đầu ra được chỉ định.
Câu hỏi thường gặp
Hỏi: Trọng tâm của hướng dẫn này là gì?
Đáp: Hướng dẫn này tập trung vào việc thêm chú giải công cụ vào văn bản trong tệp PDF bằng thư viện Aspose.PDF cho .NET. Mã nguồn C# được cung cấp thể hiện các bước cần thiết để đạt được điều này.
Câu hỏi: Những không gian tên nào cần được nhập cho hướng dẫn này?
Đáp: Trong tệp mã nơi bạn muốn thêm chú giải công cụ vào văn bản, hãy nhập các vùng tên sau vào đầu tệp:
using Aspose.Pdf;
using Aspose.Pdf.Forms;
using Aspose.Pdf.Text;
Câu hỏi: Làm cách nào để chỉ định thư mục tài liệu?
A: Trong mã, tìm dòngstring dataDir = "YOUR DOCUMENT DIRECTORY"; và thay thế"YOUR DOCUMENT DIRECTORY" với đường dẫn thực tế đến thư mục tài liệu của bạn.
Câu hỏi: Làm cách nào tôi có thể tạo tài liệu mẫu bằng văn bản?
Đáp: Ở Bước 4, bạn sẽ tạo mộtDocument đối tượng và thêm các trang có đoạn văn bản. Mã được cung cấp sẽ thêm hai đoạn văn bản có văn bản chú giải công cụ tương ứng.
Hỏi: Làm cách nào để mở tài liệu và tìm các đoạn văn bản?
Đáp: Ở Bước 5, bạn sẽ tải tài liệu đã tạo bằng cách sử dụngDocument hàm tạo và tìm các đoạn văn bản cần chú giải công cụ bằng cách sử dụngTextFragmentAbsorber.
Câu hỏi: Làm cách nào để thêm chú giải công cụ vào các đoạn văn bản?
Đáp: Ở Bước 6, bạn sẽ lặp qua các đoạn văn bản được trích xuất và tạo các nút ẩn ở vị trí của chúng. Văn bản chú giải công cụ được gán choAlternateName tài sản củaButtonFieldđược thêm vào biểu mẫu của tài liệu.
Câu hỏi: Làm cách nào để lặp lại quy trình cho các đoạn văn bản bổ sung có chú giải công cụ dài?
Đáp: Đối với các đoạn văn bản có chú giải công cụ dài, hãy lặp lại Bước 5 và 6. Sửa đổi tiêu chí tìm kiếm và văn bản chú giải công cụ cho phù hợp.
Hỏi: Làm cách nào để lưu tài liệu đã sửa đổi?
Đáp: Ở Bước 8, bạn sẽ lưu tài liệu PDF đã sửa đổi bằng cách sử dụngSave phương pháp củaDocument sự vật.
Hỏi: Điểm chính của hướng dẫn này là gì?
Đáp: Bằng cách làm theo hướng dẫn này, bạn đã học được cách nâng cao tài liệu PDF của mình bằng cách thêm chú giải công cụ vào văn bản bằng Aspose.PDF cho .NET. Điều này có thể cung cấp thông tin bổ sung có giá trị cho người đọc khi họ tương tác với nội dung PDF.
