إدراج الروابط التشعبية في إكسل أو أوبن أوفيس
إضافة الروابط الفائقة (Hyperlinks) لربط البيانات
يتم استخدام الارتباط التشعبي لإنشاء ارتباط بين كيانين. الجميع على دراية باستخدام الارتباطات التشعبية، خاصة على المواقع الإلكترونية.
باستخدام Aspose.Cells، يمكن للمطورين إنشاء أنواع مختلفة من الارتباطات التشعبية في ملفات Microsoft Excel. يناقش هذا الموضوع أنواع الارتباطات التشعبية الدعمها Aspose.Cells وكيف يمكن استخدامها في ملفات Excel الخاصة بنا.
إضافة الروابط المختصرة
يمكن إضافة ثلاثة أنواع من الارتباطات التشعبية إلى خلية باستخدام Aspose.Cells:
تسمح Aspose.Cells للمطورين بإضافة الروابط الفائقة إلى ملفات Excel سواء عن طريق استخدام واجهة برمجة التطبيقات أو جداول البيانات المصممة (جداول البيانات حيث يتم إنشاء الروابط الفائقة يدويًا ويتم استخدام Aspose.Cells لاستيرادها إلى جداول بيانات أخرى).
يوفر Aspose.Cells فئةً تسمى Workbook التي تمثل ملف Microsoft Excel. تحتوي فئة Workbook على تجميعة WorksheetCollection التي تتيح الوصول إلى كل ورقة عمل في ملف Excel. يتم تمثيل ورقة العمل بواسطة فئة Worksheet. توفر فئة Worksheet طرقًا مختلفة لإضافة روابط فائقة مختلفة إلى ملفات Excel.
إضافة رابط إلى عنوان URL
تحتوي فئة Worksheet على مجموعة Hyperlinks. يمثل كل عنصر في مجموعة Hyperlinks رابطًا فائقًا. يمكن إضافة روابط فائقة إلى عناوين URL عن طريق استدعاء Hyperlinks من مجموعة Hyperlinks إلى الخلية عن طريق استخدام الطريقة Add . تأخذ الطريقة Add المعلمات التالية:
- اسم الخلية، اسم الخلية التي سيتم إضافة الرابط التشعبي إليها.
- عدد الصفوف، عدد الصفوف في نطاق الارتباط الفائق.
- عدد الأعمدة، عدد الأعمدة في نطاق الرابط الفائق.
- عنوان URL, عنوان عنوان URL.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getSharedDataDir(AddingLinkToURL.class) + "data/"; | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first worksheet. | |
| WorksheetCollection worksheets = workbook.getWorksheets(); | |
| Worksheet sheet = worksheets.get(0); | |
| HyperlinkCollection hyperlinks = sheet.getHyperlinks(); | |
| // Adding a hyperlink to a URL at "A1" cell | |
| hyperlinks.add("A1", 1, 1, "http://www.aspose.com"); | |
| // Saving the Excel file | |
| workbook.save(dataDir + "AddingLinkToURL_out.xls"); | |
| // Print message | |
| System.out.println("Process completed successfully"); |
في المثال أعلاه، يتم إضافة رابط فائق إلى عنوان URL في خلية فارغة، A1. في مثل هذه الحالات، إذا كانت الخلية فارغة، يتم أيضًا إضافة عنوان URL لتلك الخلية الفارغة كقيمتها. إذا كانت الخلية ليست فارغة وتم إضافة رابط فائق، يبدو قيمة الخلية كنص عادي. لجعله يبدو كرابط فائق، ضع الإعدادات المناسبة لتنسيق تلك الخلية.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getSharedDataDir(AddingLinkToURLNotEmpty.class) + "data/"; | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first worksheet. | |
| WorksheetCollection worksheets = workbook.getWorksheets(); | |
| Worksheet sheet = worksheets.get(0); | |
| // Setting a value to the "A1" cell | |
| Cells cells = sheet.getCells(); | |
| Cell cell = cells.get("A1"); | |
| cell.setValue("Visit Aspose"); | |
| // Setting the font color of the cell to Blue | |
| Style style = cell.getStyle(); | |
| style.getFont().setColor(Color.getBlue()); | |
| // Setting the font of the cell to Single Underline | |
| style.getFont().setUnderline(FontUnderlineType.SINGLE); | |
| cell.setStyle(style); | |
| HyperlinkCollection hyperlinks = sheet.getHyperlinks(); | |
| // Adding a hyperlink to a URL at "A1" cell | |
| hyperlinks.add("A1", 1, 1, "http://www.aspose.com"); | |
| // Saving the Excel file | |
| workbook.save(dataDir + "AddingLinkToURLNotEmpty_out.xls"); |
إضافة رابط إلى خلية في نفس الملف
من الممكن إضافة روابط فائقة إلى الخلايا في نفس ملف Excel عن طريق استدعاء Hyperlinks من مجموعة Hyperlinks إلى الخلية عن طريق استخدام الطريقة Add . تعمل الطريقة Add لكلا الروابط الداخلية والخارجية. إحدى الإصدارات المتحملة للطريقة تأخذ المعلمات التالية:
- اسم الخلية، اسم الخلية التي سيتم إضافة الرابط التشعبي إليها.
- عدد الصفوف، عدد الصفوف في نطاق الارتباط الفائق.
- عدد الأعمدة، عدد الأعمدة في نطاق الارتباط الفائق.
- URL، عنوان الخلية المستهدفة.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getSharedDataDir(AddingLinkToAnotherCell.class) + "data/"; | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first worksheet. | |
| WorksheetCollection worksheets = workbook.getWorksheets(); | |
| workbook.getWorksheets().add(); | |
| Worksheet sheet = worksheets.get(0); | |
| // Setting a value to the "A1" cell | |
| Cells cells = sheet.getCells(); | |
| Cell cell = cells.get("A1"); | |
| cell.setValue("Visit Aspose"); | |
| // Setting the font color of the cell to Blue | |
| Style style = cell.getStyle(); | |
| style.getFont().setColor(Color.getBlue()); | |
| // Setting the font of the cell to Single Underline | |
| style.getFont().setUnderline(FontUnderlineType.SINGLE); | |
| cell.setStyle(style); | |
| HyperlinkCollection hyperlinks = sheet.getHyperlinks(); | |
| // Adding an internal hyperlink to the "B9" cell of the other worksheet "Sheet2" in the same Excel file | |
| hyperlinks.add("B3", 1, 1, "Sheet2!B9"); | |
| // Saving the Excel file | |
| workbook.save(dataDir + "ALinkTACell_out.xls"); | |
| // Print message | |
| System.out.println("Process completed successfully"); |
إضافة رابط إلى ملف خارجي
من الممكن إضافة الروابط الفائقة للملفات الخارجية من خلال استدعاء Hyperlinks مجموعة الأساليب Add . وتأخذ طريقة Add البارامترات التالية:
- اسم الخلية، اسم الخلية التي سيتم إضافة الرابط التشعبي إليها.
- عدد الصفوف، عدد الصفوف في نطاق الارتباط الفائق.
- عدد الأعمدة، عدد الأعمدة في نطاق الارتباط الفائق.
- عنوان الويب (URL)، عنوان الهدف، ملف Excel الخارجي.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getSharedDataDir(AddingLinkToExternalFile.class) + "data/"; | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first worksheet. | |
| WorksheetCollection worksheets = workbook.getWorksheets(); | |
| Worksheet sheet = worksheets.get(0); | |
| // Setting a value to the "A1" cell | |
| Cells cells = sheet.getCells(); | |
| Cell cell = cells.get("A1"); | |
| cell.setValue("Visit Aspose"); | |
| // Setting the font color of the cell to Blue | |
| Style style = cell.getStyle(); | |
| style.getFont().setColor(Color.getBlue()); | |
| // Setting the font of the cell to Single Underline | |
| style.getFont().setUnderline(FontUnderlineType.SINGLE); | |
| cell.setStyle(style); | |
| HyperlinkCollection hyperlinks = sheet.getHyperlinks(); | |
| // Adding a link to the external file | |
| hyperlinks.add("A5", 1, 1, dataDir + "book1.xls"); | |
| // Saving the Excel file | |
| workbook.save(dataDir + "ALToEFile_out.xls"); | |
| // Print message | |
| System.out.println("Process completed successfully"); |