Skip to content

Latest commit

 

History

History
107 lines (71 loc) · 3.55 KB

format_config.md

File metadata and controls

107 lines (71 loc) · 3.55 KB
Raw

TDS: Formatação de Código Fonte

Requisitos

  • formatação ativada

Configuração

Por padrão, a formatação de código fonte vem desligado. Para ligá-lo acesse File | Preferences | Settings e localize 4gl ou advpl, conforme a linguagem de programação que deseja configurar.

Lhe será apresentado algo semelhante a:

4GL settings

Saiba mais sobre precedência de configurações em User and Workspace Settings.

O bloco [4gl] (ou [advpl]), são configurações ligadas a ativação dos processos pelo VS-Code associadas ao editor da linguagem e [4gl.formatter] (ou [advpl.formatter]), são as opções de formatação específicas.

Para sobrescrever os valores padrão, acione Edit in settings.json.

Saiba mais em Formatting e Indentation.

Configurações [4gl] ou [advpl]

A formatação para AdvPL está parcialmente implementada.

  • "files.encoding": "windows1252" | "windows1251"

    Indica a codificação dos arquivos com código fonte. A codificação windows1251 deve ser utilizada em fontes com strings no alfabeto cirílico.

  • "editor.formatOnType": true | false

    Habilita a formatação durante a digitação.

  • "editor.formatOnPaste": true | false

    Habilita a formatação em blocos colados.

  • "editor.formatOnSave": true | false

    Habilita a formatação ao salvar o arquivo.

  • "editor.formatOnSaveMode": "file" | "modifications"

    Indica o modo de formatação ao salvar o arquivo.

  • "editor.insertSpaces": auto | false | true

    Controla se o editor irá inserir espaços para tabulações. Se definido como auto, o valor será determinado com base no arquivo aberto.

  • "editor.tabSize": auto | number

    Controla o tamanho de renderização da tabulação. Se definido como auto, o valor será determinado com base no arquivo aberto.

  • "files.trimTrailingWhitespace": false | true

    Habilita a remoção de caracteres não significativos ao final da linha.

Configurações 4gl.formatter ou advpl.formatter

AdvPL

Não se aplica.

4GL

Chaves específicas para formatação de fontes 4GL.

Chave Uso
keywordsCase <upper | lower | ignore> Coloca palavras-chaves em maiúsculas ou minúsculas. Padrão: upper
stringStyle <double-quotes | single-quotes | ignore> Usar aspas simples ou duplas em strings. Padrão: ignore

Exemplo com os valores padrão

Arquivo settings.json

{
  ...,
  "[advpl]": {
    "files.encoding": "windows1252",
    "editor.formatOnType": false,
    "editor.formatOnPaste": false,
    "editor.formatOnSave": false,
    "editor.formatOnSaveMode": "file",
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "files.trimTrailingWhitespace": false,
  },
  "[4gl]": {
    "files.encoding": "windows1252",
    "editor.formatOnType": false,
    "editor.formatOnPaste": false,
    "editor.formatOnSave": false,
    "editor.formatOnSaveMode": "file",
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "files.trimTrailingWhitespace": false,
  },
  "4gl.formatter": {
    "keywordsCase": "upper",
    "stringStyle": "ignore",
  }
  ...,
}