Форматирование
Ширина колонок и высота строк, объединение ячеек, темы и шрифты, условное форматирование. Операций на странице: 10.
Ширина колонок и высота строк, объединение ячеек, темы и шрифты, условное форматирование. Термины — в глоссарии.
Операции на этой странице — 10
apply_column_width
Заголовок раздела «apply_column_width»Применяет column width.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_column_width" |
да |
subsetId |
string | да |
sheetKey |
string | да |
| col | number | null | нет |
| width | number | null | нет |
| columns | ContractColumnWidth[] | нет |
defaultWidth |
number | null | нет |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_column_width
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_column_width" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
supportedSubset |
string | да |
| delta | DeltaSummary | да |
changedColumns |
number[] | да |
dirtyCellCount |
number | да |
currentSourceSaveReadiness |
ContractCurrentSourceSaveReadiness | null | нет |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
layoutMetrics |
ContractLayoutMetricsSubset | да |
Минимальный JSON-шаблон
{ "operation": "apply_column_width", "subsetId": "<subsetId>", "sheetKey": "<sheetPath>", "requestedBackend": "native-desktop"}apply_conditional_formatting_rules
Заголовок раздела «apply_conditional_formatting_rules»Применяет conditional formatting rules.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_conditional_formatting_rules" |
да |
subsetId |
string | да |
sheetKey |
string | да |
| rules | ContractConditionalRule[] | да |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_conditional_formatting_rules
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_conditional_formatting_rules" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
supportedSubset |
string | да |
| delta | DeltaSummary | да |
| rules | ContractConditionalRule[] | да |
preservedUnsupportedRuleBlockCount |
number | да |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
Минимальный JSON-шаблон
{ "operation": "apply_conditional_formatting_rules", "subsetId": "<subsetId>", "sheetKey": "<sheetPath>", "rules": [], "requestedBackend": "native-desktop"}apply_merge_cells
Заголовок раздела «apply_merge_cells»Применяет merge cells.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_merge_cells" |
да |
subsetId |
string | да |
sheetKey |
string | да |
| range | CellRange | да |
| merge | boolean | да |
| mode | ContractMergeCellsMode | null | нет |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_merge_cells
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_merge_cells" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
supportedSubset |
string | да |
| delta | DeltaSummary | да |
| merge | boolean | да |
| mode | ContractMergeCellsMode | да |
mergeRef |
string | null | нет |
mergeRefs |
string[] | да |
changedMerges |
string[] | да |
removedMerges |
string[] | да |
dirtyCellCount |
number | да |
currentSourceSaveReadiness |
ContractCurrentSourceSaveReadiness | null | нет |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
layoutMetrics |
ContractLayoutMetricsSubset | да |
Минимальный JSON-шаблон
{ "operation": "apply_merge_cells", "subsetId": "<subsetId>", "sheetKey": "<sheetPath>", "range": "<CellRange>", "merge": false, "requestedBackend": "native-desktop"}apply_row_height
Заголовок раздела «apply_row_height»Применяет row height.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_row_height" |
да |
subsetId |
string | да |
sheetKey |
string | да |
| row | number | null | нет |
| height | number | null | нет |
| rows | ContractRowHeight[] | нет |
defaultHeight |
number | null | нет |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_row_height
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_row_height" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
supportedSubset |
string | да |
| delta | DeltaSummary | да |
changedRows |
number[] | да |
dirtyCellCount |
number | да |
currentSourceSaveReadiness |
ContractCurrentSourceSaveReadiness | null | нет |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
layoutMetrics |
ContractLayoutMetricsSubset | да |
Минимальный JSON-шаблон
{ "operation": "apply_row_height", "subsetId": "<subsetId>", "sheetKey": "<sheetPath>", "requestedBackend": "native-desktop"}apply_theme_fonts_patch
Заголовок раздела «apply_theme_fonts_patch»Применяет theme fonts patch.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_theme_fonts_patch" |
да |
subsetId |
string | да |
| patch | ContractApplyThemeFontsPatch | да |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_theme_fonts_patch
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_theme_fonts_patch" |
да |
subsetId |
string | да |
| major | string | да |
| minor | string | да |
| applied | boolean | да |
Минимальный JSON-шаблон
{ "operation": "apply_theme_fonts_patch", "subsetId": "<subsetId>", "patch": "<ContractApplyThemeFontsPatch>", "requestedBackend": "native-desktop"}apply_workbook_theme
Заголовок раздела «apply_workbook_theme»Применяет workbook theme.
Запрос
| Поле | Тип TypeScript | Обяз. | Примечание из контракта |
|---|---|---|---|
| operation | "apply_workbook_theme" |
да | |
subsetId |
string | да | |
presetId |
string | да | Идентификатор темы из каталога тем — цвета вместе со шрифтами. Если задано colorsOnly, идентификатор берётся из каталога цветовых наборов, то есть из того же списка, что и «Разметка страницы → Цвета». |
colorsOnly |
boolean | нет | Применить только цветовой набор темы, не трогая шрифты. Без поля или при false тема применяется целиком — и цвета, и шрифты. |
customColors |
ContractWorkbookThemeColorScheme | null | нет | |
previewOnly |
boolean | нет | Разобрать книгу заново и показать результат в отдельном сеансе, ничего не изменяя. |
expectedRevision |
number | null | нет | Обязательно при сохранении; при просмотре без изменений не учитывается. |
readOnly |
boolean | нет | |
| protected | boolean | нет | |
| viewport | ViewportWindow | null | нет | |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_workbook_theme
| Поле | Тип TypeScript | Обяз. | Примечание из контракта |
|---|---|---|---|
| operation | "apply_workbook_theme" |
да | Ответ повторяет по составу основные поля open_workbook_subset и apply_cell_edits, поэтому оболочка перерисовывает книгу тем же способом, что и после обычной правки, — отдельной обработки не требуется. |
subsetId |
string | да | |
| session | ContractSubsetSessionInfo | да | |
appliedPresetId |
string | да | |
createdThemePart |
boolean | да | |
previewOnly |
boolean | нет | |
activeSheet |
ContractActiveSheetMeta | да | |
workbookSheets |
ContractWorkbookSheetMeta[] | да | |
| geometry | ContractGeometrySubset | да | |
recalcNeeded |
boolean | да | |
| viewport | ViewportWindow | да | |
previewCells |
ContractPreviewCell[] | да | |
layoutMetrics |
ContractLayoutMetricsSubset | нет | |
themeColorPalette |
string[] | нет | Палитра темы книги из двенадцати цветов — та же по составу и смыслу, что в open_workbook_subset, но уже после применения темы. По ней элементы, следующие за темой (например, стили таблиц), перекрашиваются сразу, без сохранения и повторного открытия. |
workbookHistory |
ContractWorkbookHistoryProjection | null | нет |
Минимальный JSON-шаблон
{ "operation": "apply_workbook_theme", "subsetId": "<subsetId>", "presetId": "<string>", "requestedBackend": "native-desktop"}manage_cell_styles
Заголовок раздела «manage_cell_styles»Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | “manage_cell_styles” | да |
subsetId |
string | да |
| action | ContractCellStylesManagerAction | да |
expectedRevision |
number | null | нет |
readOnly |
boolean | нет |
| protected | boolean | нет |
| viewport | ViewportWindow | null | нет |
Ответ при успехе · manage_cell_styles
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | “manage_cell_styles” | да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
| action | “inspect” | “commit” | “applyStyle” | “mergeFromWorkbook” | да |
| styles | ContractCellStyleDefinition[] | да |
| authority | ContractCellStylesManagerAuthority | да |
didChange |
boolean | да |
changedCellCount |
number | да |
workbookHistory |
ContractWorkbookHistoryProjection | да |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
Минимальный JSON-шаблон
{ "operation": "manage_cell_styles", "subsetId": "<subsetId>", "action": "<ContractCellStylesManagerAction>"}manage_conditional_formatting_rules
Заголовок раздела «manage_conditional_formatting_rules»Управляет conditional formatting rules.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "manage_conditional_formatting_rules" |
да |
subsetId |
string | да |
sheetKey |
string | да |
| action | ContractConditionalFormattingManagerAction | да |
expectedRevision |
number | null | нет |
readOnly |
boolean | нет |
| protected | boolean | нет |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · manage_conditional_formatting_rules
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "manage_conditional_formatting_rules" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
| action | "inspect" | “apply” |
да |
| rules | ContractConditionalRule[] | да |
opaqueRules |
ContractConditionalFormattingOpaqueRule[] | да |
| authority | ContractConditionalFormattingManagerAuthority | да |
didChange |
boolean | да |
workbookHistory |
ContractWorkbookHistoryProjection | да |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
Минимальный JSON-шаблон
{ "operation": "manage_conditional_formatting_rules", "subsetId": "<subsetId>", "sheetKey": "<sheetPath>", "action": "<ContractConditionalFormattingManagerAction>", "requestedBackend": "native-desktop"}manage_table_styles
Заголовок раздела «manage_table_styles»Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | “manage_table_styles” | да |
subsetId |
string | да |
| action | ContractTableStylesManagerAction | да |
expectedRevision |
number | null | нет |
readOnly |
boolean | нет |
| protected | boolean | нет |
| viewport | ViewportWindow | null | нет |
Ответ при успехе · manage_table_styles
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | “manage_table_styles” | да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
| action | “inspect” | “commit” | “applyStyle” | да |
| styles | ContractTableStyleDefinition[] | да |
| tables | ContractTableMetadataProjection | да |
| authority | ContractTableStylesManagerAuthority | да |
didChange |
boolean | да |
changedTableCount |
number | да |
workbookHistory |
ContractWorkbookHistoryProjection | да |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
Минимальный JSON-шаблон
{ "operation": "manage_table_styles", "subsetId": "<subsetId>", "action": "<ContractTableStylesManagerAction>"}paste_conditional_formatting_rules
Заголовок раздела «paste_conditional_formatting_rules»Вставляет conditional formatting rules.
Запрос
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "paste_conditional_formatting_rules" |
да |
subsetId |
string | да |
clipboardId |
string | да |
| target | CellRange | да |
| viewport | ViewportWindow | null | нет |
requestedBackend |
ComputeBackendKind | null | нет |
Ответ при успехе · apply_conditional_formatting_rules
| Поле | Тип TypeScript | Обяз. |
|---|---|---|
| operation | "apply_conditional_formatting_rules" |
да |
subsetId |
string | да |
| session | ContractSubsetSessionInfo | да |
supportedSubset |
string | да |
| delta | DeltaSummary | да |
| rules | ContractConditionalRule[] | да |
preservedUnsupportedRuleBlockCount |
number | да |
activeSheet |
ContractActiveSheetMeta | да |
| geometry | ContractGeometrySubset | да |
recalcNeeded |
boolean | да |
| viewport | ViewportWindow | да |
previewCells |
ContractPreviewCell[] | да |
Минимальный JSON-шаблон
{ "operation": "paste_conditional_formatting_rules", "subsetId": "<subsetId>", "clipboardId": "<string>", "target": "<CellRange>", "requestedBackend": "native-desktop"}