ورقة عمل
تعيين رؤية العمود
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 طريقة الحصول على النطاق المستخدم من ورقة العمل.