Propietats del component del llenç (experimental)

Els components del llenç permeten als fabricants crear diferents tipus de propietats per transmetre valors o lògica entre el component i l'aplicació que allotja el component. Les propietats són una part essencial de la creació de components interactius i reutilitzables.

Important

• Això és una característica experimental.
• Les característiques experimentals no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris. Més informació: Característiques experimentals i de visualització prèvia
• El comportament que descriu aquest article només està disponible quan la característica experimental Propietats dels components millorades a Configuració > Properes característiques > Experimental està activada (desactivada per defecte).
• Els vostres comentaris són molt valuosos per a nosaltres: feu-nos saber què en penseu al fòrum de la comunitat de Power Apps funcions experimentals.

Tipus d'immobles

Hi ha quatre tipus de propietats disponibles per als fabricants:

1. Propietats de les dades: les propietats de les dades pertanyen a les dades, com ara un color o un valor de text. Una propietat de dades es pot definir com a Entrada o Sortida, que indica si el component proporciona dades a l'aplicació (Sortida) o si l'aplicació proporciona dades al component (Entrada ·). Les propietats de les dades són les úniques propietats que participen en el flux de dades de l'aplicació.
2. Propietats de la funció: les propietats de la funció estan relacionades amb la lògica, com ara realitzar un càlcul basat en paràmetres específics o alterar text. Una propietat Function es pot definir com Entrada o Sortida, que indica si el component proporciona una funció que l'aplicació pot cridar (Sortida ) o l'aplicació proporciona una funció que el component pot cridar ( Entrada). Les propietats de funció no participen en el flux de dades d'una aplicació i no poden utilitzar variables de component ni d'aplicació.
3. Propietats d'acció: Les propietats d'acció són un tipus de propietat que s'ocupa de la lògica i es comporta com una funció de sortida. Així, el component té la lògica definida, i aquesta lògica pot utilitzar expressions encadenades i manipular col·leccions o variables ("comportament"). Per exemple, una propietat Action pot proporcionar funcionalitats que l'aplicació pot cridar per esborrar alguns valors del component o una propietat Action Clear() que actualitzi una Save() font de dades.
4. Propietats d'esdeveniment: Les propietats d'esdeveniment són una categoria de propietat que implica lògica i funciona com una funció d'entrada. Així, l'aplicació defineix la lògica, que el component pot cridar i que la lògica pot utilitzar expressions encadenades i manipular col·leccions o variables ("comportament"). Normalment, els noms d'aquestes propietats reflecteixen un esdeveniment com OnSelect ara o OnChanged.

Propietat de les dades

L'ús d'una propietat de dades és fàcil d'imaginar. Els controls estàndard de les aplicacions solen tenir diverses propietats de dades, per establir els valors predeterminats, el color del text, la mida, etc. Vegem un exemple senzill on volem posar a disposició de l'aplicació d'allotjament propietats d'un control dins del component. En aquest exemple, s'anomena Component1 el nostre component. Posarem un control lliscant dins del nostre component. Tindrem una propietat Entrada per especificar el color de l'aplicació que consumeix i una propietat Sortida on el component pot indicar a l'aplicació quin és el valor actual del control lliscant. L'exemple següent assumeix que el vostre component conté un control lliscant anomenat Slider. Slider

1. A la subfinestra de propietats del component, seleccioneu Propietat personalitzada nova.
2. A la subfinestra Nova propietat personalitzada, introduïu el nom de visualització Slider Color.
3. Seleccioneu Tipus de propietat de Dades i seleccioneu Valor de definició de propietat Entrada.
4. Finalment, al menú desplegable Tipus de dades, seleccioneu Color.
5. Feu clic a Crea.

A continuació, seleccioneu el Slider1 control lliscant . Cerqueu la propietat ValueFill i, a la barra de fórmules, introduïu-la. Component1.SliderColor Component1 fa referència al nom del nostre component, i SliderColor és el nom de la propietat que hem afegit anteriorment.

Ara el nostre component té una SliderColor propietat que es pot establir a l'aplicació que consumeix, per passar un color al component per establir la propietat ValueFill del control lliscant.

També volem aportar el valor del control lliscant a l'aplicació que consumeix. Per aconseguir-ho, afegirem una propietat Output .

1. A la subfinestra de propietats del component, seleccioneu Propietat personalitzada nova.
2. A la subfinestra Nova propietat personalitzada, introduïu el nom de visualització Slider Value.
3. Seleccioneu Tipus de propietat de Dades i seleccioneu Valor de definició de propietat Sortida.
4. Finalment, al menú desplegable Tipus de dades, seleccioneu Número.
5. Feu clic a Crea.

Quan una propietat de dades és Sortida, el component proporciona el valor a l'aplicació que consumeix. Per establir la fórmula per a això, hem d'establir la nova SliderValue propietat en el component a la propietat Valor del control lliscant.

1. A la subfinestra de propietats del component, feu clic a la Slider Value propietat.
2. A la barra de fórmules, substituïu el valor per defecte de 100 per la fórmula següent: Slider1.Value.

Ara la SliderValue propietat del nostre component reflectirà el valor del control lliscant dins del component, que després es pot llegir des de l'aplicació que consumeix.

Propietat de la funció

Una propietat de funció conté una expressió que retorna un valor. Normalment, la funció pren alguns arguments que utilitza per calcular o determinar el valor a retornar.

Nota

Actualment, les propietats de la funció no poden accedir a variables o valors i propietats dels components, i no poden activar el flux de dades. Els valors requerits s'han de passar com a arguments.

Una funció de sortida és una manera senzilla de crear una funció personalitzada per a Power Apps. El component defineix una funció de sortida amb una expressió que pren alguns arguments i retorna un valor. Aquesta funció es pot utilitzar en una aplicació utilitzant el nom del component (per exemple Component1) trucant Component1.MyFunction(arg1, arg2).

Una funció d'entrada és una manera que té una aplicació consumidora de proporcionar lògica a un component, similar a una funció de punter o de devolució de trucada. Per exemple, el vostre component pot estar tractant amb noms de persones i tenir una funció d'entrada amb arguments firstname i lastname respecta una cadena. L'aplicació podria definir l'expressió de la funció a retornar $"{firstname} {lastname}" , o podria optar per definir una expressió per a $"{lastname}, {firstname}". El component només pot trucar a la funció que ha proporcionat el creador de l'aplicació i utilitzar la cadena retornada.

Propietat de l'acció

Les propietats d'acció són similars a les propietats de funció del tipus Output, però permeten fórmules d'efecte secundari i encadenament d'expressions. Un component pot tenir una propietat d'acció anomenada AddRecord que permet a l'aplicació afegir un registre a una col·lecció dins del component o una Reset acció que esborra variables o col·leccions dins del component.

En l'exemple dels exemples lliscants utilitzats per a la propietat Data anteriors, podem introduir una propietat action cridada ResetValue a definir el control lliscant al seu valor per defecte. Podem utilitzar la fórmula Reset( Slider1 ) per a això. Ara, les instàncies del nostre component a l'aplicació poden trucar Component1.ResetValue() per tornar a configurar el control lliscant al valor predeterminat.

Propietat de l'esdeveniment

Hi ha moltes propietats comunes de tipus esdeveniment, efectivament propietats de funció de comportament d'entrada, en controls estàndard. OnSelect al control del botó és l'exemple més evident. Un component podria definir qualsevol nombre de propietats d'esdeveniment i anomenar aquests esdeveniments com una funció. Per exemple, un component que té un control botó podria tenir una propietat d'esdeveniment anomenada OnButtonClicked. Al control OnSelect del botó, el component pot cridar la seva Component1.OnButtonClicked() propietat. Una aplicació consumidora pot definir la seva pròpia lògica per a aquesta propietat, per actuar quan es prem el botó dins del component.

Valors per defecte per a propietats o arguments

Els valors per defecte poden proporcionar un valor per defecte per a un argument o propietat en cas que no n'hi hagi cap. Això no té sentit per a alguns tipus de propietats. No obstant això, en alguns casos es poden utilitzar per proporcionar un esquema esperat per a un registre. En proporcionar un registre per defecte, s'estableix un tipus de registre com a esquema esperat.

Per exemple, una propietat Action anomenada accepta un registre que s'afegirà a una AddRecord col·lecció local. Per proporcionar l'esquema del registre esperat, un creador ha d'afegir un valor per defecte per a l'argument d'aquesta AddRecord propietat.