Categoria: Apostilas

  • Apostila acessível de COBOL revisada: códigos corrigidos e nova versão para DOSVOX

    Tempo de leitura: 8 minutos

    Olá, amigos e leitores dessa coisa aqui!!!

    Tudo bem?

    Espero que sim…

    Em agosto deste ano, publiquei aqui no blog a apostila COBOL do básico ao avançado, um material gratuito que preparei especialmente para pessoas cegas e usuários de leitores de tela.

    Na primeira publicação, COBOL do básico ao avançado: uma apostila acessível para quem programa com leitores de tela, apresentei a proposta, a organização dos capítulos, as ferramentas utilizadas e as duas versões do material.

    Algumas horas depois, publiquei também COBOL além da apostila: vídeos, exercícios e até um mainframe para continuar estudando, reunindo cursos, exercícios, vídeos, códigos-fonte e oportunidades de experimentar ambientes de mainframe.

    Pois bem! A apostila continuou existindo, o COBOL continuou resistindo ao tempo e eu continuei encontrando coisas para mexer, assim como fiz com a apostila Programando para o Dosvox, aaa…

    Dessa vez, entretanto, não se trata simplesmente de acrescentar conteúdo. Foi feita uma revisão técnica dos exemplos de programação e também refeita e corrigida a versão em texto linear, destinada principalmente aos usuários do DOSVOX.

    A revisão técnica foi concluída em 19 de outubro de 2026, e agora quero explicar o que mudou e por que vale a pena baixar novamente o material.


    Nesta publicação


    Uma revisão que foi além da aparência

    Uma apostila de programação tem uma responsabilidade que vai além de explicar conceitos: os exemplos precisam estar corretos.

    Não adianta escrever páginas e páginas sobre uma linguagem e apresentar um código que não compila, produz um resultado incorreto ou possui uma condição capaz de deixar o programa executando indefinidamente.

    Imagine alguém que está aprendendo COBOL pela primeira vez. A pessoa copia o exemplo, segue as instruções, executa o compilador e recebe uma mensagem de erro.

    Naturalmente, a primeira reação pode ser pensar que digitou alguma coisa errada. Só que nem sempre o problema está em quem estuda. Às vezes, o erro está no próprio material didático.

    Por isso, essa revisão concentrou-se principalmente no comportamento dos programas, nas validações, na precisão dos cálculos e na maneira como cada exemplo é apresentado e explicado.

    A ideia foi manter a proposta original da apostila, mas tornar os exemplos mais confiáveis e as explicações mais precisas.

    Voltar ao índice


    Correções nos códigos COBOL

    Durante a revisão, foram encontrados alguns problemas que mereciam atenção. Alguns eram relativamente simples; outros poderiam produzir resultados errados sem que o estudante percebesse imediatamente.

    Validação de entradas numéricas

    Uma das correções envolveu a maneira como determinados exemplos recebiam e validavam números digitados pelo usuário.

    Em COBOL, é importante distinguir um campo de texto de um campo numérico. Uma entrada recebida por ACCEPT não deve ser considerada válida apenas porque o usuário deveria ter digitado um número.

    Também existem detalhes relacionados aos espaços de preenchimento, sinais e conversões.

    Na revisão, foram ajustadas situações em que entradas inadequadas poderiam passar por determinadas verificações. Um exemplo envolvia valores como -5 e 105, que podiam acabar sendo interpretados incorretamente como 5.

    As explicações também passaram a enfatizar a diferença entre verificar se uma entrada contém números e verificar se esses números fazem sentido para a regra do programa.

    Afinal, um campo pode conter somente dígitos e, mesmo assim, representar uma idade impossível ou um valor fora dos limites permitidos.

    Correções em cálculos e campos numéricos

    Outro ponto importante foi o tratamento de valores monetários e saldos.

    Encontrei uma situação em que o tamanho de um campo poderia provocar perda de dígitos durante determinadas operações.

    Esse tipo de problema merece atenção especial numa linguagem utilizada frequentemente em sistemas financeiros e comerciais.

    Em COBOL, declarar um campo com PIC 9(5)V99, por exemplo, não significa que ele possa receber qualquer resultado numérico. É preciso considerar quantos dígitos inteiros e decimais serão necessários, inclusive depois de somas, multiplicações e outras operações.

    Revisei os exemplos afetados e reforçamos as explicações sobre capacidade dos campos, arredondamento e prevenção de perda de valores.

    Um exemplo de SORT que precisava de correção

    Também foi corrigido um exemplo relacionado à ordenação de registros com SORT.

    Na versão anterior, havia um problema que impedia sua compilação como previsto.

    Esse é justamente o tipo de falha que pode atrapalhar bastante quem está estudando processamento de arquivos, porque a pessoa pode entender a finalidade da instrução e, ainda assim, não conseguir executar o programa.

    O exemplo foi revisto para apresentar uma estrutura adequada ao ambiente utilizado na apostila.

    Correção de um possível laço infinito

    Outro problema identificado envolvia uma repetição cuja condição de encerramento não estava sendo tratada corretamente.

    O resultado poderia ser um programa que continuava executando sem alcançar a saída esperada.

    A revisão corrigiu esse comportamento e reforçou a importância de verificar como uma variável de controle muda durante a execução de um PERFORM.

    Um laço precisa ter uma condição de saída alcançável. Caso contrário, o pobre do computador fica trabalhando eternamente, provavelmente se perguntando o que fez para merecer aquilo,aaa…

    Validações no cadastro de clientes

    Também foram revisadas as verificações de dados relacionadas ao projeto prático de cadastro de clientes.

    A intenção foi deixar mais claro que receber um valor, armazená-lo e considerá-lo válido são operações diferentes.

    Essas correções ajudam a aproximar os exercícios de situações reais, nas quais um sistema precisa lidar com informações incorretas ou fora das regras estabelecidas.

    Voltar ao índice


    Compilação e testes dos exemplos

    Para essa revisão, não foram apenas lidos os programas procurando possíveis erros de sintaxe.

    Os exemplos passaram por verificações técnicas utilizando o GnuCOBOL 3.1.2 em ambiente Linux.

    Durante o trabalho, foram identificados 84 blocos de código, entre programas, declarações, trechos explicativos e exemplos que dependem de outras partes para funcionar.

    O registro da revisão aponta 55 testes aprovados.

    É importante fazer uma distinção: nem todo bloco apresentado numa apostila é um programa completo que pode ser compilado isoladamente.

    Alguns mostram apenas uma declaração de variável, uma instrução, um parágrafo ou uma operação específica. Nesses casos, é necessário considerar o contexto ao qual pertencem.

    A própria apostila revisada passou a deixar essa diferença mais clara, indicando quando o estudante pode copiar um programa completo e quando está diante de um trecho destinado à explicação de determinado recurso.

    Naturalmente, isso não significa garantir o funcionamento de todos os exemplos em qualquer compilador ou sistema operacional. COBOL possui diferentes dialetos e particularidades, especialmente quando entramos no universo dos mainframes.

    O ambiente principal adotado continua sendo o GnuCOBOL, com destaque para o formato livre.

    Voltar ao índice


    A versão linear para DOSVOX foi refeita

    Essa foi outra parte importante do trabalho.

    Desde a primeira publicação, a apostila é oferecida em dois formatos: DOCX, com navegação estruturada, e TXT, preparado para leitura linear no DOSVOX.

    Mas transformar um documento do Word em texto puro não significa simplesmente salvar o arquivo com outra extensão.

    Uma tabela pode funcionar muito bem quando o leitor de tela permite navegar entre linhas e colunas. Entretanto, quando ela é apresentada como texto corrido, a sequência pode ficar confusa.

    Imagine uma tabela com três colunas: comando, finalidade e exemplo. Se o conteúdo for extraído sem reorganização, a leitura pode misturar comandos, explicações e exemplos que pertencem a linhas diferentes.

    Por isso, a versão linear foi refeita e conferida.

    Tabelas explicadas por extenso

    Na revisão, foram trabalhadas 17 tabelas, reorganizando seus dados para que possam ser compreendidos sequencialmente.

    Em vez de depender da posição visual de cada célula, a leitura apresenta os elementos em uma ordem textual compreensível.

    A versão DOCX também inclui explicações lineares para as tabelas, oferecendo uma alternativa a quem prefere acompanhar o conteúdo dessa maneira.

    Blocos de código identificados

    Os exemplos de programação receberam atenção especial.

    Na versão TXT, os blocos possuem marcadores que ajudam o leitor a identificar onde começa e termina cada trecho.

    Isso permite distinguir o código COBOL das explicações que aparecem antes ou depois dele.

    Também procurou-se preservar os espaços necessários, algo particularmente importante nos exemplos que demonstram o formato fixo tradicional da linguagem.

    Codificação compatível com o DOSVOX

    O TXT revisado utiliza a codificação Windows-1252 e quebras de linha no padrão Windows, buscando manter a compatibilidade com os programas tradicionais de leitura e edição de texto do DOSVOX.

    O material continua integral. A versão linear não é um resumo, não elimina os capítulos avançados e não substitui os programas por descrições genéricas.

    É a mesma apostila, organizada para outra maneira de leitura.

    Voltar ao índice


    Espaços, colunas e acessibilidade

    Quem já programou em COBOL no formato fixo sabe que a posição de um caractere pode fazer diferença.

    Existem áreas destinadas a números de sequência, indicadores e instruções, com regras específicas para determinadas colunas.

    Agora imagine acompanhar tudo isso utilizando exclusivamente um sintetizador de voz.

    Um espaço não anunciado, um Tab interpretado de maneira diferente ou uma instrução deslocada para a coluna errada podem transformar um exemplo aparentemente correto em uma fonte de erros.

    A revisão reforçou as explicações sobre espaços, posições, colunas e utilização da tecla Tab.

    Também foi dada atenção à diferença entre caracteres e bytes, especialmente quando trabalhamos com arquivos em UTF-8.

    Um campo PIC X(40), por exemplo, não deve ser interpretado automaticamente como espaço para quarenta caracteres Unicode. Dependendo da codificação, determinadas letras podem ocupar mais de um byte.

    Esse detalhe é importante tanto para evitar problemas de armazenamento quanto para compreender o comportamento de algumas operações com texto.

    O objetivo continua sendo o mesmo da publicação original: ensinar COBOL sem exigir que o estudante enxergue a formatação do código.

    Voltar ao índice


    O conteúdo da apostila continua completo

    A revisão não transformou a apostila em outro curso, nem eliminou os assuntos mais avançados.

    O material continua começando pela história da linguagem e pelos fundamentos da programação, incluindo um capítulo preparatório de lógica com exemplos em COBOL.

    Depois, passa pela instalação e configuração do ambiente de desenvolvimento, utilização do GnuCOBOL, VS Code e leitores de tela.

    Entre os assuntos abordados estão variáveis, operações aritméticas, decisões, repetições, tabelas com OCCURS, arquivos sequenciais e indexados, ordenação, copybooks, subprogramas, testes e tratamento de erros.

    Os capítulos avançados incluem representações numéricas como COMP e COMP-3, concorrência, transações, integração com SQL, JSON, XML e C, além de uma introdução a JCL, CICS, DB2 e ao ambiente de mainframe.

    Há também um projeto prático de cadastro de clientes, exercícios, respostas comentadas, glossário e orientações de acessibilidade.

    Portanto, quem já estava estudando pode continuar de onde parou, mas recomendo substituir os arquivos antigos pelos revisados, especialmente para acompanhar os exemplos corrigidos.

    Voltar ao índice


    Onde baixar as versões revisadas

    A apostila continua gratuita, disponível em dois formatos.

    Versão DOCX

    Indicada para quem utiliza o Microsoft Word ou outro editor compatível, com leitores de tela como NVDA, JAWS e Orca.

    O documento possui títulos estruturados, sumário navegável, exemplos de código e explicações textuais.

    Você pode fazer download da versão Docx revisada Aqui!

    Versão TXT para DOSVOX

    Indicada especialmente para leitura linear, incluindo usuários do Edivox e de outros recursos de leitura de texto.

    Apresenta tabelas reorganizadas por extenso, blocos de código identificados, preservação dos espaços necessários e codificação Windows-1252.

    Download dessa versão Aqui!

    As duas versões apresentam o conteúdo completo da apostila. A diferença principal está na organização para leitura e navegação.

    Quem quiser complementar os estudos também pode consultar as duas publicações de agosto mencionadas na introdução, especialmente a segunda, que reúne vídeos, exercícios, códigos-fonte e recursos para conhecer melhor o universo dos mainframes.

    Voltar ao índice


    Considerações finais

    Uma das coisas que aprendi produzindo materiais de programação é que publicar não significa necessariamente terminar.

    Mesmo depois de revisar dezenas de capítulos, sempre pode aparecer um exemplo que precisa ser melhorado, uma explicação que ficou ambígua ou algum comportamento que não foi observado durante os testes.

    É por isso que considero essa revisão importante.

    Não basta entregar uma apostila acessível se o estudante encontra erros que poderiam ter sido evitados. Acessibilidade também envolve oferecer informações corretas, exemplos compreensíveis e condições para que a pessoa aprenda com autonomia.

    E, no caso do DOSVOX, envolve lembrar que uma leitura perfeitamente organizada visualmente pode não fazer o menor sentido quando apresentada em sequência por uma voz sintetizada.

    Se você já baixou a apostila anteriormente, recomendo atualizar seus arquivos.

    Se está conhecendo o material agora, seja bem-vindo ao mundo de uma linguagem que nasceu há mais de seis décadas, atravessou gerações de computadores e continua presente em sistemas importantes.

    E, naturalmente, se encontrar algum erro nos exemplos, alguma dificuldade de acessibilidade ou alguma explicação que possa ser melhorada, entre em contato.

    Porque a apostila pode continuar evoluindo. E o COBOL, pelo jeito, ainda vai nos dar muito trabalho,aaa…

    Boa leitura, bons estudos e bons códigos!

    Um abraço e… Até a próxima!

    Fernando

  • Programando para o DOSVOX ganhou um upgrade: revisão, exemplos completos e leitura acessível

    Tempo de leitura: 4 minutos

    Ooi turma, leitores dessa coisa aqui!!!

    Lembram da apostila Programando para o DOSVOX, que apareceu por aqui em setembro? Pois é, ela voltou para a bancada, passou por uma revisão e está de volta com exemplos mais completos, explicações melhoradas e mais orientação para quem quer começar pelo Free Pascal. Até apostila tem direito a um upgrade,aaa.

    Para quem ainda não conhece o material, vale conferir o post de apresentação da apostila, com Delphi, Free Pascal e o projeto final AventuraVox. Aqui vou contar o que mudou nesta revisão e deixar os links atualizados para download.

    Os links de download do post antigo também já apontam para esta edição revisada. Quem chegar pela publicação de setembro vai encontrar a apostila nova por lá também. Até a entrada antiga dá acesso ao upgrade,aaa.

    Neste texto:

    Uma revisão com colaboração e código na prática

    Esta atualização contou com a colaboração do Caio Gustavo, que revisou e reorganizou trechos das primeiras partes da apostila, acrescentou comentários e ajudou a melhorar o caminho de quem está começando. Segundo seu relato, os exemplos que revisou foram escritos no EDIVOX e compilados e testados pelo terminal do Windows, com o NVDA.

    Depois veio mais uma conferência, concluída em 19 de outubro de 2026, para completar programas, ajustar detalhes técnicos e preparar a versão HTML. É aquela história: a gente revisa, confere a revisão e ainda encontra um ponto e vírgula dando risada num canto,aaa.

    Fica aqui meu agradecimento ao Caio pela colaboração. E permanece o crédito à Bruna de Lima Costa, autora da documentação de rotinas do DOSVOX que serviu de base para a parte específica do sistema. A organização e a ampliação do material continuam assinadas por mim.

    Voltar ao início

    Exemplos completos, do começo ao ponto final

    Uma das mudanças mais importantes está nos exemplos de ensino e nas respostas dos exercícios: eles passaram a apresentar programas completos, com as declarações necessárias, variáveis, unidades utilizadas, chamadas e encerramento.

    Quem já programa costuma olhar um pedaço de código e saber onde encaixá-lo. Quem está aprendendo precisa entender também o que vem antes e depois daquele trecho. Ter o programa inteiro ajuda a acompanhar essa estrutura e a experimentar no compilador sem precisar adivinhar a parte que ficou de fora.

    Também foram ajustados tipos de variáveis, inicializações, dependências e diretivas de compilação. Os trechos que servem como referência de uma rotina, comando ou configuração passaram a ter sua finalidade identificada com mais clareza.

    E os exemplos também estão no pacote em arquivos separados, para facilitar o estudo. Dá para abrir, compilar, alterar e descobrir o que acontece. O compilador certamente continuará reclamando quando a gente errar, mas essa parte faz parte do curso,aaa.

    Voltar ao início

    Mais orientação para começar com Free Pascal e Lazarus

    A revisão melhorou as orientações para instalar o Lazarus, configurar o acesso ao compilador pelo terminal e compilar os primeiros programas com o Free Pascal. Isso ajuda quem quer acompanhar a apostila desde os capítulos de lógica usando esse ambiente.

    A passagem do Pascal para os recursos de Object Pascal também recebeu atenção, com reorganização de explicações e ajustes nos exemplos. Os cabeçalhos passaram a indicar o modo de linguagem necessário no Free Pascal, preservando o cuidado com a compatibilidade com o Delphi 6.

    Os exemplos independentes receberam validação adicional com Free Pascal. Já os programas que usam fala, teclado e outras rotinas do DOSVOX precisam das unidades e bibliotecas correspondentes à instalação utilizada. A apostila explica esse cuidado e orienta a conferir as declarações das rotinas nos arquivos-fonte quando houver diferenças entre versões.

    Voltar ao início

    O AventuraVox também passou pela oficina

    O projeto final, AventuraVox — A Última Transmissão, continua reunindo os conhecimentos da apostila em uma aventura textual. Ele também recebeu ajustes, incluindo verificações na leitura de partidas salvas, validação do estado do jogo e mais cuidado com o cálculo da pontuação.

    Além de estudar cada exemplo pequeno, o leitor pode acompanhar como as peças se juntam em um projeto maior: organização do programa, interação pelo teclado, mensagens faladas e armazenamento do progresso.

    E fica a sugestão: depois de entender o projeto, experimente mexer nele. Troque mensagens, invente situações, acrescente caminhos. Daqui a pouco o exercício virou um jogo que nem o autor consegue terminar,aaa.

    Voltar ao início

    HTML para navegar, TXT para ler no EDIVOX

    O material está disponível em dois formatos, para facilitar a escolha de como estudar:

    • HTML: com títulos estruturados, sumário navegável e blocos de código preservados, para leitura no navegador e navegação com leitor de telas.
    • TXT: para leitura linear no EDIVOX ou em outro editor de textos, com títulos numerados e marcações de início e fim dos exemplos de código.

    No TXT, as explicações dos diagramas seguem em texto, e as linhas foram mantidas relativamente curtas. O arquivo usa codificação Windows-1252 e quebras de linha do Windows, conforme indicado na própria apostila.

    O conteúdo continua indo da lógica de programação às rotinas do DOSVOX, passando por Pascal, Object Pascal, Delphi, Free Pascal e Lazarus. Quem está começando pode seguir a sequência; quem já conhece a linguagem pode procurar os capítulos de que precisa.

    Voltar ao início

    Links para download

    Pacote completo: reúne a apostila em HTML e TXT, os exemplos e o projeto AventuraVox.

    Baixar o pacote completo da apostila Programando para o DOSVOX, com exemplos e AventuraVox.

    Somente a versão TXT: para quem quer abrir o material diretamente no EDIVOX pelo DOSVOX ou prefere estudar em texto simples.

    Abrir ou baixar a apostila Programando para o DOSVOX em TXT.

    Quem baixou a edição anterior já pode pegar esta versão revisada e substituir sua cópia de estudo. Se fez anotações no arquivo antigo, guarde uma cópia antes de trocar.

    Voltar ao início

    Continuar estudando para continuar criando

    Uma colaboração assim ajuda a melhorar o material justamente onde ele precisa ser mais claro: na hora em que alguém abre o editor, tenta acompanhar o exemplo e coloca o código para funcionar.

    É esse o convite da apostila. Estude, experimente, altere os programas e conte se encontrar algum problema ou explicação que possa melhorar. O DOSVOX continua tendo espaço para novos utilitários, jogos e ideias, e cada pessoa que aprende suas rotinas pode ajudar a construir alguma coisa.

    Obrigado novamente ao Caio Gustavo pela revisão e à Bruna de Lima Costa pelo material que está na base deste trabalho. Agora é baixar a versão nova e colocar os dedos no teclado. O próximo programa falante pode sair daí,aaa.

    Um abraço, turma, e até a próxima nessa coisa aqui!!!

    Fernando

  • Programando aplicações acessíveis para Windows com C#: do primeiro código à fala nativa

    Tempo de leitura: 7 minutos

    Olá, pessoal! Tudo bem com vocês?

    Pois é, terça, como quase sempre, é dia de apostila…

    E, quem acompanha o blog sabe que, de uns tempos para cá, tenho me aventurado bastante pelo mundo da programação. Entre um programa que funciona, outro que resolve inventar moda e aquele erro que aparece justamente quando a gente pensa que terminou, algumas experiências acabam rendendo muito mais do que apenas algumas linhas de código. aaa

    Foi assim com o Correio Acessível, o Criador de Posts e outros projetos que venho desenvolvendo.

    Durante essas experiências, surgiu uma ideia: por que não reunir boa parte do conhecimento envolvido na criação desses programas em uma apostila que também pudesse ajudar outras pessoas a desenvolver aplicações para Windows?

    Mas havia um detalhe fundamental: o material precisava ser acessível para quem programa utilizando leitores de tela, sem depender do mouse ou de um ambiente visual para acompanhar as explicações.

    E foi assim que nasceu a apostila Programando aplicações acessíveis para Windows com C#, um material gratuito, em português, que vai dos primeiros conceitos da linguagem até assuntos mais avançados, como acesso à internet, bancos de dados, correio eletrônico, sintetizadores de voz e bibliotecas de acessibilidade.

    E não, você não precisa conhecer C# para começar. A proposta é justamente permitir que o estudante acompanhe o conteúdo desde o início.

    Índice

    1. Como surgiu a ideia da apostila
    2. O que você encontrará no material
    3. Programação acessível: o teclado em primeiro lugar
    4. Fala nativa e ajuda guiada
    5. Da teoria à prática
    6. Para quem é esta apostila?
    7. Onde baixar a apostila
    8. Considerações finais
    9. Fontes e referências

    1. Como surgiu a ideia da apostila

    Nos últimos tempos, venho trabalhando em programas para Windows que possuem algo em comum: a preocupação com a acessibilidade.

    Alguns utilizam recursos de fala nativa, outros possuem sistemas de ajuda guiada, e praticamente todos procuram oferecer uma navegação eficiente pelo teclado.

    Para desenvolver essas aplicações, precisei trabalhar com C#, Windows Forms, bibliotecas do .NET, comunicação HTTP, tratamento de arquivos, interfaces, bancos de dados e uma infinidade de outros recursos.

    Quem já programou sabe como isso funciona: a gente começa querendo criar uma janela com três botões e, quando percebe, já está estudando autenticação, tarefas em segundo plano e protocolos de comunicação. aaa

    Foi justamente essa experiência que motivou a criação do material.

    A ideia não é apenas explicar como escrever um programa em C#, mas também mostrar como construir aplicações que possam ser utilizadas de verdade, especialmente por pessoas que dependem de tecnologias assistivas.

    2. O que você encontrará no material

    A apostila possui 36 capítulos, organizados para permitir um estudo progressivo.

    Ela começa apresentando os conceitos de C#, .NET Framework e Windows Forms, explicando a função de cada tecnologia e como elas trabalham juntas.

    Depois, entra no ambiente de desenvolvimento: instalação das ferramentas, utilização do Visual Studio Code pelo teclado, compilação, depuração e execução dos primeiros programas.

    Entre os assuntos abordados estão:

    • Fundamentos de C#, variáveis, tipos de dados, estruturas de decisão, laços e métodos.
    • Classes, objetos, interfaces, herança, eventos e tratamento de exceções.
    • Criação de janelas, menus, caixas de diálogo, listas, árvores e atalhos de teclado com Windows Forms.
    • Leitura e gravação de arquivos, codificações de texto, XML e JSON.
    • Proteção de informações e armazenamento de credenciais.
    • Execução de tarefas em segundo plano, evitando que a interface fique travada.
    • Comunicação HTTP, APIs REST e integração com WordPress.
    • Manipulação de HTML e utilização dos componentes WebBrowser e WebView2.
    • Produção de fala por meio de recursos do Windows e do System.Speech.
    • Mensagens de correio eletrônico, anexos e protocolos IMAP, POP e SMTP.
    • Autenticação OAuth2 e seus mecanismos de autorização.
    • Utilização do SQLite para armazenamento de dados.
    • Correção ortográfica, geração de códigos QR e interoperabilidade com recursos do Windows.
    • Testes de acessibilidade, criação de bibliotecas reutilizáveis e distribuição de programas portáteis ou instaláveis.

    Também há exercícios, glossário, referências e orientações para identificar e resolver erros.

    O material utiliza principalmente o .NET Framework 4.x nos exemplos iniciais, mas também apresenta recursos e laboratórios envolvendo tecnologias mais recentes, inclusive .NET 10, quando necessário.

    Cada laboratório informa a plataforma utilizada, porque misturar versões de bibliotecas e frameworks sem prestar atenção às compatibilidades pode produzir uma bela coleção de mensagens de erro. E dessas ninguém precisa fazer coleção! aaa

    3. Programação acessível: o teclado em primeiro lugar

    Este é um dos pontos mais importantes da apostila.

    Muitos tutoriais de programação ensinam a criar interfaces arrastando componentes com o mouse, posicionando botões visualmente e configurando propriedades em janelas gráficas.

    Isso pode funcionar perfeitamente para quem enxerga, mas nem sempre é uma solução prática para quem utiliza um leitor de tela.

    Por isso, o material procura apresentar os procedimentos utilizando comandos de teclado, menus, editores de código e ferramentas acessíveis.

    São abordados recursos do Visual Studio Code, navegação pelos arquivos, compilação e depuração, além dos cuidados necessários ao desenvolver interfaces compatíveis com leitores de tela como NVDA, JAWS e Narrador do Windows.

    Também são discutidas questões como ordem de tabulação, identificação dos controles, gerenciamento do foco, mensagens acessíveis e utilização adequada das teclas de atalho.

    Porque não adianta muito criar um programa com cinquenta funções maravilhosas se o usuário não consegue descobrir onde está o botão que executa a primeira delas!

    A proposta é mostrar que a acessibilidade não precisa ser uma adaptação feita às pressas depois que o programa está pronto. Ela pode, e deve, fazer parte do desenvolvimento desde o começo.

    4. Fala nativa e ajuda guiada

    Além dos recursos tradicionais do Windows Forms, a apostila apresenta duas bibliotecas que desenvolvi para facilitar a criação de aplicações acessíveis: Fala nativa e ajuda guiada, ambas para Windows forms.

    A primeira permite incorporar recursos de voz ao próprio aplicativo, utilizando mecanismos de síntese de fala do Windows.

    São apresentados conceitos de inicialização, leitura de controles, tratamento de mensagens, configurações de voz e integração com leitores de tela, procurando evitar problemas como falas simultâneas ou repetidas.

    Já a biblioteca de ajuda guiada possui outra finalidade: orientar o usuário sobre os comandos disponíveis e explicar a utilização dos controles de uma aplicação.

    Em vez de depender exclusivamente de um arquivo de ajuda extenso, o programa pode oferecer informações relacionadas ao controle em que o usuário está trabalhando.

    Naturalmente, esses mecanismos não substituem uma interface corretamente construída nem a utilização de leitores de tela. Eles funcionam como recursos complementares.

    A apostila dedica capítulos específicos a essas duas bibliotecas, incluindo orientações de instalação, integração e exemplos de utilização.

    Os pacotes das bibliotecas também possuem distribuição independente, permitindo seu aproveitamento em outros projetos.

    5. Da teoria à prática

    Uma apostila de programação não pode ficar apenas explicando o que cada comando deveria fazer. Em algum momento, precisamos colocar o código para trabalhar!

    Por isso, o material reúne 26 exemplos completos de programação, com explicações, comentários e instruções para compilação.

    Os exercícios começam com conceitos fundamentais e avançam até projetos com interfaces gráficas, manipulação de arquivos, comunicação pela internet, fala e ajuda integrada.

    Há, inclusive, um projeto didático que combina edição de texto, arquivos, HTML, recursos de voz e orientação ao usuário.

    Alguns assuntos foram inspirados nas tecnologias utilizadas em programas que venho desenvolvendo, como o Criador de Posts e o Correio Acessível.

    Isso não significa que a apostila contenha o código completo desses programas. Os exemplos foram preparados para fins didáticos, permitindo estudar cada recurso sem precisar compreender uma aplicação inteira de uma só vez.

    Afinal, apresentar milhares de linhas de código a alguém que acabou de aprender a declarar uma variável seria uma maneira bastante eficiente de fazê-lo desistir da programação antes do almoço. aaa

    Outro detalhe importante é que os exemplos foram pensados para permitir o acompanhamento pelo teclado, inclusive na criação das janelas e na verificação dos resultados.

    6. Para quem é esta apostila?

    Embora a preocupação principal seja atender pessoas cegas ou com baixa visão, o material não é exclusivo desse público.

    Ele pode ser utilizado por qualquer pessoa interessada em aprender C# e desenvolver aplicações para Windows.

    Quem nunca programou encontrará explicações introdutórias e uma sequência sugerida de estudos.

    Quem já possui conhecimentos em linguagens como Pascal ou Delphi encontrará conceitos familiares, além de comparações que ajudam a compreender algumas diferenças de organização e funcionamento.

    E quem já programa em C# poderá aproveitar os capítulos dedicados à acessibilidade, comunicação com serviços externos, armazenamento de dados e integração de bibliotecas.

    O único requisito realmente importante é ter disposição para experimentar, ler as mensagens de erro e descobrir por que aquele programa que compilava perfeitamente cinco minutos atrás resolveu mudar de ideia. aaa

    7. Onde baixar a apostila

    A apostila é gratuita e está disponível em dois formatos: HTML e TXT.

    Versão HTML:

    Acessar a apostila de C# e Windows Forms em HTML

    A versão HTML possui títulos estruturados, índice com links internos e organização apropriada para navegação com leitores de tela. Pode ser consultada diretamente pelo navegador.

    Versão TXT:

    Baixar a apostila de C# e Windows Forms em TXT

    A versão TXT é indicada para quem prefere trabalhar com editores de texto simples ou utilizar ferramentas como o EDIVOX, do DOSVOX. O arquivo utiliza a codificação Windows-1252, para favorecer a compatibilidade com esses ambientes.

    O conteúdo didático é o mesmo nas duas versões. A escolha depende apenas da maneira como você prefere estudar.

    Uma sugestão é acompanhar os capítulos na ordem apresentada, testar os exemplos e fazer pequenas modificações no código para compreender como cada recurso funciona.

    E não se preocupe se algo não funcionar na primeira tentativa. Em programação, descobrir por que determinada coisa deu errado também faz parte do aprendizado. Às vezes, é justamente essa investigação que ensina mais!

    8. Considerações finais

    Desenvolver aplicações acessíveis é um trabalho que envolve muito mais do que escolher uma linguagem de programação.

    É necessário pensar na navegação pelo teclado, na maneira como as informações serão apresentadas, na identificação dos controles e nas dificuldades que diferentes usuários poderão encontrar.

    Com esta apostila, minha intenção é compartilhar conhecimentos adquiridos durante o desenvolvimento dos meus próprios projetos e, ao mesmo tempo, contribuir para que outras pessoas também possam criar suas ferramentas.

    Se o material ajudar alguém a escrever seu primeiro programa, compreender melhor o Windows Forms ou acrescentar acessibilidade a uma aplicação existente, já terá cumprido uma parte importante de seu objetivo.

    E quem sabe não surgem daí novos programas, bibliotecas e ideias que também possam beneficiar outras pessoas?

    Afinal, o mundo da programação é grande demais para ficar restrito a quem consegue enxergar a posição de um botão na tela.

    Espero que vocês aproveitem o material, façam seus experimentos e, principalmente, se divirtam aprendendo.

    Um abraço e até a próxima!

    Fernando

    9. Fontes e referências

    Para complementar o estudo, seguem algumas referências técnicas utilizadas nos assuntos apresentados pela apostila. Priorizei a documentação disponível em português.

    OXiV mx86 kdzt qjKR WuAs qdJ4
    OXiV mx86 kdzt qjKR WuAs qdJ4
    OXiV mx86 kdzt qjKR WuAs qdJ4
    OXiV mx86 kdzt qjKR WuAs qdJ4

    As páginas disponíveis apenas em outros idiomas podem ser consultadas com o recurso de tradução automática do navegador.

  • Programando para o DOSVOX: Delphi, Free Pascal e projeto final: Aventuravox

    Tempo de leitura: 3 minutos

    Ooi turma, leitores dessa coisa aqui!!!

    Hoje, terça, como sempre, tem apostila nova! E desta vez a conversa é sobre programação, Pascal, Delphi, Free Pascal e um sistema que já atravessou mais de três décadas fazendo computador falar: o DOSVOX.

    O sistema começou a ser desenvolvido em 1993. De lá para cá, o Windows mudou, os computadores ficaram milhares de vezes mais rápidos, os disquetes desapareceram e até o telefone resolveu virar computador. O nosso bom e velho DOSVOX, porém, continua por aqui — e não deve morrer!

    Neste texto:

    De onde surgiu a ideia

    O ponto de partida foi uma apostila escrita por Bruna de Lima Costa, com explicações sobre as rotinas utilizadas para criar programas para o DOSVOX.

    Era um material importante porque mostrava justamente a parte que costuma causar mais dúvidas: como fazer um programa em Pascal ou Delphi conversar com o DOSVOX, usar sua síntese de voz, receber teclas e seguir o estilo de funcionamento que seus usuários já conhecem.

    A ideia, então, foi conservar os créditos da autora e ampliar o conteúdo, transformando aquele material em um guia mais completo. A nova apostila parte da lógica de programação, passa por Pascal, Delphi, Object Pascal, Free Pascal e Lazarus, até finalmente chegar às rotinas específicas do DOSVOX.

    Voltar ao topo

    O problema da falta de programadores

    Tem bastante gente que usa o DOSVOX. Também tem muita gente que conhece Pascal. O grupo de pessoas que conhece as duas coisas e ainda sabe quais rotinas chamar para o programa falar, ler o teclado e funcionar dentro do ambiente DOSVOX já é bem menor,aaa.

    O próprio site do projeto possui documentação para programadores, mas boa parte desse conhecimento acabou ficando espalhada entre apostilas antigas, códigos-fonte e programadores que trabalham com o sistema há muitos anos.

    Por isso, a proposta desta apostila não é apenas ensinar uma linguagem. É criar uma ponte para que novos programadores possam entender o estilo do DOSVOX, estudar programas existentes e, quem sabe, criar novos utilitários, jogos e ferramentas acessíveis.

    Afinal, programa também envelhece. E, quando ninguém mais sabe mexer nele, qualquer pequeno erro começa a parecer uma assombração saída de um computador de 2001,aaa.

    Voltar ao topo

    O que há na apostila

    A apostila começa contando um pouco da história do Pascal e do Delphi e apresenta essas ferramentas nos dias atuais. Depois, traz um curso de lógica de programação, começando pelo tradicional “Olá, mundo!” e avançando por condições, repetições, vetores, matrizes, funções, procedimentos, arquivos, unidades e outros recursos.

    Também há capítulos sobre Object Pascal, Delphi, Free Pascal e Lazarus, além de orientações para compilar programas usando diferentes ambientes.

    Na parte dedicada ao DOSVOX entram as rotinas de voz, leitura do teclado, menus, arquivos de configuração, sons, mensagens, organização dos programas e vários exemplos comentados.

    A intenção não é que a pessoa apenas leia e guarde a apostila numa pasta esquecida. É para abrir o compilador, errar alguns pontos e vírgulas, ouvir o compilador reclamar e começar a criar,aaa.

    Voltar ao topo

    O projeto final Aventuravox

    Para reunir os conhecimentos apresentados, a apostila termina com o projeto Aventuravox, uma pequena aventura textual criada especialmente para o material.

    As mensagens da história são faladas pela síntese de voz, enquanto arquivos WAV podem ser usados para representar portas, passos, mecanismos e outras ocorrências do jogo.

    Além de servir como diversão, o projeto mostra na prática como criar menus navegáveis pelo teclado, controlar o andamento de uma história, salvar o ponto em que o jogador parou, ler configurações do DOSVOX e organizar os sons externos.

    E, claro, ele foi pensado como exemplo didático, sem tentar copiar o Colossal, o Piratvox, a Fuga de San Quentin ou qualquer outro clássico da jogatina falante.

    Voltar ao topo

    Links para download

    Preparei duas formas de baixar o material:

    Voltar ao topo

    Fontes e páginas relacionadas

    Voltar ao topo

    Espero que este material ajude quem deseja dar os primeiros passos na programação e também quem já programa, mas nunca se aventurou pelas rotinas do DOSVOX.

    Se a apostila conseguir incentivar pelo menos mais uma pessoa a criar um programa novo para o sistema, o trabalho já terá valido a pena. O DOSVOX tem história, tem usuários e ainda pode ganhar muita coisa nova. Para isso, precisa continuar tendo gente disposta a estudar, programar e manter essa máquina falando!

    Um abraço, turma, e até a próxima nessa coisa aqui!!!

    Fernando

  • Musicografia Braille: duas apostilas para estudar, praticar e ir além dos primeiros sinais

    Tempo de leitura: 5 minutos

    Oi amigos leitores, tudo bem?

    Aqui tudo… Nada melhor que uma surpresinha para o domingo, não? É claro que eu não conseguiria segurar isso até terça, que é o “dia oficial” de apostilas no blog,aaa…

    E quem acompanha essa coisa aqui já percebeu que informática e música vivem se encontrando por estas bandas. Dessa vez, o encontro rendeu duas apostilas de musicografia Braille: uma dos fundamentos ao nível intermediário e outra dedicada ao nível avançado. A ideia é oferecer um material de estudo mais detalhado, com explicações, exemplos e exercícios, incluindo particularidades do canto e de diferentes instrumentos.

    E, como cada um tem seu jeito de estudar, preparei versões em HTML, com exercícios interativos, e em TXT, para quem prefere abrir o texto no DOSVOX e seguir a leitura por ali. Tem teoria, tem prática, tem gabarito e até nota. Só não tem como o computador estudar no lugar do sujeito, aaa!

    Os dois níveis podem ser acessados pela página de Musicografia Braille aqui no blog. Para estudar sem internet, também disponibilizei um ZIP de cada volume, reunindo o HTML offline e o TXT. Os links estão nas seções abaixo.

    Neste post

    De onde veio a ideia

    O ponto de partida foi a Apostila de Musicografia Braille, da professora Dolores Tomé, vinculada ao Projeto Musibraille. Ao estudar esse material, surgiu a vontade de desenvolver uma abordagem mais extensa, explicando os sinais em seu contexto e ampliando os exemplos de aplicação. Afinal, reconhecer uma nota é um começo; entender o que acontece quando entram várias vozes, texto cantado, pedais, dedilhados e particularidades de cada instrumento já pede outra conversa.

    O Projeto Musibraille tem como proposta favorecer o acesso das pessoas com deficiência visual à aprendizagem musical. Foi desse trabalho que veio a inspiração inicial, e faço questão de deixar o caminho até ele bem indicado para quem quiser conhecer o projeto e consultar seus materiais.

    As duas apostilas apresentadas aqui foram preparadas por Fernando de Paula Zamboni, com base no material de Dolores Tomé e nas demais referências técnicas identificadas nos volumes. São publicações independentes, com organização didática, explicações, exemplos e exercícios próprios. Os créditos da obra de referência estão preservados; os acréscimos não representam uma edição oficial ou uma revisão aprovada pelo Projeto Musibraille.

    Voltar ao índice

    O que procurei desenvolver

    A proposta é ajudar o leitor a passar do reconhecimento dos sinais à compreensão de uma passagem musical. Isso envolve relacionar notas e durações, acompanhar oitavas e acidentes, separar vozes simultâneas e perceber como as informações se organizam numa partitura. Uma lista de sinais é útil para consulta, mas o estudo também precisa mostrar o que fazer com eles.

    Por isso, o material reúne explicações e exemplos descritos musicalmente, acompanhados da composição das celas por pontos. Essa apresentação permite estudar os sinais sem depender apenas da maneira como um sintetizador de voz pronuncia um caractere Braille. O HTML também traz as celas como apoio visual; no TXT, a descrição por pontos mantém a informação disponível para leitura.

    Outro objetivo foi dedicar espaço ao canto e às particularidades instrumentais: distribuição de sílabas, melismas e respirações; mãos e pedais nos teclados; baixos, acordes e fole no acordeon; cordas, posições e dedilhados; além de sopros, percussão e outros contextos. Cada assunto aparece dentro de uma sequência de estudo, com aprofundamento no segundo volume.

    As apostilas podem servir a estudantes, músicos, professores e interessados em leitura musical em Braille. O ideal é combinar a leitura com a prática: conferir um exemplo, reconstruir sua organização e, quando possível, tocar ou cantar o trecho. A nota dos exercícios ajuda na autoavaliação, mas não afina o acordeon nem resolve o dedilhado sozinha!

    Voltar ao índice

    Apostila básica e intermediária

    O primeiro volume, Musicografia Braille ampliada: fundamentos, canto e instrumentos, reúne 29 capítulos e 87 exercícios comentados. Começa pela cela Braille e pelos fundamentos musicais, desenvolve notas, pausas, compassos, oitavas, acidentes, escalas, intervalos e acordes, e avança para aplicações no canto e nos instrumentos.

    Também há material de consulta, como tabelas de notas e pausas, escalas e índice de sinais. É o caminho indicado para quem está começando ou quer reorganizar os conhecimentos antes de enfrentar passagens mais complexas.

    Voltar ao índice

    Apostila avançada

    O segundo volume, Musicografia Braille avançada: polifonia, canto, instrumentos e revisão de transcrições, reúne 24 capítulos e 96 questões comentadas, além de atividades práticas com soluções orientadoras e projetos de aplicação. Ele pressupõe o domínio dos fundamentos trabalhados no primeiro volume.

    O aprofundamento inclui ritmos e agrupamentos mais complexos, acordes e intervalos compostos, duplicações, em-acorde completo e parcial, notas móveis, dupla duração e ligaduras seletivas. Também aborda canto em diferentes idiomas, escrita coral, técnicas instrumentais, notação contemporânea, harmonia e revisão de partituras.

    A intenção é desenvolver uma leitura que possa ser conferida: entender quais sons começam juntos, quais continuam sustentados, como as vozes se relacionam e o que cada indicação pede ao intérprete. Os projetos finais ajudam a reunir essas decisões em pequenos trabalhos de transcrição.

    Voltar ao índice

    HTML, TXT e exercícios: como usar

    Para estudar online, entre na página indicada e escolha o volume. Para estudar no computador sem depender de conexão, baixe o ZIP correspondente e extraia os arquivos. Abra o HTML offline no navegador ou o TXT no DOSVOX. Quem quiser os dois níveis pode baixar os dois pacotes; cada um já traz seus dois formatos, sem precisar procurar a arquivaíada separadamente, aaa!

    Na versão HTML, o leitor pode navegar pelo sumário e pelos títulos, escolher as alternativas e conferir as respostas. A correção informa se houve acerto ou erro e apresenta uma explicação. Ao finalizar, aparecem a nota de zero a dez, o desempenho por capítulo e o gabarito comentado.

    A primeira resposta conferida é a que conta para a nota. Novas tentativas servem para praticar, e questões deixadas em branco valem zero ao finalizar. As atividades de escrita e os projetos têm orientação para revisão, mas não são corrigidos automaticamente como as questões de alternativas.

    O progresso pode ser guardado no navegador e também salvo em arquivo para continuar depois. Cada volume tem seu próprio progresso. As respostas dos exercícios não são enviadas a mim: o resultado fica com quem está estudando.

    A versão TXT contém teoria, exemplos, exercícios e gabarito, com codificação Windows-1252 e quebras de linha adequadas ao uso no Windows. Foi preparada pensando especialmente na leitura pelo DOSVOX. Nela, a conferência das respostas e o cálculo da nota são manuais.

    Os exemplos descritos por pontos são um recurso de estudo. Os arquivos não são partituras BRF prontas para impressão em relevo. Para esse uso, é necessário preparar a transcrição e a diagramação Braille apropriadas.

    Voltar ao índice

    Musibraille, musicoteca e referências

    Além das apostilas, recomendo conhecer o trabalho que deu origem à ideia e explorar seus materiais. Os links abaixo abrem em outra aba:

    O manual internacional foi a principal referência técnica para a conferência dos sinais. Os créditos completos e as demais referências, incluindo a localização da edição brasileira, estão nas próprias apostilas.

    Espero que esse material ajude quem quer começar, retomar ou aprofundar os estudos. E, se encontrar alguma dúvida, erro ou trecho que mereça uma explicação melhor, deixe um comentário indicando o volume, o capítulo e o exemplo ou a questão. Assim fica muito mais fácil localizar o ponto e melhorar o material.

    Um abraço e bons estudos!

    Fernando de Paula Zamboni

    Voltar ao início