Summary  
This chapter explains how to programmatically modify the visual attributes of table-like cells—adjusting their dimensions, borders, fill colors, text wrapping, merging, and alignment—to improve layout and readability.

General domain of usage  
Spreadsheet formatting

Formatar células no **Excel** é excelente para tornar suas planilhas não apenas mais fáceis de ler, mas também mais profissionais.

## Pontos principais

- Ajuste a **altura da linha** e a **largura da coluna** arrastando ou dando duplo clique nas bordas, ou através das opções **Altura da Linha**/**Largura da Coluna** no menu do botão direito;

- Adicionar bordas com **Bordas** na guia **Página Inicial** → grupo **Fonte**;

- Aplicar cor de fundo usando **Cor de Preenchimento** na guia **Página Inicial** → grupo **Fonte**;

- Utilizar **Quebra de Texto Automática** para exibir todo o conteúdo sem ampliar a coluna na guia **Página Inicial** → grupo **Alinhamento**;
- Combinar células e centralizar o conteúdo com **Mesclar e Centralizar** na guia **Página Inicial** → grupo **Alinhamento**;

- Definir **alinhamento vertical** e **horizontal** na guia **Página Inicial** → grupo **Alinhamento**.

Pasta de Trabalho Inicial

import unittest
import json
import os


def _dynamic_test(test_case, condition, success_message, failure_message):
    if condition:
        test_case._testMethodName = success_message
        test_case.assertTrue(True, success_message)
    else:
        test_case._testMethodName = failure_message
        test_case.fail(failure_message)


class TestUserCode(unittest.TestCase):
    @classmethod
    def setUpClass(cls):
        cls._no_data = True
        cls.sheet = {}
        cls.styles = {}

        if os.path.exists("payload.json"):
            try:
                with open("payload.json") as f:
                    content = f.read().strip()
                if content:
                    data = json.loads(content)
                    cls.sheet = next(iter(data["sheets"].values()))
                    cls.styles = data.get("styles", {})
                    cls._no_data = False
            except (json.JSONDecodeError, ValueError, StopIteration):
                pass

    # ------------------------------------------------------------------ #
    # Helpers
    # ------------------------------------------------------------------ #

    def _cell(self, row, col):
        """Return cell dict at 0-based row/col, or None."""
        row_data = self.sheet.get("cellData", {}).get(str(row), {})
        cell = row_data.get(str(col))
        if cell:
            return cell
        for key, c in row_data.items():
            if "-" in key:
                try:
                    s, e = map(int, key.split("-", 1))
                    if s <= col <= e:
                        return c
                except ValueError:
                    pass
        return None

    def _style(self, row, col):
        cell = self._cell(row, col)
        if not cell:
            return {}
        s = cell.get("s")
        if isinstance(s, str):
            return self.styles.get(s, {})
        return s if isinstance(s, dict) else {}

    def _has_all_borders(self, bd):
        """Accept both Univer short keys (t/b/l/r) and full keys (top/bottom/left/right)."""
        return (all(k in bd for k in ("t", "b", "l", "r")) or
                all(k in bd for k in ("top", "bottom", "left", "right")))

    # ------------------------------------------------------------------ #
    # Step 7 — Merge A1:D1
    # ------------------------------------------------------------------ #

    def test_merge_A1_D1(self):
        if self._no_data:
            _dynamic_test(self, True, "A1:D1 is merged.", ""); return
        merge_data = self.sheet.get("mergeData", [])
        via_merge = any(
            m.get("startRow") == 0 and m.get("startColumn") == 0 and m.get("endColumn", 0) >= 3
            for m in merge_data
        )
        cell = self._cell(0, 0)
        via_cell = cell is not None and cell.get("colSpan", 1) >= 4
        _dynamic_test(self, via_merge or via_cell,
            "A1:D1 is merged.",
            "A1:D1 is not merged. Select A1:D1 → Home → Alignment → Merge & Center.")

    # ------------------------------------------------------------------ #
    # Step 4 — All Borders on B10:H16
    # ------------------------------------------------------------------ #

    def test_borders_B10_H16(self):
        if self._no_data:
            _dynamic_test(self, True, "All Borders applied to B10:H16.", ""); return
        missing = []
        for ri in range(9, 16):
            for ci in range(1, 8):
                bd = self._style(ri, ci).get("bd", {})
                if not self._has_all_borders(bd):
                    missing.append(f"{chr(65+ci)}{ri+1}")
        _dynamic_test(self, len(missing) == 0,
            "All Borders applied to B10:H16.",
            f"Borders missing on B10:H16: {missing[:5]}{'...' if len(missing)>5 else ''}. "
            f"Select B10:H16 → Home → Font → Borders → All Borders.")

    # ------------------------------------------------------------------ #
    # Step 5 — All Borders on B18:H18
    # ------------------------------------------------------------------ #

    def test_borders_B18_H18(self):
        if self._no_data:
            _dynamic_test(self, True, "All Borders applied to B18:H18.", ""); return
        missing = []
        for ci in range(1, 8):
            bd = self._style(17, ci).get("bd", {})
            if not self._has_all_borders(bd):
                missing.append(f"{chr(65+ci)}18")
        _dynamic_test(self, len(missing) == 0,
            "All Borders applied to B18:H18.",
            f"Borders missing on B18:H18: {missing}. "
            f"Select B18:H18 → Home → Font → Borders → All Borders.")

    # ------------------------------------------------------------------ #
    # Step 6 — Fill color on A9:H9
    # ------------------------------------------------------------------ #

    def test_fill_A9_H9(self):
        if self._no_data:
            _dynamic_test(self, True, "Fill color applied to A9:H9.", ""); return
        missing = []
        for ci in range(8):
            bg = self._style(8, ci).get("bg")
            if not bg:
                missing.append(f"{chr(65+ci)}9")
        _dynamic_test(self, len(missing) == 0,
            "Fill color applied to A9:H9.",
            f"No fill on A9:H9: {missing}. Select A9:H9 → Home → Font → Fill Color.")

    # ------------------------------------------------------------------ #
    # Step 6 — Fill color on A17:H17
    # ------------------------------------------------------------------ #

    def test_fill_A17_H17(self):
        if self._no_data:
            _dynamic_test(self, True, "Fill color applied to A17:H17.", ""); return
        missing = []
        for ci in range(8):
            bg = self._style(16, ci).get("bg")
            if not bg:
                missing.append(f"{chr(65+ci)}17")
        _dynamic_test(self, len(missing) == 0,
            "Fill color applied to A17:H17.",
            f"No fill on A17:H17: {missing}. Select A17:H17 → Home → Font → Fill Color.")

    # ------------------------------------------------------------------ #
    # Step 6 — Fill color on A10:A16
    # ------------------------------------------------------------------ #

    def test_fill_A10_A16(self):
        if self._no_data:
            _dynamic_test(self, True, "Fill color applied to A10:A16.", ""); return
        missing = []
        for ri in range(9, 16):
            bg = self._style(ri, 0).get("bg")
            if not bg:
                missing.append(f"A{ri+1}")
        _dynamic_test(self, len(missing) == 0,
            "Fill color applied to A10:A16.",
            f"No fill on A10:A16: {missing}. Select A10:A16 → Home → Font → Fill Color.")


if __name__ == "__main__":
    unittest.main()


test_main.py

Mergulhe no universo do Excel com este curso em vídeo abrangente, projetado para conduzi-lo desde a navegação básica até o domínio de funções e análise de dados elementar. Iniciando com habilidades fundamentais como inserção de dados e formatação de células, você avançará rapidamente para o uso de ferramentas poderosas. Seja organizando grandes conjuntos de dados, realizando análises estatísticas ou criando gráficos dinâmicos, este curso oferece as competências práticas exigidas no ambiente orientado por dados atual.

Inicie sua jornada com o Excel compreendendo sua interface, funções básicas e técnicas essenciais de inserção de dados. Aprenda a navegar pelas barras de ferramentas, planilhas e domine os elementos fundamentais para estabelecer uma base sólida.

Aprofunde-se no Excel explorando opções avançadas de inserção e formatação de dados. Aprimore suas habilidades em formatação de texto e números, descubra como utilizar estilos de forma eficaz e melhore a legibilidade e funcionalidade das planilhas.

Desvende o poder do Excel com uma introdução às fórmulas e funções básicas. Adquira confiança na criação de cálculos, utilização de referências de células e aplicação de funções essenciais como SOMA, MÉDIA, MÍN e MÁX para automatizar e simplificar tarefas de análise de dados.

Nesta seção, você dominará fórmulas e funções avançadas do Excel, aprimorando sua capacidade de gerenciar cálculos complexos. Aprenda a exibir e auditar fórmulas, utilizar declarações aninhadas e lógicas, e aplicar condições de forma eficaz para otimizar suas tarefas de análise de dados.

Explore técnicas abrangentes para classificar, filtrar e gerenciar dados de forma eficiente. Esta seção abrange desde a organização básica de dados até filtragem avançada e gerenciamento de tabelas, garantindo a capacidade de manipular e analisar dados de maneira eficaz.

Mergulhe na arte da visualização de dados utilizando as ferramentas avançadas de gráficos do Excel. Aprenda a criar diferentes tipos de gráficos, personalizá-los para aprimorar o apelo visual e manipular dados dentro dos gráficos para apresentar histórias visuais claras e envolventes.

Adquira proficiência no gerenciamento de planilhas e pastas de trabalho no Excel. Esta seção ensina como organizar e manipular elementos da pasta de trabalho de forma eficaz, utilizar ferramentas de formatação e proteger seu trabalho com senhas, proporcionando uma base sólida em operações com pastas de trabalho.

Formatação de Células no Excel

Pontos principais

Atalhos de Teclado Essenciais