diff --git a/ar/README.md b/ar/README.md index 225184e4..8b9a0f70 100644 --- a/ar/README.md +++ b/ar/README.md @@ -9,7 +9,7 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- وقت تحديث المستند: يونيو 5, 2025 +- وقت تحديث المستند: يونيو 24, 2025 ## بعثة المشروع diff --git a/ar/SUMMARY.md b/ar/SUMMARY.md index 3faaeb1d..3b87db14 100644 --- a/ar/SUMMARY.md +++ b/ar/SUMMARY.md @@ -45,6 +45,8 @@ * [احصل على خصائص التطبيق](workbook.md#GetAppProps) * [تعيين خصائص الوثيقة](workbook.md#SetDocProps) * [احصل على خصائص المستند](workbook.md#GetDocProps) + * [تعيين خصائص مخصصة](workbook.md#SetCustomProps) + * [الحصول على خصائص مخصصة](workbook.md#GetCustomProps) * [تعيين خصائص الحساب](workbook.md#SetCalcProps) * [الحصول على خصائص الحساب](workbook.md#GetCalcProps) * [حماية المصنف](workbook.md#ProtectWorkbook) diff --git a/ar/workbook.md b/ar/workbook.md index 3c22a8be..744f4417 100644 --- a/ar/workbook.md +++ b/ar/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +تُطابق `CustomProperty` مباشرةً الخاصية المخصصة للمصنف. قد يكون نوع تاريخ القيمة أحد الأنواع التالية: `int32`، `float64`، `string`، `bool`، `time.Time`، أو `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + تعرف CalcPropsOptions مجموعة الخصائص التي تستخدمها التطبيق لتسجيل حالة الحساب والتفاصيل. ```go @@ -1009,6 +1018,22 @@ func (f *File) GetDocProps() (*DocProperties, error) يوفر GetDocProps وظيفة للحصول على خصائص المستند الأساسية. +## تعيين خصائص مخصصة {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +توفر دالة SetCustomProps دالة لتعيين خصائص ملف مخصصة باستخدام اسم وقيمة الخاصية المحددين. إذا كان اسم الخاصية موجودًا بالفعل، فسيتم تحديثه، وإلا فسيتم إضافة خاصية جديدة. يمكن أن تكون القيمة من نوع `int32`، أو `float64`، أو `bool`، أو `string`، أو `time.Time`، أو `nil`. سيتم حذف الخاصية إذا كانت قيمتها `nil`. تُرجع الدالة خطأً إذا لم تكن قيمة الخاصية من النوع الصحيح. + +## الحصول على خصائص مخصصة {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +توفر GetCustomProps وظيفة للحصول على خصائص ملف مخصصة. + ## تعيين خصائص الحساب {#SetCalcProps} ```go diff --git a/de/README.md b/de/README.md index 8d07ddfb..d095fc2d 100644 --- a/de/README.md +++ b/de/README.md @@ -9,7 +9,7 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- Dokument Aktualisierungszeit: Juni 5, 2025 +- Dokument Aktualisierungszeit: Juni 24, 2025 ## Project mission diff --git a/de/SUMMARY.md b/de/SUMMARY.md index f4928b64..703017cb 100644 --- a/de/SUMMARY.md +++ b/de/SUMMARY.md @@ -45,6 +45,8 @@ * [Anwendungseigenschaften abrufen](workbook.md#GetAppProps) * [Festlegen von Dokumenteigenschaften](workbook.md#SetDocProps) * [Abrufen von Dokumenteigenschaften](workbook.md#GetDocProps) + * [Festlegen benutzerdefinierter Eigenschaften](workbook.md#SetCustomProps) + * [Abrufen benutzerdefinierter Eigenschaften](workbook.md#GetCustomProps) * [Festlegen von Berechnungseigenschaften](workbook.md#SetCalcProps) * [Abrufen von Berechnungseigenschaften](workbook.md#GetCalcProps) * [Arbeitsbuch schützen](workbook.md#ProtectWorkbook) diff --git a/de/workbook.md b/de/workbook.md index f5b1db04..37e10343 100644 --- a/de/workbook.md +++ b/de/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` bildet die benutzerdefinierte Eigenschaft der Arbeitsmappe direkt ab. Der Datumstyp des Werts kann einer der folgenden sein: `int32`, `float64`, `string`, `bool`, `time.Time` oder `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` definiert die Sammlung von Eigenschaften, die die Anwendung zum Aufzeichnen des Berechnungsstatus und von Berechnungsdetails verwendet. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps bietet eine Funktion zum Abrufen der Eigenschaften des Dokumentkerns. +## Festlegen benutzerdefinierter Eigenschaften {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps bietet eine Funktion zum Festlegen benutzerdefinierter Dateieigenschaften anhand des angegebenen Eigenschaftsnamens und -werts. Existiert der Eigenschaftsname bereits, wird er aktualisiert, andernfalls wird eine neue Eigenschaft hinzugefügt. Der Wert kann vom Typ `int32`, `float64`, `bool`, `string`, `time.Time` oder `nil` sein. Bei einem Wert von `nil` wird die Eigenschaft gelöscht. Die Funktion gibt einen Fehler zurück, wenn der Eigenschaftswert nicht vom richtigen Typ ist. + +## Abrufen benutzerdefinierter Eigenschaften {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps bietet eine Funktion zum Abrufen benutzerdefinierter Dateieigenschaften. + ## Festlegen von Berechnungseigenschaften {#SetCalcProps} ```go diff --git a/en/README.md b/en/README.md index 55ba6cc4..6c59a720 100644 --- a/en/README.md +++ b/en/README.md @@ -9,7 +9,7 @@ Excelize is a library written in pure Go providing a set of functions that allow - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- Document update time: June 5, 2025 +- Document update time: June 24, 2025 ## Project mission diff --git a/en/SUMMARY.md b/en/SUMMARY.md index 07e768b0..5f77d099 100644 --- a/en/SUMMARY.md +++ b/en/SUMMARY.md @@ -45,6 +45,8 @@ * [Get application properties](workbook.md#GetAppProps) * [Set document properties](workbook.md#SetDocProps) * [Get document properties](workbook.md#GetDocProps) + * [Set custom properties](workbook.md#SetCustomProps) + * [Get custom properties](workbook.md#GetCustomProps) * [Set calculation properties](workbook.md#SetCalcProps) * [Get calculation properties](workbook.md#GetCalcProps) * [Protect workbook](workbook.md#ProtectWorkbook) diff --git a/en/workbook.md b/en/workbook.md index 6585f67b..6735ee66 100644 --- a/en/workbook.md +++ b/en/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` directly maps the custom property of the workbook. The value date type may be one of the following: `int32`, `float64`, `string`, `bool`, `time.Time`, or `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` defines the collection of properties the application uses to record calculation status and details. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps provides a function to get document core properties. +## Set custom properties {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps provides a function to set custom file properties by given property name and value. If the property name already exists, it will be updated, otherwise a new property will be added. The value can be of type `int32`, `float64`, `bool`, `string`, `time.Time` or `nil`. The property will be delete if the value is `nil`. The function returns an error if the property value is not of the correct type. + +## Get custom properties {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps provides a function to get custom file properties. + ## Set calculation properties {#SetCalcProps} ```go diff --git a/es/README.md b/es/README.md index 61f39cf5..91e9c030 100644 --- a/es/README.md +++ b/es/README.md @@ -9,7 +9,7 @@ Excelize es una biblioteca escrita en Go puro que proporciona un conjunto de fun - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- Tiempo de actualización del documento: junio 5, 2025 +- Tiempo de actualización del documento: junio 24, 2025 ## Misión del proyecto diff --git a/es/SUMMARY.md b/es/SUMMARY.md index 9e366abb..944eed1c 100644 --- a/es/SUMMARY.md +++ b/es/SUMMARY.md @@ -45,6 +45,8 @@ * [Obtener propiedades de la aplicación](workbook.md#GetAppProps) * [Establecer las propiedades del documento](workbook.md#SetDocProps) * [Obtener propiedades del documento](workbook.md#GetDocProps) + * [Establecer propiedades personalizadas](workbook.md#SetCustomProps) + * [Obtenga propiedades personalizadas](workbook.md#GetCustomProps) * [Establecer propiedades de cálculo](workbook.md#SetCalcProps) * [Obtener propiedades de cálculo](workbook.md#GetCalcProps) * [Proteger el libro de trabajo](workbook.md#ProtectWorkbook) diff --git a/es/workbook.md b/es/workbook.md index e0b3e651..43232f72 100644 --- a/es/workbook.md +++ b/es/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` asigna directamente la propiedad personalizada del libro. El tipo de fecha del valor puede ser uno de los siguientes: `int32`, `float64`, `string`, `bool`, `time.Time` o `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` define la colección de propiedades que utiliza la aplicación para registrar el estado y los detalles del cálculo. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps proporciona una función para obtener las propiedades principales del documento. +## Establecer propiedades personalizadas {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps proporciona una función para establecer propiedades de archivo personalizadas según el nombre y el valor de la propiedad. Si el nombre de la propiedad ya existe, se actualizará; de lo contrario, se añadirá una nueva. El valor puede ser de tipo `int32`, `float64`, `bool`, `string`, `time.Time` o `nil`. La propiedad se eliminará si el valor es `nil`. La función devuelve un error si el valor de la propiedad no es del tipo correcto. + +## Obtenga propiedades personalizadas {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps proporciona una función para obtener propiedades de archivos personalizadas. + ## Establecer propiedades de cálculo {#SetCalcProps} ```go diff --git a/fr/README.md b/fr/README.md index 319d6f2b..40ec4f78 100644 --- a/fr/README.md +++ b/fr/README.md @@ -9,7 +9,7 @@ Excelize est une bibliothèque écrite en pure Go fournissant un ensemble de fon - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- Heure de mise à jour du document: 5 juin 2025 +- Heure de mise à jour du document: 24 juin 2025 ## Mission du projet diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md index b00672f5..6f174fcc 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -45,6 +45,8 @@ * [Obtenir les propriétés de l'application](workbook.md#GetAppProps) * [Définir les propriétés du document](workbook.md#SetDocProps) * [Obtenir les propriétés du document](workbook.md#GetDocProps) + * [Définir des propriétés personnalisées](workbook.md#SetCustomProps) + * [Obtenir des propriétés personnalisées](workbook.md#GetCustomProps) * [Définir les propriétés de calcul](workbook.md#SetCalcProps) * [Obtenir les propriétés de calcul](workbook.md#GetCalcProps) * [Protéger le classeur](workbook.md#ProtectWorkbook) diff --git a/fr/workbook.md b/fr/workbook.md index 0ce9221f..480176c1 100644 --- a/fr/workbook.md +++ b/fr/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` mappe directement la propriété personnalisée du classeur. Le type de date de valeur peut être: `int32`, `float64`, `string`, `bool`, `time.Time` ou `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` définit la collection de propriétés que l'application utilise pour enregistrer l'état et les détails du calcul. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps fournit une fonction pour obtenir les propriétés de base du document. +## Définir des propriétés personnalisées {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps fournit une fonction permettant de définir des propriétés de fichier personnalisées selon un nom et une valeur donnés. Si le nom de la propriété existe déjà, il sera mis à jour; sinon, une nouvelle propriété sera ajoutée. La valeur peut être de type `int32`, `float64`, `bool`, `string`, `time.Time` ou `nil`. La propriété sera supprimée si elle est égale à `nil`. La fonction renvoie une erreur si la valeur de la propriété n'est pas du type correct. + +## Obtenir des propriétés personnalisées {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps fournit une fonction pour obtenir des propriétés de fichier personnalisées. + ## Définir les propriétés de calcul {#SetCalcProps} ```go diff --git a/it/README.md b/it/README.md index cf5b2258..4810c12f 100644 --- a/it/README.md +++ b/it/README.md @@ -9,7 +9,7 @@ Excelize è una libreria scritta in puro Go che fornisce una serie di funzioni c - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Licenze: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) - Ultima versione: [v2.9.1](https://github.com/xuri/excelize/releases/latest) -- Orario aggiornamento documento: giugno 5, 2025 +- Orario aggiornamento documento: giugno 24, 2025 ## Missione del progetto diff --git a/it/SUMMARY.md b/it/SUMMARY.md index 5af9b869..d57380bd 100644 --- a/it/SUMMARY.md +++ b/it/SUMMARY.md @@ -45,6 +45,8 @@ * [Ottieni le proprietà dell'applicazione](workbook.md#GetAppProps) * [Imposta le proprietà del documento](workbook.md#SetDocProps) * [Ottieni le proprietà del documento](workbook.md#GetDocProps) + * [Imposta proprietà personalizzate](workbook.md#SetCustomProps) + * [Ottieni proprietà personalizzate](workbook.md#GetCustomProps) * [Imposta le proprietà di calcolo](workbook.md#SetCalcProps) * [Ottieni le proprietà di calcolo](workbook.md#GetCalcProps) * [Proteggi la cartella di lavoro](workbook.md#ProtectWorkbook) diff --git a/it/workbook.md b/it/workbook.md index 72a564f7..240a7ab3 100644 --- a/it/workbook.md +++ b/it/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` mappa direttamente la proprietà personalizzata della cartella di lavoro. Il tipo di data del valore può essere uno dei seguenti: `int32`, `float64`, `string`, `bool`, `time.Time` o `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` definisce la raccolta di proprietà che l'applicazione utilizza per registrare lo stato e i dettagli del calcolo. ```go @@ -1012,6 +1021,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps fornisce una funzione per ottenere le proprietà principali del documento. +## Imposta proprietà personalizzate {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps fornisce una funzione per impostare proprietà di file personalizzate in base al nome e al valore della proprietà specificati. Se il nome della proprietà esiste già, verrà aggiornato, altrimenti verrà aggiunta una nuova proprietà. Il valore può essere di tipo `int32`, `float64`, `bool`, `string`, `time.Time` o `nil`. La proprietà verrà eliminata se il valore è `nil`. La funzione restituisce un errore se il valore della proprietà non è del tipo corretto. + +## Ottieni proprietà personalizzate {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps fornisce una funzione per ottenere proprietà di file personalizzate. + ## Imposta le proprietà di calcolo {#SetCalcProps} ```go diff --git a/ja/README.md b/ja/README.md index d290b3dc..5901ebe6 100644 --- a/ja/README.md +++ b/ja/README.md @@ -9,7 +9,7 @@ Excelize は、純粋な Go で記述されたライブラリで、XLAM / XLSM / - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- ドキュメントの更新:2025年6月5日 +- ドキュメントの更新:2025年6月24日 ## プロジェクトミッション diff --git a/ja/SUMMARY.md b/ja/SUMMARY.md index f5a3bc78..1790d429 100644 --- a/ja/SUMMARY.md +++ b/ja/SUMMARY.md @@ -45,6 +45,8 @@ * [アプリケーションのプロパティを取得する](workbook.md#GetAppProps) * [ドキュメントのプロパティを設定する](workbook.md#SetDocProps) * [ドキュメントのプロパティを取得する](workbook.md#GetDocProps) + * [カスタムプロパティを設定する](workbook.md#SetCustomProps) + * [カスタムプロパティを取得する](workbook.md#GetCustomProps) * [計算プロパティを設定する](workbook.md#SetCalcProps) * [計算プロパティを取得する](workbook.md#GetCalcProps) * [ブックを保護する](workbook.md#ProtectWorkbook) diff --git a/ja/workbook.md b/ja/workbook.md index eefc476e..213950f1 100644 --- a/ja/workbook.md +++ b/ja/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` は、ワークブックのカスタムプロパティを直接マッピングします。値の日付型は、`int32`、`float64`、`string`、`bool`、`time.Time`、`nil` のいずれかになります。 + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` は、計算の状態と詳細を記録するためにアプリケーションが使用するプロパティのコレクションを定義します。 ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) ワークブックのコアとなるプロパティを取得してください。 +## カスタムプロパティを設定する {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomPropsは、指定されたプロパティ名と値でカスタムファイルプロパティを設定する関数を提供します。プロパティ名が既に存在する場合は更新され、存在しない場合は新しいプロパティが追加されます。値の型は、`int32`、`float64`、`bool`、`string`、`time.Time`、または `nil` です。値が `nil` の場合、プロパティは削除されます。プロパティ値が正しい型でない場合、関数はエラーを返します。 + +## カスタムプロパティを取得する {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps は、カスタム ファイル プロパティを取得する関数を提供します。 + ## 計算プロパティを設定する {#SetCalcProps} ```go diff --git a/ko/README.md b/ko/README.md index 7d1abd6f..cba0b09f 100644 --- a/ko/README.md +++ b/ko/README.md @@ -9,7 +9,7 @@ Excelize 는 순수 Go로 작성된 라이브러리로 XLAM / XLSM / XLSX / XLTM - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- 문서 업데이트 시간: 2025 년 6 월 5 일 +- 문서 업데이트 시간: 2025 년 6 월 24 일 ## 프로젝트 미션 diff --git a/ko/SUMMARY.md b/ko/SUMMARY.md index c16df27e..3b8e1eff 100644 --- a/ko/SUMMARY.md +++ b/ko/SUMMARY.md @@ -45,6 +45,8 @@ * [애플리케이션 속성 가져오기](workbook.md#GetAppProps) * [문서 속성 설정](workbook.md#SetDocProps) * [문서 속성 가져오기](workbook.md#GetDocProps) + * [사용자 정의 속성 설정](workbook.md#SetCustomProps) + * [사용자 정의 속성 가져오기](workbook.md#GetCustomProps) * [계산 속성 설정](workbook.md#SetCalcProps) * [계산 속성 가져오기](workbook.md#GetCalcProps) * [통합 문서 보호](workbook.md#ProtectWorkbook) diff --git a/ko/workbook.md b/ko/workbook.md index c46e48c0..f4009024 100644 --- a/ko/workbook.md +++ b/ko/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` 는 통합 문서의 사용자 지정 속성을 직접 매핑합니다. 값 날짜 유형은 `int32`, `float64`, `string`, `bool`, `time.Time` 또는 `nil` 중 하나일 수 있습니다. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` 는 애플리케이션이 계산 상태와 세부 정보를 기록하는 데 사용하는 속성 컬렉션을 정의합니다. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) 통합 문서의 핵심 속성을 가져옵니다. +## 사용자 정의 속성 설정 {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps 는 주어진 속성 이름과 값으로 사용자 지정 파일 속성을 설정하는 함수를 제공합니다. 속성 이름이 이미 존재하면 업데이트되고, 그렇지 않으면 새 속성이 추가됩니다. 값은 `int32`, `float64`, `bool`, `string`, `time.Time` 또는 `nil` 유형일 수 있습니다. 값이 `nil` 이면 속성은 삭제됩니다. 속성 값이 올바른 유형이 아니면 이 함수는 오류를 반환합니다. + +## 사용자 정의 속성 가져오기 {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps 는 사용자 정의 파일 속성을 가져오는 함수를 제공합니다. + ## 계산 속성 설정 {#SetCalcProps} ```go diff --git a/pt/README.md b/pt/README.md index 55010577..6d2ea1c6 100644 --- a/pt/README.md +++ b/pt/README.md @@ -9,7 +9,7 @@ Excelize é uma biblioteca escrita em Go puro que fornece um conjunto de funçõ - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2) - Licenças: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) - Última versão: [v2.9.1](https://github.com/xuri/excelize/releases/latest) -- Hora de atualização do documento: junho 5, 2025 +- Hora de atualização do documento: junho 24, 2025 ## Missão do projeto diff --git a/pt/SUMMARY.md b/pt/SUMMARY.md index b972343a..9ae4ab1f 100644 --- a/pt/SUMMARY.md +++ b/pt/SUMMARY.md @@ -45,6 +45,8 @@ * [Obtenha propriedades do aplicativo](workbook.md#GetAppProps) * [Definir propriedades do documento](workbook.md#SetDocProps) * [Obtenha propriedades do documento](workbook.md#GetDocProps) + * [Definir propriedades personalizadas](workbook.md#SetCustomProps) + * [Obtenha propriedades personalizadas](workbook.md#GetCustomProps) * [Definir propriedades de cálculo](workbook.md#SetCalcProps) * [Obter propriedades de cálculo](workbook.md#GetCalcProps) * [Proteger pasta de trabalho](workbook.md#ProtectWorkbook) diff --git a/pt/workbook.md b/pt/workbook.md index 78d353d4..72f9e0b3 100644 --- a/pt/workbook.md +++ b/pt/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` mapeia diretamente a propriedade personalizada da pasta de trabalho. O tipo de data do valor pode ser um dos seguintes: `int32`, `float64`, `string`, `bool`, `time.Time` ou `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` define a coleção de propriedades que o aplicativo usa para registrar o status e os detalhes do cálculo. ```go @@ -1012,6 +1021,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps fornece uma função para obter as propriedades principais do documento. +## Definir propriedades personalizadas {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps fornece uma função para definir propriedades de arquivo personalizadas com base no nome e valor da propriedade. Se o nome da propriedade já existir, ele será atualizado; caso contrário, uma nova propriedade será adicionada. O valor pode ser do tipo `int32`, `float64`, `bool`, `string`, `time.Time` ou `nil`. A propriedade será excluída se o valor for `nil`. A função retornará um erro se o valor da propriedade não for do tipo correto. + +## Obtenha propriedades personalizadas {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps fornece uma função para obter propriedades de arquivo personalizadas. + ## Definir propriedades de cálculo {#SetCalcProps} ```go diff --git a/ru/README.md b/ru/README.md index f76ed7fd..7e2c2840 100644 --- a/ru/README.md +++ b/ru/README.md @@ -9,7 +9,7 @@ EXCELIZE - это библиотека, написанная на чистом G - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- Время обновления документа: 5 Июнь 2025 г. +- Время обновления документа: 24 Июнь 2025 г. ## Миссия проекта diff --git a/ru/SUMMARY.md b/ru/SUMMARY.md index ab04bea0..d41fac7b 100644 --- a/ru/SUMMARY.md +++ b/ru/SUMMARY.md @@ -45,6 +45,8 @@ * [Получить свойства приложения](workbook.md#GetAppProps) * [Установить свойства документа](workbook.md#SetDocProps) * [Получить свойства документа](workbook.md#GetDocProps) + * [Установить пользовательские свойства](workbook.md#SetCustomProps) + * [Получить пользовательские свойства](workbook.md#GetCustomProps) * [Установить свойства расчета](workbook.md#SetCalcProps) * [Получить свойства расчета](workbook.md#GetCalcProps) * [Защитить книгу](workbook.md#ProtectWorkbook) diff --git a/ru/workbook.md b/ru/workbook.md index 46f84a7d..a9ba1499 100644 --- a/ru/workbook.md +++ b/ru/workbook.md @@ -50,6 +50,15 @@ const ( ) ``` +`CustomProperty` напрямую отображает пользовательское свойство рабочей книги. Тип даты значения может быть одним из следующих: `int32`, `float64`, `string`, `bool`, `time.Time` или `nil`. + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` определяет набор свойств, которые приложение использует для записи статуса и подробностей расчетов. ```go @@ -1004,6 +1013,22 @@ func (f *File) GetDocProps() (*DocProperties, error) GetDocProps предоставляет функцию для получения основных свойств документа. +## Установить пользовательские свойства {#SetCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +SetCustomProps предоставляет функцию для установки пользовательских свойств файла по заданному имени свойства и значению. Если имя свойства уже существует, оно будет обновлено, в противном случае будет добавлено новое свойство. Значение может иметь тип `int32`, `float64`, `bool`, `string`, `time.Time` или `nil`. Свойство будет удалено, если значение равно `nil`. Функция возвращает ошибку, если значение свойства имеет неправильный тип. + +## Получить пользовательские свойства {#GetCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +GetCustomProps предоставляет функцию для получения пользовательских свойств файла. + ## Установить свойства расчета {#SetCalcProps} ```go diff --git a/zh-hans/README.md b/zh-hans/README.md index 1e52438f..533b14d5 100644 --- a/zh-hans/README.md +++ b/zh-hans/README.md @@ -9,7 +9,7 @@ Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基 - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- 文档更新: 2025年6月5日 +- 文档更新: 2025年6月24日 ## 项目使命 diff --git a/zh-hans/SUMMARY.md b/zh-hans/SUMMARY.md index 6b6f646e..69163d36 100755 --- a/zh-hans/SUMMARY.md +++ b/zh-hans/SUMMARY.md @@ -45,6 +45,8 @@ * [获取工作簿应用程序属性](workbook.md#GetAppProps) * [设置文档属性](workbook.md#SetDocProps) * [获取文档属性](workbook.md#GetDocProps) + * [设置自定义属性](workbook.md#SetDocCustomProps) + * [获取自定义属性](workbook.md#GetDocCustomProps) * [设置计算属性](workbook.md#SetCalcProps) * [获取计算属性](workbook.md#GetCalcProps) * [保护工作簿](workbook.md#ProtectWorkbook) diff --git a/zh-hans/workbook.md b/zh-hans/workbook.md index c183b3e2..5e1385b2 100644 --- a/zh-hans/workbook.md +++ b/zh-hans/workbook.md @@ -52,6 +52,15 @@ const ( ) ``` +`CustomProperty` 定义了设置工作簿自定义属性时的选项。自定义属性的值支持以下数据类型:`int32`、`float64`、`string`、`bool`、`time.Time` 和 `nil`。 + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` 定义了设置工作簿计算属性时的选项。 ```go @@ -1006,6 +1015,22 @@ func (f *File) GetDocProps() (*DocProperties, error) 获取工作簿的核心属性。 +## 设置自定义属性 {#SetDocCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +根据给定的属性名称和值设置工作簿的自定义属性。如果给定的属性名称已经存在,将会更新已存在属性的值,否则将添加新的属性。属性值支持的数据类型为 `int32`、`float64`、`bool`、`string`、`time.Time` 或 `nil`。当设置属性的值为 `nil` 时,将删除指定的属性。当给定的属性值是不受支持的数据类型时,函数将会返回错误。 + +## 获取自定义属性 {#GetDocCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +获取全部自定义属性。 + ## 设置计算属性 {#SetCalcProps} ```go diff --git a/zh-tw/README.md b/zh-tw/README.md index 48f9acbc..6aa2a0e6 100644 --- a/zh-tw/README.md +++ b/zh-tw/README.md @@ -9,7 +9,7 @@ Excelize 是 Go 語言編寫的用於操作 Office Excel 檔案基礎庫,基 - 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.9.1](https://github.com/xuri/excelize/releases/latest) -- 檔案更新: 2025年6月5日 +- 檔案更新: 2025年6月24日 ## 專案使命 diff --git a/zh-tw/SUMMARY.md b/zh-tw/SUMMARY.md index 050227e5..4cc0ab4f 100755 --- a/zh-tw/SUMMARY.md +++ b/zh-tw/SUMMARY.md @@ -45,6 +45,8 @@ * [獲取活頁簿應用程式屬性](workbook.md#GetAppProps) * [設定檔案屬性](workbook.md#SetDocProps) * [獲取檔案屬性](workbook.md#GetDocProps) + * [設定自訂屬性](workbook.md#SetDocCustomProps) + * [獲取自訂屬性](workbook.md#GetDocCustomProps) * [設定計算屬性](workbook.md#SetCalcProps) * [獲取計算屬性](workbook.md#GetCalcProps) * [保護活頁簿](workbook.md#ProtectWorkbook) diff --git a/zh-tw/workbook.md b/zh-tw/workbook.md index ae12937e..2a3992f9 100755 --- a/zh-tw/workbook.md +++ b/zh-tw/workbook.md @@ -52,6 +52,15 @@ const ( ) ``` +`CustomProperty` 定義了設定活頁簿自訂屬性時的選項。自訂屬性的值支持以下資料類型:`int32`、`float64`、`string`、`bool`、`time.Time` 和 `nil`。 + +```go +type CustomProperty struct { + Name string + Value interface{} +} +``` + `CalcPropsOptions` 定義了設定活頁簿計算屬性時的選項。 ```go @@ -1006,6 +1015,22 @@ func (f *File) GetDocProps() (*DocProperties, error) 獲取活頁簿的核心屬性。 +## 設定自訂屬性 {#SetDocCustomProps} + +```go +func (f *File) SetCustomProps(prop CustomProperty) error +``` + +根據給定的屬性名稱和值設定活頁簿的自訂屬性。如果給定的屬性名稱已經存在,將會更新已存在屬性的值,否則將添加新的屬性。屬性值支持的資料類型為 `int32`、`float64`、`bool`、`string`、`time.Time` 或 `nil`。當設定屬性的值為 `nil` 時,將刪除指定的屬性。當給定的屬性值是不受支持的資料類型時,函數將會返回錯誤。 + +## 獲取自訂屬性 {#GetDocCustomProps} + +```go +func (f *File) GetCustomProps() ([]CustomProperty, error) +``` + +獲取全部自訂屬性。 + ## 設定計算屬性 {#SetCalcProps} ```go