Os campos de textos têm várias propriedades quer devem ser entendidas para o perfeito funcionamento.
Nome do campo de texto. Este campo deve estar entre colchetes, não possuir espaços e de preferência não ter caracteres com acentuação.
É uma propriedade que é usada para os MSRoutines fazerem referência a este campo. É a propriedade que identifica o campo.
Por isso é importante que este campo tenha um nome com a seguinte sintaxe: NomeDoModeloDeDocumento.NomeDoCampo. Desta forma controla-se que nenhum campo tenha o mesmo nome.
No entanto, às vezes pode ser necessário ter campos com o mesmo nome em documentos diferentes (ou até no mesmo documento) por algum dos seguintes motivos:
Deseja-se que um campo em documentos diferentes use a mesma lista de itens de digitador
Necessita-se que campos alimentados em documentos diferentes possam servir para um mesmo objetivo. Por exemplo: o campo Peso Atual pode estar presente em um documento com função de sinopse. E este campo que tem por objeto simplesmente apresentar o dado, pode estar buscando este valor numa anamnese, numa evolução clínica, num documento para controle de peso e estar trazendo o valor mais recente.
Existem campos que trazem o conteúdo de um campo diretamente do banco de dados. Como existem tipos de campos que têm por objetivo simplesmente servir como um espaço para digitação, existem outros campos que tem por objetivo trazer dados de outras fontes como, no caso, o banco de dados.
Esta propriedade somente estará habilitada quando o campo Tipo do campo estiver definida como Campo de dados.
É efetivamente o conteúdo ou valor do campo que é mostrado no documento.
Este valor pode ser alterado aqui na tela de propriedades ou diretamente no texto.
Ver Tipos de Campos.
Por alguns motivos alguns campos necessitam de uma definição de quando eles devem ser atualizados.
Existem campos que não devem ser atualizados nunca, outros campos necessitam ser atualizados sempre que o documento é aberto e existe situações de diversas peculiaridades.
Veja a seguir as opções que você tem para este campo:
Quando for um documento novo: sempre que um documento novo for criado o campo será atualizado. Depois que o documento tiver sido criado, os campos que tiverem com esta opção não serão mais atualizados. Esta opção é utilizada, por exemplo, no campo Idade Gestacional que é calculada a partir do campo Data da Última Menstruação. Depois que foi calculada, não precisa mais ser recalculada, a não ser que o campo Data da Última Menstruação tiver seu valor mudado.
Sempre: os campos que tiverem com esta opção serão sempre atualizados, tanto quando eles forem criados como a cada vez que eles forem abertos novamente. Este campo pode ser usado, por exemplo, em um campo do tipo Dia do Ciclo Menstrual em um laudo de controle de ovulação em que o mesmo laudo é emitido após uma série de várias ecografias e a cada vez que a paciente vem no serviço de ecografia para uma nova avaliação da série, este campo necessita ser recalculado.
Pergunte-me: este opção não vai atualizar e nem deixar de atualizar. Esta opção vai abrir uma tela de diálogo com o usuário a fim de permitir que o usuário decida o que é melhor. Será apresentada para o usuário uma tela com a lista de todos os campos que tiverem com esta opção na propriedade Atualizar valor quando. O usuário vai assinalar os campos que ele necessita atualização e vai deixar sem assinar os que ele não quer que sejam atualizados. Além disso, a opção que o usuário assinalou para cada campo virá como padrão na próxima vez que ele abrir o documento. Este campo pode ser usado, por exemplo, em um campo do tipo Dia do Ciclo Menstrual em um laudo de controle de ovulação em que o mesmo laudo é emitido após uma série de várias ecografias e a cada vez que a paciente vem no serviço de ecografia para uma nova avaliação da série, este campo necessita ser recalculado. No entanto, ao final da série, talvez o usuário não queira mais que o campo seja atualizado e então ele assinala o campo Dia do Ciclo para não ser mais atualizado. Se o laudo for aberto um ano depois para revisão, o campo Dia do Ciclo vai vir na lista de campos para serem atualizados porém com a valor padrão desmarcado (ou seja, para não atualizar mais)
Texto usado para descrever o campo de uma forma mais detalhada.
Esta propriedade além de servir para esclarecimento durante o desenvolvimento do modelo de documento, também é mostrada na barra de status no documento durante a fase de criação e edição do mesmo.
É uma propriedade sem uma função específica.
É utilizada para funções variadas dependendo de uma determinada circunstância.
Veja tabela abaixo para as situações que usam este campo:
|
Campo |
Descrição |
|
Foto do cliente |
Quando você insere um campo do tipo foto do cliente através do Control + N, algumas vezes esta foto (dependendo com que resolução foi capturada) tem um tamanho muito grande ou muito pequeno; para aumentar o tamanho da imagem o campo deve ser editado e na propriedade TAG usar PorcentagemHorizontal,PorcentagemVertical Por exemplo, se você deseja aumentar o tamanho da foto para 200%, digite 200,200 no campo TAG; se desejar diminuir para a metade, digite 50,50. |
Quando esta opção estiver assinalada o campo de texto no documento torna-se editável. Caso contrário ao se tentar digitar alguma coisa no campo de texto, as teclas digitadas não terão efeitos pois o campo não esta aberto para digitação.
Esta opção é utilizada, por exemplo, em situações que se deseje que um campo somente possa ser atualizado por MSRoutines.
Quando esta opção estiver assinalada o campo pode ser deletado da mesma forma que qualquer outro texto no documento. Quando esta opção estiver desmarcada o campo não pode ser deletado.
Caso você selecione um texto e dentro da seleção houver algum campo que está marcado para não permitir deleção, ao se tentar excluir o texto da seleção com a tecla Del ou com o comando Excluir do menu de contexto dos documentos, a ação não terá efeito e nenhum e nada do que estiver dentro da seleção será excluído, nem mesmo as partes do texto que permitiriam a deleção.
Quando se navega (ver Navegando campos de texto) pelos campos através do F2 (retroceder para o campo de texto anterior) e F3 (avançar para o próximo campo de texto) é possível marcar alguns campos para que sejam desconsiderados durante a navegação. Para que o foco pare nos campos de texto com as teclas de navegação, assinale esta opção; para que o foco não pare em determinado campo quando estiver usando as teclas de navegação, desmarque esta opção.
Os campos de texto dentro de um documento têm, a princípio, somente a função de reservar uma parte do texto para que se possa saltar para este local e para que se coloque um tipo de texto já esperado (ver campos de texto). Estes campos são salvos dentro do documento mas não tem como se acessar o valor destes campos a não ser que se abra o documento. Para isso existe esta opção Salvar Campo no Banco de Dados. Com esta propriedade o valor do campo, além de ser salvo juntamente com o documento, também será salvo em uma tabela própria do banco de dados chamada TXTextValues.
Sempre que um campo é alterado um evento chamado FieldChanged (campo alterado) será disparado. No procedimento de evento que é onde se decide o que fazer com esta situação o programador ou até mesmo o usuário pode escrever algumas linhas de código para fazer alguma ação.
Além disso, quando houver outros campos que necessitam do valor deste campo para fazer algum cálculo, somente tomarão conhecimento de que o campo foi alterado através de uma notificação enviada pelo evento FieldChanged.
A maioria dos campos não necessita disparar este evento e além do mais se cada campo disparar este evento haverá um comprometimento importante da performance do sistema. Para resolver esta situação o MedSoft® disponibiliza esta propriedade para que o evento FieldChanged seja disparado somente quando for necessário.
Ver também eventos dos documentos.