Partilhar via


elemento de evento

Define uma expressão Power FX que pode ser configurada no Power Apps Studio e, em seguida, acionada dentro do código do componente.

Disponível para

Canvas e aplicativos orientados por modelo

Propriedades

Nome Description Tipo Obrigatório Disponível para
name Nome do evento string Yes Canvas e aplicativos orientados por modelo
display-name-key Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem o nome do evento. string Yes Aplicações de tela
description-key Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem a descrição do evento. string Opcional Aplicações de tela
pfx-default-value O valor de expressão Power Fx padrão fornecido ao componente. Ver comentários Opcional Aplicações de tela

Observações

Use o valor da pfx-default-value propriedade para avaliar eventos e propriedades usando expressões Power Fx em vez de valores padrão estáticos. Você pode usar isso para:

  • Dimensione responsivamente o controle
  • Aceder a conectores
  • Fornecer dados de exemplo
  • Propriedades do tema de referência
  • Eventos personalizados

Observação

  • Você pode usar qualquer expressão Power Fx, mas deve certificar-se de que a expressão é válida ao importar o controle.
  • Se você usar aspas internas ou outros caracteres especiais, envolva o valor em aspas simples, por exemplo: pfx-default-value='"Test"'
  • Você pode fazer referência a outros controles (incluindo telas) e suas propriedades. Escreva estas referências como: %ControlName.ID%.ControlProperty. Por exemplo: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Escreva enums, como DisplayType e ScreenTransition como: %EnumName.RESERVED%.EnumValue. Por exemplo: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Se pfx-default-value estiver incluído, então tem precedência sobre default-value.

Elementos pai

Elemento Description
Controlo Define o namespace, a versão e as informações de exibição do componente.

Example

<event name="OnSelectCustomButton"
   pfx-default-value='SubmitForm(%MyFormName.ID%); Back(%ScreenTransition.RESERVED%.Cover)'
   display-name-key="OnSelectCustomButton_Display_Key"
   description-key="OnSelectCustomButton_Desc_Key" />

Referência de esquema de manifesto da estrutura do componente Power Apps
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps