Skip to content

Commit a7832d0

Browse files
xurixuri
committed
This related for qax-os/excelize#2229, update docs for the SetDefinedName function
1 parent 48440de commit a7832d0

28 files changed

+206
-98
lines changed

‎ar/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج
99
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
1010
- التراخيص: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
1111
- الإصدار الأخير: [v2.10.0](https://github.com/xuri/excelize/releases/latest)
12-
- وقت تحديث المستند: اكتوبر 14, 2025
12+
- وقت تحديث المستند: اكتوبر 30, 2025
1313

1414
## بعثة المشروع
1515

‎ar/workbook.md‎

Lines changed: 23 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -852,10 +852,9 @@ func (f *File) SetDefinedName(definedName *DefinedName) error
852852

853853
```go
854854
err := f.SetDefinedName(&excelize.DefinedName{
855-
Name: "Amount",
856-
RefersTo: "Sheet1!$A$2:$D$5",
857-
Comment: "defined name comment",
858-
Scope: "Sheet2",
855+
Name: "كمية",
856+
RefersTo: "ورقة1!$A$2:$D$5",
857+
Comment: "تعليق على الاسم المحدد",
859858
})
860859
```
861860

@@ -866,15 +865,15 @@ err := f.SetDefinedName(&excelize.DefinedName{
866865
```go
867866
if err := f.SetDefinedName(&excelize.DefinedName{
868867
Name: "_xlnm.Print_Area",
869-
RefersTo: "Sheet1!$A$1:$Z$100",
870-
Scope: "Sheet1",
868+
RefersTo: "ورقة1!$A$1:$Z$100",
869+
Scope: "ورقة1",
871870
}); err != nil {
872871
fmt.Println(err)
873872
}
874873
if err := f.SetDefinedName(&excelize.DefinedName{
875874
Name: "_xlnm.Print_Titles",
876-
RefersTo: "Sheet1!$A:$A,Sheet1!$1:$1",
877-
Scope: "Sheet1",
875+
RefersTo: "ورقة1!$A:$A,ورقة1!$1:$1",
876+
Scope: "ورقة1",
878877
}); err != nil {
879878
fmt.Println(err)
880879
}
@@ -885,8 +884,8 @@ if err := f.SetDefinedName(&excelize.DefinedName{
885884
```go
886885
if err := f.SetDefinedName(&excelize.DefinedName{
887886
Name: "_xlnm.Print_Titles",
888-
RefersTo: "Sheet1!$A:$A",
889-
Scope: "Sheet1",
887+
RefersTo: "ورقة1!$A:$A",
888+
Scope: "ورقة1",
890889
}); err != nil {
891890
fmt.Println(err)
892891
}
@@ -897,13 +896,23 @@ if err := f.SetDefinedName(&excelize.DefinedName{
897896
```go
898897
if err := f.SetDefinedName(&excelize.DefinedName{
899898
Name: "_xlnm.Print_Titles",
900-
RefersTo: "Sheet1!$1:$1",
901-
Scope: "Sheet1",
899+
RefersTo: "ورقة1!$1:$1",
900+
Scope: "ورقة1",
902901
}); err != nil {
903902
fmt.Println(err)
904903
}
905904
```
906905

906+
يمكنك أيضًا استخدام الدالة في `RefersTo`. على سبيل المثال:
907+
908+
```go
909+
err := f.SetDefinedName(&excelize.DefinedName{
910+
Name: "نطاق مخصص",
911+
RefersTo: "ورقة1!$A$2+ورقة1!$D$5",
912+
Scope: "ورقة1",
913+
})
914+
```
915+
907916
## احصل على اسم محدد {#GetDefinedName}
908917

909918
```go
@@ -922,8 +931,8 @@ func (f *File) DeleteDefinedName(definedName *DefinedName) error
922931

923932
```go
924933
err := f.DeleteDefinedName(&excelize.DefinedName{
925-
Name: "Amount",
926-
Scope: "Sheet2",
934+
Name: "كمية",
935+
Scope: "ورقة2",
927936
})
928937
```
929938

‎de/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe
99
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
1010
- Lizenzen: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
1111
- Letzte Version: [v2.10.0](https://github.com/xuri/excelize/releases/latest)
12-
- Dokument Aktualisierungszeit: Oktober 14, 2025
12+
- Dokument Aktualisierungszeit: Oktober 30, 2025
1313

1414
## Project mission
1515

‎de/workbook.md‎

Lines changed: 23 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -847,10 +847,9 @@ SetDefinedName bietet eine Funktion zum Festlegen der definierten Namen der Arbe
847847

848848
```go
849849
err := f.SetDefinedName(&excelize.DefinedName{
850-
Name: "Amount",
851-
RefersTo: "Sheet1!$A$2:$D$5",
852-
Comment: "defined name comment",
853-
Scope: "Sheet2",
850+
Name: "Betrag",
851+
RefersTo: "Tabelle1!$A$2:$D$5",
852+
Comment: "definierter Name Kommentar",
854853
})
855854
```
856855

@@ -861,15 +860,15 @@ Einstellungen für Druckbereich und Drucktitel für das Arbeitsblatt:
861860
```go
862861
if err := f.SetDefinedName(&excelize.DefinedName{
863862
Name: "_xlnm.Print_Area",
864-
RefersTo: "Sheet1!$A$1:$Z$100",
865-
Scope: "Sheet1",
863+
RefersTo: "Tabelle1!$A$1:$Z$100",
864+
Scope: "Tabelle1",
866865
}); err != nil {
867866
fmt.Println(err)
868867
}
869868
if err := f.SetDefinedName(&excelize.DefinedName{
870869
Name: "_xlnm.Print_Titles",
871-
RefersTo: "Sheet1!$A:$A,Sheet1!$1:$1",
872-
Scope: "Sheet1",
870+
RefersTo: "Tabelle1!$A:$A,Tabelle1!$1:$1",
871+
Scope: "Tabelle1",
873872
}); err != nil {
874873
fmt.Println(err)
875874
}
@@ -880,8 +879,8 @@ Wenn Sie die Eigenschaft `RefersTo` mit nur einem Spaltenbereich ohne Komma fül
880879
```go
881880
if err := f.SetDefinedName(&excelize.DefinedName{
882881
Name: "_xlnm.Print_Titles",
883-
RefersTo: "Sheet1!$A:$A",
884-
Scope: "Sheet1",
882+
RefersTo: "Tabelle1!$A:$A",
883+
Scope: "Tabelle1",
885884
}); err != nil {
886885
fmt.Println(err)
887886
}
@@ -892,13 +891,23 @@ Wenn Sie die Eigenschaft `RefersTo` mit nur einem Zeilenbereich ohne Komma füll
892891
```go
893892
if err := f.SetDefinedName(&excelize.DefinedName{
894893
Name: "_xlnm.Print_Titles",
895-
RefersTo: "Sheet1!$1:$1",
896-
Scope: "Sheet1",
894+
RefersTo: "Tabelle1!$1:$1",
895+
Scope: "Tabelle1",
897896
}); err != nil {
898897
fmt.Println(err)
899898
}
900899
```
901900

901+
Sie können die Funktion auch in `RefersTo` verwenden. Zum Beispiel:
902+
903+
```go
904+
err := f.SetDefinedName(&excelize.DefinedName{
905+
Name: "Sondersortiment",
906+
RefersTo: "Tabelle1!$A$2+Tabelle1!$D$5",
907+
Scope: "Tabelle1",
908+
})
909+
```
910+
902911
## Definierten Namen abrufen {#GetDefinedName}
903912

904913
```go
@@ -917,8 +926,8 @@ DeleteDefinedName bietet eine Funktion zum Löschen der definierten Namen der Ar
917926

918927
```go
919928
err := f.DeleteDefinedName(&excelize.DefinedName{
920-
Name: "Amount",
921-
Scope: "Sheet2",
929+
Name: "Betrag",
930+
Scope: "Tabelle2",
922931
})
923932
```
924933

‎en/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Excelize is a library written in pure Go providing a set of functions that allow
99
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
1010
- Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
1111
- Last version: [v2.10.0](https://github.com/xuri/excelize/releases/latest)
12-
- Document update time: October 14, 2025
12+
- Document update time: October 30, 2025
1313

1414
## Project mission
1515

‎en/workbook.md‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -850,7 +850,6 @@ err := f.SetDefinedName(&excelize.DefinedName{
850850
Name: "Amount",
851851
RefersTo: "Sheet1!$A$2:$D$5",
852852
Comment: "defined name comment",
853-
Scope: "Sheet2",
854853
})
855854
```
856855
@@ -899,6 +898,16 @@ if err := f.SetDefinedName(&excelize.DefinedName{
899898
}
900899
```
901900
901+
You can also use the function in `RefersTo`. For example:
902+
903+
```go
904+
err := f.SetDefinedName(&excelize.DefinedName{
905+
Name: "CustomRange",
906+
RefersTo: "Sheet1!$A$2+Sheet1!$D$5",
907+
Scope: "Sheet1",
908+
})
909+
```
910+
902911
## Get defined name {#GetDefinedName}
903912
904913
```go

‎es/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Excelize es una biblioteca escrita en Go puro que proporciona un conjunto de fun
99
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
1010
- Licencias: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
1111
- Ultima versión: [v2.10.0](https://github.com/xuri/excelize/releases/latest)
12-
- Tiempo de actualización del documento: octubre 14, 2025
12+
- Tiempo de actualización del documento: octubre 30, 2025
1313

1414
## Misión del proyecto
1515

‎es/workbook.md‎

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -847,10 +847,9 @@ SetDefinedName proporciona una función para establecer los nombres definidos de
847847

848848
```go
849849
err := f.SetDefinedName(&excelize.DefinedName{
850-
Name: "Amount",
850+
Name: "Cantidad",
851851
RefersTo: "Hoja1!$A$2:$D$5",
852-
Comment: "defined name comment",
853-
Scope: "Hoja2",
852+
Comment: "comentario de nombre definido",
854853
})
855854
```
856855

@@ -899,6 +898,16 @@ if err := f.SetDefinedName(&excelize.DefinedName{
899898
}
900899
```
901900

901+
También puedes usar la función en `RefersTo`. Por ejemplo:
902+
903+
```go
904+
err := f.SetDefinedName(&excelize.DefinedName{
905+
Name: "RangoPersonalizado",
906+
RefersTo: "Hoja1!$A$2+Hoja1!$D$5",
907+
Scope: "Hoja1",
908+
})
909+
```
910+
902911
## Obtener el nombre definido {#GetDefinedName}
903912

904913
```go
@@ -917,7 +926,7 @@ DeleteDefinedName proporciona una función para eliminar los nombres definidos d
917926

918927
```go
919928
err := f.DeleteDefinedName(&excelize.DefinedName{
920-
Name: "Amount",
929+
Name: "Cantidad",
921930
Scope: "Hoja2",
922931
})
923932
```

‎fr/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Excelize est une bibliothèque écrite en pure Go fournissant un ensemble de fon
99
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
1010
- Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
1111
- Dernière version: [v2.10.0](https://github.com/xuri/excelize/releases/latest)
12-
- Heure de mise à jour du document: 14 octobre 2025
12+
- Heure de mise à jour du document: 30 octobre 2025
1313

1414
## Mission du projet
1515

‎fr/workbook.md‎

Lines changed: 22 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -847,10 +847,9 @@ SetDefinedName fournit une fonction permettant de définir les noms définis du
847847

848848
```go
849849
err := f.SetDefinedName(&excelize.DefinedName{
850-
Name: "Amount",
850+
Name: "Montant",
851851
RefersTo: "Sheet1!$A$2:$D$5",
852-
Comment: "defined name comment",
853-
Scope: "Sheet2",
852+
Comment: "nom défini commentaire",
854853
})
855854
```
856855

@@ -861,15 +860,15 @@ Paramètres de la zone d'impression et des titres d'impression pour la feuille d
861860
```go
862861
if err := f.SetDefinedName(&excelize.DefinedName{
863862
Name: "_xlnm.Print_Area",
864-
RefersTo: "Sheet1!$A$1:$Z$100",
865-
Scope: "Sheet1",
863+
RefersTo: "Feuil1!$A$1:$Z$100",
864+
Scope: "Feuil1",
866865
}); err != nil {
867866
fmt.Println(err)
868867
}
869868
if err := f.SetDefinedName(&excelize.DefinedName{
870869
Name: "_xlnm.Print_Titles",
871-
RefersTo: "Sheet1!$A:$A,Sheet1!$1:$1",
872-
Scope: "Sheet1",
870+
RefersTo: "Feuil1!$A:$A,Feuil1!$1:$1",
871+
Scope: "Feuil1",
873872
}); err != nil {
874873
fmt.Println(err)
875874
}
@@ -880,8 +879,8 @@ Si vous remplissez la propriété `RefersTo` avec une seule plage de colonnes sa
880879
```go
881880
if err := f.SetDefinedName(&excelize.DefinedName{
882881
Name: "_xlnm.Print_Titles",
883-
RefersTo: "Sheet1!$A:$A",
884-
Scope: "Sheet1",
882+
RefersTo: "Feuil1!$A:$A",
883+
Scope: "Feuil1",
885884
}); err != nil {
886885
fmt.Println(err)
887886
}
@@ -892,13 +891,23 @@ Si vous remplissez la propriété `RefersTo` avec une seule plage de lignes sans
892891
```go
893892
if err := f.SetDefinedName(&excelize.DefinedName{
894893
Name: "_xlnm.Print_Titles",
895-
RefersTo: "Sheet1!$1:$1",
896-
Scope: "Sheet1",
894+
RefersTo: "Feuil1!$1:$1",
895+
Scope: "Feuil1",
897896
}); err != nil {
898897
fmt.Println(err)
899898
}
900899
```
901900

901+
Vous pouvez également utiliser la fonction dans `RefersTo`. Par exemple:
902+
903+
```go
904+
err := f.SetDefinedName(&excelize.DefinedName{
905+
Name: "PlagePersonnalisée",
906+
RefersTo: "Feuil1!$A$2+Feuil1!$D$5",
907+
Scope: "Feuil1",
908+
})
909+
```
910+
902911
## Obtenir le nom défini {#GetDefinedName}
903912

904913
```go
@@ -917,8 +926,8 @@ DeleteDefinedName fournit une fonction pour supprimer les noms définis du class
917926
918927
```go
919928
err := f.DeleteDefinedName(&excelize.DefinedName{
920-
Name: "Amount",
921-
Scope: "Sheet2",
929+
Name: "Montant",
930+
Scope: "Feuil1",
922931
})
923932
```
924933

0 commit comments

Comments
 (0)