ورقة عمل

تعيين رؤية العمود

func (f *File) SetColVisible(sheet, col string, visible bool) error

يوفر SetColVisible وظيفة لتعيين مرئي لعمود واحد من خلال اسم ورقة العمل واسم العمود المحدد. هذه الوظيفة آمنة للتزامن. على سبيل المثال ، إخفاء العمود D في ورقة1:

err := f.SetColVisible("ورقة1", "D", false)

إخفاء الأعمدة من D إلى F (مضمنة):

err := f.SetColVisible("ورقة1", "D:F", false)

تعيين عرض العمود

func (f *File) SetColWidth(sheet, startCol, endCol string, width float64) error

يوفر SetColWidth وظيفة لتعيين عرض عمود واحد أو عدة أعمدة. هذه الوظيفة آمنة للتزامن. فمثلا:

f := excelize.NewFile()
err := f.SetColWidth("ورقة1", "A", "H", 20)

تعيين ارتفاع الصف

func (f *File) SetRowHeight(sheet string, row int, height float64) error

يوفر SetRowHeight وظيفة لتعيين ارتفاع صف واحد. إذا كانت قيمة الارتفاع هي 0، فسيتم إخفاء الصف المحدد، وإذا كانت قيمة الارتفاع -1، فسيتم إلغاء تعيين ارتفاع الصف المخصص. على سبيل المثال، قم بتعيين ارتفاع الصف الأول في ورقة1:

err := f.SetRowHeight("ورقة1", 1, 50)

تعيين رؤية الصف

func (f *File) SetRowVisible(sheet string, row int, visible bool) error

يوفر SetRowVisible وظيفة لتعيين مرئي لصف واحد من خلال اسم ورقة العمل وفهرس الصف. على سبيل المثال ، إخفاء الصف 2 في ورقة1:

err := f.SetRowVisible("ورقة1", 2, false)

احصل على اسم الورقة

func (f *File) GetSheetName(index int) string

يوفر GetSheetName وظيفة للحصول على اسم ورقة المصنف من خلال فهرس الورقة المحدد. إذا كان فهرس الورقة المحدد غير صالح ، فسيتم إرجاع سلسلة فارغة.

احصل على رؤية العمود

func (f *File) GetColVisible(sheet, column string) (bool, error)

يوفر GetColVisible وظيفة لإظهار عمود واحد من خلال اسم ورقة العمل واسم العمود المحدد. هذه الوظيفة آمنة للتزامن. على سبيل المثال ، احصل على الحالة المرئية للعمود D في ورقة1:

visible, err := f.GetColVisible("ورقة1", "D")

احصل على عرض العمود

func (f *File) GetColWidth(sheet, col string) (float64, error)

يوفر GetColWidth وظيفة للحصول على عرض العمود من خلال إعطاء اسم ورقة العمل وفهرس العمود. هذه الوظيفة آمنة للتزامن.

احصل على ارتفاع الخط

func (f *File) GetRowHeight(sheet string, row int) (float64, error)

يوفر GetRowHeight وظيفة للحصول على ارتفاع الصف من خلال اسم ورقة العمل وفهرس الصف. على سبيل المثال ، احصل على ارتفاع الصف الأول في ورقة1:

height, err := f.GetRowHeight("ورقة1", 1)

احصل على رؤية للخط

func (f *File) GetRowVisible(sheet string, row int) (bool, error)

يوفر GetRowVisible وظيفة لإظهار صف واحد من خلال اسم ورقة العمل وفهرس الصف. على سبيل المثال ، احصل على الحالة المرئية للصف 2 في ورقة1:

visible, err := f.GetRowVisible("ورقة1", 2)

احصل على فهرس ورقة العمل

func (f *File) GetSheetIndex(sheet string) (int, error)

يوفر GetSheetIndex وظيفة للحصول على فهرس ورقة المصنف حسب اسم الورقة المحدد. إذا كان اسم الورقة المحدد غير صالح أو كانت ورقة العمل غير موجودة ، فستُرجع قيمة نوع عدد صحيح -1.

يمكن استخدام الفهرس الذي تم الحصول عليه كمعامل لاستدعاء الوظيفة SetActiveSheet() عند تعيين ورقة العمل الافتراضية للمصنف.

الحصول على خريطة ورقة

func (f *File) GetSheetMap() map[int]string

يوفر GetSheetMap وظيفة للحصول على أوراق العمل وأوراق المخططات ومعرف أوراق الحوار وخريطة اسم المصنف. فمثلا:

f, err := excelize.OpenFile("المصنف1.xlsx")
if err != nil {
    return
}
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
for index, name := range f.GetSheetMap() {
    fmt.Println(index, name)
}

الحصول على قائمة ورقة

func (f *File) GetSheetList() []string

يوفر GetSheetList وظيفة للحصول على أوراق العمل وأوراق المخططات وقائمة أسماء أوراق الحوار الخاصة بالمصنف.

تعيين اسم الورقة

func (f *File) SetSheetName(source, target string) error

يوفر SetSheetName وظيفة لتعيين اسم ورقة العمل من خلال إعطاء أسماء أوراق العمل القديمة والجديدة. يُسمح بـ 31 حرفًا كحد أقصى في عنوان الورقة وهذه الوظيفة تغير فقط اسم الورقة ولن تقوم بتحديث اسم الورقة في الصيغة أو المرجع المرتبط بالخلية. لذلك قد يكون هناك خطأ في صيغة مشكلة أو إشارة مفقودة.

إدراج أعمدة

func (f *File) InsertCols(sheet, col string, n int) error

يوفر InsertCols وظيفة لإدراج أعمدة جديدة قبل اسم العمود المحدد وعدد الأعمدة. على سبيل المثال، أنشئ عمودين قبل العمود C في ورقة1:

err := f.InsertCols("ورقة1", "C", 2)

إدراج صفوف

func (f *File) InsertRows(sheet string, row, n int) error

يوفر InsertRows وظيفة لإدراج صفوف جديدة بعد رقم صف Excel المحدد بدءا من 1 وعدد الصفوف. على سبيل المثال، أنشئ صفين قبل الصف 3 في ورقة1:

err := f.InsertRows("ورقة1", 3, 2)

إلحاق صف مكرر

func (f *File) DuplicateRow(sheet string, row int) error

يُدرج DuplicateRow نسخة من صف معين أدناه المحدد ، على سبيل المثال:

err := f.DuplicateRow("ورقة1", 2)

استخدم هذه الطريقة بحذر ، مما سيؤثر على التغييرات في المراجع مثل الصيغ والمخططات وما إلى ذلك. إذا كان هناك أي قيمة مرجعية لورقة العمل ، فسوف يتسبب ذلك في حدوث خطأ في الملف عند فتحه. برنامج excelize يقوم بتحديث هذه المراجع جزئيًا فقط حاليًا.

صف مكرر

func (f *File) DuplicateRowTo(sheet string, row, row2 int) error

يُدرج DuplicateRowTo نسخة من الصف المحدد بواسطته رقم Excel إلى موضع الصف المحدد ويتحرك إلى أسفل الصفوف الموجودة بعد الموضع الهدف ، على سبيل المثال:

err := f.DuplicateRowTo("ورقة1", 2, 7)

استخدم هذه الطريقة بحذر ، مما سيؤثر على التغييرات في المراجع مثل الصيغ والمخططات وما إلى ذلك. إذا كان هناك أي قيمة مرجعية لورقة العمل ، فسوف يتسبب ذلك في حدوث خطأ في الملف عند فتحه. برنامج excelize يقوم بتحديث هذه المراجع جزئيًا فقط حاليًا.

إنشاء مخطط تفصيلي للصف

func (f *File) SetRowOutlineLevel(sheet string, row int, level uint8) error

يوفر SetRowOutlineLevel وظيفة لتعيين رقم مستوى المخطط التفصيلي لصف واحد من خلال اسم ورقة العمل المعطى ورقم صف Excel. على سبيل المثال ، مخطط الصف 2 في Sheet1 إلى المستوى 1:

إنشاء مخطط الصف

err := f.SetRowOutlineLevel("Sheet1", 2, 1)

إنشاء مخطط تفصيلي للعمود

func (f *File) SetColOutlineLevel(sheet, col string, level uint8) error

يوفر SetColOutlineLevel وظيفة لتعيين مستوى المخطط التفصيلي لعمود واحد من خلال اسم ورقة العمل واسم العمود. على سبيل المثال ، عيّن مستوى المخطط التفصيلي للعمود D في Sheet1 على 2:

إنشاء مخطط العمود

err := f.SetColOutlineLevel("Sheet1", "D", 2)

الحصول على مخطط تفصيلي للصف

func (f *File) GetRowOutlineLevel(sheet string, row int) (uint8, error)

يوفر GetRowOutlineLevel وظيفة للحصول على رقم مستوى المخطط التفصيلي لصف واحد عن طريق اسم ورقة العمل المعطى ورقم صف Excel. على سبيل المثال ، احصل على رقم المخطط التفصيلي للصف 2 في ورقة1:

err := f.GetRowOutlineLevel("ورقة1", 2)

الحصول على مخطط تفصيلي للعمود

func (f *File) GetColOutlineLevel(sheet, col string) (uint8, error)

يوفر GetColOutlineLevel وظيفة للحصول على مستوى المخطط التفصيلي لعمود واحد عن طريق اسم ورقة العمل واسم العمود. على سبيل المثال ، احصل على مستوى المخطط التفصيلي للعمود D في ورقة1:

level, err := f.GetColOutlineLevel("ورقة1", "D")

مُكَرِّد عمود

func (f *File) Cols(sheet string) (*Cols, error)

تقوم Cols بإرجاع مكرر العمود ، المستخدم لدفق بيانات القراءة لورقة عمل ذات بيانات كبيرة. هذه الوظيفة آمنة للتزامن. فمثلا:

cols, err := f.Cols("ورقة1")
if err != nil {
    fmt.Println(err)
    return
}
for cols.Next() {
    col, err := cols.Rows()
    if err != nil {
        fmt.Println(err)
    }
    for _, rowCell := range col {
        fmt.Print(rowCell, "\t")
    }
    fmt.Println()
}

مُكَرِّد عمود - الأعمدة

func (cols *Cols) Rows(opts ...Options) ([]string, error)

تُرجع الصفوف قيم صف الأعمدة الحالية.

مُكَرِّد عمود - ترافيرس

func (cols *Cols) Next() bool

سيعيد Next true إذا تم العثور على العمود التالي.

مُكَرِّد عمود - معالجة الأخطاء

func (cols *Cols) Error() error

سيعيد Error الحرف error عند حدوث الخطأ.

مُكَرِّد الصفوف

func (f *File) Rows(sheet string) (*Rows, error)

يقوم Rows بإرجاع مكرر الصفوف ، يُستخدم لدفق بيانات القراءة لورقة عمل تحتوي على بيانات كبيرة. هذه الوظيفة آمنة للتزامن. فمثلا:

rows, err := f.Rows("ورقة1")
if err != nil {
    fmt.Println(err)
    return
}
for rows.Next() {
    row, err := rows.Columns()
    if err != nil {
        fmt.Println(err)
    }
    for _, colCell := range row {
        fmt.Print(colCell, "\t")
    }
    fmt.Println()
}
if err = rows.Close(); err != nil {
    fmt.Println(err)
}

مُكَرِّد الصفوف - الأعمدة

func (rows *Rows) Columns(opts ...Options) ([]string, error)

تُرجع Columns قيم عمود الصف الحالي. يؤدي هذا إلى جلب بيانات ورقة العمل كتدفق ، وإرجاع كل خلية في صف كما هي ، ولن يتم تخطي الصفوف الفارغة في ذيل ورقة العمل.

مُكَرِّد الصفوف - ترافيرس

func (rows *Rows) Next() bool

سيعيد Next true إذا تم العثور على عنصر الصف التالي.

مُكَرِّد الصفوف - معالجة الأخطاء

func (rows *Rows) Error() error

سيعيد Error الحرف error عند حدوث الخطأ.

مُكَرِّد الصفوف - الحصول على خيارات الصفوف

func (rows *Rows) GetRowOpts() RowOpts

سيقوم GetRowOpts بإرجاع RowOpts للصف الحالي.

مكرر الصف - إغلاق

func (rows *Rows) Close() error

يغلق Close ملف XML المفتوح لورقة العمل في الدليل المؤقت للنظام.

ورقة البحث

func (f *File) SearchSheet(sheet, value string, reg ...bool) ([]string, error)

يوفر SearchSheet وظيفة للحصول على الإحداثيات من خلال اسم ورقة العمل المعطى وقيمة الخلية والتعبير العادي. لا تدعم الوظيفة البحث في النتيجة المحسوبة والأرقام المنسقة والبحث الشرطي حاليًا. إذا كانت خلية مدمجة ، فستقوم بإرجاع إحداثيات الزاوية اليسرى العليا للمنطقة المدمجة.

على سبيل المثال ، ابحث عن إحداثيات القيمة 100 في ورقة1:

result, err := f.SearchSheet("ورقة1", "100")

على سبيل المثال ، ابحث في الإحداثيات حيث يتم وصف القيمة العددية في النطاق 0-9 من ورقة1:

result, err := f.SearchSheet("ورقة1", "[0-9]", true)

حماية الورقة

func (f *File) ProtectSheet(sheet string, opts *SheetProtectionOptions) error

توفر ProtectSheet وظيفة لمنع المستخدمين الآخرين من تغيير البيانات في ورقة العمل أو نقلها أو حذفها عن طريق الخطأ أو عن عمد. الحقل الاختياري AlgorithmName خوارزمية التجزئة المحددة ، ودعم XOR ، MD4 ، MD5 ، SHA-1 ، SHA-256 ، SHA-384 ، و SHA-512 حاليًا ، إذا لم يتم تحديد خوارزمية التجزئة ، فسيستخدم خوارزمية XOR كإعداد افتراضي. على سبيل المثال ، حماية Sheet1 بإعدادات الحماية:

حماية الورقة

err := f.ProtectSheet("Sheet1", &excelize.SheetProtectionOptions{
    AlgorithmName:       "SHA-512",
    Password:            "password",
    SelectLockedCells:   true,
    SelectUnlockedCells: true,
    EditScenarios:       true,
})

يقوم SheetProtectionOptions بتعيين إعدادات حماية ورقة العمل مباشرةً.

type SheetProtectionOptions struct {
    AlgorithmName       string
    AutoFilter          bool
    DeleteColumns       bool
    DeleteRows          bool
    EditObjects         bool
    EditScenarios       bool
    FormatCells         bool
    FormatColumns       bool
    FormatRows          bool
    InsertColumns       bool
    InsertHyperlinks    bool
    InsertRows          bool
    Password            string
    PivotTables         bool
    SelectLockedCells   bool
    SelectUnlockedCells bool
    Sort                bool
}

ورقة إلغاء الحماية

func (f *File) UnprotectSheet(sheet string, password ...string) error

يوفر UnprotectSheet وظيفة لإزالة الحماية للورقة ، وحدد معلمة كلمة المرور الاختيارية الثانية لإزالة حماية الورقة باستخدام التحقق من كلمة المرور.

إزالة عمود

func (f *File) RemoveCol(sheet, col string) error

يوفر RemoveCol وظيفة لإزالة عمود واحد من خلال إعطاء اسم ورقة العمل وفهرس العمود. على سبيل المثال ، أزل العمود C في ورقة1:

err := f.RemoveCol("ورقة1", "C")

استخدم هذه الطريقة بحذر ، مما سيؤثر على التغييرات في المراجع مثل الصيغ والمخططات وما إلى ذلك. إذا كان هناك أي قيمة مرجعية لورقة العمل ، فسوف يتسبب ذلك في حدوث خطأ في الملف عند فتحه. برنامج excelize يقوم بتحديث هذه المراجع جزئيًا فقط حاليًا.

إزالة الصف

func (f *File) RemoveRow(sheet string, row int) error

يوفر RemoveRow وظيفة لإزالة صف واحد عن طريق اسم ورقة العمل المحددة ورقم صف Excel. على سبيل المثال ، أزل الصف 3 في ورقة1:

err := f.RemoveRow("ورقة1", 3)

استخدم هذه الطريقة بحذر ، مما سيؤثر على التغييرات في المراجع مثل الصيغ والمخططات وما إلى ذلك. إذا كان هناك أي قيمة مرجعية لورقة العمل ، فسوف يتسبب ذلك في حدوث خطأ في الملف عند فتحه. برنامج excelize يقوم بتحديث هذه المراجع جزئيًا فقط حاليًا.

قم بتعيين قيم العمود

func (f *File) SetSheetCol(sheet, cell string, slice interface{}) error

يقوم SetSheetCol بكتابة مصفوفة إلى عمود من خلال اسم ورقة العمل المحدد ، وبدء التنسيق ومؤشر لنوع المصفوفة slice. على سبيل المثال ، يكتب صفيفًا في العمود B يبدأ بالخلية B6 في ورقة1:

err := f.SetSheetCol("ورقة1", "B6", &[]interface{}{"1", nil, 2})

تعيين قيم الصفوف

func (f *File) SetSheetRow(sheet, cell string, slice interface{}) error

يكتب SetSheetRow مصفوفة إلى صف بواسطة اسم ورقة العمل المحدد ، وبدء التنسيق ومؤشر لنوع الصفيف slice. هذه الوظيفة آمنة للتزامن. على سبيل المثال ، يكتب مصفوفة في الصف 6 تبدأ بالخلية B6 في ورقة1:

err := f.SetSheetRow("ورقة1", "B6", &[]interface{}{"1", nil, 2})

إدراج فاصل الصفحات

func (f *File) InsertPageBreak(sheet, cell string) error

يُنشئ InsertPageBreak فاصل صفحات لتحديد مكان انتهاء الصفحة المطبوعة وأين يبدأ الفصل التالي من خلال اسم ومحور ورقة العمل المعينين ، بحيث تتم طباعة المحتوى قبل فاصل الصفحة على صفحة واحدة وبعد فاصل الصفحة على أخرى.

إزالة فاصل الصفحات

func (f *File) RemovePageBreak(sheet, cell string) error

يقوم RemovePageBreak بإزالة فاصل صفحة من خلال اسم ومحور ورقة العمل المحددين.

قم بتعيين بُعد ورقة العمل

func (f *File) SetSheetDimension(sheet string, rangeRef string) error

يوفر SetSheetDimension طريقة لتعيين أو إزالة النطاق المستخدم من ورقة العمل بواسطة مرجع نطاق معين. تحدد حدود الصفوف والأعمدة للخلايا المستخدمة في ورقة العمل. تم تعيين مرجع النطاق باستخدام نمط المرجع A1 (على سبيل المثال ، A1:D5). سيؤدي تمرير مرجع نطاق فارغ إلى إزالة النطاق المستخدم من ورقة العمل.

احصل على أبعاد ورقة العمل

func (f *File) GetSheetDimension(sheet string) (string, error)

يوفر GetSheetDimension طريقة الحصول على النطاق المستخدم من ورقة العمل.

results matching ""

    No results matching ""