Personalizar a completação automática do código

A completação do código é discutida na secção deste manual sobre a escrita de código-fonte. No KDevelop, vem de duas origens: o editor e o motor de processamento. O editor (Kate) é um componente do grande ambiente do KDe e fornece a completação automática com base nas palavras que já tiverem sido vista noutras partes do mesmo documento. Essa completação automática poderá ser identificada na dica pelo ícone que a antecede:

A completação de código do editor poderá ser personalizada com a opção ConfiguraçãoConfigurar o EditorEdiçãoCompletação Automática. Em particular, pode seleccionar quantos caracteres necessita escrever para que a janela de completação automática apareça.

Por outro lado, a completação automática própria do KDevelop é muito mais poderosa, dado que tem em conta a informação semântica acerca do contexto. Por exemplo, sabe que funções-membro deverá oferecer quando escrever objecto., etc., como demonstrado acima:

Esta informação de contexto vem de vários 'plugins' de suporte às linguagens, os quais poderão ser utilizados depois de um dado ficheiro ter sido gravado (para que possa então verificar o tipo de ficheiro e usar o suporte da linguagem correcto).

A completação do KDevelop está configurada para aparecer assim que escrever, praticamente em todo o lado onde seja possível completar algo. Isto é configurável na opção ConfiguraçãoConfigurar o KDevelopSuporte à Linguagem. Se não estiver já definido (como deveria, por omissão), certifique-se que a opção Activar a Invocação Automática está activa.

O KDevelop tem duas formas de mostrar uma completação: a Completação Automática Mínima mostra apenas a informação básica nas dicas de completação (isto é o espaço de nomes, a classe, função ou variável). Isto será semelhante à completação do Kate (exceptuando os ícones).

Por outro lado, a Completação total irá também mostrar o tipo de cada item e, no caso das funções, também os argumentos que recebem. Do mesmo modo, se estiver a preencher de momento os argumentos de uma função, a completação total irá ter uma área informativa adicional sobre o cursor que lhe mostrará o argumento actual com que está a lidar.

A completação de código do KDevelop deverá também invocar para o topo e realçar a verde os itens de completação que corresponderem ao tipo esperado, tanto na completação mínima como na total, conhecido como melhores ocorrências.

As três opções possíveis para o nível de completação na janela de configuração são:

  • Sempre a completação mínima: Nunca mostrar a Completação Total

  • Completação automática mínima: Só mostrar a Completação Total quando esta tiver sido invocada manualmente (isto é, quando carregar em Ctrl+Espaço)

  • Sempre a completação total: Mostrar sempre a Completação Total