DesignGuidelines/pt

From Free Pascal wiki
Jump to: navigation, search

Deutsch (de) English (en) español (es) français (fr) 日本語 (ja) 한국어 (ko) português (pt) русский (ru)

Linhas Gerais de Desenho

Isto é para desenvolvedores Lazarus:


Coding style
  • A não ser que outro estilo se mostre mais legível, o Lazarus seguirá a linhas de guia de estilo do Borland Coding. Claro que quase todo mundo vai achar alguns pontos que podem ser considerados menos legíveis nele que em outros estilos. Ok, então tente segui-lo em pelo menos 90%.
  • Tente evitar referências circulares em units. Isto as torna mais fáceis de navegar e, quando as units estão crescendo, permite dividi-las.
  • Minimize o número de chamadas da interface para LCL ao executar uma ação pedida pelo LCL. As interfaces só notificam o LCL, nunca force algo. O LCL decide.
  • Convenção de nomes, veja Nomenclature
  • Todo o código precisa funcionar bem com todas as checagens (range, io, overflow, stack) ligadas. Ao mesmo tempo que isto ajuda na depuração, alguns usuários puseram estas checagens em seus fpc.cfg e assim eles são aplicados ao Lazarus inteiro. Inclusive pacotes e exemplos.


Novos arquivos
  • Todo arquivo deve começar com um cabeçalho que contém a licença e alguns linhas que descrevem o conteúdo.
  • Os nomes de arquivos em Pascal tem de ser escritos em letra minúscula (.pas, .pp, .inc, .lfm, .lrs)


Incluir arquivos
  • Deveria começar com a diretiva {%MainUnit }


Packages
  • Deveria ter uma entrada packager/globallinks/ no .lpl


Caixas de diálogo (modal forms)
  • Fechar ao se pressionar Esc (se essa tecla não for usada para outra função)
  • Defina botão padrão e o de retorno ativos (if key not used)
  • As médias e complexas caixas de diálogos deveriam ser redimensionáveis e o tamanho ser guardado


Itens no Main Menu 
  • Deveriam ter suas teclas em keymapping.pp



Authoritive version pode ser achada em svn.Propostas para melhorias podem ser adicionadas na página de discussão.