01/12/2024

5.2

# Widgets

O &kmymoney; possui alguns elementos específicos que não são encontrados nas outras aplicações. A utilização destes itens é explicada neste capítulo.

## Elemento de entrada de data e seletor de data

Sempre que o &kmymoney; precisar de informações sobre uma data específica, ⪚, a data de lançamento de uma transação ou a data de abertura de uma conta, ele oferece ao usuário o widget de entrada de data. Este widget consiste em três campos, que apresentam o dia, o mês e o ano, separados pelos caracteres separadores de data especificados pelas suas configurações de localidade. Se você clicar na seta para baixo ao lado da data, o programa abrirá o widget de seleção de data.

Widget de data Widget de data

Dentro do widget de entrada de data, as teclas de cursor &Left;/&Right; podem ser usadas para alternar entre os campos de dia, mês e ano. Usando as teclas de cursor &Up;/&Down;, o valor do campo selecionado pode ser incrementado/decrementado. As teclas + ou = e - podem ser usadas para incrementar/decrementar um único dia. As teclas ] ou } e [ ou { podem ser usadas para incrementar/decrementar um único mês. As teclas ' ou " e ; ou : podem ser usadas para incrementar/decrementar um único ano. Os limites de mês e ano são considerados e incrementados/decrementados, se necessário; por exemplo, usar + para incrementar a data de 31 de janeiro a alterará para 1º de fevereiro.

Os seguintes atalhos adicionais também podem ser usados:

- M para definir a data para o primeiro dia do mês atual

- H para definir a data para o último dia do mês atual

- Y para definir a data para o primeiro dia do ano atual

- R para definir a data para o último dia do ano atual

- T para definir a data para a data de hoje

A data também pode ser alterada usando o mouse. Clicar no campo dia, mês ou ano seleciona o campo. O valor pode então ser incrementado/decrementado usando as teclas de cursor &Up;/&Down;. Além disso, se você usar as teclas de cursor &Right;/&Left;, ao passar para um campo diferente, o campo inteiro será selecionado e você poderá simplesmente digitar o novo valor para esse campo.

O widget de seleção de data mostra o mês, o nome e o ano selecionados. Acima, há quatro botões de seta, dois de cada lado do mês e do ano exibidos. Os botões mais à esquerda são usados ​​para diminuir o ano e o mês; os botões à direita do ano são usados ​​para aumentar o mês e o ano. O botão mais à direita fecha o seletor de data.

Abaixo dos botões, o item apresenta uma página de calendário para o mês respectivo. Clicar num dia do mês selecionado, irá selecionar essa data, fechar o seletor de datas e transferir a data selecionada para os campos do dia, mês ou ano.

No fundo do item, os usuário poderão encontrar um botão, um campo de edição de texto e uma lista. Clicar no botão, irá selecionar a data de hoje no seletor, enquanto o campo de texto poderá ser usado para inserir uma data específica. Pressionar a tecla &Enter;, irá mostrar essa data no item de seleção de datas. A lista permite ao usuário selecionar uma semana específica, podendo selecionar uma data a partir daí.

Caso seja inserida uma data inválida, o seletor de datas exibirá uma moldura vermelha, e uma dica de ferramenta mostrará detalhes sobre o erro.

## Inserção de valores

O item de inserção de valores consiste num campo de texto (que aceita números, separadores de milhares e separadores decimais), assim como um botão à direita. Use os números para inserir o valor. Separe a parte fracionária, inserindo para isso o separador decimal para a sua região. Ao clicar no botão à direita ou pressionar uma tecla que representa uma operação numérica (⪚, +, -, /, * ou %), irá aparecer uma pequena calculadora que lhe permite calcular o valor final.

Você poderá inserir valores negativos, antecedendo o valor com um sinal '-' (menos). No caso de a sua configuração regional definir que os números negativos devem aparecer entre parênteses, o valor também poderá ser envolvido com parênteses no campo de inserção do valor.

Widget de valor Widget de valor

Use o item da calculadora como se fosse uma calculadora normal, assim que terminar, deixe-a ao clicar no botão = ou pressione a tecla = do seu teclado.

## Item de Pagador/Beneficiário

O widget para inserir um Beneficiário/Pagador é muito semelhante a uma caixa de combinação típica - mas possui alguns recursos adicionais.

Widget do beneficiário Widget do beneficiário

Quando for solicitado que você insira um beneficiário/pagador para uma transação, você pode começar a digitar o nome pressionando as teclas do seu teclado. Contanto que haja entradas na lista de beneficiários/pagadores mantida pelo &kmymoney; que correspondam aos caracteres digitados, elas serão apresentadas em uma caixa abaixo ou acima da área de entrada de texto. Usando o mouse ou as teclas &Up;/&Down;, você pode selecionar um nome dessa lista. Usar o teclado também exige que você selecione a entrada pressionando a tecla &Enter;. Clicar no X à direita da área de entrada limpa o campo. Clicar na seta para baixo à direita do X exibe a lista completa de possíveis beneficiários/pagadores.

Se for inserido um nome que não seja conhecido do &kmymoney; será questionado se deseja criar ou não um registro novo de pagador/beneficiário. Se não quiser fazer isso, então o campo ficará em branco. Caso contrário, será criado o registro e adicionado à lista.

## Entrada de categoria/conta

O campo para inserir uma Categoria ou Conta é muito semelhante ao descrito acima para Beneficiários/Pagadores.

Widget de categoria Widget de categoria

À direita do campo de entrada, entre o X para limpá-lo e a seta para baixo para exibir a lista completa, há um ícone de divisão que abre o Editor de divisão