Propriedades de componentes de tela

Os componentes de tela permitem aos criadores criarem diferentes tipos de propriedades para transmitir valores ou lógica entre o componente e a aplicação que aloja o componente. As propriedades são essenciais para criar componentes interativos e reutilizáveis.

Pré-requisitos

Por predefinição, esta caraterística está ativada para novas aplicações. Para as aplicações existentes, precisa de ativá-la nas definições da sua aplicação.

1. Abra a sua aplicação de tela para edição no Power Apps Studio. Na barra de comandos, selecione Definições>Atualizações.

2. No separador Novo, localize e ative a definição Propriedades de componente avançadas.

Tipos de propriedades

Existem quatro tipos de propriedades disponíveis para os criadores.

1. Propriedades de dados: as propriedades de dados pertencem a dados, tal como uma cor ou um valor de texto. É possível definir uma propriedade Data como Entrada ou Saída, o que indica se o componente fornece dados à aplicação (Saída) ou se a aplicação fornece dados ao componente (Entrada). As propriedades Data são as únicas propriedades que participam no fluxo de dados da aplicação.
2. Propriedades da função: as propriedades da função estão relacionadas com a lógica, tal como e execução de um cálculo com base em parâmetros específicos ou alteração de texto. É possível definir uma propriedade Function como Entrada ou Saída, o que indica se o componente fornece uma função à aplicação pode chamar (Saída) ou se a aplicação fornece uma função ao componente pode chamar (Entrada). As propriedadesFunction não participam no fluxo de dados de uma aplicação e não podem utilizar variáveis de componentes ou aplicações.
3. Propriedades da ação: as propriedades da ação são um tipo de propriedade que aborda a lógica e comporta-se como uma OutputFunction. Assim, o componente tem a lógica definida, pelo que essa lógica pode utilizar expressões encadeadas e manipular coleções ou variáveis ("comportamento"). Por exemplo, uma propriedade Clear()Action pode fornecer uma funcionalidade que a aplicação pode chamar para limpar alguns valores no componente, ou uma propriedade Save()Action que atualiza uma origem de dados.
4. Propriedades do evento: as propriedades do evento são uma categoria de propriedade que envolve lógica e funções como uma InputFunction. Assim, a aplicação define a lógica, que o componente pode chamar e essa lógica pode utilizar expressões encadeadas e manipular coleções ou variáveis ("comportamento"). Normalmente, os nomes destas propriedades refletem um evento, tal como OnSelect ou OnChanged.

Propriedade de dados

A utilização de uma propriedade de dados é fácil de imaginar. Normalmente, os controlos padrão nas aplicações têm várias propriedades de dados para predefinir os valores, a cor do texto, o tamanho, etc. Vejamos um exemplo simples onde pretende disponibilizar propriedades de um controlo dentro do componente para a aplicação de alojamento. Neste exemplo, o componente chama-se Component1. Coloque um controlo de deslize dentro do componente. Adicione uma propriedade de Entrada para especificar a cor da aplicação de consumo e uma propriedade de Saída para que o componente possa dizer à aplicação o valor atual do controlo de deslize. Este exemplo pressupõe que o componente tem um controlo de Deslize chamado Slider.

1. No painel de propriedade do componente, selecione Nova propriedade personalizada.
2. No painel Nova propriedade personalizada, introduza o nome a apresentar Slider Color.
3. Selecione Tipo de propriedadeDados e selecione o valor Definições de propriedadeInput.
4. Finalmente, a partir do menu pendente Tipo de dados, selecione Cor.
5. Clique em Criar.

Em seguida, selecione o controlo Slider1Controlo de deslize. Localize a propriedade ValueFill e, na barra de fórmulas, introduza Component1.SliderColor. Component1 é o nome do componente e SliderColor é o nome da propriedade que adicionou.

Agora, o componente tem uma propriedade SliderColor que pode ser definida na aplicação de consumo para transmitir uma cor no componente e definir a propriedade ValueFill do controlo de deslize.

Também pode querer fornecer o valor do controlo de deslize para a aplicação consumidora. Para isso, adicione uma propriedade de Saída.

1. No painel de propriedade do componente, selecione Nova propriedade personalizada.
2. No painel Nova propriedade personalizada, introduza o nome a apresentar Slider Value.
3. Selecione Tipo de propriedadeDados e selecione o valor Definições de propriedadeOutput.
4. Finalmente, a partir do menu pendente Tipo de dados, selecione Número.
5. Clique em Criar.

Quando uma propriedade Data é Output, o componente fornece o valor à aplicação que consome. Para definir a fórmula, defina a nova propriedade SliderValue no componente como a propriedade Value do controlo de deslize.

1. No painel de propriedade do componente, clique na propriedade Slider Value.
2. Na barra de fórmulas à direita, substitua o valor predefinido de 100 pela seguinte fórmula: Slider1.Value.

Agora, a propriedade SliderValue do componente reflete o valor do controlo de deslize dentro do componente, o qual a aplicação consumidora pode ler.

Propriedade Function

A propriedade Function contém uma expressão que devolve um valor. Normalmente, a função pega em argumentos que usa para calcular o valor a devolver.

Uma função Output é uma forma simples de criar uma função personalizada para o Power Apps. O componente define uma função Output com uma expressão que aceita alguns argumentos e devolve um valor. Esta função pode, em seguida, ser utilizada numa aplicação utilizando o nome do componente (digamos Component1) ao chamar Component1.MyFunction(arg1, arg2).

Uma função de Entrada permite que uma aplicação de consumo forneça lógica a um componente, semelhante a uma função de ponteiro ou função de chamada de retorno. Por exemplo, se o componente trabalhar com os nomes de pessoas, pode ter uma função de entrada com argumentos firstname e lastname e esperar uma cadeia de volta. A aplicação pode definir a expressão da função para devolver $"{firstname} {lastname}" ou $"{lastname}, {firstname}". O componente chama a função que o criador de aplicações fornece e usa a cadeia devolvida.

Propriedade Action

As propriedades de ação são semelhantes às propriedades de função do tipo Output, mas permitem fórmulas de efeitos laterais e encadeamento de expressões. O componente pode ter uma propriedade de ação chamada AddRecord que permite que a aplicação adicione um registo a uma coleção dentro do componente, ou uma ação Reset que limpa variáveis ou coleções dentro do componente.

No exemplo de controlo de deslize anterior para a propriedade de Dados, pode adicionar uma propriedade de ação chamada ResetValue para definir o controlo de deslize de volta para o valor predefinido. Para tal, utilize a fórmula Reset( Slider1 ): Agora, as instâncias do componente na aplicação podem chamar Component1.ResetValue() para definir o controlo de deslize de volta para o valor predefinido.

Propriedade Event

Muitos controlos padrão têm propriedades do tipo Evento comuns, que são propriedades de função de comportamento de entrada. OnSelect no controlo de botão é um exemplo comum. Um componente pode definir propriedades de evento e chamar esses eventos como função. Por exemplo, um componente com um controlo de botão pode ter uma propriedade de evento chamada OnButtonClicked. No controlo de botão OnSelect, o componente pode chamar a respetiva propriedade Component1.OnButtonClicked(). Uma aplicação consumidora pode definir a sua própria lógica para esta propriedade para agir quando o botão dentro do componente é pressionado.

Valores predefinidos para propriedades ou argumentos

Os valores predefinidos dão um valor a um argumento ou propriedade se nenhum estiver definido. Isto não faz sentido para alguns tipos de propriedades. Em alguns casos, pode usar os valores predefinidos para mostrar o esquema esperado para um registo. Ao fornecer um registo predefinido, define o tipo de registo como o esquema esperado.

Por exemplo, uma propriedade de Ação chamada AddRecord pega num registo para adicionar a uma coleção local. Para mostrar o esquema do registo esperado, adicione um valor predefinido ao argumento AddRecord da propriedade.