From 93b96124da00915a2b71707b66352c653d91abea Mon Sep 17 00:00:00 2001 From: xuri Date: Sun, 27 Aug 2023 14:17:55 +0800 Subject: [PATCH] Docs for the released version 2.8.0 --- ar/README.md | 4 +- ar/SUMMARY.md | 2 +- ar/base/installation.md | 2 +- ar/data.md | 4 + ar/releases/v2.8.0.md | 41 ++++++++-- ar/utils.md | 16 ++-- de/README.md | 4 +- de/SUMMARY.md | 1 + de/base/installation.md | 2 +- de/data.md | 4 + de/releases/v2.8.0.md | 49 +++++++++--- de/utils.md | 18 ++--- en/README.md | 4 +- en/SUMMARY.md | 2 +- en/base/installation.md | 2 +- en/data.md | 4 + en/releases/v2.8.0.md | 41 ++++++++-- en/utils.md | 20 ++--- es/README.md | 4 +- es/SUMMARY.md | 2 +- es/base/installation.md | 2 +- es/data.md | 4 + es/releases/v2.8.0.md | 41 ++++++++-- es/utils.md | 16 ++-- fr/README.md | 4 +- fr/SUMMARY.md | 2 +- fr/base/installation.md | 2 +- fr/data.md | 4 + fr/releases/v2.8.0.md | 41 ++++++++-- fr/utils.md | 20 ++--- index.html | 2 +- ja/README.md | 4 +- ja/SUMMARY.md | 2 +- ja/base/installation.md | 2 +- ja/data.md | 4 + ja/releases/v2.8.0.md | 41 ++++++++-- ja/utils.md | 20 ++--- ko/README.md | 4 +- ko/SUMMARY.md | 2 +- ko/base/installation.md | 2 +- ko/data.md | 4 + ko/releases/v2.8.0.md | 46 ++++++++--- ko/utils.md | 20 ++--- ru/README.md | 4 +- ru/SUMMARY.md | 2 +- ru/base/installation.md | 2 +- ru/data.md | 4 + ru/releases/v2.8.0.md | 43 +++++++++-- ru/utils.md | 16 ++-- zh-hans/README.md | 4 +- zh-hans/SUMMARY.md | 6 +- zh-hans/base/installation.md | 2 +- zh-hans/data.md | 4 + zh-hans/formControl.md | 144 +++++++++++++++++++++++++++++++++++ zh-hans/releases/v2.8.0.md | 39 ++++++++-- zh-hans/utils.md | 16 ++-- zh-tw/README.md | 4 +- zh-tw/SUMMARY.md | 6 +- zh-tw/base/installation.md | 2 +- zh-tw/data.md | 4 + zh-tw/formControl.md | 144 +++++++++++++++++++++++++++++++++++ zh-tw/releases/v2.0.2.md | 2 +- zh-tw/releases/v2.6.1.md | 2 +- zh-tw/releases/v2.8.0.md | 43 +++++++++-- zh-tw/utils.md | 18 ++--- zh-tw/workbook.md | 2 +- 66 files changed, 818 insertions(+), 210 deletions(-) create mode 100644 zh-hans/formControl.md create mode 100644 zh-tw/formControl.md diff --git a/ar/README.md b/ar/README.md index 41781eae..f1eeba3d 100644 --- a/ar/README.md +++ b/ar/README.md @@ -8,8 +8,8 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج - المساله: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - التراخيص: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- الإصدار الأخير: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- وقت تحديث المستند: أغسطس 4, 2023 +- الإصدار الأخير: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- وقت تحديث المستند: أغسطس 28, 2023 ## بعثة المشروع diff --git a/ar/SUMMARY.md b/ar/SUMMARY.md index c4dcd9dd..6ac03f6a 100644 --- a/ar/SUMMARY.md +++ b/ar/SUMMARY.md @@ -233,7 +233,7 @@ * [أداء](performance.md) * [إسهام](contribution.md) * الإصدارات الصادرة - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/ar/base/installation.md b/ar/base/installation.md index e07210bd..69c50d49 100644 --- a/ar/base/installation.md +++ b/ar/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -استخدام أحدث إصدار Excelize مكتبة تتطلب الانتقال الإصدار 1.16 أو أحدث. +استخدام أحدث إصدار Excelize مكتبة تتطلب الانتقال الإصدار 1.16 أو أحدث. لاحظ أن هناك بعض [التغييرات غير المتوافقة](https://github.com/golang/go/issues/61881) في Go 1.21.0، ولا يمكن لهذه المكتبة العمل مع هذا الإصدار، إذا كنت تستخدم Go 1.21.x، فيرجى الترقية إلى Go 1.21.1 والإصدار الأحدث. - التركيب diff --git a/ar/data.md b/ar/data.md index 486e4517..92dbc9dc 100644 --- a/ar/data.md +++ b/ar/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +إذا قمت بكتابة العناصر في مربع حوار التحقق من صحة البيانات (قائمة محددة)، فإن الحد الأقصى هو 255 حرفًا، بما في ذلك الفواصل. إذا كانت صيغة مصدر قائمة التحقق من صحة البيانات الخاصة بك تتجاوز الحد الأقصى للطول، فيرجى تعيين القيم المسموح بها في خلايا ورقة العمل، واستخدام وظيفة `SetSqrefDropList` لتعيين المرجع للخلايا الخاصة بها. + المثال 4 ، قم بتعيين التحقق من صحة البيانات على `Sheet1!A7:B8` باستخدام إعدادات مصدر معايير التحقق `Sheet1!E1:E3` ، قم بإنشاء قائمة منسدلة داخل الخلية عن طريق السماح بمصدر القائمة:

تأكيد صحة البيانات

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +هناك حدود لعدد العناصر التي ستظهر في القائمة المنسدلة للتحقق من صحة البيانات: يمكن أن تظهر القائمة حتى تعرض 32768 عنصرًا من قائمة في ورقة العمل. إذا كنت بحاجة إلى المزيد من العناصر، فيمكنك إنشاء قائمة منسدلة تابعة، مقسمة حسب الفئة. + ## الحصول على التحقق من صحة البيانات {#GetDataValidations} ```go diff --git a/ar/releases/v2.8.0.md b/ar/releases/v2.8.0.md index 0fa45649..b4754af3 100644 --- a/ar/releases/v2.8.0.md +++ b/ar/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* سيصدر: 28 أغسطس 2023 +* صدر هذا يوم: 28 أغسطس 2023 +* صدر في GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## ملاحظات الإصدار @@ -8,20 +9,34 @@ ### كسر التغييرات -* التغييرات الفاصلة: إعادة تسمية المتغير الذي تم تصديره `ErrTableNameLength` إلى `ErrNameLength` -* كسر التغييرات: إعادة تسمية النوع المُصدَّر `PaneOptions` إلى `Selection` +* إعادة تسمية المتغير الذي تم تصديره `ErrTableNameLength` إلى `ErrNameLength` +* إعادة تسمية النوع المُصدَّر `PaneOptions` إلى `Selection` +* أعد تسمية الحقل `Runs` إلى `Paragraph` في نوع بيانات `Comment` المُصدَّر * قم بإزالة الحقل `Lang` في نوع بيانات `Style` +* تمت إزالة نوع بيانات `ChartTitle` المُصدَّر ، واستخدام نوع بيانات `RichTextRun` بدلاً منه +* تم تغيير نوع البيانات لـ `DecimalPlaces` إلى مؤشر عدد صحيح * قم بتغيير النقطة الافتراضية إلى عامل تحويل البكسل ، وحل المشكلات [#279](https://github.com/xuri/excelize/issues/279) و [#1536](https://github.com/xuri/excelize/issues/1536) +* تغيير توقيع الوظيفة `AddShape`: غير `func (f *File) AddShape(sheet, cell string, opts *Shape) error` إلى `func (f *File) AddShape(sheet string, opts *Shape) error` ### ميزات بارزة -* إضافة متغير خطأ جديد تم تصديره `ErrExistsTableName` +* إضافة متغيرات خطأ جديدة تم تصديرها `ErrExistsTableName` و `ErrorFormControlValue` * إضافة خيارات جديدة `ShortDatePattern` و `LongDatePattern` و `LongTimePattern` و `CultureInfo` في نوع البيانات `Options` والمشكلة ذات الصلة [#1199](https://github.com/xuri/excelize/issues/1199) * إضافة تعداد نوع البيانات الجديدة المُصدرة `CultureName` لرمز البلد -* دعم العنصر النائب ، والحشو ، وتقريب الأرقام ، وسلسلة العملة ، وسيطة التبديل بواسطة رمز تنسيق الرقم المحدد ، والمشكلة ذات الصلة [#660](https://github.com/xuri/excelize/issues/660) +* دالات جديدة تدعم `GetTables` و `DeleteTable` للحصول على الجداول وإزالتها ، مشكلة ذات صلة [#674](https://github.com/xuri/excelize/issues/674) و [#1454](https://github.com/xuri/excelize/issues/1454) +* وظيفة جديدة تدعم `GetStyle` للحصول على تعريفات الأنماط ، مشكلة ذات صلة [#314](https://github.com/xuri/excelize/issues/314) و [#1520](https://github.com/xuri/excelize/issues/1520) و [#1521](https://github.com/xuri/excelize/issues/1521) +* دعم تطبيق قيمة الخلية مع العنصر النائب والحشو وأرقام التقريب والعملة والمحاسبة وتنسيق رقم وسيطة التبديل ودعم تطبيق تنسيق رقم التاريخ والوقت لعلامات اللغة 812 ، والمشكلة ذات الصلة [#660](https://github.com/xuri/excelize/issues/660) +* دعم 10 وظائف صيغة جديدة: ARRAYTOTEXT و FORECAST و FORECAST.LINEAR و FREQUENCY و INTERCEPT و ODDFYIELD و ODDLPRICE و ODDLYIELD و PROB و VALUETOTEXT * أضف تفاصيل حدود طول مسار الملف في رسالة الخطأ * وظيفة جديدة دعم `GetPanes` للحصول على أجزاء الأوراق وعرض التحديد +* دعم الوظائف الجديدة `AddFormControl` و `GetFormControls` و `DeleteFormControl` لعناصر تحكم النموذج ، القضايا ذات الصلة [#301](https://github.com/xuri/excelize/issues/301) و [#1169](https://github.com/xuri/excelize/issues/1169) * تدعم وظيفة `AddChart` تعيين العناوين الأساسية والمشكلات ذات الصلة [#1553](https://github.com/xuri/excelize/issues/1553) +* تدعم وظيفة `AddChart` إنشاء مخطط بمحور سلسلة ثانوي ، مشكلة ذات صلة [#518](https://github.com/xuri/excelize/issues/518) +* تدعم وظيفة `AddChart` التنسيق وتعيين عناوين النص المنسق للمخطط ، المشكلة ذات الصلة [#1588](https://github.com/xuri/excelize/issues/1588) +* إضافة تحقق من نوع الشكل لوظيفة `AddShape` ، سيتم إرجاع خطأ إذا لم يتم تحديد نوع الشكل +* دعم قراءة قيم الخلية المنسقة بواسطة تنسيق رقم التقويم الياباني ، والمشكلة ذات الصلة [#1590](https://github.com/xuri/excelize/issues/1590) +* تدعم وظيفة `GetPictures` قراءة صور ارتساء خلية واحدة ، والمشكلة ذات الصلة [#1585](https://github.com/xuri/excelize/issues/1585) +* تدعم وظيفة `NewConditionalStyle` إنشاء تنسيق شرطي بتنسيق الأرقام والحماية ، والمشكلة ذات الصلة [#1610](https://github.com/xuri/excelize/issues/1610) ### تحسين التوافق @@ -29,6 +44,7 @@ * منع إنشاء جداول مكررة واسم محدد بنفس الاسم * قم بتحسين توافق حجم مربع تعليق الخلية مع KingSoft WPS * دعم الرجوع إلى عرض العمود الافتراضي في خاصية تنسيق الورقة ، والمشكلة ذات الصلة [#1536](https://github.com/xuri/excelize/issues/1536) +* جعل حالة الأحرف حساسة لمسار XML لورقة العمل الداخلية لتحسين التوافق ، والمشكلة ذات الصلة [#1591](https://github.com/xuri/excelize/issues/1591) ### إصلاحات الأخطاء @@ -38,11 +54,18 @@ * إصلاح ظروف السباق لوظائف أمان التزامن * إصلاح غير صحيح جولة مللي ثانية لوقت التاريخ * إصلاح النتيجة المنسقة بأرقام غير صحيحة للتاريخ والوقت بـ 12 ساعة في AM -* تصحيح استثناء حساب الصيغة غير الصحيحة النتيجة المتوقعة +* إصلاح دالات الصيغة غير الصحيحة نتيجة SUMIFS و AVERAGEIFS وحل المشكلة [#1564](https://github.com/xuri/excelize/issues/1564) +* إصلاح مشكلات الأولوية الحسابية الأساسية في محرك الحساب ، وحل المشكلات [#1599](https://github.com/xuri/excelize/issues/1599) * إصلاح مشكلة مرجع ورقة العمل المتقاطعة لمحرك حساب الصيغة * إصلاح مشكلة ضبط الجدول عند حل المشكلة بعد إزالة الصفوف [#1539](https://github.com/xuri/excelize/issues/1539) * دعم للحصول على صور متعددة في خلية واحدة ، حل المشكلة [#1548](https://github.com/xuri/excelize/issues/1548) -* إصلاح رقم الصف غير الصحيح عند الحصول على موضع الكائن ، وحل المشكلة [#1560](https://github.com/xuri/excelize/issues/1560) +* إصلاح وضع الصورة المضافة كان غير صحيح في بعض الحالات ، حل المشكلة [#1560](https://github.com/xuri/excelize/issues/1560) +* دعم تعديل الصيغة عند إدراج الأعمدة والصفوف ، وإصلاح تلف المصنف الناتج عن إدراج الأعمدة أو الصفوف الناتجة ، وحل المشكلة [#1565](https://github.com/xuri/excelize/issues/1565) +* دالة الصيغة CONCAT ، CONCATENATE تدعم تسلسل قيم الخلايا المتعددة ، وحل المشكلة [#1569](https://github.com/xuri/excelize/issues/1569) +* إصلاح الصيغة غير الصحيحة لحساب النتائج على دالة وسيطة متداخلة تقوم بإرجاع نتيجة رقمية ، وحل المشكلة [#1582](https://github.com/xuri/excelize/issues/1582) +* إصلاح مشكلات عداد الكائنات الرسومية الداخلية التي تسببت في تكرار الصورة المضافة وحل المشكلة [#1584](https://github.com/xuri/excelize/issues/1584) +* تم إصلاح نتيجة خلية تاريخ القراءة والوقت بشكل غير صحيح بسبب مشكلة تقريب الساعات ، وحل المشكلة [#1587](https://github.com/xuri/excelize/issues/1587) +* أصلح حالة الذعر عند دمج الخلايا بنفس محور البداية والنهاية ### تحسين الأداء @@ -70,3 +93,7 @@ * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/ar/utils.md b/ar/utils.md index cdeb47d3..a9be5f7e 100644 --- a/ar/utils.md +++ b/ar/utils.md @@ -283,10 +283,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - يتم استخدام معلمة `minimum` لتعيين قيمة الحد الأدنى عندما يكون `Criteria` إما `between` أو `not between`. +type: `MinValue` - يتم استخدام معلمة `MinValue` لتعيين قيمة الحد الأدنى عندما يكون `Criteria` إما `between` أو `not between`. ```go // قاعدة الخلايا المميزة: بين... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - تُستخدم معلمة `maximum` لتعيين قيمة الحد الأعلى عندما تكون المعايير إما `between` أو `not between`. انظر المثال السابق. +type: `MaxValue` - تُستخدم معلمة `maximum` لتعيين قيمة الحد الأعلى عندما تكون المعايير إما `between` أو `not between`. انظر المثال السابق. type: `average` - يُستخدم النوع `average` لتحديد التنسيق الشرطي لنمط "المتوسط" في Office Excel: diff --git a/de/README.md b/de/README.md index 9409539e..15bd9145 100644 --- a/de/README.md +++ b/de/README.md @@ -8,8 +8,8 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe - Problem: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Lizenzen: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- Letzte Version: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- Dokument Aktualisierungszeit: August 4, 2023 +- Letzte Version: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- Dokument Aktualisierungszeit: August 28, 2023 ## Project mission diff --git a/de/SUMMARY.md b/de/SUMMARY.md index 0e032119..580e29df 100644 --- a/de/SUMMARY.md +++ b/de/SUMMARY.md @@ -233,6 +233,7 @@ * [Leistung](performance.md) * [Beitrag](contribution.md) * Freigegebene Versionen + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/de/base/installation.md b/de/base/installation.md index c7c28900..b320a6cc 100644 --- a/de/base/installation.md +++ b/de/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -Für die Verwendung der neuesten Version Excelize Bibliothek erfordern, um Version 1.16 oder höher. +Für die Verwendung der neuesten Version Excelize Bibliothek erfordern, um Version 1.16 oder höher. Beachten Sie, dass es in Go 1.21.0 einige [inkompatible Änderungen](https://github.com/golang/go/issues/61881) gibt. Diese Bibliothek kann mit dieser Version nicht funktionieren. Wenn Sie Go 1.21.x verwenden, aktualisieren Sie bitte auf Go 1.21.1 und eine spätere Version. - Installation diff --git a/de/data.md b/de/data.md index 83c85fd7..f52d96ee 100644 --- a/de/data.md +++ b/de/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +Wenn Sie die Elemente in das Datenvalidierungsdialogfeld (eine durch Trennzeichen getrennte Liste) eingeben, beträgt die Grenze 255 Zeichen, einschließlich der Trennzeichen. Wenn die Quellformel Ihrer Datenvalidierungsliste die maximale Längenbeschränkung überschreitet, legen Sie bitte die zulässigen Werte in den Arbeitsblattzellen fest und verwenden Sie die Funktion `SetSqrefDropList`, um die Referenz für ihre Zellen festzulegen. + Beispiel 4: Setzen Sie die Datenvalidierung auf `Sheet1!A7:B8` mit den Einstellungen der Validierungskriterienquelle `Sheet1!E1:E3`. Erstellen Sie ein Dropdown-Menü in der Zelle, indem Sie die Listenquelle zulassen:

Datenvalidierung

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +Die Anzahl der Elemente, die in einer Datenvalidierungs-Dropdown-Liste angezeigt werden, ist begrenzt: Die Liste kann bis zu 32768 Elemente aus einer Liste im Arbeitsblatt anzeigen. Wenn Sie mehr Elemente benötigen, können Sie eine abhängige Dropdown-Liste erstellen, die nach Kategorien aufgeschlüsselt ist. + ## Datenvalidierung erhalten {#GetDataValidations} ```go diff --git a/de/releases/v2.8.0.md b/de/releases/v2.8.0.md index e61b0ab7..7f5fe570 100644 --- a/de/releases/v2.8.0.md +++ b/de/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* Wird veröffentlicht: August 28, 2023 +* Veröffentlicht am: August 28, 2023 +* Veröffentlicht auf GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## Versionshinweise @@ -8,20 +9,34 @@ Die bemerkenswertesten Änderungen in dieser Version sind: ### Kompatibilität -* Wichtige Änderungen: Benennen Sie die exportierte Variable `ErrTableNameLength` in `ErrNameLength` um -* Wichtige Änderungen: Benennen Sie den exportierten Typ `PaneOptions` in `Selection` um -* Remove the `Lang` field in the `Style` data type +* Benennen Sie die exportierte Variable `ErrTableNameLength` in `ErrNameLength` um +* Benennen Sie den exportierten Typ `PaneOptions` in `Selection` um +* Benennen Sie das Feld `Runs` im exportierten Datentyp `Comment` in `Paragraph` um +* Entfernen Sie das Feld `Lang` im Datentyp `Style` +* Der exportierte Datentyp `ChartTitle` wurde entfernt und stattdessen der Datentyp `RichTextRun` verwendet +* Der Datentyp für `DecimalPlaces` wurde in einen Ganzzahlzeiger geändert * Ändern Sie den Standardfaktor für die Umrechnung von Punkt in Pixel, verwandtes problem [#279](https://github.com/xuri/excelize/issues/279) und [#1536](https://github.com/xuri/excelize/issues/1536) +* Ändern Sie die Funktionssignatur `AddShape`: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` in `func (f *File) AddShape(sheet string, opts *Shape) error` ### Neue Eigenschaften -* Fügen Sie die neue exportierte Fehlervariable `ErrExistsTableName` hinzu -* Fügen Sie neue Optionen `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` und `CultureInfo` im Datentyp `Options` hinzu, verwandtes Problem [#1199](https://github.com/xuri/excelize/issues/1199) +* Fügen Sie neue exportierte Fehlervariablen `ErrExistsTableName` und `ErrorFormControlValue` hinzu +* Fügen Sie neue Optionen `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` und `CultureInfo` im Datentyp `Options` hinzu, verwandtes problem [#1199](https://github.com/xuri/excelize/issues/1199) * Fügen Sie eine neue exportierte Datentyp-Enumeration `CultureName` für den Ländercode hinzu -* Unterstützt Platzhalter, Auffüllen, Runden von Zahlen, Währungszeichenfolgen und schaltet Argumente anhand des angegebenen Zahlenformatcodes um. Ähnliches Problem [#660](https://github.com/xuri/excelize/issues/660) +* Neue Funktionen `GetTables` und `DeleteTable` unterstützen das Abrufen und Entfernen von Tabellen, verwandtes problem [#674](https://github.com/xuri/excelize/issues/674) und [#1454](https://github.com/xuri/excelize/issues/1454) +* Neue Funktion `GetStyle` unterstützt das Abrufen von Stildefinitionen, verwandtes problem [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) und [#1521](https://github.com/xuri/excelize/issues/1521) +* Unterstützt die Anwendung von Zellenwerten mit Platzhaltern, Auffüllungen, Rundungen, Währungen, Buchhaltungs- und Schalterargument-Nummernformaten sowie die Anwendung von Datums- und Uhrzeit-Nummernformaten für 812-Sprach-Tags, verwandtes problem [#660](https://github.com/xuri/excelize/issues/660) +* Neue Unterstützung für 10 Formelfunktionen: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * Fügen Sie der Fehlermeldung Details zur Dateipfadlängenbeschränkung hinzu * Neue Funktion `GetPanes` unterstützt das Abrufen von Blattfenstern und die Ansichtsauswahl +* Die neuen Funktionen `AddFormControl`, `GetFormControls` und `DeleteFormControl` unterstützen Formularsteuerelemente und damit verbundene Probleme [#301](https://github.com/xuri/excelize/issues/301) und [#1169](https://github.com/xuri/excelize/issues/1169) * Die Funktion `AddChart` unterstützt das Festlegen von Primärtiteln, verwandtes problem [#1553](https://github.com/xuri/excelize/issues/1553) +* Die Funktion `AddChart` unterstützt das Erstellen von Diagrammen mit einer sekundären Reihenachse, verwandtes problem [#518](https://github.com/xuri/excelize/issues/518) +* Die Funktion `AddChart` unterstützt das Formatieren und Festlegen von Rich-Text-Titeln für das Diagramm, verwandtes problem [#1588](https://github.com/xuri/excelize/issues/1588) +* Fügen Sie eine Prüfung für den Formtyp für die Funktion `AddShape` hinzu. Wenn kein Formtyp angegeben ist, wird ein Fehler zurückgegeben +* Unterstützt das Lesen von Zellenwerten, die im japanischen Kalenderzahlenformat formatiert sind, verwandtes problem [#1590](https://github.com/xuri/excelize/issues/1590) +* Die Funktion `GetPictures` unterstützt das Lesen von Einzelzellen-Ankerbildern, verwandtes problem [#1585](https://github.com/xuri/excelize/issues/1585) +* Die Funktion `NewConditionalStyle` unterstützt die Erstellung eines bedingten Formats mit Zahlenformat und Schutz, verwandtes problem [#1610](https://github.com/xuri/excelize/issues/1610) ### Verbesserung der Kompatibilität @@ -29,6 +44,7 @@ Die bemerkenswertesten Änderungen in dieser Version sind: * Verhindern Sie die Erstellung doppelter Tabellen und definierter Namen mit demselben Namen * Verbessern Sie die Kompatibilität der Zellenkommentarfeldformgröße mit KingSoft WPS * Unterstützt Fallback auf die Standardspaltenbreite in der Blattformateigenschaft, verwandtes problem [#1536](https://github.com/xuri/excelize/issues/1536) +* Zur Verbesserung der Kompatibilität wurde die Groß-/Kleinschreibung für den XML-Pfad des internen Arbeitsblatts nicht beachtet, verwandtes problem [#1591](https://github.com/xuri/excelize/issues/1591) ### Fehlerbehebung @@ -38,16 +54,23 @@ Die bemerkenswertesten Änderungen in dieser Version sind: * Race-Bedingungen für Parallelitätssicherheitsfunktionen beheben * Korrigieren Sie die falsche runde Millisekunde für das Datum und die Uhrzeit * Korrigieren Sie ein falsch formatiertes Zahlenergebnis für Datum und Uhrzeit mit 12 Stunden am Vormittag -* Korrigieren Sie das erwartete Ergebnis einer falschen Formelberechnungsausnahme +* Korrigieren Sie falsche Ergebnisse der Formelfunktionen SUMIFS und AVERAGEIFS, verwandtes problem [#1564](https://github.com/xuri/excelize/issues/1564) +* Beheben Sie grundlegende Prioritätsprobleme bei arithmetischen Operatoren in der Rechenmaschine, resolve issue [#1599](https://github.com/xuri/excelize/issues/1599) * Behebung des Problems mit tabellenübergreifenden Referenzen für die Formelberechnungs-Engine * Behebung des Problems beim Anpassen der Tabelle nach dem Entfernen von Zeilen, verwandtes problem [#1539](https://github.com/xuri/excelize/issues/1539) * Unterstützung für das Abrufen mehrerer Bilder in einer Zelle, verwandtes problem [#1548](https://github.com/xuri/excelize/issues/1548) -* Korrigieren Sie die falsche Zeilennummer beim Abrufen der Objektposition, verwandtes problem [#1560](https://github.com/xuri/excelize/issues/1560) +* Beheben Sie, dass die Position des hinzugefügten Bildes in einigen Fällen falsch war, verwandtes problem [#1560](https://github.com/xuri/excelize/issues/1560) +* Unterstützen Sie das Anpassen der Formel beim Einfügen von Spalten und Zeilen und beheben Sie die durch das Einfügen von Spalten oder Zeilen verursachte Beschädigung der Arbeitsmappe, verwandtes problem [#1565](https://github.com/xuri/excelize/issues/1565) +* Die Formelfunktionen CONCAT und CONCATENATE unterstützen die Verkettung mehrerer Zellwerte, verwandtes problem [#1569](https://github.com/xuri/excelize/issues/1569) +* Korrigieren Sie falsche Formelberechnungsergebnisse für eine verschachtelte Argumentfunktion, die ein numerisches Ergebnis zurückgibt, verwandtes problem [#1582](https://github.com/xuri/excelize/issues/1582) +* Behebung interner Probleme mit dem Grafikobjektzähler, die dazu führten, dass das hinzugefügte Bild dupliziert wurde, verwandtes problem [#1584](https://github.com/xuri/excelize/issues/1584) +* Behebung, dass das Ergebnis der gelesenen Datums-/Uhrzeitzelle fälschlicherweise durch ein Stundenrundungsproblem verursacht wurde, verwandtes problem [#1587](https://github.com/xuri/excelize/issues/1587) +* Behebung der Panik beim Erhalten zusammengeführter Zellen mit derselben Start und Endachse ### Leistungsverbesserung -* Optimierung von Aufrufen regulärer Ausdrücke zur Verbesserung der Leistung, ähnliches Problem [#1532](https://github.com/xuri/excelize/issues/1532) -* Dies vermeidet unnötige Byte-/String-Konvertierungen und damit verbundene Probleme [#1541](https://github.com/xuri/excelize/issues/1541) +* Optimierung von Aufrufen regulärer Ausdrücke zur Verbesserung der Leistung, verbundene problem [#1532](https://github.com/xuri/excelize/issues/1532) +* Dies vermeidet unnötige Byte-/String-Konvertierungen und damit verbundene problem [#1541](https://github.com/xuri/excelize/issues/1541) ### Sonstiges @@ -70,3 +93,7 @@ Vielen Dank für alle Mitwirkenden an Excelize. Nachfolgend finden Sie eine List * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/de/utils.md b/de/utils.md index ae7f48e1..9d4aae81 100644 --- a/de/utils.md +++ b/de/utils.md @@ -283,10 +283,10 @@ Die Option `Type` ist ein erforderlicher Parameter und hat keinen Standardwert. Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ Die Option `Type` ist ein erforderlicher Parameter und hat keinen Standardwert. Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - Der Parameter `minimum` wird verwendet, um den unteren Grenzwert festzulegen, wenn das `Criteria` entweder `between` oder `not between` liegt. +type: `MinValue` - Der Parameter `MinValue` wird verwendet, um den unteren Grenzwert festzulegen, wenn das `Criteria` entweder `between` oder `not between` liegt. ```go // Markieren Sie die Regel für Zellen: zwischen ... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - Der Parameter `maximum` wird verwendet, um den oberen Grenzwert festzulegen, wenn die Kriterien entweder `between` oder `not between` liegen. Siehe das vorherige Beispiel. +type: `MaxValue` - Der Parameter `maximum` wird verwendet, um den oberen Grenzwert festzulegen, wenn die Kriterien entweder `between` oder `not between` liegen. Siehe das vorherige Beispiel. type: `average` - Der Typ `average` wird verwendet, um das bedingte Format im "Durchschnitt" -Stil von Office Excel anzugeben: @@ -721,7 +721,7 @@ num|Numerisch percent|Prozentsatz percentile|Perzentil formula|Formel -max|Maximum (nur für `MaxType`) +max|MaxValue (nur für `MaxType`) `MidType` - Wird für `3_color_scale` verwendet. Gleich wie `MinType`, siehe oben. diff --git a/en/README.md b/en/README.md index db343fcb..24d417be 100644 --- a/en/README.md +++ b/en/README.md @@ -8,8 +8,8 @@ Excelize is a library written in pure Go providing a set of functions that allow - Issue: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- Last version: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- Document update time: August 4, 2023 +- Last version: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- Document update time: August 28, 2023 ## Project mission diff --git a/en/SUMMARY.md b/en/SUMMARY.md index 9cd5e4e5..615a78fd 100644 --- a/en/SUMMARY.md +++ b/en/SUMMARY.md @@ -233,7 +233,7 @@ * [Performance](performance.md) * [Contribution](contribution.md) * Released Versions - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/en/base/installation.md b/en/base/installation.md index fa860f18..26fce6f5 100644 --- a/en/base/installation.md +++ b/en/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -Using the latest version Excelize library require to Go version 1.16 or later. +Using the latest version Excelize library require to Go version 1.16 or later. Note that, there are some [incompatible changes](https://github.com/golang/go/issues/61881) in the Go 1.21.0, the Excelize library can not working with that version normally, if you are using the Go 1.21.x, please upgrade to the Go 1.21.1 and later version. - Installation diff --git a/en/data.md b/en/data.md index 9391bcb1..40ce1f80 100644 --- a/en/data.md +++ b/en/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +If you type the items into the data validation dialog box (a delimited list), the limit is 255 characters, including the separators. If your data validation list source formula is over the maximum length limit, please set the allowed values in the worksheet cells, and use the `SetSqrefDropList` function to set the reference for their cells. + Example 4，set data validation on `Sheet1!A7:B8` with validation criteria source `Sheet1!E1:E3` settings, create in-cell dropdown by allowing list source:

Data validation

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +There are limits to the number of items that will show in a data validation drop down list: The list can show up to show 32768 items from a list on the worksheet. If you need more items than that, you could create a dependent drop down list, broken down by category. + ## Get data validations {#GetDataValidations} ```go diff --git a/en/releases/v2.8.0.md b/en/releases/v2.8.0.md index 9bf55021..4a4190bb 100644 --- a/en/releases/v2.8.0.md +++ b/en/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* Will be released: August 28, 2023 +* Released this on: August 28, 2023 +* GitHub Release: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## Release Notes @@ -8,20 +9,34 @@ The most notable changes in this release are: ### Breaking Change -* Breaking changes: rename exported variable `ErrTableNameLength` to `ErrNameLength` -* Breaking changes: rename exported type `PaneOptions` to `Selection` +* Rename exported variable `ErrTableNameLength` to `ErrNameLength` +* Rename exported type `PaneOptions` to `Selection` +* Rename the `Runs` field to `Paragraph` in the exported `Comment` data type * Remove the `Lang` field in the `Style` data type +* Removed exported `ChartTitle` data type, and using the `RichTextRun` data type instead of it +* Changed the data type for the `DecimalPlaces` to pointer of integer * Change the default point to pixels conversion factor, resolve issues [#279](https://github.com/xuri/excelize/issues/279) and [#1536](https://github.com/xuri/excelize/issues/1536) +* Change the `AddShape` function signature: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` to `func (f *File) AddShape(sheet string, opts *Shape) error` ### Notable Features -* Add new exported error variable `ErrExistsTableName` +* Add new exported error variables `ErrExistsTableName` and `ErrorFormControlValue` * Add new options `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` and `CultureInfo` in the `Options` data type, related issue [#1199](https://github.com/xuri/excelize/issues/1199) * Add new exported data type `CultureName` enumeration for country code -* Support placeholder, padding, rounds numbers, currency string and switches argument by specified number format code, related issue [#660](https://github.com/xuri/excelize/issues/660) +* New functions `GetTables` and `DeleteTable`support to get and remove tables, related issues [#674](https://github.com/xuri/excelize/issues/674) and [#1454](https://github.com/xuri/excelize/issues/1454) +* New function `GetStyle` support to get style definitions, related issues [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) and [#1521](https://github.com/xuri/excelize/issues/1521) +* Support applying cell value with placeholder, padding, rounds numbers, currency, accounting and switches argument number format, and support applying date and time number format for 812 language tags, related issue [#660](https://github.com/xuri/excelize/issues/660) +* New support 10 formula functions: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * Add file path length limitation details in the error message * New function `GetPanes` support to get sheet panes and view selection +* New functions `AddFormControl`, `GetFormControls` and `DeleteFormControl` support to form controls, related issues [#301](https://github.com/xuri/excelize/issues/301) and [#1169](https://github.com/xuri/excelize/issues/1169) * The `AddChart` function support set primary titles, related issue [#1553](https://github.com/xuri/excelize/issues/1553) +* The `AddChart` function support creating chart with a secondary series axis, related issue [#518](https://github.com/xuri/excelize/issues/518) +* The `AddChart` function support formatting and setting rich text titles for the chart, related issue [#1588](https://github.com/xuri/excelize/issues/1588) +* Add check for shape type for the `AddShape` function, an error will be returned if no shape type is specified +* Support read cell values formatted by the Japanese calendar number format, related issue [#1590](https://github.com/xuri/excelize/issues/1590) +* The `GetPictures` function support read one cell anchor pictures, related issue [#1585](https://github.com/xuri/excelize/issues/1585) +* The `NewConditionalStyle` function support to create a conditional format with number format and protection, related issue [#1610](https://github.com/xuri/excelize/issues/1610) ### Improve the Compatibility @@ -29,6 +44,7 @@ The most notable changes in this release are: * Prevent create duplicate tables and defined name with the same name * Improve the cell comment box shape size compatibility with KingSoft WPS * Support fallback to default column width in sheet format property, related issue [#1536](https://github.com/xuri/excelize/issues/1536) +* Made case in-sensitive for internal worksheet XML path to improve compatibility, related issue [#1591](https://github.com/xuri/excelize/issues/1591) ### Bug Fixes @@ -38,11 +54,18 @@ The most notable changes in this release are: * Fix race conditions for concurrency safety functions * Fix incorrect round millisecond for the date time * Fix incorrect number formatted result for date and time with 12 hours at AM -* Fix incorrect formula calculation exception expected result +* Fix incorrect formula functions SUMIFS and AVERAGEIFS result, resolve issue [#1564](https://github.com/xuri/excelize/issues/1564) +* Fix basic arithmetic operator priority issues in the calculating engine, resolve issue [#1599](https://github.com/xuri/excelize/issues/1599) * Fix across worksheet reference issue for the formula calculation engine * Fix adjust table issue when after removing rows, resolve issue [#1539](https://github.com/xuri/excelize/issues/1539) * Support to get multiple images in one cell, resolve issue [#1548](https://github.com/xuri/excelize/issues/1548) -* Fix incorrect row number when get object position, resolve issue [#1560](https://github.com/xuri/excelize/issues/1560) +* Fix the added picture position was incorrect in some cases, resolve issue [#1560](https://github.com/xuri/excelize/issues/1560) +* Support adjusting the formula when inserting columns and rows, fix the workbook corruption caused by inserting columns or rows caused, resolve issue [#1565](https://github.com/xuri/excelize/issues/1565) +* Formula function CONCAT, CONCATENATE support concatenation of multiple cell values, resolve issue [#1569](https://github.com/xuri/excelize/issues/1569) +* Fix incorrect formula calculate results on a nested argument function which returns a numeric result, resolve issue [#1582](https://github.com/xuri/excelize/issues/1582) +* Fix internal graphic object counter issues caused added picture was duplicated, resolve issue [#1584](https://github.com/xuri/excelize/issues/1584) +* Fix read date time cell result was incorrectly caused by hours rounding issue, resolve issue [#1587](https://github.com/xuri/excelize/issues/1587) +* Fix panic on getting merged cells with the same start and end axis ### Performance @@ -70,3 +93,7 @@ Thanks for all the contributors to Excelize. Below is a list of contributors tha * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/en/utils.md b/en/utils.md index 2fad4219..775ec7c5 100644 --- a/en/utils.md +++ b/en/utils.md @@ -283,10 +283,10 @@ The `Type` option is a required parameter and it has no default value. Allowable Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ The `Type` option is a required parameter and it has no default value. Allowable Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - The `minimum` parameter is used to set the lower limiting value when the `Criteria` is either `between` or `not between`. +type: `MinValue` - The `MinValue` parameter is used to set the lower limiting value when the `Criteria` is either `between` or `not between`. ```go // Highlight cells rule: between... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - The `maximum` parameter is used to set the upper limiting value when the criteria are either `between` or `not between`. See the previous example. +type: `MaxValue` - The `maximum` parameter is used to set the upper limiting value when the criteria are either `between` or `not between`. See the previous example. type: `average` - The `average` type is used to specify Office Excel's "Average" style conditional format: @@ -716,12 +716,12 @@ The available `min/mid/max` types are: Parameter|Explanation ---|--- -min|Minimum value (for `MinType` only) +min|MinValue value (for `MinType` only) num|Numeric percent|Percentage percentile|Percentile formula|Formula -max|Maximum (for `MaxType` only) +max|MaxValue (for `MaxType` only) `MidType` - Used for `3_color_scale`. Same as `MinType`, see above. diff --git a/es/README.md b/es/README.md index bd4d6a54..4d39cb6a 100644 --- a/es/README.md +++ b/es/README.md @@ -8,8 +8,8 @@ Excelize es una biblioteca escrita en Go puro que proporciona un conjunto de fun - Problema: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Licencias: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- Ultima versión: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- Tiempo de actualización del documento: agosto 4, 2023 +- Ultima versión: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- Tiempo de actualización del documento: agosto 28, 2023 ## Misión del proyecto diff --git a/es/SUMMARY.md b/es/SUMMARY.md index 72fa4d00..30ed7718 100644 --- a/es/SUMMARY.md +++ b/es/SUMMARY.md @@ -233,7 +233,7 @@ * [Rendimiento](performance.md) * [Contribución](contribution.md) * Versiones Publicadas - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/es/base/installation.md b/es/base/installation.md index b77fbc4b..afa59cfc 100644 --- a/es/base/installation.md +++ b/es/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -Using the latest version Excelize library require to Go version 1.16 or later. +Using the latest version Excelize library require to Go version 1.16 or later. Tenga en cuenta que hay algunos [cambios incompatibles](https://github.com/golang/go/issues/61881) en Go 1.21.0, esta biblioteca no puede funcionar con esa versión; si está utilizando Go 1.21.x, actualice a Go 1.21.1 y una versión posterior. - Instalación diff --git a/es/data.md b/es/data.md index c289413b..877560ae 100644 --- a/es/data.md +++ b/es/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +Si escribe los elementos en el cuadro de diálogo de validación de datos (una lista delimitada), el límite es de 255 caracteres, incluidos los separadores. Si la fórmula de origen de su lista de validación de datos supera el límite de longitud máxima, establezca los valores permitidos en las celdas de la hoja de trabajo y utilice la función `SetSqrefDropList` para establecer la referencia para sus celdas. + Ejemplo 4, configure la validación de datos en `Sheet1!A7:B8` con la fuente de criterios de validación `Sheet1!E1:E3`, cree un menú desplegable en la celda permitiendo la fuente de la lista:

Validación de datos

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +Hay límites en la cantidad de elementos que se mostrarán en una lista desplegable de validación de datos: la lista puede mostrar hasta 32768 elementos de una lista en la hoja de trabajo. Si necesita más elementos, puede crear una lista desplegable dependiente, desglosada por categoría. + ## Obtener validación de datos{#GetDataValidations} ```go diff --git a/es/releases/v2.8.0.md b/es/releases/v2.8.0.md index f8fb9b44..49c86e89 100644 --- a/es/releases/v2.8.0.md +++ b/es/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* Lanzamiento: 28 agosto 2022 +* Esta versión lanzada el: 28 agosto 2022 +* Lanzado en GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## Notas de lanzamiento @@ -8,20 +9,34 @@ Los cambios más notables en esta versión son: ### Rompiendo cambios -* Cambios importantes: cambiar el nombre de la variable exportada `ErrTableNameLength` a `ErrNameLength` -* Cambios importantes: cambie el nombre del tipo exportado `PaneOptions` a `Selection` +* Cambiar el nombre de la variable exportada `ErrTableNameLength` a `ErrNameLength` +* Cambiar el nombre del tipo exportado `PaneOptions` a `Selection` +* Cambie el nombre del campo `Runs` a `Paragraph` en el tipo de datos `Comment` exportado * Eliminar el campo `Lang` en el tipo de datos `Style` +* Se eliminó el tipo de datos `ChartTitle` exportado y se usó el tipo de datos `RichTextRun` en su lugar +* Cambió el tipo de datos para `DecimalPlaces` a puntero de entero * Cambiar el factor de conversión predeterminado de puntos a píxeles, problema relacionado [#279](https://github.com/xuri/excelize/issues/279) y [#1536](https://github.com/xuri/excelize/issues/1536) +* Cambie la firma de la función `AddShape`: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` to `func (f *File) AddShape(sheet string, opts *Shape) error` ### Características notables -* Agregar nueva variable de error exportada `ErrExistsTableName` +* Agregue nuevas variables de error exportadas `ErrExistsTableName` y `ErrorFormControlValue` * Agregue nuevas opciones `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` y `CultureInfo` en el tipo de datos `Options`, problema relacionado [#1199](https://github.com/xuri/excelize/issues/1199) * Agregue una nueva enumeración `CultureName` del tipo de datos exportados para el código de país -* Soporte de marcador de posición, relleno, números de redondeo, cadena de moneda y argumento de interruptores por código de formato de número especificado, problema relacionado [#660](https://github.com/xuri/excelize/issues/660) +* Las nuevas funciones `GetTables` y `DeleteTable` admiten obtener y eliminar tablas, problema relacionado [#674](https://github.com/xuri/excelize/issues/674) y [#1454](https://github.com/xuri/excelize/issues/1454) +* Compatibilidad con la nueva función `GetStyle` para obtener definiciones de estilo, problema relacionado [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) y [#1521](https://github.com/xuri/excelize/issues/1521) +* Admite la aplicación de valor de celda con marcador de posición, relleno, números de redondeo, moneda, contabilidad y cambia el formato de número de argumento, y admite la aplicación de formato de número de fecha y hora para etiquetas de idioma 812, problema relacionado [#660](https://github.com/xuri/excelize/issues/660) +* Nuevo soporte 10 funciones de fórmula: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * Agregue detalles de limitación de longitud de ruta de archivo en el mensaje de error * Compatibilidad con la nueva función `GetPanes` para obtener paneles de hojas y ver la selección +* Las nuevas funciones `AddFormControl`, `GetFormControls` y `DeleteFormControl` son compatibles con los controles de formulario, problema relacionado [#301](https://github.com/xuri/excelize/issues/301) y [#1169](https://github.com/xuri/excelize/issues/1169) * El soporte de la función `AddChart` establece títulos primarios, problema relacionado [#1553](https://github.com/xuri/excelize/issues/1553) +* La función `AddChart` admite la creación de gráficos con un eje de serie secundario, problema relacionado [#518](https://github.com/xuri/excelize/issues/518) +* La función `AddChart` admite el formateo y la configuración de títulos de texto enriquecido para el gráfico, problema relacionado [#1588](https://github.com/xuri/excelize/issues/1588) +* Agregue verificación para el tipo de forma para la función `AddShape`, se devolverá un error si no se especifica ningún tipo de forma +* Admite valores de celda de lectura formateados por el formato de número de calendario japonés, problema relacionado [#1590](https://github.com/xuri/excelize/issues/1590) +* El soporte de la función `GetPictures` lee imágenes de anclaje de una celda, problema relacionado [#1585](https://github.com/xuri/excelize/issues/1585) +* El soporte de la función `NewConditionalStyle` para crear un formato condicional con formato de número y protección, problema relacionado [#1610](https://github.com/xuri/excelize/issues/1610) ### Mejorar la compatibilidad @@ -29,6 +44,7 @@ Los cambios más notables en esta versión son: * Evite crear tablas duplicadas y un nombre definido con el mismo nombre * Mejore la compatibilidad del tamaño de la forma del cuadro de comentarios de la celda con KingSoft WPS * Admite respaldo al ancho de columna predeterminado en la propiedad de formato de hoja, problema relacionado [#1536](https://github.com/xuri/excelize/issues/1536) +* Hizo que no se distinguiera entre mayúsculas y minúsculas para la ruta XML de la hoja de trabajo interna para mejorar la compatibilidad, problema relacionado [#1591](https://github.com/xuri/excelize/issues/1591) ### Corrección de errores @@ -38,11 +54,18 @@ Los cambios más notables en esta versión son: * Corregir condiciones de carrera para funciones de seguridad de concurrencia * Corrija el milisegundo redondo incorrecto para la fecha y hora * Solucione el resultado con formato de número incorrecto para la fecha y la hora con 12 horas a la mañana -* Solucione el resultado esperado de excepción de cálculo de fórmula incorrecta +* Corrige el resultado de las funciones de fórmula incorrecta SUMIFS y AVERAGEIFS, problema relacionado [#1564](https://github.com/xuri/excelize/issues/1564) +* Solucionar problemas básicos de prioridad del operador aritmético en el motor de cálculo, problema relacionado [#1599](https://github.com/xuri/excelize/issues/1599) * Solucionar el problema de referencia cruzada de hojas de trabajo para el motor de cálculo de fórmulas * Solucione el problema de ajuste de la tabla después de eliminar filas, problema relacionado [#1539](https://github.com/xuri/excelize/issues/1539) * Soporte para obtener múltiples imágenes en una celda, problema relacionado [#1548](https://github.com/xuri/excelize/issues/1548) -* Corrija el número de fila incorrecto cuando obtenga la posición del objeto, problema relacionado [#1560](https://github.com/xuri/excelize/issues/1560) +* Arreglar la posición de la imagen agregada era incorrecta en algunos casos, problema relacionado [#1560](https://github.com/xuri/excelize/issues/1560) +* Admite el ajuste de la fórmula al insertar columnas y filas, corrige la corrupción del libro de trabajo causada por la inserción de columnas o filas causadas, problema relacionado [#1565](https://github.com/xuri/excelize/issues/1565) +* Función de fórmula CONCAT, CONCATENATE admite la concatenación de múltiples valores de celda, problema relacionado [#1569](https://github.com/xuri/excelize/issues/1569) +* Solucione los resultados de cálculo de fórmula incorrectos en una función de argumento anidado que devuelve un resultado numérico, problema relacionado [#1582](https://github.com/xuri/excelize/issues/1582) +* Solucione los problemas internos del contador de objetos gráficos que causaron que la imagen agregada se duplicara, problema relacionado [#1584](https://github.com/xuri/excelize/issues/1584) +* Arreglar el resultado de la celda de fecha y hora de lectura fue causado incorrectamente por un problema de redondeo de horas, problema relacionado [#1587](https://github.com/xuri/excelize/issues/1587) +* Solucione el pánico al obtener celdas combinadas con el mismo eje inicial y final ### Optimización del rendimiento @@ -70,3 +93,7 @@ Gracias por todos los colaboradores de Excelize. A continuación se muestra una * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/es/utils.md b/es/utils.md index 75105270..19e4f439 100644 --- a/es/utils.md +++ b/es/utils.md @@ -283,10 +283,10 @@ La opción `Type` es un parámetro obligatorio y no tiene un valor predeterminad Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ La opción `Type` es un parámetro obligatorio y no tiene un valor predeterminad Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - El parámetro `minimum` se utiliza para establecer el valor límite inferior cuando el `Criteria` es `between` o `not between`. +type: `MinValue` - El parámetro `MinValue` se utiliza para establecer el valor límite inferior cuando el `Criteria` es `between` o `not between`. ```go // Regla de las celdas resaltadas: entre... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - El parámetro `maximum` se utiliza para establecer el valor límite superior cuando los criterios están `between` o `not between`. Vea el ejemplo anterior. +type: `MaxValue` - El parámetro `maximum` se utiliza para establecer el valor límite superior cuando los criterios están `between` o `not between`. Vea el ejemplo anterior. type: `average` - El tipo `average` se utiliza para especificar el formato condicional de estilo "Average" de Office Excel: diff --git a/fr/README.md b/fr/README.md index d7e08600..e8a54682 100644 --- a/fr/README.md +++ b/fr/README.md @@ -8,8 +8,8 @@ Excelize est une bibliothèque écrite en pure Go fournissant un ensemble de fon - Problème: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- Dernière version: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- Heure de mise à jour du document: 4 août 2023 +- Dernière version: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- Heure de mise à jour du document: 28 août 2023 ## Mission du projet diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md index aae57f13..09f2c2d0 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -233,7 +233,7 @@ * [Performance](performance.md) * [Contribution](contribution.md) * Versions publiées - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/fr/base/installation.md b/fr/base/installation.md index 76091a9c..5b73348c 100644 --- a/fr/base/installation.md +++ b/fr/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -L'utilisation de la dernière version de la bibliothèque Excelize nécessite Go version 1.16 ou ultérieure. +L'utilisation de la dernière version de la bibliothèque Excelize nécessite Go version 1.16 ou ultérieure. Notez qu'il y a des [modifications incompatibles](https://github.com/golang/go/issues/61881) dans Go 1.21.0, cette bibliothèque ne peut pas fonctionner avec cette version, si vous utilisez Go 1.21.x, veuillez passer à Go 1.21.1 et version ultérieure. - Installation diff --git a/fr/data.md b/fr/data.md index 0f282a8f..26c050a9 100644 --- a/fr/data.md +++ b/fr/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +Si vous saisissez les éléments dans la boîte de dialogue de validation des données (une liste délimitée), la limite est de 255 caractères, séparateurs compris. Si la formule source de votre liste de validation de données dépasse la limite de longueur maximale, veuillez définir les valeurs autorisées dans les cellules de la feuille de calcul et utilisez la fonction `SetSqrefDropList` pour définir la référence de leurs cellules. + Example 4，définir la validation des données sur `Sheet1!A7:B8` avec la source des critères de validation `Sheet1!E1:E3`, créer un menu déroulant dans la cellule en autorisant la source de liste: !["Data validation"](./images/data_validation_04.png "Data validation") @@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +Il existe des limites au nombre d'éléments qui s'afficheront dans une liste déroulante de validation des données: la liste peut afficher 32768 éléments d'une liste sur la feuille de calcul. Si vous avez besoin de plus d'éléments que cela, vous pouvez créer une liste déroulante dépendante, divisée par catégorie. + ## Obtenir la validation des données{#GetDataValidations} ```go diff --git a/fr/releases/v2.8.0.md b/fr/releases/v2.8.0.md index f1a50520..31a66c45 100644 --- a/fr/releases/v2.8.0.md +++ b/fr/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* Sera publié: 28 août 2023 +* Publié ce sur: 28 août 2023 +* Sorti sur GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## Notes de version @@ -8,20 +9,34 @@ Les changements les plus notables de cette version sont: ### Compatibilité -* Changements avec rupture: renommer la variable exportée `ErrTableNameLength` en `ErrNameLength` -* Changements avec rupture: renommez le type exporté "PaneOptions" en "Selection" +* Renommez la variable exportée `ErrTableNameLength` en `ErrNameLength` +* Renommez le type exporté `PaneOptions` en `Selection` +* Renommez le champ `Runs` en `Paragraph` dans le type de données `Comment` exporté * Supprimez le champ `Lang` dans le type de données `Style` +* Suppression du type de données exporté `ChartTitle` et utilisation du type de données `RichTextRun` à sa place +* Changement du type de données pour les `DecimalPlaces` en pointeur d'entier * Modifier le facteur de conversion point par défaut en pixels, problème associé [#279](https://github.com/xuri/excelize/issues/279) et [#1536](https://github.com/xuri/excelize/issues/1536) +* Modifier la signature de la fonction `AddShape`: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` en `func (f *File) AddShape(sheet string, opts *Shape) error` ### Caractéristiques notables -* Ajouter une nouvelle variable d'erreur exportée `ErrExistsTableName` +* Ajouter de nouvelles variables d'erreur exportées `ErrExistsTableName` et `ErrorFormControlValue` * Ajouter de nouvelles options `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` et `CultureInfo` dans le type de données `Options`, problème associé [#1199](https://github.com/xuri/excelize/issues/1199) * Ajouter une nouvelle énumération de type de données exportées `CultureName` pour le code de pays -* Prise en charge de l'espace réservé, du remplissage, des nombres arrondis, de la chaîne de devise et de l'argument des commutateurs par le code de format de nombre spécifié, problème associé [#660](https://github.com/xuri/excelize/issues/660) +* Nouvelles fonctions `GetTables` et `DeleteTable` support pour obtenir et supprimer des tables, problème associé [#674](https://github.com/xuri/excelize/issues/674) et [#1454](https://github.com/xuri/excelize/issues/1454) +* Prise en charge de la nouvelle fonction `GetStyle` pour obtenir les définitions de style, problème associé [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) et [#1521](https://github.com/xuri/excelize/issues/1521) +* Prise en charge de l'application de la valeur de cellule avec espace réservé, remplissage, nombres d'arrondis, devise, comptabilité et format de numéro d'argument de commutateurs, et prise en charge de l'application du format de date et d'heure pour les balises de langue 812, problème associé [#660](https://github.com/xuri/excelize/issues/660) +* Nouvelle prise en charge de 10 fonctions de formule: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * Ajouter des détails sur la limitation de la longueur du chemin d'accès au fichier dans le message d'erreur * Prise en charge de la nouvelle fonction `GetPanes` pour obtenir des volets de feuille et une sélection de vue +* Prise en charge des nouvelles fonctions `AddFormControl`, `GetFormControls` et `DeleteFormControl` pour les contrôles de formulaire, problème associé [#301](https://github.com/xuri/excelize/issues/301) et [#1169](https://github.com/xuri/excelize/issues/1169) * La fonction `AddChart` prend en charge les titres principaux définis, problème associé [#1553](https://github.com/xuri/excelize/issues/1553) +* La fonction `AddChart` prend en charge la création d'un graphique avec un axe de série secondaire, problème associé [#518](https://github.com/xuri/excelize/issues/518) +* La fonction `AddChart` prend en charge le formatage et la définition de titres de texte enrichi pour le graphique, problème associé [#1588](https://github.com/xuri/excelize/issues/1588) +* Ajouter une vérification du type de forme pour la fonction `AddShape`, une erreur sera renvoyée si aucun type de forme n'est spécifié +* Prise en charge des valeurs de cellule de lecture formatées par le format de numéro de calendrier japonais, problème associé [#1590](https://github.com/xuri/excelize/issues/1590) +* La fonction `GetPictures` prend en charge la lecture des images d'ancrage d'une cellule, problème associé [#1585](https://github.com/xuri/excelize/issues/1585) +* La fonction `NewConditionalStyle` prend en charge la création d'un format conditionnel avec format numérique et protection, problème associé [#1610](https://github.com/xuri/excelize/issues/1610) ### Improve the Compatibilité @@ -29,6 +44,7 @@ Les changements les plus notables de cette version sont: * Empêcher de créer des tables en double et un nom défini avec le même nom * Améliorer la compatibilité de la taille de la forme de la boîte de commentaire de cellule avec KingSoft WPS * Prend en charge le retour à la largeur de colonne par défaut dans la propriété de format de feuille, problème associé [#1536](https://github.com/xuri/excelize/issues/1536) +* Insensible à la casse pour le chemin XML de la feuille de calcul interne afin d'améliorer la compatibilité, problème associé [#1591](https://github.com/xuri/excelize/issues/1591) ### Corrections de bogues @@ -38,11 +54,18 @@ Les changements les plus notables de cette version sont: * Correction des conditions de concurrence pour les fonctions de sécurité de la simultanéité * Correction de la milliseconde ronde incorrecte pour la date et l'heure * Correction d'un résultat au format numérique incorrect pour la date et l'heure avec 12 heures le matin -* Corriger le résultat attendu de l'exception de calcul de formule incorrecte +* Correction des fonctions de formule incorrectes résultat SUMIFS et AVERAGEIFS, problème associé [#1564](https://github.com/xuri/excelize/issues/1564) +* Correction des problèmes de priorité des opérateurs arithmétiques de base dans le moteur de calcul, problème associé [#1599](https://github.com/xuri/excelize/issues/1599) * Correction d'un problème de référence de feuille de calcul croisée pour le moteur de calcul de formule * Correction du problème d'ajustement du tableau après avoir supprimé des lignes, problème associé [#1539](https://github.com/xuri/excelize/issues/1539) * Prise en charge pour obtenir plusieurs images dans une cellule, problème associé [#1548](https://github.com/xuri/excelize/issues/1548) -* Correction d'un numéro de ligne incorrect lors de l'obtention de la position de l'objet, problème associé [#1560](https://github.com/xuri/excelize/issues/1560) +* Corriger la position de l'image ajoutée était incorrecte dans certains cas, problème associé [#1560](https://github.com/xuri/excelize/issues/1560) +* Prend en charge l'ajustement de la formule lors de l'insertion de colonnes et de lignes, corrige la corruption du classeur causée par l'insertion de colonnes ou de lignes causées, problème associé [#1565](https://github.com/xuri/excelize/issues/1565) +* La fonction de formule CONCAT, CONCATENATE prend en charge la concaténation de plusieurs valeurs de cellule, problème associé [#1569](https://github.com/xuri/excelize/issues/1569) +* Correction des résultats de calcul de formule incorrects sur une fonction d'argument imbriquée qui renvoie un résultat numérique, problème associé [#1582](https://github.com/xuri/excelize/issues/1582) +* Correction des problèmes de compteur d'objets graphiques internes à cause desquels l'image ajoutée a été dupliquée, problème associé [#1584](https://github.com/xuri/excelize/issues/1584) +* Correction du résultat de la cellule de date et d'heure de lecture incorrectement causé par un problème d'arrondi des heures, problème associé [#1587](https://github.com/xuri/excelize/issues/1587) +* Correction de la panique lors de l'obtention de cellules fusionnées avec le même axe de début et de fin ### Performance @@ -70,3 +93,7 @@ Merci pour tous les contributeurs d'Excelize. Vous trouverez ci-dessous une list * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/fr/utils.md b/fr/utils.md index 32536a43..dfc3c4a2 100644 --- a/fr/utils.md +++ b/fr/utils.md @@ -283,10 +283,10 @@ L'option `Type` est un paramètre obligatoire et n'a pas de valeur par défaut. Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ L'option `Type` est un paramètre obligatoire et n'a pas de valeur par défaut. Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - Le paramètre `minimum` est utilisé pour définir la valeur limite inférieure lorsque le `critère` est entre `between` ou `not between`. +type: `MinValue` - Le paramètre `MinValue` est utilisé pour définir la valeur limite inférieure lorsque le `critère` est entre `between` ou `not between`. ```go // Highlight cells rules: between... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - Le paramètre `maximum` est utilisé pour définir la valeur limite supérieure lorsque les critères sont entre `between` ou `not between`. Voir l'exemple précédent. +type: `MaxValue` - Le paramètre `maximum` est utilisé pour définir la valeur limite supérieure lorsque les critères sont entre `between` ou `not between`. Voir l'exemple précédent. type: `average` - Le type `average` est utilisé pour spécifier le format conditionnel de style "Moyenne" d'Office Excel: @@ -716,12 +716,12 @@ Les types `min/mid/max` disponibles sont: Paramètre|Explication ---|--- -min|Minimum value (for `MinType` only) +min|MinValue value (for `MinType` only) num|Numeric percent|Percentage percentile|Percentile formula|Formula -max|Maximum (for `MaxType` only) +max|MaxValue (for `MaxType` only) `MidType` - Utilisé pour `3_color_scale`. Pareil que `MinType`, voir au dessus. diff --git a/index.html b/index.html index 33c012c0..6abf0bab 100644 --- a/index.html +++ b/index.html @@ -1172,7 +1172,7 @@

Release
- v 2.7.1 Go 1.16 or Higher v 2.8.0 Go 1.16 or Higher Donate
Support Development diff --git a/ja/README.md b/ja/README.md index c929e682..c64c28b9 100644 --- a/ja/README.md +++ b/ja/README.md @@ -8,8 +8,8 @@ Excelize は、純粋な Go で記述されたライブラリで、XLAM / XLSM / - 問題: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - ライセンス契約: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- 現在のバージョン: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- ドキュメントの更新：2023年8月4日 +- 現在のバージョン: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- ドキュメントの更新：2023年8月28日 ## プロジェクトミッション diff --git a/ja/SUMMARY.md b/ja/SUMMARY.md index 19b6c2cc..53e465ed 100644 --- a/ja/SUMMARY.md +++ b/ja/SUMMARY.md @@ -233,7 +233,7 @@ * [パフォーマンスデータ](performance.md) * [参加貢献](contribution.md) * バージョン履歴 - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/ja/base/installation.md b/ja/base/installation.md index cedadba9..84a24a0c 100644 --- a/ja/base/installation.md +++ b/ja/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -最新バージョンの Excelize ライブラリを使用するには、Go 1.16 以降が必要です。 +最新バージョンの Excelize ライブラリを使用するには、Go 1.16 以降が必要です。Go 1.21.0 には[互換性のない変更](https://github.com/golang/go/issues/61881)がいくつかあることに注意してください。このライブラリはそのバージョンでは動作しません。Go 1.21.x を使用している場合は、Go 1.21.1 以降のバージョンにアップグレードしてください。 - インストールコマンド diff --git a/ja/data.md b/ja/data.md index 97c80cc6..c4a8cb8a 100644 --- a/ja/data.md +++ b/ja/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +データ検証ダイアログ ボックス (区切り文字で区切られたリスト) に項目を入力する場合、制限は区切り文字を含めて 255 文字です。データ検証リストのソース式が最大長制限を超えている場合は、ワークシートのセルに許容値を設定し、`SetSqrefDropList` 関数を使用してセルの参照を設定してください。 + 例4、`Sheet1!A7:B8` に設定されています。`Sheet1!E1:E3` はソースの検証条件であり、空の値を無視してドロップダウン矢印を表示します:

データの検証

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +データ検証ドロップダウン リストに表示される項目の数には制限があります。ワークシート上のリストから最大 32768 個の項目を表示できます。それ以上の項目が必要な場合は、カテゴリ別に分類された依存ドロップダウン リストを作成できます。 + ## データ検証を取得する {#GetDataValidations} ```go diff --git a/ja/releases/v2.8.0.md b/ja/releases/v2.8.0.md index 35f16ade..dc42ce8c 100644 --- a/ja/releases/v2.8.0.md +++ b/ja/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* 近日公開予定: 2023年8月28日 +* 発売日: 2023年8月28日 +* GitHub Release: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## リリースノート @@ -8,20 +9,34 @@ ### 互換性のヒント -* 重大な変更: エクスポートされた変数 `ErrTableNameLength` の名前を `ErrNameLength` に変更します -* 重大な変更: エクスポートされたタイプの名前を `PaneOptions` から `Selection` に変更 +* エクスポートされた変数 `ErrTableNameLength` の名前を `ErrNameLength` に変更します +* エクスポートされたタイプの名前を `PaneOptions` から `Selection` に変更します +* エクスポートされた `Comment` データ型の `Runs` フィールドの名前を `Paragraph` に変更します * `Style` データ型の `Lang` フィールドを削除します +* エクスポートされた `ChartTitle` データ型を削除し、代わりに `RichTextRun` データ型を使用 +* `DecimalPlaces` のデータ型を整数のポインタに変更しました * デフォルトのポイントからピクセルへの変換係数を変更する, 関連する問題 [#279](https://github.com/xuri/excelize/issues/279) と [#1536](https://github.com/xuri/excelize/issues/1536) +* `AddShape` 関数のシグネチャを変更する: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` を `func (f *File) AddShape(sheet string, opts *Shape) error` ### 新機能 -* 新しいエクスポートされたエラー変数 `ErrExistsTableName` を追加します +* 新しいエクスポートされたエラー変数 `ErrExistsTableName` と `ErrorFormControlValue` を追加します * `Options` データ型に新しいオプション `ShortDatePattern`、`LongDatePattern`、`LongTimePattern`、`CultureInfo` を追加しました, 関連する問題 [#1199](https://github.com/xuri/excelize/issues/1199) * 国コードの新しいエクスポート データ型 `CultureName` 列挙を追加 -* プレースホルダー、パディング、数値の丸め、通貨文字列をサポートし、指定された数値形式コードによる引数の切り替えをサポートします, 関連する問題 [#660](https://github.com/xuri/excelize/issues/660) +* 新しい関数 `GetTables` と `DeleteTable` によるテーブルの取得と削除のサポート, 関連する問題 [#674](https://github.com/xuri/excelize/issues/674) と [#1454](https://github.com/xuri/excelize/issues/1454) +* スタイル定義を取得するための新しい関数 `GetStyle` のサポート, 関連する問題 [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) と [#1521](https://github.com/xuri/excelize/issues/1521) +* プレースホルダー、パディング、数値の四捨五入、通貨、アカウンティングを使用したセル値の適用をサポートし、引数の数値形式を切り替え、812 言語タグの日付と時刻の数値形式の適用をサポート, 関連する問題 [#660](https://github.com/xuri/excelize/issues/660) +* 新たに 10 個の数式関数をサポート: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * エラーメッセージにファイルパスの長さ制限の詳細を追加 * シート ペインとビューの選択を取得するための新しい関数 `GetPanes` のサポート +* 新しい関数 `AddFormControl`、`GetFormControls`、および `DeleteFormControl` によるフォーム コントロールのサポート, 関連する問題 [#301](https://github.com/xuri/excelize/issues/301) と [#1169](https://github.com/xuri/excelize/issues/1169) * `AddChart` 関数は、主要なタイトルの設定をサポートします, 関連する問題 [#1553](https://github.com/xuri/excelize/issues/1553) +* `AddChart` 関数は、第 2 系列軸を使用したグラフの作成をサポートします, 関連する問題 [#518](https://github.com/xuri/excelize/issues/518) +* `AddChart` 関数は、グラフのリッチ テキスト タイトルの書式設定と設定をサポートします, 関連する問題 [#1588](https://github.com/xuri/excelize/issues/1588) +* `AddShape` 関数の形状タイプのチェックを追加します。形状タイプが指定されていない場合はエラーが返されます +* 和暦数値形式でフォーマットされたセル値の読み取りをサポート, 関連する問題 [#1590](https://github.com/xuri/excelize/issues/1590) +* `GetPictures` 関数は、1 つのセルのアンカー画像の読み取りをサポートします, 関連する問題 [#1585](https://github.com/xuri/excelize/issues/1585) +* `NewConditionalStyle` 関数は、数値形式と保護を備えた条件付き書式の作成をサポートします, 関連する問題 [#1610](https://github.com/xuri/excelize/issues/1610) ### 互換性を向上させる @@ -29,6 +44,7 @@ * 重複したテーブルの作成と同じ名前の定義名を防止する * セルのコメント ボックスの形状サイズと KingSoft WPS の互換性を改善しました * シート形式プロパティでデフォルトの列幅へのフォールバックをサポート, 関連する問題 [#1536](https://github.com/xuri/excelize/issues/1536) +* 互換性を向上させるために、内部ワークシート XML パスで大文字と小文字を区別しないようにしました, 関連する問題 [#1591](https://github.com/xuri/excelize/issues/1591) ### 問題の修正 @@ -38,11 +54,18 @@ * 同時実行安全機能の競合状態を修正 * 日付時刻の誤ったミリ秒単位の丸めを修正 * 午前 12 時間の日付と時刻の誤った数値形式の結果を修正 -* 誤った数式計算例外の予期される結果を修正 +* 誤った数式関数 SUMIFS および AVERAGEIFS の結果を修正, 関連する問題 [#1564](https://github.com/xuri/excelize/issues/1564) +* 計算エンジンにおける基本的な算術演算子の優先順位の問題を修正, 関連する問題 [#1599](https://github.com/xuri/excelize/issues/1599) * 数式計算エンジンのクロスワークシート参照の問題を修正 * 行を削除した後のテーブルの調整の問題を修正, 関連する問題 [#1539](https://github.com/xuri/excelize/issues/1539) * 1 つのセルで複数の画像を取得するサポート, 関連する問題 [#1548](https://github.com/xuri/excelize/issues/1548) -* オブジェクトの位置を取得する際の間違った行番号を修正, 関連する問題 [#1560](https://github.com/xuri/excelize/issues/1560) +* 追加した画像の位置が正しくない場合があるのを修正, 関連する問題 [#1560](https://github.com/xuri/excelize/issues/1560) +* 列と行を挿入するときの数式の調整をサポートし、列または行の挿入によって引き起こされるブックの破損を修正します, 関連する問題 [#1565](https://github.com/xuri/excelize/issues/1565) +* 数式関数 CONCAT、CONCATENATE は複数のセル値の連結をサポートします, 関連する問題 [#1569](https://github.com/xuri/excelize/issues/1569) +* 数値結果を返すネストされた引数関数での誤った数式計算結果を修正しました, 関連する問題 [#1582](https://github.com/xuri/excelize/issues/1582) +* 追加された画像が重複する原因となった内部グラフィック オブジェクト カウンタの問題を修正, 関連する問題 [#1584](https://github.com/xuri/excelize/issues/1584) +* 時間の丸めの問題により、読み取り日付時刻セルの結果が誤って発生する問題を修正しました, 関連する問題 [#1587](https://github.com/xuri/excelize/issues/1587) +* 同じ開始軸と終了軸を持つセルを結合した場合のパニックを修正 ### パフォーマンスの最適化 @@ -70,3 +93,7 @@ Excelize へのすべての貢献者に感謝します。以下は、このバ * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/ja/utils.md b/ja/utils.md index 67f1960d..81766dc5 100644 --- a/ja/utils.md +++ b/ja/utils.md @@ -283,10 +283,10 @@ SetConditionalFormat には、セル値の条件付き書式設定規則を作 Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ SetConditionalFormat には、セル値の条件付き書式設定規則を作 Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - `minimum` パラメーターは、`Criteria` が `between` または `not between` でない場合に、より低い制限値を設定するために使用されます。 +type: `MinValue` - `MinValue` パラメーターは、`Criteria` が `between` または `not between` でない場合に、より低い制限値を設定するために使用されます。 ```go // Highlight cells rules: between... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - `maximum` パラメータは、条件が `between` または `not between` の場合に、上限制限値を設定するために使用されます。前の例を参照してください。 +type: `MaxValue` - `maximum` パラメータは、条件が `between` または `not between` の場合に、上限制限値を設定するために使用されます。前の例を参照してください。 type: `average` - `average` タイプは、Office Excel の "平均" スタイルの条件付き形式を指定するために使用されます: @@ -716,12 +716,12 @@ err := f.SetConditionalFormat("Sheet1", "K1:K10", パラメータ|説明 ---|--- -min|Minimum value (for `MinType` only) +min|MinValue value (for `MinType` only) num|Numeric percent|Percentage percentile|Percentile formula|Formula -max|Maximum (for `MaxType` only) +max|MaxValue (for `MaxType` only) `MidType` - `3_color_scale` に使用されます。`MinType` と同じ, 上記を参照してください。 diff --git a/ko/README.md b/ko/README.md index 7a0e03ee..f37f776a 100644 --- a/ko/README.md +++ b/ko/README.md @@ -8,8 +8,8 @@ Excelize 는 순수 Go로 작성된 라이브러리로 XLAM / XLSM / XLSX / XLTM - 발행물: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - 면허: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- 마지막 버전: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- 문서 업데이트 시간: 2023 년 8 월 4 일 +- 마지막 버전: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- 문서 업데이트 시간: 2023 년 8 월 28 일 ## 프로젝트 미션 diff --git a/ko/SUMMARY.md b/ko/SUMMARY.md index e753b4c6..7a998b25 100644 --- a/ko/SUMMARY.md +++ b/ko/SUMMARY.md @@ -233,7 +233,7 @@ * [성능](performance.md) * [의연금](contribution.md) * 릴리스된 버전 - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/ko/base/installation.md b/ko/base/installation.md index 7aa813ac..831d3fb0 100644 --- a/ko/base/installation.md +++ b/ko/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -최신 버전의 Excelize 라이브러리를 사용하려면 Go 버전 1.16 이상이 필요합니다. +최신 버전의 Excelize 라이브러리를 사용하려면 Go 버전 1.16 이상이 필요합니다. Go 1.21.0 에는 일부 [호환되지 않는 변경 사항](https://github.com/golang/go/issues/61881) 이 있습니다. 이 라이브러리는 해당 버전에서 작동할 수 없습니다. Go 1.21.x 를 사용하는 경우 Go 1.21.1 이상 버전으로 업그레이드하세요. - 설치 명령 diff --git a/ko/data.md b/ko/data.md index 84b28168..26382caa 100644 --- a/ko/data.md +++ b/ko/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +데이터 유효성 검사 대화 상자 (구분된 목록) 에 항목을 입력하는 경우 구분 기호를 포함하여 255 자로 제한됩니다. 데이터 유효성 검사 목록 소스 수식이 최대 길이 제한을 초과하는 경우 워크시트 셀에 허용되는 값을 설정하고 `SetSqrefDropList` 함수를 사용하여 해당 셀에 대한 참조를 설정하세요. + 예제 4, 유효성 검사 기준 소스 `Sheet1!E1:E3` 설정으로 `Sheet1!A7:B8` 에 대한 데이터 유효성 검사를 설정하고 목록 소스를 허용하여 셀 내 드롭다운을 만듭니다:

Data validation

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +데이터 유효성 검사 드롭다운 목록에 표시되는 항목 수에는 제한이 있습니다. 목록은 워크시트 목록의 최대 32768 개 항목을 표시할 수 있습니다. 그보다 더 많은 항목이 필요한 경우 카테고리별로 분류된 종속 드롭다운 목록을 만들 수 있습니다. + ## 데이터 유효성 검사 받기 {#GetDataValidations} ```go diff --git a/ko/releases/v2.8.0.md b/ko/releases/v2.8.0.md index 6bc6305f..a2b139f9 100644 --- a/ko/releases/v2.8.0.md +++ b/ko/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* 출시 예정: 2023 년 8 월 28 일 +* 이에 출시: 2023 년 8 월 28 일 +* GitHub 릴리스: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## 릴리스 노트 @@ -8,20 +9,35 @@ ### 호환성 -* 브레이킹 체인지: 내보낸 변수 `ErrTableNameLength` 를 `ErrNameLength` 로 이름 바꾸기 -* 브레이킹 체인지: 내보낸 유형 `PaneOptions` 의 이름을 `Selection` 으로 바꿉니다 +* 내보낸 변수 `ErrTableNameLength` 를 `ErrNameLength`로 이름 바꾸기 +* 내보낸 유형 `PaneOptions`를 `Selection` 으로 이름 바꾸기 +* 내보낸 `Comment` 데이터 유형에서 `Runs` 필드의 이름을 `Paragraph` 로 바꿉니다 +* フィールドの名前を `Paragraph` に変更します * `Style` 데이터 유형에서 `Lang` 필드 제거 +* 내보낸 `ChartTitle` 데이터 유형을 제거하고 대신 `RichTextRun` 데이터 유형 사용 +* `DecimalPlaces` 의 데이터 유형을 정수 포인터로 변경했습니다 * 기본 포인트를 픽셀 변환 계수로 변경, 관련 문제 [#279](https://github.com/xuri/excelize/issues/279) 과 [#1536](https://github.com/xuri/excelize/issues/1536) +* `AddShape` 함수 시그니처를 변경합니다: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` 를 `func (f *File) AddShape(sheet string, opts *Shape) error` ### 주목할 만한 기능 -* 내보낸 새 오류 변수 `ErrExistsTableName` 추가 +* 내보낸 새 오류 변수 `ErrExistsTableName` 및 `ErrorFormControlValue` 추가 * `Options` 데이터 유형에 새로운 옵션 `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` 및 `CultureInfo` 추가, 관련 문제 [#1199](https://github.com/xuri/excelize/issues/1199) * 국가 코드에 대해 새로 내보낸 데이터 유형 `CultureName` 열거 추가 -* 지정된 숫자 형식 코드로 자리 표시자, 패딩, 반올림 숫자, 통화 문자열 및 스위치 인수 지원, 관련 문제 [#660](https://github.com/xuri/excelize/issues/660) +* 테이블 가져오기 및 제거를 위한 새로운 함수 `GetTables` 및 `DeleteTable` 지원, 관련 문제 [#674](https://github.com/xuri/excelize/issues/674) 과 [#1454](https://github.com/xuri/excelize/issues/1454) +* 스타일 정의를 가져오는 새로운 함수 `GetStyle` 지원, 관련 문제 [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) 과 [#1521](https://github.com/xuri/excelize/issues/1521) +* 자리 표시자, 패딩, 반올림 숫자, 통화, 회계 및 스위치 인수 숫자 형식으로 셀 값 적용 지원 및 812 언어 태그에 날짜 및 시간 숫자 형식 적용 지원, 관련 문제 [#660](https://github.com/xuri/excelize/issues/660) +* 새로운 지원 10 수식 기능: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * 오류 메시지에 파일 경로 길이 제한 세부 정보 추가 * 시트 창 및 뷰 선택을 가져오는 새로운 함수 `GetPanes` 지원 +* 양식 컨트롤에 대한 새로운 기능 `AddFormControl`, `GetFormControls` 및 `DeleteFormControl` 지원, 관련 문제 [#301](https://github.com/xuri/excelize/issues/301) 과 [#1169](https://github.com/xuri/excelize/issues/1169) * `AddChart` 기능은 기본 제목 설정을 지원합니다, 관련 문제 [#1553](https://github.com/xuri/excelize/issues/1553) +* `AddChart` 기능은 보조 시리즈 축으로 차트 생성을 지원합니다, 관련 문제 [#518](https://github.com/xuri/excelize/issues/518) +* `AddChart` 기능은 차트의 서식 지정 및 서식 있는 텍스트 제목 설정을 지원합니다, 관련 문제 [#1588](https://github.com/xuri/excelize/issues/1588) +* `AddShape` 기능에 대한 모양 유형 검사를 추가합니다. 모양 유형이 지정되지 않으면 오류가 반환됩니다 +* 일본 달력 숫자 형식으로 형식이 지정된 읽기 셀 값 지원, 관련 문제 [#1590](https://github.com/xuri/excelize/issues/1590) +* `GetPictures` 기능은 하나의 셀 앵커 사진 읽기를 지원합니다, 관련 문제 [#1585](https://github.com/xuri/excelize/issues/1585) +* `NewConditionalStyle` 함수는 숫자 형식 및 보호 기능이 있는 조건부 형식을 생성하도록 지원합니다, 관련 문제 [#1610](https://github.com/xuri/excelize/issues/1610) ### 호환성 개선 @@ -29,6 +45,7 @@ * 동일한 이름으로 중복 테이블 생성 및 정의된 이름 방지 * KingSoft WPS 와 셀 주석 상자 모양 크기 호환성 개선 * 시트 형식 속성에서 기본 열 너비로 대체 지원, 관련 문제 [#1536](https://github.com/xuri/excelize/issues/1536) +* 호환성을 개선하기 위해 내부 워크시트 XML 경로에 대해 대소문자를 구분하지 않음, 관련 문제 [#1591](https://github.com/xuri/excelize/issues/1591) ### 버그 수정 @@ -37,17 +54,24 @@ * 서식 텍스트 셀 값을 숫자로 방지, 관련 문제 [#1523](https://github.com/xuri/excelize/issues/1523), [#1528](https://github.com/xuri/excelize/issues/1528) 과 [#1533](https://github.com/xuri/excelize/issues/1533) * 동시성 안전 함수에 대한 경합 조건 수정 * 날짜 시간에 대한 잘못된 라운드 밀리초 수정 -* 오전 12시간으로 날짜 및 시간에 대해 잘못된 숫자 형식 결과 수정 -* 잘못된 수식 계산 예외 예상 결과 수정 +* 오전 12 시간으로 날짜 및 시간에 대해 잘못된 숫자 형식 결과 수정 +* 잘못된 수식 함수 SUMIFS 및 AVERAGEIFS 결과 수정, 관련 문제 [#1564](https://github.com/xuri/excelize/issues/1564) +* 계산 엔진의 기본 산술 연산자 우선 순위 문제 수정, 관련 문제 [#1599](https://github.com/xuri/excelize/issues/1599) * 수식 계산 엔진에 대한 교차 워크시트 참조 문제 수정 * 행을 제거한 후 테이블 조정 문제 수정, 관련 문제 [#1539](https://github.com/xuri/excelize/issues/1539) * 하나의 셀에 여러 이미지 가져오기 지원, 관련 문제 [#1548](https://github.com/xuri/excelize/issues/1548) -* 개체 위치를 가져올 때 잘못된 행 번호 수정, 관련 문제 [#1560](https://github.com/xuri/excelize/issues/1560) +* 경우에 따라 추가된 사진 위치가 올바르지 않은 문제 수정, 관련 문제 [#1560](https://github.com/xuri/excelize/issues/1560) +* 열과 행을 삽입할 때 수식 조정을 지원하고, 열이나 행을 삽입하여 발생하는 통합 문서 손상 수정, 관련 문제 [#1565](https://github.com/xuri/excelize/issues/1565) +* 수식 함수 CONCAT, CONCATENATE 는 여러 셀 값의 연결을 지원합니다, 관련 문제 [#1569](https://github.com/xuri/excelize/issues/1569) +* 숫자 결과를 반환하는 중첩 인수 함수에서 잘못된 수식 계산 결과 수정, 관련 문제 [#1582](https://github.com/xuri/excelize/issues/1582) +* 추가된 그림이 중복되는 내부 그래픽 개체 카운터 문제 수정, 관련 문제 [#1584](https://github.com/xuri/excelize/issues/1584) +* 시간 반올림 문제로 인해 읽기 날짜 시간 셀 결과가 잘못 발생하는 문제 수정, 관련 문제 [#1587](https://github.com/xuri/excelize/issues/1587) +* 시작 축과 종료 축이 동일한 셀을 병합할 때 발생하는 패닉 수정 ### 성능 최적화 * 정규식 호출을 최적화하여 성능 향상, 관련 문제 [#1532](https://github.com/xuri/excelize/issues/1532) -* 이는 불필요한 바이트/문자열 변환을 방지합니다., 관련 문제 [#1541](https://github.com/xuri/excelize/issues/1541) +* 이는 불필요한 바이트/문자열 변환을 방지합니다, 관련 문제 [#1541](https://github.com/xuri/excelize/issues/1541) ### 기타 @@ -70,3 +94,7 @@ Excelize 에 기여한 모든 분들께 감사드립니다. 아래는 이 버전 * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/ko/utils.md b/ko/utils.md index 4f8cd2e5..36b6a0bb 100644 --- a/ko/utils.md +++ b/ko/utils.md @@ -283,10 +283,10 @@ SetConditionalFormat 는 셀 값에 대한 조건부 서식 지정 규칙을 만 Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ SetConditionalFormat 는 셀 값에 대한 조건부 서식 지정 규칙을 만 Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -type: `Minimum` - 최소 매개변수는 `Criteria` 가 `between` 또는 `not between` 일 때 하한 값을 설정하는 데 사용됩니다. +type: `MinValue` - 최소 매개변수는 `Criteria` 가 `between` 또는 `not between` 일 때 하한 값을 설정하는 데 사용됩니다. ```go // Highlight cells rules: between... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -type: `Maximum` - `maximum` 매개변수는 기준이 `between` 또는 `not between` 일 때 상한 값을 설정하는 데 사용됩니다. 이전 예제를 참조하십시오. +type: `MaxValue` - `maximum` 매개변수는 기준이 `between` 또는 `not between` 일 때 상한 값을 설정하는 데 사용됩니다. 이전 예제를 참조하십시오. type: `average` - `average` 형식은 Office Excel 의 "Average" 스타일 조건부 형식을 지정하는 데 사용됩니다. @@ -716,12 +716,12 @@ err := f.SetConditionalFormat("Sheet1", "K1:K10", 매개 변수|설명 ---|--- -min|Minimum value (for `MinType` only) +min|MinValue value (for `MinType` only) num|Numeric percent|Percentage percentile|Percentile formula|Formula -max|Maximum (for `MaxType` only) +max|MaxValue (for `MaxType` only) `MidType` - `3_color_scale` 에 사용. `MinType` 와 동일, 위의 참조. diff --git a/ru/README.md b/ru/README.md index 47de618a..9b32705f 100644 --- a/ru/README.md +++ b/ru/README.md @@ -8,8 +8,8 @@ EXCELIZE - это библиотека, написанная на чистом G - вопрос: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Лицензии: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- Последняя версия: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- Время обновления документа: 4 Август 2023 г. +- Последняя версия: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- Время обновления документа: 28 Август 2023 г. ## Миссия проекта diff --git a/ru/SUMMARY.md b/ru/SUMMARY.md index df275eb3..7c3dcddf 100644 --- a/ru/SUMMARY.md +++ b/ru/SUMMARY.md @@ -233,7 +233,7 @@ * [Производительность](performance.md) * [Вклад](contribution.md) * Выпущенные версии - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/ru/base/installation.md b/ru/base/installation.md index cc99f96d..c1b0465c 100644 --- a/ru/base/installation.md +++ b/ru/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -Для использования библиотеки Excelize последней версии требуется версия Go 1.16 или более поздняя. +Для использования библиотеки Excelize последней версии требуется версия Go 1.16 или более поздняя. Обратите внимание, что в Go 1.21.0 есть некоторые [несовместимые изменения](https://github.com/golang/go/issues/61881), эта библиотека не может работать с этой версией. Если вы используете Go 1.21.x, обновитесь до Go 1.21.1 и более поздних версий. - Установка diff --git a/ru/data.md b/ru/data.md index 30eeece3..37e32199 100644 --- a/ru/data.md +++ b/ru/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +Если вы вводите элементы в диалоговое окно проверки данных (список с разделителями), ограничение составляет 255 символов, включая разделители. Если ваша исходная формула списка проверки данных превышает максимальный предел длины, установите допустимые значения в ячейках рабочего листа и используйте функцию `SetSqrefDropList`, чтобы установить ссылку для их ячеек. + Пример 4, установите проверку данных на `Sheet1!A7:B8` с параметрами критериев проверки. Параметры `Sheet1!E1:E3`, создайте раскрывающийся список в ячейке, разрешив источник списка: !["Data validation"](./images/data_validation_04.png "Data validation") @@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +Существуют ограничения на количество элементов, которые будут отображаться в раскрывающемся списке проверки данных: в списке может отображаться 32768 элементов из списка на листе. Если вам нужно больше элементов, вы можете создать зависимый раскрывающийся список, разбитый по категориям. + ## Получение проверки данных {#GetDataValidations} ```go diff --git a/ru/releases/v2.8.0.md b/ru/releases/v2.8.0.md index 9940d795..18d99bc9 100644 --- a/ru/releases/v2.8.0.md +++ b/ru/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* Выйдет: 28 Август 2023 г. +* Версия выпущена: 28 Август 2023 г. +* Выпуск GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## Примечания к выпуску @@ -8,20 +9,34 @@ ### Совместимость -* Критические изменения: переименуйте экспортированную переменную `ErrTableNameLength` в `ErrNameLength` -* Критические изменения: переименуйте экспортированный тип `PaneOptions` в `Selection` +* Переименуйте экспортированную переменную `ErrTableNameLength` в `ErrNameLength` +* Переименуйте экспортированный тип `PaneOptions` в `Selection` +* Переименуйте поле `Runs` в `Paragraph` в экспортированном типе данных `Comment` * Удалите поле `Lang` в типе данных `Style` +* Удален экспортированный тип данных `ChartTitle` и использование вместо него типа данных `RichTextRun` +* Изменен тип данных для `DecimalPlaces` на указатель целого числа * Измените коэффициент преобразования точки в пиксели по умолчанию, связанная проблема [#279](https://github.com/xuri/excelize/issues/279) и [#1536](https://github.com/xuri/excelize/issues/1536) +* Измените сигнатуру функции `AddShape`: `func (f *File) AddShape(sheet, cell string, opts *Shape) error` на `func (f *File) AddShape(sheet string, opts *Shape) error` ### Примечательные особенности -* Добавить новую экспортированную переменную ошибки `ErrExistsTableName` +* Добавьте новые экспортированные переменные ошибок `ErrExistsTableName` и `ErrorFormControlValue` * Добавьте новые параметры `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` и `CultureInfo` в типе данных `Options`, связанная проблема [#1199](https://github.com/xuri/excelize/issues/1199) * Добавить новое перечисление типа экспортируемых данных `CultureName` для кода страны -* Поддержка заполнителя, заполнения, округления чисел, строки валюты и аргумента переключения по указанному коду числового формата, связанная проблема [#660](https://github.com/xuri/excelize/issues/660) +* Новые функции GetTables и DeleteTable поддерживают получение и удаление таблиц, связанная проблема [#674](https://github.com/xuri/excelize/issues/674) и [#1454](https://github.com/xuri/excelize/issues/1454) +* Поддержка новой функции `GetStyle` для получения определений стилей, связанная проблема [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) и [#1521](https://github.com/xuri/excelize/issues/1521) +* Поддержка применения значения ячейки с заполнителем, отступами, числами раундов, валютой, бухгалтерским учетом и переключателем формата номера аргумента, а также поддержка применения формата даты и времени для языковых тегов 812, связанная проблема [#660](https://github.com/xuri/excelize/issues/660) +* Новые функции поддержки 10 формул: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB, VALUETOTEXT * Добавить сведения об ограничении длины пути к файлу в сообщении об ошибке -* New function `GetPanes` support to get sheet panes and view selection +* Поддержка новой функции `GetPanes` для получения панелей листа и выбора просмотра. +* Новые функции `AddFormControl`, `GetFormControls` и `DeleteFormControl` поддерживают элементы управления формы, связанная проблема [#301](https://github.com/xuri/excelize/issues/301) и [#1169](https://github.com/xuri/excelize/issues/1169) * Функция `AddChart` поддерживает установку основных заголовков, связанная проблема [#1553](https://github.com/xuri/excelize/issues/1553) +* Функция `AddChart` поддерживает создание диаграммы с осью вторичного ряда, связанная проблема [#518](https://github.com/xuri/excelize/issues/518) +* Функция `AddChart` поддерживает форматирование и установку форматированных текстовых заголовков для диаграммы, связанная проблема [#1588](https://github.com/xuri/excelize/issues/1588) +* Добавлена проверка типа фигуры для функции `AddShape`, будет возвращена ошибка, если тип фигуры не указан +* Поддержка чтения значений ячеек, отформатированных в формате чисел японского календаря, связанная проблема [#1590](https://github.com/xuri/excelize/issues/1590) +* Функция `GetPictures` поддерживает чтение изображений привязки одной ячейки, связанная проблема [#1585](https://github.com/xuri/excelize/issues/1585) +* Функция NewConditionalStyle поддерживает создание условного формата с числовым форматом и защитой, связанная проблема [#1610](https://github.com/xuri/excelize/issues/1610) ### Улучшение совместимости @@ -29,6 +44,7 @@ * Запретить создание повторяющихся таблиц и определенного имени с тем же именем * Улучшена совместимость размеров поля комментариев к ячейкам с KingSoft WPS * Поддержка возврата к ширине столбца по умолчанию в свойстве формата листа, связанная проблема [#1536](https://github.com/xuri/excelize/issues/1536) +* Сделано без учета регистра для внутреннего XML-пути рабочего листа для улучшения совместимости, связанная проблема [#1591](https://github.com/xuri/excelize/issues/1591) ### Исправление ошибок @@ -38,11 +54,18 @@ * Исправление условий гонки для функций безопасности параллелизма * Исправьте неправильную круглую миллисекунду для даты и времени * Исправить неверный формат числа для даты и времени с 12 часами в AM -* Исправить ожидаемый результат исключения вычисления неправильной формулы +* Исправьте неверные функции формулы SUMIFS и AVERAGEIFS, связанная проблема [#1564](https://github.com/xuri/excelize/issues/1564) +* Исправление основных проблем с приоритетом арифметических операций в вычислительном движке, связанная проблема [#1599](https://github.com/xuri/excelize/issues/1599) * Исправлена проблема со ссылками на листы для механизма расчета формул * Исправить проблему настройки таблицы после удаления строк, связанная проблема [#1539](https://github.com/xuri/excelize/issues/1539) * Поддержка получения нескольких изображений в одной ячейке, связанная проблема [#1548](https://github.com/xuri/excelize/issues/1548) -* Исправлен неправильный номер строки при получении позиции объекта, связанная проблема [#1560](https://github.com/xuri/excelize/issues/1560) +* Исправлена ошибка, из-за которой положение добавленного изображения было неправильным в некоторых случаях, связанная проблема [#1560](https://github.com/xuri/excelize/issues/1560) +* Поддержка настройки формулы при вставке столбцов и строк, исправление повреждения книги, вызванного вставкой столбцов или строк, вызванных, связанная проблема [#1565](https://github.com/xuri/excelize/issues/1565) +* Функция формулы CONCAT, CONCATENATE поддерживает объединение нескольких значений ячеек, связанная проблема [#1569](https://github.com/xuri/excelize/issues/1569) +* Исправлена неправильная формула, вычисляющая результаты для вложенной функции аргумента, которая возвращает числовой результат, связанная проблема [#1582](https://github.com/xuri/excelize/issues/1582) +* Исправление внутренних проблем со счетчиком графических объектов, из-за которых добавленное изображение дублировалось, связанная проблема [#1584](https://github.com/xuri/excelize/issues/1584) +* Исправлена ошибка, из-за которой результат чтения ячейки даты и времени был неправильно вызван проблемой округления часов, связанная проблема [#1587](https://github.com/xuri/excelize/issues/1587) +* Исправлена паника при получении объединенных ячеек с одной и той же начальной и конечной осями ### Оптимизация производительности @@ -70,3 +93,7 @@ * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/ru/utils.md b/ru/utils.md index f253eaf4..8bce9f23 100644 --- a/ru/utils.md +++ b/ru/utils.md @@ -283,10 +283,10 @@ SetConditionalFormat предоставляет функцию для созда Value - Minimum + MinValue - Maximum + MaxValue date @@ -296,10 +296,10 @@ SetConditionalFormat предоставляет функцию для созда Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle( ) ``` -Тип: `Minimum` - Минимальный параметр используется для установки нижнего предельного значения, когда `Criteria` либо `between`или `not between`. +Тип: `MinValue` - Минимальный параметр используется для установки нижнего предельного значения, когда `Criteria` либо `between`или `not between`. ```go // Выделяйте правила ячеек: между... @@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -Тип: `Maximum` - `Maximum` параметр используется для задания верхнего предельного значения, когда критерии являются либо `between` или `not between`. См. Предыдущий пример. +Тип: `MaxValue` - `MaxValue` параметр используется для задания верхнего предельного значения, когда критерии являются либо `between` или `not between`. См. Предыдущий пример. Тип: `average` - `average` типа используются для указания «Average» стиль условного формата Office Excel в: diff --git a/zh-hans/README.md b/zh-hans/README.md index f25ac3ad..3635c53c 100644 --- a/zh-hans/README.md +++ b/zh-hans/README.md @@ -8,8 +8,8 @@ Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基 - Issue: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - 许可协议: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- 当前版本: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- 文档更新: 2023年7月20日 +- 当前版本: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- 文档更新: 2023年8月28日 ## 项目使命 diff --git a/zh-hans/SUMMARY.md b/zh-hans/SUMMARY.md index cd207046..d422c1cc 100755 --- a/zh-hans/SUMMARY.md +++ b/zh-hans/SUMMARY.md @@ -197,6 +197,10 @@ * [删除数据验证](data.md#DeleteDataValidation) * [数据透视表](pivot.md#PivotTable) * [创建数据透视表](pivot.md#AddPivotTable) +* [表单控件](formControl.md) + * [添加表单控件](formControl.md#AddFormControl) + * [获取表单控件](formControl.md#GetFormControls) + * [删除表单控件](formControl.md#DeleteFormControl) * [工具函数](utils.md) * [创建表格](utils.md#AddTable) * [自动过滤器](utils.md#AutoFilter) @@ -229,7 +233,7 @@ * [性能数据](performance.md) * [参与贡献](contribution.md) * 版本历史 - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/zh-hans/base/installation.md b/zh-hans/base/installation.md index 9382ba94..ea98ea48 100644 --- a/zh-hans/base/installation.md +++ b/zh-hans/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -使用最新版本 Excelize 要求您使用的 Go 语言为 1.16 或更高版本。 +使用最新版本 Excelize 要求您使用的 Go 语言为 1.16 或更高版本。请注意，Go 1.21.0 中存在[不兼容的更改](https://github.com/golang/go/issues/61881)，导致 Excelize 基础库无法在该版本上正常工作，如果您使用的是 Go 1.21.x，请升级到 Go 1.21.1 及更高版本。 - 安装命令 diff --git a/zh-hans/data.md b/zh-hans/data.md index bfe6ccad..219ff018 100644 --- a/zh-hans/data.md +++ b/zh-hans/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +如果您在序列中设置的项目超过限制累计 255 个字符的限制，请使用另一种方式设置：在工作表单元格中设置允许的值，并使用 `SetSqrefDropList` 函数设置序列中引用单元格的范围。 + 例4，为 `Sheet1!A7:B8` 设置以 `Sheet1!E1:E3` 为来源的验证条件，忽略空值并提供下拉箭头:

数据验证

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +数据验证下拉列表中显示的项目数量有限制：该列表最多可以显示 32768 个项目。如果您需要更多项目，可以通过级联列表将项目分类。 + ## 获取数据验证 {#GetDataValidations} ```go diff --git a/zh-hans/formControl.md b/zh-hans/formControl.md new file mode 100644 index 00000000..0182ed7d --- /dev/null +++ b/zh-hans/formControl.md @@ -0,0 +1,144 @@ +# 表单控件 + +FormControl 定义了表单控件的属性。 + +```go +type FormControl struct { + Cell string + Macro string + Width uint + Height uint + Checked bool + CurrentVal uint + MinVal uint + MaxVal uint + IncChange uint + PageChange uint + Horizontally bool + CellLink string + Text string + Paragraph []RichTextRun + Type FormControlType + Format GraphicOptions +} +``` + +## 添加表单控件 {#AddFormControl} + +```go +func (f *File) AddFormControl(sheet string, opts FormControl) error +``` + +AddFormControl 通过给定的工作表名称和表单控件选项在工作表中添加表单控件。支持的表单控件类型为：按钮、复选框、分组框、标签、选项按钮、滚动条和微调框（调节按钮）。若需要为表单控件指定宏，保存的工作簿扩展名应为 `.xlsm` 或者 `.xltm`。滚动值应介于 0 到 30000 之间。 + +例1，在 `Sheet1!A2` 单元格添加带有指定宏、富文本、自定义尺寸和属性的按钮表单控件： + +

使用 Excelize 在工作表中添加按钮表单控件

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlButton, + Macro: "Button1_Click", + Width: 140, + Height: 60, + Text: "Button 1\r\n", + Paragraph: []excelize.RichTextRun{ + { + Font: &excelize.Font{ + Bold: true, + Italic: true, + Underline: "single", + Family: "Times New Roman", + Size: 14, + Color: "777777", + }, + Text: "C1=A1+B1", + }, + }, + Format: excelize.GraphicOptions{ + PrintObject: &enable, + Positioning: "absolute", + }, +}) +``` + +例2，在 `Sheet1!A1` 和 `Sheet1!A2` 单元格添加带有选中状态的选项按钮表单控件： + +

使用 Excelize 在工作表中添加选项按钮表单控件

+ +```go +if err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A1", + Type: excelize.FormControlOptionButton, + Text: "Option Button 1", + Checked: true, +}); err != nil { + fmt.Println(err) +} +if err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlOptionButton, + Text: "Option Button 2", +}); err != nil { + fmt.Println(err) +} +``` + +例3，在 `Sheet1!B1` 单元格添加带有控制选项的微调框（调节按钮）来增大或减小 `Sheet1!A1` 单元格的值： + +

使用 Excelize 在工作表中添加微调框（调节按钮）表单控件

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "B1", + Type: excelize.FormControlSpinButton, + Width: 15, + Height: 40, + CurrentVal: 7, + MinVal: 5, + MaxVal: 10, + IncChange: 1, + CellLink: "A1", +}) +``` + +例4，在 `Sheet1!A2` 单元格添加水平滚动条，通过拖动滚动框输入或修改 `Sheet1!A1` 单元格的值： + +

使用 Excelize 在工作表中添加水平滚动条表单控件

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlScrollBar, + Width: 140, + Height: 20, + CurrentVal: 50, + MinVal: 10, + MaxVal: 100, + IncChange: 1, + PageChange: 1, + CellLink: "A1", + Horizontally: true, +}) +``` + +## 获取表单控件 {#GetFormControls} + +```go +func (f *File) GetFormControls(sheet string) ([]FormControl, error) +``` + +根据给定的工作表名称获取工作表中的全部表单控件。注意，该函数目前尚未支持获取表单控件的宽高。 + +## 删除表单控件 {#DeleteFormControl} + +```go +func (f *File) DeleteFormControl(sheet, cell string) error +``` + +DeleteFormControl 通过给定的工作表名称和单元格坐标删除指定的表单控件。例如，删除位于 `Sheet1!$A$1` 单元格的表单控件: + +```go +err := f.DeleteFormControl("Sheet1", "A1") +``` diff --git a/zh-hans/releases/v2.8.0.md b/zh-hans/releases/v2.8.0.md index 3aa18e97..44e94f53 100644 --- a/zh-hans/releases/v2.8.0.md +++ b/zh-hans/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* 即将发布: 2023年8月28日 +* 发布日期: 2023年8月28日 +* GitHub Release: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## 版本说明 @@ -10,18 +11,32 @@ * 将导出变量 `ErrTableNameLength` 重命名为 `ErrNameLength` * 将导出类型 `PaneOptions` 重命名为 `Selection` +* 将导出类型 `Comment` 中的 `Runs` 字段重命名为 `Paragraph` * 移除了 `Style` 数据类型中的 `Lang` 字段 -* 修改了默认点与像素单位转换系数，相关 issue [#279](https://github.com/xuri/excelize/issues/279) and [#1536](https://github.com/xuri/excelize/issues/1536) +* 移除了 `ChartTitle` 数据类型，使用 `RichTextRun` 类型代替 +* 更改 `DecimalPlaces` 字段的数据类型为指针类型 +* 修改了默认点与像素单位转换系数，相关 issue [#279](https://github.com/xuri/excelize/issues/279) 和 [#1536](https://github.com/xuri/excelize/issues/1536) +* 修改了 `AddShape` 函数的签名：将 `func (f *File) AddShape(sheet, cell string, opts *Shape) error` 改为 `func (f *File) AddShape(sheet string, opts *Shape) error` ### 新增功能 -* 新增导出错误变量 `ErrExistsTableName` +* 新增导出错误变量 `ErrExistsTableName` 和 `ErrorFormControlValue` * `Options` 数据类型中新增 `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` 和 `CultureInfo` 选项，支持设置长短日期与时间格式代码，相关 issue [#1199](https://github.com/xuri/excelize/issues/1199) * 新增用于表示区域代码的 `CultureName` 类型枚举 -* 支持格式化带有占位、对其、舍入、货币符号和转换选项的数字格式，相关 issue [#660](https://github.com/xuri/excelize/issues/660) +* 新增函数 `GetTables` 与 `DeleteTable` 支持获取与删除表格，相关 issue [#674](https://github.com/xuri/excelize/issues/674) 和 [#1454](https://github.com/xuri/excelize/issues/1454) +* 新增函数 `GetStyle` 支持获取样式定义，相关 issue [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) 和 [#1521](https://github.com/xuri/excelize/issues/1521) +* 支持为单元格的值应用带有占位、对齐、舍入、货币、会计专用和转换选项的数字格式，并支持带有 812 种语言（位置）时间和日期类型的数字格式，相关 issue [#660](https://github.com/xuri/excelize/issues/660) +* 新增 71 项公式函数: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB 和 VALUETOTEXT * 增加对工作簿保存路径的检查，若路径长度超出限制将返回错误提示 * 新增 `GetPanes` 函数，支持获取窗格和视图选区设置 +* 新增 3 项表单控件函数 `AddFormControl`、`GetFormControls` 和 `DeleteFormControl`, 支持添加主要水平和垂直坐标轴标题，相关 issues [#301](https://github.com/xuri/excelize/issues/301) 和 [#1169](https://github.com/xuri/excelize/issues/1169) * 添加图表函数 `AddChart` 支持添加主要水平和垂直坐标轴标题，相关 issue [#1553](https://github.com/xuri/excelize/issues/1553) +* 添加图表函数 `AddChart` 支持添加次坐标轴，相关 issue [#518](https://github.com/xuri/excelize/issues/518) +* 添加图表函数 `AddChart` 支持设置图表富文本标题与图表标题格式，相关 issue [#1588](https://github.com/xuri/excelize/issues/1588) +* 通过 `AddShape` 函数添加形状时，如果给定的形状类型不受支持，将返回异常错误 +* 支持读取带有日本年号数字格式的单元格，相关 issue [#1590](https://github.com/xuri/excelize/issues/1590) +* 函数 `GetPictures` 支持读取带有单一单元格锚点位置的图片，相关 issue [#1585](https://github.com/xuri/excelize/issues/1585) +* 函数 `NewConditionalStyle` 支持创建带有数字格式与保护属性的条件格式样式，相关 issue [#1610](https://github.com/xuri/excelize/issues/1610) ### 兼容性提升 @@ -29,6 +44,7 @@ * 当创建带有重复名称的表格或自定义名称时，将返回错误异常 * 提高单元格批注文本框大小显示效果在 KingSoft WPS 下的兼容性 * 支持从自定义工作表属性设置中读取列宽度，相关 issue [#1536](https://github.com/xuri/excelize/issues/1536) +* 修改内部工作表 XML 部件名称为大小写不敏感以提高兼容性，相关 issue [#1591](https://github.com/xuri/excelize/issues/1591) ### 问题修复 @@ -38,11 +54,18 @@ * 修复了并发安全函数中存在的竞态问题 * 修复了部分情况下，对与单元格时间毫秒舍入精度结果有误的问题 * 修复了部分情况下，读取带有 12 小时制数字格式的单元格时，时间结果有误的问题 -* 修复部分情况下，公式计算引擎结果有误的问题 +* 修复了部分情况下，计算带有 SUMIFS 和 AVERAGEIFS 函数的公式结果有误的问题，解决 issue [#1564](https://github.com/xuri/excelize/issues/1564) +* 修复了公式计算引擎中基本算数运算符优先级问题导致的计算结果有误问题，解决 issue [#1599](https://github.com/xuri/excelize/issues/1599) * 修复部分情况下，带有跨工作表单元格引用公式计算结果有误的问题 * 修复部分情况下，删除行后，工作表中的表格调整结果异常的问题，解决 issue [#1539](https://github.com/xuri/excelize/issues/1539) -* 支持读取单元格中的多张图片，解决相关 issue [#1548](https://github.com/xuri/excelize/issues/1548) +* 支持读取单元格中的多张图片，解决 issue [#1548](https://github.com/xuri/excelize/issues/1548) * 修复部分情况下，因读取图形对象位置有误导致的添加图片结果异常问题，解决 issue [#1560](https://github.com/xuri/excelize/issues/1560) +* 删除行列时支持调整公式，修复部分情况下导致的文档损坏问题，解决 issue [#1565](https://github.com/xuri/excelize/issues/1565) +* 修复了部分情况下，计算带有 CONCAT 和 CONCATENATE 函数的公式结果有误的问题，解决 issue [#1569](https://github.com/xuri/excelize/issues/1569) +* 修复部分情况下，带有嵌套数字类型参数公式的计算结果有误问题，解决 issue [#1582](https://github.com/xuri/excelize/issues/1582) +* 修复因内部图形对象计数器有误导致的部分情况下添加图片出现重复的问题，解决 issue [#1584](https://github.com/xuri/excelize/issues/1584) +* 修复因部分情况下读取带有时间类型数字格式的单元格时，小时有误的问题，解决 issue [#1587](https://github.com/xuri/excelize/issues/1587) +* 修复了部分情况下，获取合并单元格区域右下角单元格坐标时出现的 panic ### 性能优化 @@ -70,3 +93,7 @@ * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/zh-hans/utils.md b/zh-hans/utils.md index 6d86d6ff..2e275131 100644 --- a/zh-hans/utils.md +++ b/zh-hans/utils.md @@ -280,10 +280,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue date @@ -293,10 +293,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -545,7 +545,7 @@ format3, err := f.NewConditionalStyle( ) ``` -类型：`minimum` - 当条件格式 `Criteria` 为 `between` 或 `not between` 时，`minimum` 参数用于设置下限值。 +类型：`MinValue` - 当条件格式 `Criteria` 为 `between` 或 `not between` 时，`MinValue` 参数用于设置下限值。 ```go // 高亮单元格条件格式规则： between... @@ -555,14 +555,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -类型：`Maximum` - 当条件格式 `Criteria` 为 `between` 或 `not between` 时，`Maximum` 参数用于设置上限值，参考上面的例子。 +类型：`MaxValue` - 当条件格式 `Criteria` 为 `between` 或 `not between` 时，`MaxValue` 参数用于设置上限值，参考上面的例子。 类型：`average` - 平均类型用于指定 Office Excel “最前最后规则”中“经典”样式的“仅高于或低于平均值的数值设置格式”条件格式： diff --git a/zh-tw/README.md b/zh-tw/README.md index 3014ee28..88bf7f36 100644 --- a/zh-tw/README.md +++ b/zh-tw/README.md @@ -8,8 +8,8 @@ Excelize 是 Go 語言編寫的用於操作 Office Excel 檔案基礎庫，基 - Issue: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues) - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - 許可協議: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) -- 當前版本: [v2.7.1](https://github.com/xuri/excelize/releases/latest) -- 檔案更新: 2023年7月20日 +- 當前版本: [v2.8.0](https://github.com/xuri/excelize/releases/latest) +- 檔案更新: 2023年8月28日 ## 專案使命 diff --git a/zh-tw/SUMMARY.md b/zh-tw/SUMMARY.md index 93f87ac7..de513a6e 100755 --- a/zh-tw/SUMMARY.md +++ b/zh-tw/SUMMARY.md @@ -197,6 +197,10 @@ * [刪除資料驗證](data.md#DeleteDataValidation) * [樞紐分析表](pivot.md#PivotTable) * [創建樞紐分析表](pivot.md#AddPivotTable) +* [表單控制項](formControl.md) + * [添加表單控制項](formControl.md#AddFormControl) + * [獲取表單控制項](formControl.md#GetFormControls) + * [刪除表單控制項](formControl.md#DeleteFormControl) * [工具函式](utils.md) * [創建表格](utils.md#AddTable) * [自動過濾器](utils.md#AutoFilter) @@ -229,7 +233,7 @@ * [性能資料](performance.md) * [參與貢獻](contribution.md) * 版本歷史 - * [v2.8.0](releases/v2.8.0.md) + * [v2.8.0 (2023-08-28)](releases/v2.8.0.md) * [v2.7.1 (2023-04-10)](releases/v2.7.1.md) * [v2.7.0 (2023-01-09)](releases/v2.7.0.md) * [v2.6.1 (2022-08-22)](releases/v2.6.1.md) diff --git a/zh-tw/base/installation.md b/zh-tw/base/installation.md index e423a0cd..0cef56e8 100644 --- a/zh-tw/base/installation.md +++ b/zh-tw/base/installation.md @@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15 v2.0.2 ~ v2.3.2 | 1.10 v1.0.0 ~ v2.0.1 | 1.6 -使用最新版本 Excelize 要求您使用的 Go 語言為 1.16 或更高版本。 +使用最新版本 Excelize 要求您使用的 Go 語言為 1.16 或更高版本。請注意，Go 1.21.0 中存在[不兼容的更改](https://github.com/golang/go/issues/61881)，導致 Excelize 基礎庫無法在該版本上正常工作，如果您使用的是 Go 1.21.x，請升級到 Go 1.21.1 及更高版本。 - 安裝命令 diff --git a/zh-tw/data.md b/zh-tw/data.md index 46edd888..7d6b0c7e 100644 --- a/zh-tw/data.md +++ b/zh-tw/data.md @@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"}) f.AddDataValidation("Sheet1", dv) ``` +如果您在序列中設定的項目超過限制累計 255 個字符的限制，請使用另一種方式設定：在工作表存儲格中設定允許的值，並使用 `SetSqrefDropList` 函數設定序列中引用存儲格的範圍。 + 例4，為 `Sheet1!A7:B8` 設定以 `Sheet1!E1:E3` 為來源的驗證條件，忽略空值並提供下拉箭頭:

資料驗證

@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3") f.AddDataValidation("Sheet1", dv) ``` +資料驗證下拉列表中顯示的項目數量有限制：該列表最多可以顯示 32768 個項目。如果您需要更多項目，可以通過級聯列表將項目分類。 + ## 獲取資料驗證 {#GetDataValidations} ```go diff --git a/zh-tw/formControl.md b/zh-tw/formControl.md new file mode 100644 index 00000000..836b9693 --- /dev/null +++ b/zh-tw/formControl.md @@ -0,0 +1,144 @@ +# 表單控制項 + +FormControl 定義了表單控制項的屬性。 + +```go +type FormControl struct { + Cell string + Macro string + Width uint + Height uint + Checked bool + CurrentVal uint + MinVal uint + MaxVal uint + IncChange uint + PageChange uint + Horizontally bool + CellLink string + Text string + Paragraph []RichTextRun + Type FormControlType + Format GraphicOptions +} +``` + +## 添加表單控制項 {#AddFormControl} + +```go +func (f *File) AddFormControl(sheet string, opts FormControl) error +``` + +AddFormControl 通過給定的工作表名稱和表單控制項選項在工作表中添加表單控制項。支持的表單控制項類型為：按鈕、核取方塊、群組方塊、標籤、選項按鈕、捲軸和微調按鈕。若需要為表單控制項指定巨集，保存的活頁簿擴展名應為 `.xlsm` 或者 `.xltm`。滾動值應介於 0 到 30000 之間。 + +例1，在 `Sheet1!A2` 存儲格添加帶有指定巨集、富文本、自定義尺寸和摘要資訊的按鈕表單控制項： + +

使用 Excelize 在工作表中添加按鈕表單控制項

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlButton, + Macro: "Button1_Click", + Width: 140, + Height: 60, + Text: "Button 1\r\n", + Paragraph: []excelize.RichTextRun{ + { + Font: &excelize.Font{ + Bold: true, + Italic: true, + Underline: "single", + Family: "Times New Roman", + Size: 14, + Color: "777777", + }, + Text: "C1=A1+B1", + }, + }, + Format: excelize.GraphicOptions{ + PrintObject: &enable, + Positioning: "absolute", + }, +}) +``` + +例2，在 `Sheet1!A1` 和 `Sheet1!A2` 存儲格添加帶有選中狀態的選項按鈕表單控制項： + +

使用 Excelize 在工作表中添加選項按鈕表單控制項

+ +```go +if err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A1", + Type: excelize.FormControlOptionButton, + Text: "Option Button 1", + Checked: true, +}); err != nil { + fmt.Println(err) +} +if err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlOptionButton, + Text: "Option Button 2", +}); err != nil { + fmt.Println(err) +} +``` + +例3，在 `Sheet1!B1` 存儲格添加帶有控制選項的微調按鈕來增大或減小 `Sheet1!A1` 存儲格的值： + +

使用 Excelize 在工作表中添加微調按鈕表單控制項

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "B1", + Type: excelize.FormControlSpinButton, + Width: 15, + Height: 40, + CurrentVal: 7, + MinVal: 5, + MaxVal: 10, + IncChange: 1, + CellLink: "A1", +}) +``` + +例4，在 `Sheet1!A2` 存儲格添加水平捲軸，通過拖動滾動框輸入或修改 `Sheet1!A1` 存儲格的值： + +

使用 Excelize 在工作表中添加水平捲軸表單控制項

+ +```go +err := f.AddFormControl("Sheet1", excelize.FormControl{ + Cell: "A2", + Type: excelize.FormControlScrollBar, + Width: 140, + Height: 20, + CurrentVal: 50, + MinVal: 10, + MaxVal: 100, + IncChange: 1, + PageChange: 1, + CellLink: "A1", + Horizontally: true, +}) +``` + +## 獲取表單控制項 {#GetFormControls} + +```go +func (f *File) GetFormControls(sheet string) ([]FormControl, error) +``` + +根據給定的工作表名稱獲取工作表中的全部表單控制項。注意，該函數目前尚未支持獲取表單控制項的寬高。 + +## 刪除表單控制項 {#DeleteFormControl} + +```go +func (f *File) DeleteFormControl(sheet, cell string) error +``` + +DeleteFormControl 通過給定的工作表名稱和存儲格坐標刪除指定的表單控制項。例如，刪除位於 `Sheet1!$A$1` 存儲格的表單控制項: + +```go +err := f.DeleteFormControl("Sheet1", "A1") +``` diff --git a/zh-tw/releases/v2.0.2.md b/zh-tw/releases/v2.0.2.md index 2a54371e..f6083e4f 100644 --- a/zh-tw/releases/v2.0.2.md +++ b/zh-tw/releases/v2.0.2.md @@ -16,7 +16,7 @@ * 支持創建樞紐分析表。新增 `AddPivotTable` 函式 * 支持創建走勢圖 (Sparkine)。新增 `AddSparkline` 函式 * 新增 `GroupSheets` 和 `UngroupSheets` 方法，支持設定工作表分組和取消工作表分組 -* 新增 `AddVBAProject` 方法，支持向 Excel 文檔中嵌入包含函式和宏的 VBA 工程 +* 新增 `AddVBAProject` 方法，支持向 Excel 文檔中嵌入包含函式和巨集的 VBA 工程 * 函式 `SetPageLayout` 增加適應頁面寬高屬性支持，相關 issue [#432](https://github.com/xuri/excelize/issues/432) * 函式 `SetSheetViewOptions` 現在支持 「值為零的儲存格是否顯示零值」 屬性的設定 * 函式 `SetCellFormula` 增加了對公式型別和引用屬性的設定支持 diff --git a/zh-tw/releases/v2.6.1.md b/zh-tw/releases/v2.6.1.md index 142062b0..b8abfdca 100644 --- a/zh-tw/releases/v2.6.1.md +++ b/zh-tw/releases/v2.6.1.md @@ -20,7 +20,7 @@ * 新增 34 項公式函式: CONVERT, COVARIANCE.S, DAVERAGE, DAYS360, DCOUNT, DCOUNTA, DGET, DMAX, DMIN, DPRODUCT, DSTDEV, DSTDEVP, DSUM, DVAR, DVARP, EDATE, EOMONTH, EUROCONVERT, GROWTH, HYPERLINK, MINVERSE, MMULT, NETWORKDAYS, NETWORKDAYS.INTL, PEARSON, RSQ, SKEW.P, SLOPE, STDEVPA, STEYX, TREND, WEEKNUM, WORKDAY, WORKDAY.INTL * 新增 `DeleteComment` 函式支持刪除存儲格註解，相關 issue [#849](https://github.com/xuri/excelize/issues/849) -* 透過 `AddShape` 函式添加圖形時支持指定宏 +* 透過 `AddShape` 函式添加圖形時支持指定巨集 * 新增對 1900 和 1904 日期系統的支持，相關 issue [#1212](https://github.com/xuri/excelize/issues/1212) * 新增更新超鏈接支持，相關 issue [#1217](https://github.com/xuri/excelize/issues/1217) * 透過 `AddPicture` 添加圖片時，現已允許插入 EMF、WMF、EMZ 和 WMZ 格式圖片，相關 issue [#1225](https://github.com/xuri/excelize/issues/1225) diff --git a/zh-tw/releases/v2.8.0.md b/zh-tw/releases/v2.8.0.md index 66977a5e..f2216756 100644 --- a/zh-tw/releases/v2.8.0.md +++ b/zh-tw/releases/v2.8.0.md @@ -1,6 +1,7 @@ # Excelize v2.8.0 -* 即將釋出: 2023年8月28日 +* 釋出日期: 2023年8月28日 +* GitHub Release: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0) ## 版本說明 @@ -8,20 +9,34 @@ ### 相容性提示 -* 將導出變量 `ErrTableNameLength` 重命名為 `ErrNameLength` +* 將導出變數 `ErrTableNameLength` 重命名為 `ErrNameLength` * 將導出類型 `PaneOptions` 重命名為 `Selection` +* 將導出類型 `Comment` 中的 `Runs` 字段重命名為 `Paragraph` * 移除了 `Style` 數據類型中的 `Lang` 字段 +* 移除了 `ChartTitle` 數據類型，使用 `RichTextRun` 類型代替 +* 更改 `DecimalPlaces` 字段的數據類型為指針類型 * 修改了默認點與像素單位轉換系數，相關 issue [#279](https://github.com/xuri/excelize/issues/279) and [#1536](https://github.com/xuri/excelize/issues/1536) +* 修改了 `AddShape` 函式的簽名：將 `func (f *File) AddShape(sheet, cell string, opts *Shape) error` 改為 `func (f *File) AddShape(sheet string, opts *Shape) error` ### 新增功能 -* 新增導出錯誤變量 `ErrExistsTableName` +* 新增導出錯誤變數 `ErrExistsTableName` 和 `ErrorFormControlValue` * `Options` 數據類型中新增 `ShortDatePattern`, `LongDatePattern`, `LongTimePattern` 和 `CultureInfo` 選項，支持設定長短日期與時間格式代碼，相關 issue [#1199](https://github.com/xuri/excelize/issues/1199) * 新增用於表示區域代碼的 `CultureName` 類型枚舉 -* 支持格式化帶有佔位、對其、捨入、貨幣符號和轉換選項的數字格式，相關 issue [#660](https://github.com/xuri/excelize/issues/660) +* 新增函式 `GetTables` 與 `DeleteTable` 支持獲取與刪除表格，相關 issue [#674](https://github.com/xuri/excelize/issues/674) 和 [#1454](https://github.com/xuri/excelize/issues/1454) +* 新增函式 `GetStyle` 支持獲取樣式定義，相關 issue [#314](https://github.com/xuri/excelize/issues/314), [#1520](https://github.com/xuri/excelize/issues/1520) 和 [#1521](https://github.com/xuri/excelize/issues/1521) +* 支持為存儲格的值應用帶有佔位、對齊、捨入、貨幣、會計專用和轉換選項的數字格式，並支持帶有 812 種語言（位置）時間和日期類型的數字格式，相關 issue [#660](https://github.com/xuri/excelize/issues/660) +* 新增 71 項公式函式: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB 和 VALUETOTEXT * 增加對活頁簿保存路徑的檢查，若路徑長度超出限制將返回錯誤提示 * 新增 `GetPanes` 函式，支持獲取窗格和視圖選區設定 +* 新增 3 項表單控制項函式 `AddFormControl`、`GetFormControls` 和 `DeleteFormControl`, 支持添加主要水平和垂直坐標軸標題，相關 issues [#301](https://github.com/xuri/excelize/issues/301) 和 [#1169](https://github.com/xuri/excelize/issues/1169) * 添加圖表函式 `AddChart` 支持添加主要水平和垂直坐標軸標題，相關 issue [#1553](https://github.com/xuri/excelize/issues/1553) +* 添加圖表函式 `AddChart` 支持添加次坐標軸，相關 issue [#518](https://github.com/xuri/excelize/issues/518) +* 添加圖表函式 `AddChart` 支持設置圖表富文本標題與圖表標題格式,，相關 issue [#1588](https://github.com/xuri/excelize/issues/1588) +* 通過 `AddShape` 函式添加形狀時，如果給定的形狀類型不受支持，將返回異常錯誤 +* 支持讀取帶有日本年號數字格式的存儲格，相關 issue [#1590](https://github.com/xuri/excelize/issues/1590) +* 函式 `GetPictures` 支持讀取帶有單一存儲格錨點位置的圖片，相關 issue [#1585](https://github.com/xuri/excelize/issues/1585) +* 函式 `NewConditionalStyle` 支持創建帶有數字格式與保護屬性的條件格式樣式，相關 issue [#1610](https://github.com/xuri/excelize/issues/1610) ### 相容性提升 @@ -29,6 +44,7 @@ * 當創建帶有重復名稱的表格或自定義名稱時，將返回錯誤異常 * 提高存儲格註解文本框大小顯示效果在 KingSoft WPS 下的兼容性 * 支持從自定義工作表屬性設定中讀取欄寬度，相關 issue [#1536](https://github.com/xuri/excelize/issues/1536) +* 修改內部工作表 XML 部件名稱為大小寫不敏感以提高相容性，相關 issue [#1591](https://github.com/xuri/excelize/issues/1591) ### 問題修復 @@ -38,21 +54,28 @@ * 修復了併發安全函式中存在的競態問題 * 修復了部分情況下，對與存儲格時間毫秒捨入精度結果有誤的問題 * 修復了部分情況下，讀取帶有 12 小時制數字格式的存儲格時，時間結果有誤的問題 -* 修復部分情況下，公式計算引擎結果有誤的問題 +* 修復了部分情況下，計算帶有 SUMIFS 和 AVERAGEIFS 函式的公式結果有誤的問題，解決 issue [#1564](https://github.com/xuri/excelize/issues/1564) +* 修復了公式計算引擎中基本算數運算符優先級問題導致的計算結果有誤問題，解決 issue [#1599](https://github.com/xuri/excelize/issues/1599) * 修復部分情況下，帶有跨工作表存儲格引用公式計算結果有誤的問題 * 修復部分情況下，刪除列後，工作表中的表格調整結果異常的問題，解決 issue [#1539](https://github.com/xuri/excelize/issues/1539) -* 支持讀取存儲格中的多張圖片，解決相關 issue [#1548](https://github.com/xuri/excelize/issues/1548) +* 支持讀取存儲格中的多張圖片，解決 issue [#1548](https://github.com/xuri/excelize/issues/1548) * 修復部分情況下，因讀取圖形對象位置有誤導致的添加圖片結果異常問題，解決 issue [#1560](https://github.com/xuri/excelize/issues/1560) +* 刪除列欄時支持調整公式，修復部分情況下導致的檔案損壞問題，解決 issue [#1565](https://github.com/xuri/excelize/issues/1565) +* 修復了部分情況下，計算帶有 CONCAT 和 CONCATENATE 函式的公式結果有誤的問題，解決 issue [#1569](https://github.com/xuri/excelize/issues/1569) +* 修復部分情況下，帶有嵌套數字類型參數公式的計算結果有誤問題，解決 issue [#1582](https://github.com/xuri/excelize/issues/1582) +* 修復因內部圖形對象計數器有誤導致的部分情況下添加圖片出現重復的問題，解決 issue [#1584](https://github.com/xuri/excelize/issues/1584) +* 修復因部分情況下讀取帶有時間類型數字格式的存儲格時，小時有誤的問題，解決 issue [#1587](https://github.com/xuri/excelize/issues/1587) +* 修復了部分情況下，獲取合併存儲格區域右下角存儲格坐標時出現的 panic ### 性能優化 * 優化內部正字表達式的執行速度，相關 issue [#1532](https://github.com/xuri/excelize/issues/1532) -* 避免內部字節數組與字符串數據類型變量之間的轉換，相關 issue [#1541](https://github.com/xuri/excelize/issues/1541) +* 避免內部字節數組與字符串數據類型變數之間的轉換，相關 issue [#1541](https://github.com/xuri/excelize/issues/1541) ### 其他 * Go Modules 依賴模塊更新 -* 簡化了內部變量的聲明與錯誤返回語句 +* 簡化了內部變數的聲明與錯誤返回語句 * 移除了內部帶有 Unicode 編碼的預設語言數字格式映射表 * 移除了內部 `xlsxTabColor` 數據類型，使用 `xlsxColor` 代替 `xlsxTabColor` 數據類型 * 單元測試與文檔更新 @@ -70,3 +93,7 @@ * @yicixin (壹次心) * @vb6iscool * @chengcxy (chengxinyao) +* @lidp20 +* @JDavidVR (David) +* @fsfsx +* @cnmlgbgithub diff --git a/zh-tw/utils.md b/zh-tw/utils.md index 5b437975..4352e5ba 100644 --- a/zh-tw/utils.md +++ b/zh-tw/utils.md @@ -280,10 +280,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue date @@ -293,10 +293,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo Value - Minimum + MinValue - Maximum + MaxValue time_period @@ -545,7 +545,7 @@ format3, err := f.NewConditionalStyle( ) ``` -類別：`Minimum` - 當條件式格式 `Criteria` 為 `between` 或 `not between` 時，`Minimum` 參數用於設定下限值。 +類別：`MinValue` - 當條件式格式 `Criteria` 為 `between` 或 `not between` 時，`MinValue` 參數用於設定下限值。 ```go // 高亮儲存格條件式格式規則： between... @@ -555,14 +555,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10", Type: "cell", Criteria: "between", Format: format, - Minimum: "6", - Maximum: "8", + MinValue: "6", + MaxValue: "8", }, }, ) ``` -類別：`Maximum` - 當條件式格式 `Criteria` 為 `between` 或 `not between` 時，`Maximum` 參數用於設定上限值，參考上面的例子。 +類別：`MaxValue` - 當條件式格式 `Criteria` 為 `between` 或 `not between` 時，`MaxValue` 參數用於設定上限值，參考上面的例子。 類別：`average` - 平均類別用於指定 Office Excel 「前段後段規則」中「經典」樣式的「僅高於或低於平均值的數值設定格式」條件式格式： @@ -1104,7 +1104,7 @@ func (f *File) WriteToBuffer() (*bytes.Buffer, error) func (f *File) AddVBAProject(file []byte) error ``` -該函式提供方法將包含函式和/或宏的 `vbaProject.bin` 檔案嵌入到 Excel 文檔中，檔案擴展名應為 `.xlsm` 或者 `.xltm`。例如: +該函式提供方法將包含函式和/或巨集的 `vbaProject.bin` 檔案嵌入到 Excel 文檔中，檔案擴展名應為 `.xlsm` 或者 `.xltm`。例如: ```go codeName := "Sheet1" diff --git a/zh-tw/workbook.md b/zh-tw/workbook.md index ad1a2f25..ee91866d 100755 --- a/zh-tw/workbook.md +++ b/zh-tw/workbook.md @@ -40,7 +40,7 @@ type Options struct { func NewFile(opts ...Options) *File ``` -使用 `NewFile` 新增 Excel 工作薄，新創建的活頁簿中會默認包含一個名為 `Sheet1` 的工作表。 +使用 `NewFile` 新增 Excel 活頁簿，新創建的活頁簿中會默認包含一個名為 `Sheet1` 的工作表。 ## 開啓 {#OpenFile}