Worksheet класс

Worksheet класс

Инкапсулирует объект, представляющий один рабочий лист.

Тип Worksheet предоставляет следующие элементы:

Характеристики

СвойствоОписание
protectionПредставляет различные типы защиты, доступные для рабочего листа. Поддерживает расширенные параметры защиты в ExcelXP и более поздних версиях.
unique_idПолучает и задает уникальный идентификатор, он такой же, как {15DB5C3C-A5A1-48AF-8F25-3D86AC232D4F}.
workbookПолучает объект рабочей книги, содержащий этот лист.
cellsПолучает коллекцию Worksheet.cells.
query_tablesПолучает QueryTableCollection на рабочем листе.
typeПредставляет тип рабочего листа.
nameПолучает или задает имя рабочего листа.
show_formulasУказывает, следует ли показывать формулы или их результаты.
is_gridlines_visibleВозвращает или задает значение, указывающее, видны ли линии сетки. Значение по умолчанию — true.
is_row_column_headers_visibleВозвращает или задает значение, указывающее, будут ли на листе отображаться заголовки строк и столбцов.
Значение по умолчанию — true.
pane_stateУказывает, имеет ли панель горизонтальные или вертикальные разделения, а также зафиксированы ли эти разделения.
display_zerosTrue, если отображаются нулевые значения.
display_right_to_leftУказывает, отображается ли указанный рабочий лист справа налево, а не слева направо.
Значение по умолчанию — false.
is_outline_shownУказывает, следует ли показывать контур.
is_selectedУказывает, выбран ли этот рабочий лист при открытии рабочей книги.
pivot_tablesПолучает все сводные таблицы на этом листе.
list_objectsПолучает все объекты ListObjects на этом листе.
tab_idУказывает внутренний идентификатор листа.
horizontal_page_breaksПолучает коллекцию HorizontalPageBreakCollection.
vertical_page_breaksПолучает коллекцию VerticalPageBreakCollection.
hyperlinksПолучает коллекцию HyperlinkCollection.
page_setupПредставляет описание настроек страницы на этом листе.
auto_filterПредставляет автоматический фильтр для указанного рабочего листа.
has_autofilterУказывает, имеет ли этот рабочий лист автоматический фильтр.
transition_evaluationУказывает, включена ли опция оценки формулы перехода (совместимость с Lotus).
transition_entryУказывает, включена ли опция «Ввод формулы перехода» (совместимость с Lotus).
visibility_typeУказывает видимое состояние этого листа.
is_visibleПоказывает, виден ли рабочий лист.
sparkline_groupsПолучает группы спарклайнов на рабочем листе.
chartsПолучает коллекцию Chart
commentsПолучает коллекцию Comment.
picturesПолучает коллекцию Picture.
text_boxesПолучает коллекцию TextBox.
check_boxesПолучает коллекцию CheckBox.
ole_objectsПредставляет собой коллекцию OleObject на рабочем листе.
shapesВозвращает все фигуры чертежей на этом листе.
slicersПолучить коллекцию слайсеров на рабочем листе
timelinesПолучить коллекцию временной шкалы на рабочем листе
indexПолучает индекс листа в коллекции рабочих листов.
is_protectedУказывает, защищен ли рабочий лист.
validationsПолучает коллекцию настроек проверки данных на рабочем листе.
allow_edit_rangesПолучает коллекцию разрешенных диапазонов редактирования на рабочем листе.
error_check_optionsПрименяет настройку проверки ошибок к определенным диапазонам.
outlineПолучает схему этого рабочего листа.
first_visible_rowПредставляет индекс первой видимой строки.
first_visible_columnПредставляет первый видимый индекс столбца.
zoomКоэффициент масштабирования в процентах. Должен быть в диапазоне от 10 до 400.
view_typeПолучает и задает тип представления.
is_page_break_previewУказывает, отображается ли указанный рабочий лист в обычном режиме или в режиме предварительного просмотра разрыва страницы.
is_ruler_visibleУказывает, видна ли линейка. Это свойство применяется только для предварительного просмотра разрыва страницы.
tab_colorПредставляет цвет вкладки рабочего листа.
gridline_colorПолучает и задает цвет линии сетки
code_nameПолучает кодовое имя рабочего листа.
background_imageПолучает и задает фоновое изображение рабочего листа.
conditional_formattingsПолучает условные форматы на рабочем листе.
active_cellВозвращает или задает активную ячейку на листе.
custom_propertiesПолучает объект, представляющий
идентификационная информация, связанная с рабочим листом.
smart_tag_settingПолучает все SmartTagCollection объекты рабочего листа.
scenariosПолучает коллекцию Scenario.
cell_watchesПолучает коллекцию ячеек на этом листе, отслеживаемых в «окне наблюдения».

Методы

МетодОписание
freeze_panes(self, row, column, freezed_rows, freezed_columns)Закрепляет области в указанной ячейке рабочего листа.
freeze_panes(self, cell_name, freezed_rows, freezed_columns)Закрепляет области в указанной ячейке рабочего листа.
copy(self, source_sheet)Копирует содержимое и форматы из другого рабочего листа.
copy(self, source_sheet, copy_options)Копирует содержимое и форматы из другого рабочего листа.
auto_fit_column(self, column_index, first_row, last_row)Автоматически подбирает ширину столбца.
auto_fit_column(self, column_index)Автоматически подбирает ширину столбца.
auto_fit_columns(self)Автоматически подбирает размер всех столбцов на этом листе.
auto_fit_columns(self, options)Автоматически подбирает размер всех столбцов на этом листе.
auto_fit_columns(self, first_column, last_column)Автоматически подбирает ширину столбцов.
auto_fit_columns(self, first_column, last_column, options)Автоматически подбирает ширину столбцов.
auto_fit_columns(self, first_row, first_column, last_row, last_column)Автоматически подбирает ширину столбцов.
auto_fit_columns(self, first_row, first_column, last_row, last_column, options)Автоматически подбирает ширину столбцов.
auto_fit_row(self, row_index, first_column, last_column)Автоматически подбирает высоту строки.
auto_fit_row(self, row_index, first_column, last_column, options)Автоматически подбирает высоту строки.
auto_fit_row(self, start_row, end_row, start_column, end_column)Автоматически подбирает высоту строки в прямоугольном диапазоне.
auto_fit_row(self, row_index)Автоматически подбирает высоту строки.
auto_fit_rows(self)Автоматически подбирает размер всех строк на этом листе.
auto_fit_rows(self, only_auto)Автоматически подбирает размер всех строк на этом листе.
auto_fit_rows(self, options)Автоматически подбирает размер всех строк на этом листе.
auto_fit_rows(self, start_row, end_row)Автоматически подбирает высоту строки в заданном диапазоне.
auto_fit_rows(self, start_row, end_row, options)Автоматически подбирает высоту строки в заданном диапазоне.
protect(self, type)Защищает рабочий лист.
protect(self, type, password, old_password)Защищает рабочий лист.
unprotect(self)Снимает защиту с листа.
unprotect(self, password)Снимает защиту с листа.
calculate_formula(self, formula)Вычисляет формулу.
calculate_formula(self, formula, opts)Вычисляет выражение формулы напрямую.
calculate_formula(self, formula, p_opts, c_opts, base_cell_row, base_cell_column, calculation_data)Вычисляет выражение формулы напрямую.
calculate_formula(self, options, recursive)Вычисляет все формулы на этом листе.
calculate_array_formula(self, formula, opts)Вычисляет формулу как формулу массива.
calculate_array_formula(self, formula, opts, max_row_count, max_column_count)Вычисляет формулу как формулу массива.
calculate_array_formula(self, formula, p_opts, c_opts, base_cell_row, base_cell_column, max_row_count, max_column_count, calculation_data)Вычисляет формулу как формулу массива.
refresh_pivot_tables(self)Обновляет все сводные таблицы на этом листе.
refresh_pivot_tables(self, option)Обновляет все сводные таблицы на этом листе.
get_panes(self)Получает оконные стекла.
get_freezed_panes(self, row, column, freezed_rows, freezed_columns)Получает замороженные области.
split(self)Разделяет окно.
un_freeze_panes(self)Отменяет закрепление областей на листе.
remove_split(self)Удаляет разделенное окно.
add_page_breaks(self, cell_name)Добавляет разрыв страницы.
get_advanced_filter(self)Получает настройки расширенного фильтра.
advanced_filter(self, is_filter, list_range, criteria_range, copy_to, unique_record_only)Фильтрует данные, используя сложные критерии.
remove_auto_filter(self)Удаляет автоматический фильтр рабочего листа.
set_visible(self, is_visible, ignore_error)Устанавливает видимые параметры.
select_range(self, start_row, start_column, total_rows, total_columns, remove_others)Выбирает диапазон.
remove(self)Удалить текущий лист (CELLSPYTHONNET-192,Пользователь запрашивает добавление этого API)
remove_all_drawing_objects(self)Удаляет все объекты чертежей на этом листе.
clear_comments(self)Удаляет все комментарии в таблице дизайнера.
move_to(self, index)Перемещает лист в другое место электронной таблицы.
replace(self, old_string, new_string)Заменяет текст всех ячеек новой строкой.
get_selected_ranges(self)Получает выбранные диапазоны ячеек в таблице конструктора.
get_selected_areas(self)Получает выбранные диапазоны ячеек в таблице конструктора.
get_printing_page_breaks(self, options)Обеспечивает автоматические разрывы страниц.
start_access_cache(self, opts)Запускает сеанс, который использует кэши для доступа к данным на этом листе.
close_access_cache(self, opts)Закрывает сеанс, который использует кэши для доступа к данным на этом листе.
convert_formula_reference_style(self, formula, to_r1c1, base_cell_row, base_cell_column)Преобразует стиль ссылки формулы.
xml_map_query(self, path, xml_map)Запрос областей ячеек, сопоставленных/связанных с определенным путем карты XML.

Пример

В следующем примере показано, как закрепить области и вставить гиперссылку на лист с помощью .Net или VB.

from aspose.cells import Workbook

workbook = Workbook()
sheet = workbook.worksheets[0]
# Freeze panes at "AS40" with 10 rows and 10 columns
sheet.freeze_panes("AS40", 10, 10)
# Add a hyperlink in Cell A1
sheet.hyperlinks.add("A1", 1, 1, "http://www.aspose.com")

Смотрите также