Propriedades especiais

Concluído

Os formulários têm algumas propriedades ignoradas e operadores nomeados. Esta seção abordará quando e como usar a propriedade Error, a propriedade Unsaved, o operador nomeado ThisItem e o operador nomeado Parent.

Propriedade Error

A propriedade Error contém a saída de todas as mensagens de erro que são geradas pelo controle Form. Para exibir o conteúdo da propriedade, adicione um controle Text label à tela e, em seguida, para a propriedade Texto, insira a fórmula Form1.Error. Ela ficará em branco se não houver erros. No entanto, se você tentar enviar um formulário sem inserir todas as colunas necessárias, verá uma mensagem como "É obrigatória uma entrada ou tem um valor inválido. Corrija e tente novamente." Você pode usar esse valor em fórmulas ou outros controles para projetar o tratamento de erros de seus aplicativos.

Propriedade Unsaved

A propriedade Unsaved é uma propriedade booliana que surge quando um formulário é editado, mas não enviado. Você pode usar essa propriedade para verificar se o usuário tem uma alteração que não foi salva. Um exemplo disso é para configurar o botão "Voltar" no aplicativo para verificar se o formulário não foi salvo. Se houver dados que não foram salvos, não é para navegar. Para fazer isso, você pode usar a seguinte fórmula na propriedade OnSelect de um controle Botão.

If(YourFormName.Unsaved = false, Navigate(WelcomeScreen, ScreenTransition.Cover))

Essa função verifica se o controle Formulário chamado YourFormName tem false na propriedade Unsaved. Se a propriedade for false, ela levará o usuário para a tela chamada WelcomeScreen. Se a propriedade for true, nada acontecerá. No aplicativo, você pode expandir esse conceito para adicionar uma mensagem de aviso ou até uma caixa pop-up informando ao usuário o motivo pelo qual ele não pode sair da página.

Além dessas propriedades, o controle Form inclui os operadores nomeados, ThisItem e Parent, como o controle Galeria.

Operador nomeado ThisItem

No controle Formulário ou Galeria, você pode fazer referência aos valores do registro atual usando ThisItem. Isso é útil quando você está criando fórmulas manualmente para fazer referência aos valores do registro. Por exemplo, se você quiser adicionar um rótulo que combine as colunas Nome e Sobrenome em uma cadeia de caracteres com um espaço no meio, use a fórmula a seguir.

ThisItem.FirstName & " " & ThisItem.LastName

Essa fórmula pressupõe que você tenha uma coluna chamada FirstName e uma coluna chamada LastName para o registro que está sendo exibido no controle Form.

Operador nomeado Parent

Nos controles Formulário e Galeria, há o conceito de um objeto pai. No caso de Input ou de outro controle em um controle Form, você pode extrair uma propriedade do cartão de dados usando Parent e o nome da propriedade à qual você gostaria de fazer referência. O valor padrão é um exemplo. Os cartões de dados armazenam esse valor na propriedade Default. De um controle Entrada, você pode fazer referência a esse valor com a fórmula Parent.Default no valor Default do controle Entrada. As galerias têm o mesmo conceito de Pai para consultar as propriedades do controle Galeria nos controles da galeria.