This related for qax-os/excelize#1015, add example for set print titl…

…es about using RefersTo property
xuri · Aug 24, 2024 · 04d105f · 04d105f
1 parent 47ec7ac
commit 04d105f
Show file tree

Hide file tree

Showing 24 changed files with 300 additions and 12 deletions.
diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- وقت تحديث المستند: أغسطس 5, 2024
+- وقت تحديث المستند: أغسطس 24, 2024
 
 ## بعثة المشروع
 

diff --git a/ar/workbook.md b/ar/workbook.md
@@ -754,6 +754,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+إذا قمت بملء خاصية `RefersTo` بنطاق عمود واحد فقط بدون فاصلة، فسوف تعمل كـ "الأعمدة التي سيتم تكرارها على اليسار" فقط. على سبيل المثال:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+إذا قمت بملء خاصية `RefersTo` بنطاق صف واحد فقط دون فاصلة، فسوف تعمل كـ "الصفوف التي سيتم تكرارها في الأعلى" فقط. على سبيل المثال:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## احصل على اسم محدد {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Dokument Aktualisierungszeit: August 5, 2024
+- Dokument Aktualisierungszeit: August 24, 2024
 
 ## Project mission
 

diff --git a/de/workbook.md b/de/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Wenn Sie die Eigenschaft `RefersTo` mit nur einem Spaltenbereich ohne Komma füllen, funktioniert sie nur als "Links zu wiederholende Spalten". Beispiel:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Wenn Sie die Eigenschaft `RefersTo` mit nur einem Zeilenbereich ohne Komma füllen, funktioniert sie nur als "Zeilen, die oben wiederholt werden sollen". Beispiel:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Definierten Namen abrufen {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Document update time: August 5, 2024
+- Document update time: August 24, 2024
 
 ## Project mission
 

diff --git a/en/workbook.md b/en/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+If you fill the `RefersTo` property with only one columns range without a comma, it will work as "Columns to repeat at left" only. For example:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+If you fill the `RefersTo` property with only one rows range without a comma, it will work as "Rows to repeat at top" only. For example:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Get defined name {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Tiempo de actualización del documento: agosto 5, 2024
+- Tiempo de actualización del documento: agosto 24, 2024
 
 ## Misión del proyecto
 

diff --git a/es/workbook.md b/es/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Si completa la propiedad `RefersTo` con un solo rango de columnas sin coma, funcionará solo como "Columnas para repetir a la izquierda". Por ejemplo:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Hoja1!$A:$A",
+    Scope:    "Hoja1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Si completa la propiedad `RefersTo` con un solo rango de filas sin coma, funcionará solo como "Filas para repetir en la parte superior". Por ejemplo:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Hoja1!$1:$1",
+    Scope:    "Hoja1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Obtener el nombre definido {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Heure de mise à jour du document: 5 août 2024
+- Heure de mise à jour du document: 24 août 2024
 
 ## Mission du projet
 

diff --git a/fr/workbook.md b/fr/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Si vous remplissez la propriété `RefersTo` avec une seule plage de colonnes sans virgule, elle fonctionnera uniquement comme "Colonnes à répéter à gauche". Par exemple:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Si vous remplissez la propriété `RefersTo` avec une seule plage de lignes sans virgule, elle fonctionnera uniquement comme "Lignes à répéter en haut". Par exemple:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Obtenir le nom défini {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Orario aggiornamento documento: agosto 5, 2024
+- Orario aggiornamento documento: agosto 24, 2024
 
 ## Missione del progetto
 

diff --git a/it/workbook.md b/it/workbook.md
@@ -757,6 +757,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Se riempi la proprietà `RefersTo` con un solo intervallo di colonne senza virgole, funzionerà solo come "Colonne da ripetere a sinistra". Ad esempio:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Foglio1!$A:$A",
+    Scope:    "Foglio1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Se riempi la proprietà `RefersTo` con un solo intervallo di righe senza virgole, funzionerà solo come "Righe da ripetere in alto". Ad esempio:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Foglio1!$1:$1",
+    Scope:    "Foglio1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Ottieni un nome definito {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- ドキュメントの更新：2024年8月5日
+- ドキュメントの更新：2024年8月24日
 
 ## プロジェクトミッション
 

diff --git a/ja/workbook.md b/ja/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+`RefersTo` プロパティにカンマなしで 1 つの列範囲のみを入力すると、「左側で繰り返す列」としてのみ機能します。例:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+`RefersTo` プロパティにコンマなしで 1 つの行範囲のみを入力すると、「上部で繰り返す行」としてのみ機能します。例:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## 名前を取得する {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- 문서 업데이트 시간: 2024 년 8 월 5 일
+- 문서 업데이트 시간: 2024 년 8 월 24 일
 
 ## 프로젝트 미션
 

diff --git a/ko/workbook.md b/ko/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+`RefersTo` 속성을 쉼표 없이 열 범위 하나만 채우면 "왼쪽에서 반복할 열" 로만 작동합니다. 예를 들어:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+`RefersTo` 속성을 쉼표 없이 행 범위 하나만 채우면 "위에서 반복할 행" 으로만 작동합니다. 예를 들어:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## 이름 가져 오기 {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Hora de atualização do documento: agosto 5, 2024
+- Hora de atualização do documento: agosto 24, 2024
 
 ## Missão do projeto
 

diff --git a/pt/workbook.md b/pt/workbook.md
@@ -757,6 +757,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Se preencher a propriedade `RefersTo` com apenas um intervalo de colunas sem vírgula, apenas funcionará como "Colunas para repetir à esquerda". Por exemplo:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Planilha1!$A:$A",
+    Scope:    "Planilha1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Se preencher a propriedade `RefersTo` com apenas um intervalo de linhas sem vírgula, apenas funcionará como "Linhas para repetir no topo". Por exemplo:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Planilha1!$1:$1",
+    Scope:    "Planilha1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Obter nome definido {#GetDefinedName}
 
 ```go

diff --git 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.8.1](https://github.com/xuri/excelize/releases/latest)
-- Время обновления документа: 5 Август 2024 г.
+- Время обновления документа: 24 Август 2024 г.
 
 ## Миссия проекта
 

diff --git a/ru/workbook.md b/ru/workbook.md
@@ -749,6 +749,30 @@ if err := f.SetDefinedName(&excelize.DefinedName{
 }
 ```
 
+Если вы заполните свойство `RefersTo` только одним диапазоном столбцов без запятой, оно будет работать только как "Столбцы для повторения слева". Например:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$A:$A",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
+Если вы заполните свойство `RefersTo` только одним диапазоном строк без запятой, оно будет работать только как "Строки для повторения сверху". Например:
+
+```go
+if err := f.SetDefinedName(&excelize.DefinedName{
+    Name:     "_xlnm.Print_Titles",
+    RefersTo: "Sheet1!$1:$1",
+    Scope:    "Sheet1",
+}); err != nil {
+    fmt.Println(err)
+}
+```
+
 ## Получить определенное имя {#GetDefinedName}
 
 ```go