Propriedades do componente da tela

Os Componentes de tela permitem que os criadores criem diferentes tipos de propriedades para passar valores ou lógica entre o componente e o aplicativo que hospeda o componente. As propriedades são essenciais para a construção de componentes interativos e reutilizáveis.

Pré-requisitos

Este recurso está ativado por padrão para novos aplicativos. Para aplicativos existentes, você precisa ativá-lo nas configurações do aplicativo.

1. Abra o aplicativo de tela para edição no Power Apps Studio. Na barra de comandos, selecione Configurações>Atualizações.

2. Na guia Novo, localize e ative a configuração Propriedades de componente aprimoradas.

Tipos de propriedades

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

1. Propriedades de dados: as propriedades de dados pertencem aos dados, como uma cor ou valor de texto. Uma propriedade de Dados pode ser definida como Entrada ou Saída, que indica se o componente fornece dados ao aplicativo (Saída) ou se o aplicativo fornece dados ao componente (Entrada). As propriedades de Dados são as únicas que participam do fluxo de dados do aplicativo.
2. Propriedades da função: as propriedades da função estão relacionadas à lógica, como realização de cálculos com base em parâmetros específicos ou alteração de textos. Uma propriedade de Função pode ser definida como Entrada ou Saída, que indica se o componente fornece uma função que o aplicativo pode chamar de (Saída) ou se o aplicativo fornece uma função que o componente pode chamar de (Entrada). As propriedades de Função não participam do fluxo de dados de um aplicativo e não podem usar componentes ou variáveis de aplicativo.
3. Propriedades da ação: as propriedades da ação são um tipo de propriedade que lida com lógica e se comporta como uma Função de Saída. Assim, o componente tem a lógica definida, e essa lógica pode usar expressões encadeadas e manipular coleções ou variáveis ("comportamento"). Por exemplo, uma propriedade de Clear()Ação pode fornecer uma funcionalidade que o aplicativo pode chamar para limpar alguns valores no componente ou uma propriedade de Save()Ação que atualiza uma fonte de dados.
4. Propriedades do evento: as propriedades do evento são uma categoria de propriedade que envolve lógica e funciona como uma Função de Entrada. Assim, o aplicativo define a lógica que pode ser chamada pelo componente, e essa lógica pode usar expressões encadeadas e manipular coleções ou variáveis ("comportamento"). Normalmente, os nomes dessas propriedades refletem um evento como OnSelect ou OnChanged.

Propriedade de dados

O uso de uma propriedade de dados é fácil de imaginar. Os controles padrão em aplicativos normalmente têm várias propriedades de dados para definir valores padrão, cor do texto, tamanho, etc. Vejamos um exemplo simples em que você deseja disponibilizar as propriedades de um controle dentro do componente para o aplicativo de hospedagem. Neste exemplo, o componente é chamado de Component1. Coloque um controle deslizante dentro do componente. Adicione uma propriedade Input para especificar a cor do aplicativo de consumo e uma propriedade Output para que o componente possa informar ao aplicativo o valor atual do controle deslizante. Este exemplo pressupõe que o componente tenha um controle Deslizante chamado Slider.

1. No painel de propriedade do componente, selecione Nova propriedade personalizada.
2. No painel Nova propriedade personalizada, insira o nome de exibição Slider Color.
3. Selecione o Tipo de propriedade dos Dados e selecione Definição de propriedade, valor de Entrada.
4. Então, na lista suspensa Tipo de dados selecione Cor.
5. Clique em Criar.

Em seguida, selecione o Slider1Controle deslizante. Encontre sua propriedade ValueFill e, na barra de fórmulas, insira Component1.SliderColor. Component1 é o nome do componente e SliderColor é o nome da propriedade que você adicionou.

Agora, o componente tem uma propriedade SliderColor que pode ser definida no aplicativo de consumo para passar uma cor para o componente e definir a propriedade ValueFill do controle deslizante.

Você também pode fornecer o valor do controle deslizante para o aplicativo de consumo. Para fazer isso, adicione uma propriedade Output.

1. No painel de propriedade do componente, selecione Nova propriedade personalizada.
2. No painel Nova propriedade personalizada, insira o nome de exibição Slider Value.
3. Selecione o Tipo de propriedade dos Dados e selecione Definição de propriedade, valor de Saída.
4. Então, na lista suspensa Tipo de dados selecione Número.
5. Clique em Criar.

Quando uma propriedade de Dados for de Saída, o componente fornece o valor para o aplicativo de consumo. Para definir a fórmula, defina a nova propriedade SliderValue no componente como a propriedade Value do controle deslizante.

1. No painel de propriedade do componente, clique na propriedade Slider Value.
2. na barra de fórmulas, substitua o valor padrão de 100 com a seguinte fórmula: Slider1.Value.

Agora, a propriedade SliderValue do componente reflete o valor do controle deslizante dentro do componente, que o aplicativo de consumo pode ler.

Propriedade de função

Uma propriedade de função contém uma expressão que retorna um valor. Normalmente, a função recebe argumentos que utiliza para calcular o valor a retornar.

Observação

As propriedades de função atualmente não podem acessar variáveis ou valores e propriedades de componentes e não podem acionar o fluxo de dados. Quaisquer valores necessários devem ser passados como argumentos.

Uma função de Saída é uma maneira simples de criar uma função personalizada para Power Apps. O componente que define uma função de Saída com uma expressão que recebe alguns argumentos e retorna um valor. Esta função pode então ser usada em um aplicativo usando o nome do componente (como Component1) chamando Component1.MyFunction(arg1, arg2).

Uma função de Entrada permite que um aplicativo de consumo forneça lógica a um componente, semelhante a um ponteiro de função ou função de retorno de chamada. Por exemplo, se o componente trabalha com nomes de pessoas, ele pode ter uma função de entrada com argumentos firstname e lastname e espera uma cadeia de caracteres de volta. O aplicativo pode definir a expressão de função para retornar $"{firstname} {lastname}" ou $"{lastname}, {firstname}". O componente chama a função que o criador de aplicativos fornece e usa a cadeia de caracteres retornada.

Propriedade de ação

As propriedades de ação são semelhantes às propriedades de função do tipo de Saída, mas permitem fórmulas de efeitos colaterais e encadeamento de expressões. Um componente pode ter uma propriedade de ação nomeada AddRecord que permite que o aplicativo adicione um registro a uma coleção dentro do componente ou uma ação Reset que limpa variáveis ou coleções dentro do componente.

No exemplo anterior do controle deslizante para a propriedade Data, você pode adicionar uma propriedade de ação chamada ResetValue para definir o controle deslizante de volta ao seu valor padrão. Use a fórmula Reset( Slider1 ) para isso. Agora, as instâncias do componente no aplicativo podem chamar Component1.ResetValue() para definir o controle deslizante de volta ao valor padrão.

Propriedade de evento

Muitos controles padrão têm propriedades comuns do tipo Event, que são propriedades de função de comportamento de entrada. OnSelect no controle de botão é um exemplo comum. Um componente pode definir propriedades de evento e chamar esses eventos como uma função. Por exemplo, um componente com um controle de botão pode ter uma propriedade de evento chamada OnButtonClicked. No controle de botão OnSelect, o componente pode chamar sua propriedade Component1.OnButtonClicked(). Um aplicativo de consumo pode definir sua própria lógica para que essa propriedade atue quando o botão dentro do componente é pressionado.

Valores padrão para propriedades ou argumentos

Os valores padrão dão a um argumento ou propriedade um valor se nenhum estiver definido. Isso não faz sentido para alguns tipos de propriedades. Em alguns casos, você pode usar valores padrão para mostrar o esquema esperado para um registro. Ao fornecer um registro padrão, você define o tipo de registro como o esquema esperado.

Por exemplo, uma propriedade Action chamada AddRecord usa um registro para adicionar a uma coleção local. Para mostrar o esquema do registro esperado, adicione um valor padrão para o argumento da propriedade AddRecord.