Go Excelize वर्कबुक

वर्कबुक

Options स्प्रेडशीट को पढ़ने और लिखने के लिए विकल्पों को परिभाषित करता है।

type Options struct {
    MaxCalcIterations uint
    Password          string
    RawCellValue      bool
    UnzipSizeLimit    int64
    UnzipXMLSizeLimit int64
    ShortDatePattern  string
    LongDatePattern   string
    LongTimePattern   string
    CultureInfo       CultureName
}

MaxCalcIterations का उपयोग सूत्रों को गणना करते समय अधिकतम अंकगणित की संख्या की निर्दिष्टि के लिए किया जाता है, इसकी डिफ़ॉल्ट मान 0 होता है।

Password का उपयोग वर्कबुक को साधारण टेक्स्ट में खोलने और सहेजने के लिए पासवर्ड निर्धारित करने के लिए किया जाता है, इसकी डिफ़ॉल्ट मान खाली होता है।

RawCellValue का उपयोग सेल मानों को पढ़ते समय क्रूड मान प्राप्त करने के लिए किया जाता है, इसकी डिफ़ॉल्ट मान false होता है (संख्या प्रारूप लागू होता है)।

UnzipSizeLimit का उपयोग करते समय करंट डिक्रिप्शन के लिए आकार सीमा (बाइट में) निर्धारित करने के लिए किया जाता है, जो कि UnzipXMLSizeLimit से अधिक या उसके बराबर होना चाहिए, इसका डिफ़ॉल्ट सीमा 16GB होता है।

UnzipXMLSizeLimit का उपयोग करते समय प्रत्येक वर्कशीट और साझा स्ट्रिंग टेबल के विक्षेपण के लिए मेमोरी सीमा (बाइट में) निर्धारित करने के लिए किया जाता है, और जब आकार इस मान से अधिक होता है, तो वर्कशीट XML फ़ाइल को सिस्टम टेम्पोररी निर्देशिका में विक्षेपित किया जाएगा। इस माने का सीमा UnzipSizeLimit के बराबर या उससे कम होना चाहिए, इसकी डिफ़ॉल्ट सीमा 16MB होती है।

ShortDatePattern का उपयोग छोटे तारीख संख्यात्मक प्रारूप को निर्धारित करने के लिए किया जाता है।

LongDatePattern का उपयोग लंबी तारीख संख्यात्मक प्रारूप को निर्धारित करने के लिए किया जाता है।

LongTimePattern का उपयोग लंबा समय संख्यात्मक प्रारूप को निर्धारित करने के लिए किया जाता है।

CultureInfo का उपयोग क्षेत्र-विशेष तिथि और समय सेटिंग्स से प्रभावित अंकगणना प्रारूपों को पढ़ते समय क्षेत्रीय प्रारूप को निर्धारित करने के लिए किया जाता है।

सृष्टि

func NewFile(opts ...Options) *File

NewFile का उपयोग एक नया एक्सेल वर्कबुक बनाने के लिए किया जाता है, जिसमें डिफ़ॉल्ट रूप से Sheet1 नाम का एक वर्कशीट होती है।

खोलें

func OpenFile(filename string, opts ...Options) (*File, error)

मौजूदा एक्सेल दस्तावेज़ खोलने के लिए OpenFile का उपयोग करें। उदाहरण के लिए, एक पासवर्ड संरक्षण के साथ एक स्प्रेडशीट दस्तावेज़ खोलें:

f, err := excelize.OpenFile("Book1.xlsx", excelize.Options{Password: "password"})
if err != nil {
    return
}

Close() का उपयोग खोली गई वर्कबुक को बंद करने के लिए करें।

डेटा स्ट्रीम खोलें

func OpenReader(r io.Reader, opts ...Options) (*File, error)

OpenReader io.Reader से डेटा पढ़ता है।

निम्नलिखित उदाहरण में, हम एक सरल HTTP सर्वर बनाते हैं जिसे अपलोड की गई स्प्रेडशीट दस्तावेज़ प्राप्त करने, प्राप्त दस्तावेज़ में एक नया वर्कशीट जोड़ने और एक डाउनलोड प्रतिक्रिया वापस करने के लिए उपयोग करते हैं:

package main

import (
    "fmt"
    "net/http"

    "github.com/xuri/excelize/v2"
)

func process(w http.ResponseWriter, req *http.Request) {
    file, _, err := req.FormFile("file")
    if err != nil {
        fmt.Fprint(w, err.Error())
        return
    }
    defer file.Close()
    f, err := excelize.OpenReader(file)
    if err != nil {
        fmt.Fprint(w, err.Error())
        return
    }
    f.Path = "Book1.xlsx"
    f.NewSheet("NewSheet")
    w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%s", f.Path))
    w.Header().Set("Content-Type", req.Header.Get("Content-Type"))
    if err := f.Write(w); err != nil {
        fmt.Fprint(w, err.Error())
    }
}

func main() {
    http.HandleFunc("/process", process)
    http.ListenAndServe(":8090", nil)
}

cURL का उपयोग करके टेस्ट करें:

curl --location --request GET 'http://127.0.0.1:8090/process' \
--form 'file=@/tmp/template.xltx' -O -J

सहेजें

func (f *File) Save(opts ...Options) error

संपादन को एक एक्सेल दस्तावेज़ में सहेजने के लिए Save का उपयोग करें।

के रूप में सहेजें

func (f *File) SaveAs(name string, opts ...Options) error

SaveAs का उपयोग करके एक्सेल दस्तावेज़ को निर्धारित फ़ाइल के रूप में सहेजें।

वर्कबुक बंद करें

func (f *File) Close() error

वर्कबुक को बंद करें और यदि आवश्यक हो तो किसी भी सिस्टम डिस्क कैश को साफ करें जो दस्तावेज़ खोलने के समय बनाया गया हो।

नई वर्कशीट

func (f *File) NewSheet(sheet string) (int, error)

दिए गए वर्कशीट नाम के आधार पर एक नई वर्कशीट बनाएं और वर्कबुक में वर्कशीट का सूचकांक लौटें। कृपया ध्यान दें कि जब एक नई वर्कबुक बनाई जाएगी, तो उसमें डिफ़ॉल्ट वर्कशीट Sheet1 नामकी वर्कशीट शामिल होगी।

वर्कशीट हटाएं

func (f *File) DeleteSheet(sheet string) error

दिए गए वर्कशीट नाम के आधार पर निर्दिष्ट वर्कशीट को हटाएं। इस विधि का सतर्कता से इस्तेमाल करें, क्योंकि यह हस्ताक्षर, संदर्भ, चार्ट और निर्दिष्ट वर्कशीट के साथ अन्य तत्वों को प्रभावित करेगा। यदि अन्य घटक हटाए गए वर्कशीट पर मूल्यों का संदर्भ हो, तो त्रुटि का सूचना दी जाएगी, और यह शायद वर्कबुक को खोलने में विफलता दे सकता है। यह विधि केवल तब मान्य है जब वर्कबुक में केवल एक वर्कशीट हो।

वर्कशीट कॉपी करें

func (f *File) CopySheet(from, to int) error

दिए गए स्रोत वर्कशीट और लक्ष्य वर्कशीट सूचकांक के आधार पर वर्कशीट की प्रतिलिपि बनाएं। डेवलपर को पुष्टि करनी चाहिए कि क्या लक्ष्य वर्कशीट सूचकांक पहले से ही मौजूद है। वर्तमान में उनका समर्थन केवल सूची और सूत्र वाली वर्कशीटों की कॉपी करने के लिए है, जबकि सूची, छवियां, चार्ट्स और पिवट तालिकाएं वाली वर्कशीटों की कॉपी का समर्थन नहीं किया जाता है।

// वर्कशीट का नाम Sheet1 पहले से ही मौजूद है...
index, err := f.NewSheet("Sheet2")
if err != nil {
    fmt.Println(err)
    return
}
err := f.CopySheet(1, index)

वर्कशीटों का समूह

func (f *File) GroupSheets(sheets []string) error

दिए गए वर्कशीटों के नामों के आधार पर वर्कशीटों का समूह बनाएं, और दिए गए वर्कशीटों में डिफ़ॉल्ट वर्कशीट शामिल होनी चाहिए।

ग्रुप वर्कशीट

func (f *File) UngroupSheets() error

वर्कशीटों को अनग्रुप करें।

वर्कशीट पृष्ठभूमि छवि सेट करें

func (f *File) SetSheetBackground(sheet, picture string) error

दिए गए वर्कशीट नाम और छवि फ़ाइल पथ के आधार पर निर्दिष्ट वर्कशीट के लिए टाइल की गई पृष्ठभूमि छवि सेट करें। समर्थित छवि फ़ाइल प्रारूपों में बीएमपी, ईएमएफ, ईएमज़े, जिफ, जेपीजी, जेपीजी, पीएनजी, एसवीजी, टिफ, टिफ़, डब्ल्यूएमएफ और डब्ल्यूएमज़ शामिल है।

func (f *File) SetSheetBackgroundFromBytes(sheet, extension string, picture []byte) error

दिए गए वर्कशीट नाम, छवि प्रारूप एक्सटेंशन और छवि प्रारूप डेटा के आधार पर निर्दिष्ट वर्कशीट के लिए टाइल की गई पृष्ठभूमि छवि सेट करें। समर्थित छवि फ़ाइल प्रारूपों में बीएमपी, ईएमएफ, ईएमज़े, जिफ, जेपीजी, जेपीजी, पीएनजी, एसवीजी, टिफ, टिफ़, डब्ल्यूएमएफ और डब्ल्यूएमज़ शामिल है।

डिफ़ॉल्ट वर्कशीट सेट करें

func (f *File) SetActiveSheet(index int)

निर्दिष्ट सूचकांक मान के आधार पर डिफ़ॉल्ट वर्कशीट सेट करें, जहां मान 0 से अधिक और वर्कबुक में वर्कशीटों की कुल संख्या से कम होना चाहिए।

डिफ़ॉल्ट वर्कशीट सूचकांक प्राप्त करें

func (f *File) GetActiveSheetIndex() int

डिफ़ॉल्ट वर्कशीट का सूचकांक प्राप्त करें, यदि कोई डिफ़ॉल्ट वर्कशीट नहीं मिली तो 0 लौटें।

वर्कशीट दृश्यता सेट करें

func (f *File) SetSheetVisible(sheet string, visible bool, veryHidden ...bool) error

दिए गए वर्कशीट नाम और दृश्यवता पैरामीटर के आधार पर वर्कशीट की दृश्यता सेट करें। एक वर्कबुक में कम से कम एक दिखाई देने वाली वर्कशीट होनी चाहिए। यदि दिए गए वर्कशीट डिफ़ॉल्ट वर्कशीट है, तो दृश्यता सेटिंग अवैध होगी। तीसरा वैकल्पिक पैरामीटर veryHidden केवल तब मान्य होगा जब visible पैरामीटर का मान false हो।

उदाहरण के लिए, वर्कशीट को छुपाने के लिए:

err := f.SetSheetVisible("Sheet1", false)

वर्कशीट दृश्यता प्राप्त करें

func (f *File) GetSheetVisible(sheet string) (bool, error)

दिए गए वर्कशीट नाम के आधार पर वर्कशीट की दृश्यता सेटिंग प्राप्त करें। उदाहरण के लिए, वर्कशीट की दृश्यता सेटिंग को पुनःप्राप्त करने के लिए:

visible, err := f.GetSheetVisible("Sheet1")

शीट संपत्तियाँ सेट करें

func (f *File) SetSheetProps(sheet string, opts *SheetPropsOptions) error

दिए गए वर्कशीट नाम और संपत्ति विकल्पों के आधार पर एक विशिष्ट वर्कशीट की संपत्तियों को सेट करें। समर्थित वर्कशीट संपत्ति विकल्प निम्नलिखित हैं:

संपत्ति	प्रकार	विवरण
CodeName	*string	कोड नाम
EnableFormatConditionsCalculation	*bool	स्वचालित रूप से शर्त निर्धारित करने की विकल्प का निर्धारण करें, डिफ़ॉल्ट मान true है
प्रकाशित	*bool	निर्धारित करें कि क्या वर्कशीट प्रकाशित है, डिफ़ॉल्ट मान true है
AutoPageBreaks	*bool	निर्धारित करें कि क्या वर्कशीट स्वचालित रूप से पृष्ठ टुकड़े करती है, डिफ़ॉल्ट मान true है
FitToPage	*bool	निर्धारित करें कि क्या पृष्ठ को मुमकिन होने पर मुनासिब बनाए रखने के लिए सक्षम करें, डिफ़ॉल्ट मान false है
TabColorIndexed	*int	पिछले योग्य सूचीबद्ध रंग मान के लिए उपयोग किया जाता है
TabColorRGB	*string	मानक ARGB रंग मान
TabColorTheme	*int	0 से प्रारंभ होने वाला थीम रंग सूचक
TabColorTint	*float64	रंग पर लागू टिंट मान, डिफ़ॉल्ट मान 0.0 है
OutlineSummaryBelow	*bool	संक्षिप्तीकरण की दिशा निर्धारित करें, क्या विवरण डेटा के नीचे है, डिफ़ॉल्ट मान true है
OutlineSummaryRight	*bool	संक्षिप्तीकरण की दिशा निर्धारित करें, क्या विवरण डेटा के दाएं है, डिफ़ॉल्ट मान true है
BaseColWidth	*uint8	अक्षरों की संख्या में प्रस्तुत बुनियादी कॉलम चौड़ाई, डिफ़ॉल्ट मान 8 है
DefaultColWidth	*float64	मानक कॉलम चौड़ाई जिसमें सीमाएँ और ग्रिडलाइन्स शामिल हैं
DefaultRowHeight	*float64	पॉइंट में प्रस्तुत पंक्ति ऊंचाई
CustomHeight	*bool	निर्धारित करें कि क्या कस्टम पंक्ति ऊंचाई लागू है, डिफ़ॉल्ट मान false है
ZeroHeight	*bool	निर्धारित करें कि क्या पंक्तियाँ डिफ़ॉल्ट रूप से छिपी होती हैं, डिफ़ॉल्ट मान false है
ThickTop	*bool	निर्धारित करें कि क्या पंक्तियों के पास डिफ़ॉल्ट रूप से मोटी ऊपरी सीमा है, डिफ़ॉल्ट मान false है
ThickBottom	*bool	निर्धारित करें कि क्या पंक्तियों के पास डिफ़ॉल्ट रूप से मोटी निचली सीमा है, डिफ़ॉल्ट मान false है

उदाहरण के लिए, वर्कशीट नाम Sheet1 वाली डिफ़ॉल्ट पंक्ति को छिपा देने के लिए:

f, enable := excelize.NewFile(), true
if err := f.SetSheetProps("Sheet1", &excelize.SheetPropsOptions{
    ZeroHeight: &enable,
}); err != nil {
    fmt.Println(err)
}
if err := f.SetRowVisible("Sheet1", 10, true); err != nil {
    fmt.Println(err)
}
f.SaveAs("Book1.xlsx")

शीट की संपत्तियाँ प्राप्त करें

func (f *File) GetSheetProps(sheet string) (SheetPropsOptions, error)

दिए गए वर्कशीट नाम के आधार पर एक विशिष्ट वर्कशीट की संपत्तियों को प्राप्त करें।

शीट दृश्य गुण सेट करें

func (f *File) SetSheetView(sheet string, viewIndex int, opts *ViewOptions) error

दी गई शीट नाम, दृश्य सूची संख्या, और दृश्य विकल्पों के आधार पर शीट दृश्य गुण सेट करें। viewIndex एक नकारात्मक संख्या हो सकती है, जिसमें गणना प्रतिध्वनियां (-1 अंतिम दृश्य को दर्शाता है) की जाएगी। शीट दृश्य गुणों को सेट करने के लिए समर्थित विकल्प निम्नलिखित हैं:

गुण	प्रकार	विवरण
DefaultGridColor	*bool	पूर्वनिर्धारित ग्रिड रेखा रंग का प्रयोग करना है या नहीं, डिफ़ॉल्ट मान true है
करना है	*bool	दिखाने के लिए निर्देशित करता है कि दाएं से बाएं दिखाए जाएँ या नहीं, डिफ़ॉल्ट मान false है
सूची सूची	*bool	वर्कशीट में सूत्र दिखाने का निर्धारण करता है, डिफ़ॉल्ट मान false है
ShowGridLines	*bool	वर्कशीट ग्रिड रेखाएँ दिखाने का निर्धारण करता है, डिफ़ॉल्ट मान true है
ShowRowColHeaders	*bool	वर्कशीट में पंक्ति और स्तंभ शीर्षक दिखाने का निर्धारण करता है, डिफ़ॉल्ट मान true है
ShowRuler	*bool	पेज लेआउट दृश्य में रुलर दिखाने का निर्धारण करता है, डिफ़ॉल्ट मान true है
ShowZeros	*bool	कोशिकाओं में शून्य मान दिखाने या न दिखाने का निर्धारण करता है, डिफ़ॉल्ट मान true है, अन्यथा यह रिक्त दिखाएगा
TopLeftCell	*string	प्रस्तुत दृश्य शीर्ष-बायाँ कोण की निर्धारण करता है
View	*string	किसमत वर्कशीट दृश्य का प्रकार दर्शाता है, जिसमें संख्यात्मक मान normal, pageBreakPreview, और pageLayout होते हैं
ZoomScale	*float64	वर्तमान दृश्य प्रदर्शन विंडो ज़ूम स्केल प्रतिशत, सीमित सीमा 10 से 400 तक, डिफ़ॉल्ट मान 100 है

शीट दृश्य गुण प्राप्त करें

func (f *File) GetSheetView(sheet string, viewIndex int) (ViewOptions, error)

दी गई शीट नाम और दृश्य सूची संख्या के आधार पर शीट दृश्य गुण प्राप्त करें। viewIndex एक नकारात्मक संख्या हो सकती है, जिसमें गणना प्रतिध्वनियां (-1 अंतिम दृश्य को दर्शाता है) की जाएगी।

वर्कशीट पृष्ठ खाका सेट करें

func (f *File) SetPageLayout(sheet string, opts *PageLayoutOptions) error

दी गई वर्कशीट नाम और पृष्ठ खाका पैरामीटर के आधार पर वर्कशीट के पृष्ठ खाका गुण सेट करें। वर्तमान में समर्थित पृष्ठ खाका गुणों में शामिल हैं:

Size गुण, पृष्ठ कागज का आकार निर्धारित करने के लिए प्रयोग किया जाता है, जहां डिफ़ॉल्ट पृष्ठ खाका आकार "लेटर 8½ × 11 इंच" है। निम्नलिखित तालिका में पृष्ठ खाका आकारों और इंडेक्स Size पैरामीटर के बीच संबंध दिखाता है:

इंडेक्स	कागज का आकार
1	लेटर 8½ × 11 इंच
2	लेटर छोटा 8½ × 11 इंच
3	टैबलॉइड 11 × 17 इंच
4	लेजर 17 × 11 इंच
...	...
40	जर्मन मानक पंक्चर 8.5 × 12 इंच

| 41 | जर्मन कानूनी कागज पंक्चर 8.5 × 13 इंच |
| 42 | ISO B4 250 × 353 मिमी |
| 43 | जापानी पोस्टकार्ड 100 × 148 मिमी |
| 44 | स्टैंडर्ड कागज 9 × 11 इंच |
| 45 | स्टैंडर्ड कागज 10 × 11 इंच |
| 46 | स्टैंडर्ड कागज 15 × 11 इंच |
| 47 | आमंत्रण पत्र 220 × 220 मिमी |
| 50 | लेटरहेड में वृद्धि 9.275 × 12 इंच |
| 51 | अत्यधिक बड़ा कानूनी कागज 9.275 × 15 इंच |
| 52 | टैबलॉइड अतिरिक्त कागज 11.69 × 18 इंच |
| 53 | A4 अत्यधिक बड़ा 236 × 322 मिमी |
| 54 | लेटरहेड परिदृश्य 8.275 × 11 इंच |
| 55 | A4 परिदृश्य 210 × 297 मिमी |
| 56 | लेटरहेड अत्यधिक बड़ा परिदृश्य 9.275 × 12 इंच |
| 57 | सुपरए/सुपरए/A4 कागज 227 × 356 मिमी |
| 58 | सुपरबी/सुपरबी/A3 कागज 305 × 487 मिमी |
| 59 | लेटरहेड वृद्धि 8.5 × 12.69 इंच |
| 60 | A4 वृद्धि 210 × 330 मिमी |
| 61 | A5 परिदृश्य 148 × 210 मिमी |
| 62 | JIS B5 परिदृश्य 182 × 257 मिमी |
| 63 | A3 अत्यधिक बड़ा 322 × 445 मिमी |
| 64 | A5 अत्यधिक बड़ा 174 × 235 मिमी |
| 65 | ISO B5 अत्यधिक बड़ा 201 × 276 मिमी |
| 66 | A2 420 × 594 मिमी |
| 67 | A3 परिदृश्य 297 × 420 मिमी |
| 68 | A3 अत्यधिक बड़ा परिदृश्य 322 × 445 मिमी |
| 69 | डबल जापानी पोस्टकार्ड 200 × 148 मिमी |
| 70 | A6 105 × 148 मिमी |
| 71 | जापानी लिफाफा काकू #2 |
| 72 | जापानी लिफाफा काकू #3 |
| 73 | जापानी लिफाफा चो #3 |
| 74 | जापानी लिफाफा चो #4 |
| 75 | लेटरहेड परिदृश्य 11 × 8½ इंच |
| 76 | A3 परिदृश्य 420 × 297 मिमी |
| 77 | A4 परिदृश्य 297 × 210 मिमी |
| 78 | A5 परिदृश्य 210 × 148 मिमी |
| 79 | B4 (JIS) परिदृश्य 364 × 257 मिमी |
| 80 | B5 (JIS) परिदृश्य 257 × 182 मिमी |
| 81 | जापानी पोस्टकार्ड परिदृश्य 148 × 100 मिमी |
| 82 | डबल जापानी पोस्टकार्ड परिदृश्य 148 × 200 मिमी |
| 83 | A6 परिदृश्य 148 × 105 मिमी |
| 84 | जापानी लिफाफा काकू #2 परिदृश्य |
| 85 | जापानी लिफाफा काकू #3 परिदृश्य |
| 86 | जापानी लिफाफा चो #3 परिदृश्य |

| 87 | जापानी लिफ़ाफ़ा चो #4 लैंडस्केप |
| 88 | B6 (JIS) 128 × 182 मिमी |
| 89 | B6 (JIS) लैंडस्केप 182 × 128 मिमी |
| 90 | 12 × 11 इंच |
| 91 | जापानी लिफ़ाफ़ा यू #4 |
| 92 | जापानी लिफ़ाफ़ा यू #4 लैंडस्केप |
| 93 | चीनी 16K 146 × 215 मिमी |
| 94 | चीनी 32K 97 × 151 मिमी |
| 95 | चीनी Large 32K 97 × 151 मिमी |
| 96 | चीनी लिफ़ाफ़ा #1 102 × 165 मिमी |
| 97 | चीनी लिफ़ाफ़ा #2 102 × 176 मिमी |
| 98 | चीनी लिफ़ाफ़ा #3 125 × 176 मिमी |
| 99 | चीनी लिफ़ाफ़ा #4 110 × 208 मिमी |
| 100 | चीनी लिफ़ाफ़ा #5 110 × 220 मिमी |
| 101 | चीनी लिफ़ाफ़ा #6 120 × 230 मिमी |
| 102 | चीनी लिफ़ाफ़ा #7 160 × 230 मिमी |
| 103 | चीनी लिफ़ाफ़ा #8 120 × 309 मिमी |
| 104 | चीनी लिफ़ाफ़ा #9 229 × 324 मिमी |
| 105 | चीनी लिफ़ाफ़ा #10 324 × 458 मिमी |
| 106 | चीनी 16K लैंडस्केप |
| 107 | चीनी 32K लैंडस्केप |
| 108 | चीनी Large 32K लैंडस्केप |
| 109 | चीनी लिफ़ाफ़ा #1 लैंडस्केप 165 × 102 मिमी |
| 110 | चीनी लिफ़ाफ़ा #2 लैंडस्केप 176 × 102 मिमी |
| 111 | चीनी लिफ़ाफ़ा #3 लैंडस्केप 176 × 125 मिमी |
| 112 | चीनी लिफ़ाफ़ा #4 लैंडस्केप 208 × 110 मिमी |
| 113 | चीनी लिफ़ाफ़ा #5 लैंडस्केप 220 × 110 मिमी |
| 114 | चीनी लिफ़ाफ़ा #6 लैंडस्केप 230 × 120 मिमी |
| 115 | चीनी लिफ़ाफ़ा #7 लैंडस्केप 230 × 160 मिमी |
| 116 | चीनी लिफ़ाफ़ा #8 लैंडस्केप 309 × 120 मिमी |
| 117 | चीनी लिफ़ाफ़ा #9 लैंडस्केप 324 × 229 मिमी |
| 118 | चीनी लिफ़ाफ़ा #10 लैंडस्केप 458 × 324 मिमी |

`Orientation` प्रॉपर्टी का उपयोग पृष्ठ खाका दिशा को निर्धारित करने के लिए किया जाता है, जिसकी डिफ़ॉल्ट पृष्ठ खाका दिशा "पोर्ट्रेट" होती है, और वैकल्पिक मान होते हैं `पोर्ट्रेट` और `लैंडस्केप`।

`FirstPageNumber` प्रॉपर्टी का उपयोग प्रारंभिक पृष्ठ संख्या को निर्धारित करने के लिए किया जाता है, जिसकी डिफ़ॉल्ट स्वचालित होती है।

`AdjustTo` प्रॉपर्टी का उपयोग पृष्ठ स्केलिंग अनुपात को निर्धारित करने के लिए किया जाता है, जिसमें 10 से 400 तक का सीमा होता है, अर्थात 10% से 400% तक स्केलिंग, और सामान्य आकार के लिए डिफ़ॉल्ट मान `100` होता है। `FitToHeight` या `FitToWidth` को इस प्रॉपर्टी को अवरुद्ध कर देगा।

`FitToHeight` प्रॉपर्टी का उपयोग पृष्ठ स्केलिंग को समायोजित करने के लिए पृष्ठ चौड़ाई को निर्धारित करने के लिए किया जाता है, जिसका डिफ़ॉल्ट मान `1` होता है।

`FitToWidth` प्रॉपर्टी का उपयोग पृष्ठ स्केलिंग को समायोजित करने के लिए पृष्ठ ऊँचाई को निर्धारित करने के लिए किया जाता है, जिसका डिफ़ॉल्ट मान `1` होता है।

`BlackAndWhite` प्रॉपर्टी का उपयोग मोनोक्रोम प्रिंटिंग को निर्धारित करने के लिए किया जाता है, जिसकी डिफ़ॉल्ट मोड ऑफ़ होती है।

f := excelize.NewFile()
var (
    size                 = 10
    orientation          = "परिदृश्य"
    firstPageNumber uint = 2
    adjustTo        uint = 100
    fitToHeight          = 2
    fitToWidth           = 2
    blackAndWhite        = true
)
if err := f.SetPageLayout("Sheet1", &excelize.PageLayoutOptions{
    Size:            &size,
    Orientation:     &orientation,
    FirstPageNumber: &firstPageNumber,
    AdjustTo:        &adjustTo,
    FitToHeight:     &fitToHeight,
    FitToWidth:      &fitToWidth,
    BlackAndWhite:   &blackAndWhite,
}); err != nil {
    fmt.Println(err)
}

पृष्ठप्रस्थ लेआउट प्राप्त करें

func (f *File) GetPageLayout(sheet string) (PageLayoutOptions, error)

दिए गए वर्कशीट नाम और पृष्ठ लेआउट पैरामीटर के आधार पर वर्कशीट की पृष्ठ लेआउट गुणवत्ताएँ प्राप्त करें।

पृष्ठप्रस्थ मार्जिन सेट करें

func (f *File) SetPageMargins(sheet string, opts *PageLayoutMarginsOptions) error

दिए गए वर्कशीट नाम और मार्जिन पैरामीटर के आधार पर वर्कशीट के पृष्ठ मार्जिन सेट करें। समर्थित मार्जिन विकल्प हैं:

विकल्प	प्रकार	विवरण
नीचे	*float64	नीचे की मार्जिन
फ़ुटर	*float64	फ़ुटर मार्जिन
हैडर	*float64	हेडर मार्जिन
बायाँ	*float64	बायाँ मार्जिन
दायाँ	*float64	दायाँ मार्जिन
ऊपर	*float64	ऊपर मार्जिन
समरूपता	*bool	पृष्ठ केंद्रीयात्मकता के लिए
अनुप्राणीय	*bool	पृष्ठ केंद्रीयता के लिए

पृष्ठप्रस्थ मार्जिन प्राप्त करें

func (f *File) GetPageMargins(sheet string) (PageLayoutMarginsOptions, error)

दिए गए वर्कशीट नाम और मार्जिन पैरामीटर के आधार पर वर्कशीट की पृष्ठ मार्जिन प्राप्त करें।

वर्कबुक गुणवत्ताएँ सेट करें

func (f *File) SetWorkbookProps(opts *WorkbookPropsOptions) error

SetWorkbookProps का उपयोग वर्कबुक की गुणवत्ताएँ सेट करने के लिए किया जाता है। समर्थित वर्कबुक गुणवत्ताएँ हैं:

संपत्ति	प्रकार	विवरण
दिनांक1904	*bool	संकेत करता है कि क्या वर्कबुक 1904 तिथि प्रणाली का उपयोग करता है
फ़िल्टर गोपनीयता	*bool	फ़िल्टर गोपनीयता, संकेत करता है कि क्या अनुप्रयोग वर्कबुक में व्यक्तिगत जानकारी की जांच करता है
कोड नाम	*string	कोड नाम

वर्कबुक गुणवत्ताएँ प्राप्त करें

func (f *File) GetWorkbookProps() (WorkbookPropsOptions, error)

GetWorkbookProps का उपयोग वर्कबुक की गुणवत्ताएँ प्राप्त करने के लिए किया जाता है।

हैडर और फ़ुटर सेट करें

func (f *File) SetHeaderFooter(sheet string, opts *HeaderFooterOptions) error

दिए गए वर्कशीट नाम और नियंत्रण वर्णों के आधार पर वर्कशीट का हैडर और फ़ुटर सेट करें।

हैडर और फ़ुटर में निम्नलिखित फील्ड शामिल हैं:

फील्ड	विवरण
AlignWithMargins	हैडर और फ़ुटर को पृष्ठ के मार्जिन के साथ संरेखित करें
DifferentFirst	पहले पृष्ठ के लिए हैडर और फ़ुटर सेट करें
DifferentOddEven	विषम और सम पृष्ठों के लिए हैडर और फ़ुटर सेट करें
ScaleWithDoc	हैडर और फ़ुटर को दस्तावेज़ के साथ स्केल करें
OddFooter	विषम पृष्ठों के लिए फ़ुटर के लिए नियंत्रण वर्ण, 'DifferentOddEven' के मान 'false' होने पर पहले पृष्ठ के लिए फ़ुटर सेट करने के लिए उपयोग किया जाता है
OddHeader	विषम पृष्ठों के लिए हेडर के नियंत्रण वर्ण, 'DifferentOddEven' के मान 'false' होने पर पहले पृष्ठ के लिए हेडर सेट करने के लिए उपयोग किया जाता है
EvenFooter	सम पृष्ठों के लिए फ़ुटर के लिए नियंत्रण वर्ण
EvenHeader	सम पृष्ठों के लिए हेडर के नियंत्रण वर्ण
FirstFooter	पहले पृष्ठ फ़ुटर के नियंत्रण वर्ण
FirstHeader	पहले पृष्ठ हेडर के नियंत्रण वर्ण

दी गई तालिका में प्रारूप कोड निम्नलिखित 6 स्ट्रिंग प्रकार के फ़ील्डों के लिए उपयोग किया जा सकता है: OddHeader, OddFooter, EvenHeader, EvenFooter, FirstFooter, FirstHeader

प्रारूप कोड	विवरण
&&	वर्ण "&"
&font-size	पाठ फ़ॉन्ट आकार, जहां फ़ॉन्ट आकार दशमलव फ़ॉन्ट आकार पॉइंट्स में है
&"font name,font type"	पाठ फ़ॉन्ट नाम स्ट्रिंग, फ़ॉन्ट नाम, और पाठ फ़ॉन्ट प्रकार स्ट्रिंग, फ़ॉन्ट प्रकार
&"-,Regular"	सामान्य पाठ प्रारूप। मोटाई और इटैलिक मोड को बंद करें
&A	वर्तमान वर्कशीट नाम
&B या &"-,Bold"	बोल्ड पाठ प्रारूप, बंद या चालू, डिफ़ॉल्ट बंद
&D	वर्तमान तारीख
&C	केंद्रीय खण्ड
&E	पाठ के लिए डबल अंडरलाइन
&F	वर्तमान वर्कबुक फ़ाइल नाम
&G	ऑब्जेक्ट को पृष्ठभूमि के रूप में निर्दिष्ट करें (वर्तमान में समर्थित नहीं है)
&H	पाठ छाया
&I या &"-,Italic"	इटैलिक पाठ
&K	रेग्यूलर एलान के स्वरूप में फ़ॉन्ट रंग फ़ॉर्मेट। थीम रंगों को TTSNNN के रूप में निर्दिष्ट किया जाता है, जहां TT थीम रंग id है, S "+", "-" का अर्थ है रंग का तथा छाया की मान का है
&L	बाएं खण्ड
&N	पृष्ठों की कुल संख्या
&O	आउटलाइन पाठ प्रारूप
&P[[+\|-]n]	अगर कोई वैकल्पिक सम्पूरक नहीं है, वर्तमान पृष्ठ संख्या (दशमलव)
&R	दाएँ खण्ड
&S	पाठ के लिए स्ट्राइकस्थ्रू
&T	वर्तमान समय
&U	पाठ पर एकल अंडरलाइन जोड़ें। डिफ़ॉल्ट मोड बंद है
&X	सुपरस्क्रिप्ट स्वरूप
&Y	सबस्क्रिप्ट स्वरूप
&Z	वर्तमान वर्कबुक फ़ाइल पथ

उदाहरण के लिए:

err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
    DifferentFirst:   true,
    DifferentOddEven: true,
    OddHeader:        "&R&P",
    OddFooter:        "&C&F",
    EvenHeader:       "&L&P",
    EvenFooter:       "&L&D&R&T",
    FirstHeader:      `&CCenter &"-,Bold"Bold&"-,Regular"HeaderU+000A&D`,
})

ऊपर दिए गए उदाहरण में निम्नलिखित प्रारूप शामिल हैं:

• पहले पृष्ठ का अपना हेडर और फ़ुटर होता है
• विषम और सम पृष्ठों के लिए अलग हेडर और फ़ुटर हैं
• विषम पृष्ठ के दाएँ भाग में वर्तमान पृष्ठ संख्या होती है
• विषम पृष्ठ के केंद्रीय खण्ड में वर्तमान वर्कबुक फ़ाइल का नाम होता है
• सम पृष्ठ के बाएँ भाग में वर्तमान पृष्ठ संख्या होती है, और सम पृष्ठ के दाएँ भाग में वर्तमान समय होता है
• पहले पृष्ठ की केंद्रीय खण्ड में पहली पंक्ति पर "केंद्र बोल्ड हेडर" और दूसरी पंक्ति पर तारीख होती है
• पहले पृष्ठ पर कोई फ़ुटर नहीं होता है

नाम सेट करें

func (f *File) SetDefinedName(definedName *DefinedName) error

दिए गए नाम के आधार पर नाम और संदर्भ सीमा को सेट करें, डिफ़ॉल्ट स्कोप की वर्कबुक होती है। उदाहरण के लिए:

err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "मात्रा",
    RefersTo: "Sheet1!$A$2:$D$5",
    Comment:  "निर्धारित नाम टिप्पणी",
    Scope:    "Sheet2",
})

वर्कशीट के प्रिंट क्षेत्र और प्रिंट शीर्षक सेट करना:

if err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "_xlnm.Print_Area",
    RefersTo: "Sheet1!$A$1:$Z$100",
    Scope:    "Sheet1",
}); err != nil {
    fmt.Println(err)
}
if err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "_xlnm.Print_Titles",
    RefersTo: "Sheet1!$A:$A,Sheet1!$1:$1",
    Scope:    "Sheet1",
}); err != nil {
    fmt.Println(err)
}

नाम प्राप्त करें

func (f *File) GetDefinedName() []DefinedName

स्कोप के भीतर वर्कबुक और वर्कशीट के नामों की सूची प्राप्त करें।

नाम हटाएं

func (f *File) DeleteDefinedName(definedName *DefinedName) error

दिए गए नाम और नाम स्कोप के आधार पर नाम हटाएं, डिफ़ॉल्ट स्कोप की वर्कबुक होती है। उदाहरण के लिए:

err := f.DeleteDefinedName(&excelize.DefinedName{
    Name:     "मात्रा",
    Scope:    "Sheet2",
})

वर्कबुक एप्लिकेशन गुण निर्धारित करें

func (f *File) SetAppProps(appProperties *AppProperties) error

वर्कबुक के एप्लिकेशन गुणों को सेट करें। जिन गुणों को सेट किया जा सकता है, वे समाविष्ट करते हैं:

गुण	विवरण
एप्लिकेशन	इस दस्तावेज़ को बनाने वाले एप्लिकेशन का नाम
स्केलक्रॉप	दस्तावेज़ के थंबनेल का प्रदर्शन का निर्देश करता है। true थंबनेल को स्केल करें, और false थंबनेल को क्रॉप करें
डॉकसिक्यूरिटी	संख्यात्मक मूल्य के रूप में प्रस्तुत दस्तावेज़ सुरक्षा स्तर
कंपनी	दस्तावेज़ से जुड़ी कंपनी का नाम
लिंक्सअपटूडेट	दस्तावेज़ में हाइपरलिंक्स के अप-टू-डेट होने को सेट करता है। true अपडेटेड हाइपरलिंक्स के लिए, और false पुराने हाइपरलिंक्स के लिए
हाइपरलिंक्सचेंज्ड	नए हाइपरलिंक्स के निर्दिष्ट होने को अगली बार जब इस दस्तावेज़ को खोला जाए, हाइपरलिंक संबंधों को अपडेट करने का निर्देश करता है
एप्लिकेशनवर्शन	दस्तावेज़ को जनरेट करने वाले एप्लिकेशन का संस्करण। मान्य मान XX.YYYY फॉर्मेट में होना चाहिए, जहां X और Y संख्यात्मक मान होते हैं, अन्यथा फ़ाइल मानक के अनुरूप नहीं होगी

उदाहरण के लिए:

err := f.SetAppProps(&excelize.AppProperties{
    Application:       "Microsoft Excel",
    ScaleCrop:         true,
    DocSecurity:       3,
    Company:           "Company Name",
    LinksUpToDate:     true,
    HyperlinksChanged: true,
    AppVersion:        "16.0000",
})

वर्कबुक एप्लिकेशन गुण प्राप्त करें

func (f *File) GetAppProps() (*AppProperties, error)

वर्कबुक के एप्लिकेशन गुण प्राप्त करें।

दस्तावेज़ गुण सेट करें

func (f *File) SetDocProps(docProperties *DocProperties) error

वर्कबुक के मूल गुणों को सेट करें। सेट किए जा सकने वाले गुणों में शामिल हैं:

गुण	विवरण
श्रेणी	दस्तावेज़ सामग्री की श्रेणी
सामग्री स्थिति	दस्तावेज़ सामग्री की स्थिति। उदाहरण के रूप में, मान "ड्राफ्ट", "समीक्षित", और "अंतिम" हो सकते हैं
बनाया गया	दस्तावेज़ का समय जब बनाया गया था, आईएसओ 8601 हेतु कोयी समय में प्रस्तुत किया गया, जैसे 2019-06-04T22:00:10Z
रचनाकर्ता	दस्तावेज़ का निर्माता
विवरण	संसाधन सामग्री का विवरण
पहचानकर्ता	दिए गए संदर्भ में संसाधन के लिए स्पष्ट संदर्भ
कीवर्ड	दस्तावेज़ की कीवर्ड
भाषा	दस्तावेज़ की प्राथमिक भाषा
अंतिम संशोधन करने वाला	वह प्रयोगकर्ता जो दस्तावेज़ को आखिरी बार संशोधित करता है
संशोधित	दस्तावेज़ का समय जब संशोधित किया गया था, आईएसओ 8601 हेतु प्रस्तुत किया गया, उदाहरण के रूप में 2019-06-04T22:00:10Z
संस्करण	दस्तावेज़ का संशोधन संस्करण
विषय	दस्तावेज़ का विषय
शीर्षक	दस्तावेज़ का शीर्षक
संस्करण	वह संस्करण संख्या, जो प्रयोगकर्ता या अनुप्रयोग द्वारा सेट किया गया हो

उदाहरण के तोर पर:

err := f.SetDocProps(&excelize.DocProperties{
    Category:       "श्रेणी",
    ContentStatus:  "ड्राफ्ट",
    Created:        "2019-06-04T22:00:10Z",
    Creator:        "Go Excelize",
    Description:    "यह फ़ाइल Go Excelize द्वारा बनाई गई है",
    Identifier:     "xlsx",
    Keywords:       "स्प्रेडशीट",
    LastModifiedBy: "Go Author",
    Modified:       "2019-06-04T22:00:10Z",
    Revision:       "0",
    Subject:        "परीक्षण विषय",
    Title:          "परीक्षण शीर्षक",
    Language:       "en-US",
    Version:        "1.0.0",
})

दस्तावेज़ गुण प्राप्त करें

func (f *File) GetDocProps() (*DocProperties, error)

वर्कबुक के मूल गुण प्राप्त करें।

वर्कबुक की संरक्षितता

func (f *File) ProtectWorkbook(opts *WorkbookProtectionOptions) error

दस्तावेज़ की संरचना को एक पासवर्ड के साथ संरक्षित करें ताकि अन्य प्रयोक्ता गुप्त वर्गीकृत वर्कशीट देखना, छुपे हुए वर्कशीट जोड़ना, या छिपाना, वर्कशीट का नाम बदलना अथवा मूव करना से रोका जा सके। AlgorithmName फील्ड खासकर हैश एल्गोरिदम XOR, MD4, MD5, SHA-1, SHA-256, SHA-384, या SHA-512 की निर्धारिति समर्थन करता है। यदि कोई हैश एल्गोरिदम निर्धारित नहीं किया गया है, तो डिफ़ॉल्ट रूप में XOR एल्गोरिदम का प्रयोग किया जाता है। उदाहरण के लिए, दस्तावेज़ की संरचना को निम्नलिखित पासवर्ड के साथ संरक्षित करें:

err := f.ProtectWorkbook(&excelize.WorkbookProtectionOptions{
    Password:      "पासवर्ड",
    LockStructure: true,
})

WorkbookProtectionOptions वर्कबुक की संरक्षितता के लिए विकल्पों को निर्धारित करता है।

type WorkbookProtectionOptions struct {
    AlgorithmName string
    Password      string
    LockStructure bool
    LockWindows   bool
}

वर्कबुक की संरक्षण हटाएँ

func (f *File) UnprotectWorkbook(password ...string) error

वर्कबुक की संरक्षण हटाएँ, वर्कबुक की संरक्षण की पुष्टि और हटाने के विकल्पन पासवर्ड पैरामीटर को निर्दिष्ट करना।