مقدمة

هذا المقال يمر عبر المناطق الرئيسية للميزة Aspose. الخلايا FOSS لـ Java a مكتبة Java 17 النقية، مع ترخيص MIT لإنشاء وتعديل Excel .xlsx كتب العمل. سوف تتعلم كيفية إدارة الكتب ورق العمل، وتخزين قيم الخلايا المكتوبة، تطبيق التحقق من صحة البيانات، واستخدام AutoFilter، وتثبيت صفحة التحكم دون أي Microsoft Office الإعتماد.

تستخدم جميع أمثلة الكود فئات من سطح API الموثق للمكتبة. توجد أسماء الفئة والطريقة المعروضة أدناه في الإصدار 1.0.0.

الميزات الرئيسية

ورقة العمل وإدارة ورشة العمل

المجلس الوزاري Workbook أدوات الفئة AutoCloseable لذا فإنه يندمج بشكل نظيف مع نمط Java محاولة مع الموارد. يمكنك إنشاء دفتر عمل فارغ، تحميل موجودة .xlsx الملف، إعادة تسمية ورق العمل، وإضافة أو حذف الورقة، وتعيين الورقة النشطة، و رؤية علامة التبويب.

import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    sheet.setName("Q1 Report");
    workbook.getWorksheets().addSheet("Summary");
    workbook.save("report.xlsx");
}

قيم الخلية المطبوعة والصيغ

المجلس الوزاري Cell القسم يقبل القيم المكتوبة عبر: putValue() لـ: String, int, double, boolean,، و LocalDateTime. getType() الطريقة تعيد a CellValueType إينوم قيمة STRING, NUMBER, BOOLEAN, DATE_TIME,أو ، FORMULA تسهل على المستخدمين التوزيع على نوع القيمة دون سلسلة تحليل. يتم تخزين جمل الصيغ مع setFormula() وسيتم إعادة حسابها بواسطة Excel على مفتوح.

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    Cell a1 = sheet.getCells().get("A1");
    a1.putValue("Revenue");
    Cell b1 = sheet.getCells().get("B1");
    b1.putValue(42500.00);
    Cell c1 = sheet.getCells().get("C1");
    c1.setFormula("=B1*1.2");
    // Check type
    assert b1.getType() == CellValueType.NUMBER;
    assert c1.getType() == CellValueType.FORMULA;
    workbook.save("values.xlsx");
}

تصميم الخلايا والأساليب

يتم تطبيق التنسيق من خلال Style كائن تم استرجاعه من cell.getStyle() و مكتوب مرة أخرى مع cell.setStyle(). Font عرضات المواد الفرعية setBold() و setColor(). HorizontalAlignment تحكم التوافق النصي LEFT, CENTER,أو ، RIGHT. تنسيقات الأرقام المخصصة تستخدم سلاسل تشكيل Excel عبر: style.setCustom(). طوفوا ارتفاع وعرض العمود يتم ضبطها من خلال getRows().get(n).setHeight() و getColumns().get(n).setWidth().

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Style;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    Cell cell = sheet.getCells().get("B1");
    cell.putValue(9999.50);
    Style style = cell.getStyle();
    style.getFont().setBold(true);
    style.setCustom("#,##0.00");
    cell.setStyle(style);
    sheet.getCells().getRows().get(0).setHeight(24.0);
    sheet.getCells().getColumns().get(1).setWidth(16.0);
    workbook.save("styled.xlsx");
}

بيانات التحقق

يتم إضافة قواعد التحقق من صحة البيانات عبر: sheet.getValidations().add().كل واحد منهم Validation الجسم يأخذ a ValidationType (مثل:. WHOLE_NUMBER, DECIMAL, LIST) و OperatorType (مثل:. BETWEEN, GREATER_THAN) يتم تخزين حدود الصيغة على شكل: الخيوط عبر setFormula1() و setFormula2().

import com.aspose.cells_foss.CellArea;
import com.aspose.cells_foss.OperatorType;
import com.aspose.cells_foss.Validation;
import com.aspose.cells_foss.ValidationType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    int vi = sheet.getValidations().add(new CellArea(1, 0, 10, 0));
    Validation validation = sheet.getValidations().get(vi);
    validation.setType(ValidationType.WHOLE_NUMBER);
    validation.setOperator(OperatorType.BETWEEN);
    validation.setFormula1("1");
    validation.setFormula2("100");
    workbook.save("validated.xlsx");
}

AutoFilter

تسمح التصفيات الآلية للمستخدمين النهائيين بتفريغ البيانات بشكل تفاعلي في Excel دون أي إضافية التكوينات. الإتصال ws.getAutoFilter().setRange() مع نطاق A1 إلى قم بتفعيل المراسلات التنفيذية للصفح على نطاق العنوان المحدد. يمكن تشغيل أعمدة فلتر إضافية ومعايير مخصصة. محددة من خلال: FilterColumn و AutoFilterCustomFilter.

import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    sheet.getCells().get("A1").putValue("Product");
    sheet.getCells().get("B1").putValue("Qty");
    sheet.getAutoFilter().setRange("A1:B1");
    workbook.save("filtered.xlsx");
}

إعداد الصفحة وحماية ورقة العمل

المجلس الوزاري PageSetup تصرفات الطبقة حجم الورق، وتوجه الصفحة، وإعدادات التوافق مع الصفة للخروج جاهز للطباعة. يتم تطبيق حماية ورقة العمل من خلال protect() مع a WorksheetProtectionModel,، مما يسمح للخلايا المحددة بالبقاء قابلة للتحرير أثناء القفل والباقي. يتم إدارة الروابط عبر HyperlinkCollection.

بدء سريع

أضف اعتماد مافين التالي إلى حسابك. pom.xml لتضمين Aspose.خلايا FOSS في مشروعك:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-cells-foss</artifactId>
  <version>26.5.0</version>
</dependency>

قم بإنشاء دفتر عمل مع جميع الميزات الرئيسية في أقل من 20 سطر:

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Style;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

public class QuickStart {
    public static void main(String[] args) {
        try (Workbook workbook = new Workbook()) {
            WorksheetCollection sheets = workbook.getWorksheets();
            Worksheet sheet = sheets.get(0);
            sheet.setName("Sales");
            sheet.getCells().get("A1").putValue("Revenue");
            Cell b1 = sheet.getCells().get("B1");
            b1.putValue(42500.00);
            Style style = b1.getStyle();
            style.getFont().setBold(true);
            style.setCustom("#,##0.00");
            b1.setStyle(style);
            sheet.getAutoFilter().setRange("A1:B1");
            workbook.save("sales.xlsx");
        }
    }
}

تنسيقات مدعومة

شكلتمديداقرأاكتب
إكسيل افتح XML.xlsx✓✓

الحفاظ على حالياً محدود إلى .xlsx.مخازن المكتبات و صيغ الرحلات الجارية ولكن لا يعمل كمحرك حسابات كاملة.

المصدر المفتوح و الترخيص

Aspose.Cells FOSS for Java is released under the MIT license. You are free to use, تعديل وتوزيعها في المشاريع الشخصية والمفتوحة المصدر والتجارية دون يمكن الاطلاع على الكود المصدر في: github.com/aspose-cells-foss/Aspose.Cells - FOSS-لـJava.

بدءاً من

الموارد ذات الصلة