Рабочий лист

Установить видимость столбца

func (f *File) SetColVisible(sheet, col string, visible bool) error

SetColVisible предоставляет функцию для установки видимости одного столбца с помощью имени рабочего листа и имени столбца. Эта функция может быть использована для безопасности параллелизма. Например, скройте столбец D в Лист1:

err := f.SetColVisible("Лист1", "D", false)

Скрыть столбцы от D до F (включить):

err := f.SetColVisible("Лист1", "D:F", false)

Установить ширину столбца

func (f *File) SetColWidth(sheet, startCol, endCol string, width float64) error

SetColWidth предоставляет функцию для установки ширины одного столбца или нескольких столбцов. Эта функция может быть использована для безопасности параллелизма. Например:

f := excelize.NewFile()
err := f.SetColWidth("Лист1", "A", "H", 20)

Установить высоту строки

func (f *File) SetRowHeight(sheet string, row int, height float64) error

SetRowHeight предоставляет функцию для установки высоты одной строки. Если значение высоты равно 0, указанная строка будет скрыта, если значение высоты равно -1, пользовательская высота строки будет отключена. Например, установите высоту первой строки в Лист1:

err := f.SetRowHeight("Лист1", 1, 50)

Установить видимость линии

func (f *File) SetRowVisible(sheet string, row int, visible bool) error

SetRowVisible предоставляет функцию для отображения видимости одной строки с помощью заданного имени листа и индекса строки. Например, скройте строку 2 в Лист1:

err := f.SetRowVisible("Лист1", 2, false)

Получить имя листа

func (f *File) GetSheetName(index int) string

GetSheetName предоставляет функцию для получения имени рабочего листа XLSX с помощью указанного индекса рабочего листа. Если заданный индекс листа недействителен, он вернет пустую строку.

Получить видимость столбца

func (f *File) GetColVisible(sheet, column string) (bool, error)

GetColVisible предоставляет функцию, чтобы получить видимость одного столбца с помощью имени рабочего листа и имени столбца. Эта функция может быть использована для безопасности параллелизма. Например, получите видимое состояние столбца D в Лист1:

visible, err := f.GetColVisible("Лист1", "D")

Получить ширину столбц

func (f *File) GetColWidth(sheet, col string) (float64, error)

GetColWidth предоставляет функцию для получения ширины столбца с помощью имени рабочего листа и индекса столбца. Эта функция может быть использована для безопасности параллелизма.

Получить высоту строки

func (f *File) GetRowHeight(sheet string, row int) (float64, error)

GetRowHeight предоставляет функцию для получения высоты строки с помощью заданного имени листа и индекса строки. Например, получить высоту первой строки в Лист1:

height, err := f.GetRowHeight("Лист1", 1)

Получить видимость строки

func (f *File) GetRowVisible(sheet string, row int) (bool, error)

GetRowVisible предоставляет функцию, чтобы получить видимость одной строки, указав имя листа и индекс строки. Например, получить видимое состояние строки 2 в Лист1:

visible, err := f.GetRowVisible("Лист1", 2)

Получить индекс рабочего листа

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

GetSheetIndex предоставляет функцию для получения индекса листа рабочей книги по заданному имени листа. Если данное имя листа недопустимо, оно вернет целочисленное значение типа -1.

Полученный индекс может использоваться как параметр для вызова функции SetActiveSheet() при настройке рабочего листа по умолчанию для рабочей книги.

Получить список рабочих листов

func (f *File) GetSheetMap() map[int]string

GetSheetMap предоставляет функцию для получения рабочих листов, листов диаграмм, идентификаторов диалоговых листов и карты имен рабочей книги. Например:

f, err := excelize.OpenFile("Book1.xlsx")
if err != nil {
    return
}
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
for index, name := range f.GetSheetMap() {
    fmt.Println(index, name)
}

Получить список листов

func (f *File) GetSheetList() []string

GetSheetList предоставляет функцию для получения рабочих листов, листов диаграмм и списка имен диалоговых листов рабочей книги.

Задать имя листа

func (f *File) SetSheetName(source, target string) error

SetSheetName предоставляет функцию для установки имени листа по заданным именам старого и нового листа. В заголовке листа допускается не более 31 символа, и эта функция изменяет только имя листа и не обновляет имя листа в формуле или ссылке, связанной с ячейкой. Таким образом, может быть ошибка формулы проблемы или отсутствует ссылка.

Вставка столбцов

func (f *File) InsertCols(sheet, col string, n int) error

InsertCols предоставляет функцию вставки новых столбцов перед заданным именем столбца и количеством столбцов. Например, создайте два столбца перед столбцом C в Лист1:

err := f.InsertCols("Лист1", "C", 2)

Вставка строк

func (f *File) InsertRows(sheet string, row, n int) error

InsertRows предоставляет функцию вставки новых строк после заданного номера строки Excel, начиная с 1 и количества строк. Например, создайте две строки перед строкой 3 в Лист1:

err := f.InsertRows("Лист1", 3, 2)

Добавить дубликат строки

func (f *File) DuplicateRow(sheet string, row int) error

DuplicateRow вставляет копию указанной строки ниже указанной, например:

err := f.DuplicateRow("Лист1", 2)

Используйте этот метод с осторожностью, что повлияет на изменения в ссылках, таких как формулы, диаграммы и т. Д. Если на листе есть какое-либо ссылочное значение, это приведет к ошибке файла при его открытии. Excelize лишь частично обновляет эти ссылки в настоящее время.

Дублирующая строка

func (f *File) DuplicateRowTo(sheet string, row, row2 int) error

DuplicateRowTo вставляет копию указанной строки в указанную позицию строки, перемещаясь вниз на существующие строки после целевой позиции, например:

err := f.DuplicateRowTo("Лист1", 2, 7)

Создать схему строки

func (f *File) SetRowOutlineLevel(sheet string, row int, level uint8) error

SetRowOutlineLevel предоставляет функцию для установки уровня уровня строки в одной строке с помощью заданного имени листа и индекса строки. Например, контур 2 строки в Sheet1 до уровня 1:

err := f.SetRowOutlineLevel("Sheet1", 2, 1)

Создать контур столбца

func (f *File) SetColOutlineLevel(sheet, col string, level uint8) error

SetColOutlineLevel предоставляет функцию для установки уровня контуров одного столбца с помощью имени рабочего листа и имени столбца. Например, установите уровень контуров столбца D в Sheet1 равным 2:

err := f.SetColOutlineLevel("Sheet1", "D", 2)

Получить контур линии

func (f *File) GetRowOutlineLevel(sheet string, row int) (uint8, error)

GetRowOutlineLevel предоставляет функцию, позволяющую получить общий уровень уровня одной строки с помощью заданного имени листа и индекса строки. Например, получите количество строк строки 2 в Лист1:

err := f.GetRowOutlineLevel("Лист1", 2)

Получить контур колонны

func (f *File) GetColOutlineLevel(sheet, col string) (uint8, error)

GetColOutlineLevel предоставляет функцию для получения уровня контуров одного столбца с указанием имени рабочего листа и имени столбца. Например, получите уровень контуров столбца D в Лист1:

level, err := f.GetColOutlineLevel("Лист1", "D")

Итератор столбца

func (f *File) Cols(sheet string) (*Cols, error)

Cols возвращает итератор столбцов, используемый для потоковой передачи данных чтения для листа с большими данными. Эта функция может быть использована для безопасности параллелизма. Например:

cols, err := f.Cols("Лист1")
if err != nil {
    fmt.Println(err)
    return
}
for cols.Next() {
    col, err := cols.Rows()
    if err != nil {
        fmt.Println(err)
    }
    for _, rowCell := range col {
        fmt.Print(rowCell, "\t")
    }
    fmt.Println()
}

Итератор столбцов - столбцы

func (cols *Cols) Rows(opts ...Options) ([]string, error)

Rows возвращает значения строк текущего столбца.

Итератор столбца - обход

func (cols *Cols) Next() bool

Next вернет true, если найден следующий столбец.

Итератор столбца - обработка ошибок

func (cols *Cols) Error() error

Error вернет error при возникновении ошибки.

Ряд итератора

func (f *File) Rows(sheet string) (*Rows, error)

Rows возвращает итератор строк, используемый для потоковой передачи данных чтения для листа с большими данными. Эта функция может быть использована для безопасности параллелизма. Например:

rows, err := f.Rows("Лист1")
if err != nil {
    fmt.Println(err)
    return
}
for rows.Next() {
    row, err := rows.Columns()
    if err != nil {
        fmt.Println(err)
    }
    for _, colCell := range row {
        fmt.Print(colCell, "\t")
    }
    fmt.Println()
}
if err = rows.Close(); err != nil {
    fmt.Println(err)
}

Итератор строк - Столбцы

func (rows *Rows) Columns(opts ...Options) ([]string, error)

Columns возвращает значения столбца текущей строки. Это извлекает данные рабочего листа в виде потока, возвращает каждую ячейку в строке как есть и не пропускает пустые строки в хвосте рабочего листа.

Итератор строк - перемещение

func (rows *Rows) Next() bool

Next вернется true, если найдет следующий элемент строки.

Итератор строк - обработка ошибок

func (rows *Rows) Error() error

Error вернет error при возникновении ошибки.

Итератор строк - Получение параметров строки

func (rows *Rows) GetRowOpts() RowOpts

GetRowOpts вернет RowOpts текущей строки.

Итератор строк - Закрывать

func (rows *Rows) Close() error

Close закрывает открытый XML-файл рабочего листа во временном каталоге системы.

Поиск на листе

func (f *File) SearchSheet(sheet, value string, reg ...bool) ([]string, error)

SearchSheet предоставляет функцию для получения координат с помощью заданного имени листа и значения ячейки. Эта функция поддерживает только точное соответствие строк и чисел, не поддерживает вычисляемый результат, отформатированные числа и условный поиск в настоящее время. Если это объединенная ячейка, она вернет координаты верхнего левого угла объединенной области.

Например, найдите координаты значения 100 на Лист1:

result, err := f.SearchSheet("Лист1", "100")

Например, найдите координаты значения в диапазоне 0-9 на листе с именем Лист1:

result, err := f.SearchSheet("Лист1", "[0-9]", true)

Защитить лист

func (f *File) ProtectSheet(sheet string, opts *SheetProtectionOptions) error

ProtectSheet предоставляет функцию для предотвращения случайного или преднамеренного изменения, перемещения или удаления данных на листе другими пользователями. Необязательное поле AlgorithmName указывает хеш-алгоритм, поддерживает XOR, MD4, MD5, SHA-1, SHA-256, SHA-384 и SHA-512. В настоящее время, если хэш-алгоритм не указан, будет использоваться алгоритм XOR по умолчанию. Например, защитите Sheet1 с помощью параметров защиты:

err := f.ProtectSheet("Sheet1", &excelize.SheetProtectionOptions{
    AlgorithmName:       "SHA-512",
    Password:            "password",
    SelectLockedCells:   true,
    SelectUnlockedCells: true,
    EditScenarios:       true,
})

SheetProtectionOptions напрямую отображает параметры защиты листа.

type SheetProtectionOptions struct {
    AlgorithmName       string
    AutoFilter          bool
    DeleteColumns       bool
    DeleteRows          bool
    EditObjects         bool
    EditScenarios       bool
    FormatCells         bool
    FormatColumns       bool
    FormatRows          bool
    InsertColumns       bool
    InsertHyperlinks    bool
    InsertRows          bool
    Password            string
    PivotTables         bool
    SelectLockedCells   bool
    SelectUnlockedCells bool
    Sort                bool
}

Снять защиту листа

func (f *File) UnprotectSheet(sheet string, password ...string) error

UnprotectSheet предоставляет функцию для снятия защиты листа, указанного вторым необязательным параметром пароля для снятия защиты листа с проверкой пароля.

Удалить столбец

func (f *File) RemoveCol(sheet, col string) error

RemoveCol предоставляет функцию удаления одного столбца по заданному имени рабочего листа и индексу столбца Например, удалите столбец C в Лист1:

err := f.RemoveCol("Лист1", "C")

Используйте этот метод с осторожностью, что повлияет на изменения в ссылках, таких как формулы, диаграммы и т. Если на листе есть какое-либо ссылочное значение, это приведет к ошибке файла при его открытии. The excelize только частично обновляет эти ссылки в настоящее время.

Удалить строку

func (f *File) RemoveRow(sheet string, row int) error

RemoveRow предоставляет функцию для удаления одной строки по заданному имени рабочего листа и номеру строки Excel. Например, удалите строку 3 в Лист1:

err := f.RemoveRow("Лист1", 3)

Установка значений столбцов

func (f *File) SetSheetCol(sheet, cell string, slice interface{}) error

SetSheetCol записывает массив в столбец по заданному имени листа, начальной координате и указателю на тип массива slice. Например, записывает массив в столбец B, начинающийся с ячейки B6 на листе Лист1:

err := f.SetSheetCol("Лист1", "B6", &[]interface{}{"1", nil, 2})

Установить значения строки

func (f *File) SetSheetRow(sheet, cell string, slice interface{}) error

SetSheetRow записывает массив в строку по заданному имени рабочего листа, начальной координате и указателю на тип массива slice. Эта функция может быть использована для безопасности параллелизма. Например, запись массива в строку 6 начинается с ячейки B6 на Лист1:

err := f.SetSheetRow("Лист1", "B6", &[]interface{}{"1", nil, 2})

Вставить разрыв страницы

func (f *File) InsertPageBreak(sheet, cell string) error

InsertPageBreak создает разрыв страницы, чтобы определить, где заканчивается напечатанная страница и где начинается следующая страница с заданным именем и осью листа, поэтому содержимое до разрыва страницы будет напечатано на одной странице, а после разрыва страницы - на другой.

Удалить разрыв страницы

func (f *File) RemovePageBreak(sheet, cell string) error

RemovePageBreak удаляет разрыв страницы по заданному имени листа и оси.

Установить размер рабочего листа

func (f *File) SetSheetDimension(sheet string, rangeRef string) error

SetSheetDimension предоставляет метод для установки или удаления используемого диапазона рабочего листа с помощью заданной ссылки на диапазон. Он указывает границы строк и столбцов используемых ячеек на листе. Ссылка на диапазон задается с использованием стиля ссылки A1 (например, A1:D5). Передача ссылки на пустой диапазон удалит используемый диапазон рабочего листа.

Получить измерение рабочего листа

func (f *File) GetSheetDimension(sheet string) (string, error)

GetSheetDimension предоставляет метод для получения используемого диапазона рабочего листа.