Propiedades dos compoñentes do lenzo (experimental)

Os compoñentes do lenzo permiten aos fabricantes crear diferentes tipos de propiedades para transmitir valores ou lóxica entre o compoñente ea aplicación que alberga o compoñente. As propiedades son unha parte esencial da creación de compoñentes interactivos e reutilizables.

Tipos de propiedades

Existen catro tipos de propiedades dispoñibles para os fabricantes:

1. Propiedades dos datos: As propiedades dos datos pertencen aos datos, como unha cor ou un valor de texto. Unha propiedade de datos pode establecerse como Entrada ou Saída, que indica se o compoñente proporciona datos á aplicación (Saída ·) ou a aplicación proporciona datos ao compoñente (Entrada ·). As propiedades dos datos son as únicas propiedades que participan no fluxo de datos das aplicacións.
2. Propiedades da función: As propiedades da función están relacionadas coa lóxica, como realizar un cálculo baseado en parámetros específicos ou alterar texto. Unha propiedade da función pode definirse como Entrada ou saída , que indica se o compoñente proporciona unha función que a aplicación pode chamar (Saída), ou a aplicación proporciona unha función que o compoñente pode chamar (Entrada ·). As propiedades da función non participan no fluxo de datos dunha aplicación, e non poden usar compoñentes ou variables de aplicacións.
3. Propiedades de acción: As propiedades de acción son un tipo de propiedade que se ocupa da lóxica e compórtase como unha función de saída. Así, o compoñente ten a lóxica definida, e que a lóxica pode utilizar expresións encadeadas e manipular coleccións ou variables ("comportamento"). Por exemplo, unha propiedade de Acción podería proporcionar funcionalidade que a aplicación pode chamar para eliminar algúns valores no compoñente, ou unha propiedade de Acción Clear() que actualiza unha fonte de Save() datos.
4. Propiedades de eventos: As propiedades dos eventos son unha categoría de propiedade que implica lóxica e funcións como función de entrada. Así, a aplicación define a lóxica, que o compoñente pode chamar e que a lóxica pode usar expresións encadeadas e manipular coleccións ou variables ("comportamento"). Tipicamente os nomes destas propiedades reflicten un evento como OnSelect ou OnChanged.

Propiedade de datos

O uso dunha propiedade de datos é fácil de imaxinar. Os controis estándar nas aplicacións normalmente teñen varias propiedades de datos, para definir valores predefinidos, cor do texto, tamaño, etc. Vexamos un exemplo sinxelo onde queremos facer propiedades dun control dentro do compoñente dispoñible para a aplicación de hospedaxe. Neste exemplo, o noso compoñente leva o nome Component1. Poñeremos un control deslizante dentro do noso compoñente. Teremos unha propiedade de Entrada para especificar a cor da aplicación consumidora, e unha propiedade de Saída onde o compoñente pode indicar á aplicación cal é o valor actual do deslizador. O seguinte exemplo asume que o seu compoñente contén un control deslizante nomeado Slider.

1. No panel de propiedade do compoñente, selecciona Nova propiedade personalizada.
2. No novo panel de propiedades personalizadas, introduza nome de Slider Color visualización.
3. Seleccione Tipo de propiedade de Datos e seleccione Valor de definición de propiedade Entrada.
4. Finalmente, a partir da caída do tipo de datos, seleccione Cor.
5. Prema Crear.

A continuación, seleccione o Slider1 control deslizante . Atopa a súa propiedade ValueFill e na barra de fórmulas, entra Component1.SliderColor. Component1 Refírese ao nome do noso compoñente, e SliderColor é o nome da propiedade que engadimos anteriormente.

Agora o noso compoñente ten unha propiedade que se pode configurar na aplicación consumida, para pasar unha SliderColor cor ao compoñente para configurar a propiedade ValueFill do deslizador.

Tamén queremos achegar o valor do deslizador á aplicación consumidora. Para logralo, engadiremos unha propiedade de Saída .

1. No panel de propiedade do compoñente, selecciona Nova propiedade personalizada.
2. No novo panel de propiedades personalizadas, introduza nome de visualización Slider Value.
3. Seleccione Tipo de propiedade de Datos e seleccione Saída de valor de definición de propiedade.
4. Finalmente, a partir da caída do tipo de datos, seleccione Número.
5. Prema Crear.

Cando unha propiedade de datos é Output, o compoñente proporciona o valor á aplicación consumida. Para establecer a fórmula para iso, necesitamos establecer a nova SliderValue propiedade no compoñente á propiedade de valor do deslizador.

1. No panel de propiedade do compoñente, fai clic na Slider Value propiedade.
2. Na barra de fórmulas, substitúe o valor predeterminado da 100 seguinte fórmula: Slider1.Value

Agora a propiedade do noso compoñente reflectirá o valor do deslizador dentro do compoñente, que logo se pode ler desde a SliderValue aplicación consumida.

Propiedade da función

Unha propiedade da función contén unha expresión que devolve un valor. Normalmente, a función toma algúns argumentos que utiliza para calcular ou determinar o valor a devolver.

Unha función de saída é un xeito sinxelo de crear unha función Power Apps personalizada. O compoñente define unha función de saída cunha expresión que toma algúns argumentos e devolve un valor. Esta función pode entón usarse nunha aplicación usando o nome do compoñente (digamos Component1) chamando Component1.MyFunction(arg1, arg2).

Unha función de entrada é un xeito de que unha aplicación consumida proporcione lóxica a un compoñente, similar a un punteiro de función ou función de retorno. Por exemplo, o seu compoñente pode estar a tratar cos nomes das persoas e ter unha función de entrada con argumentos firstname e lastname respectar unha cadea de volta. A aplicación podería definir a expresión da función para devolver $"{firstname} {lastname}" ou podería optar por definir unha expresión para $"{lastname}, {firstname}". O compoñente só pode chamar á función que proporcionou o fabricante de aplicacións e usar a cadea devolta.

Propiedade de acción

As propiedades de acción son similares ás propiedades de función do tipo Output, pero permiten fórmulas de efecto secundario e encadeamento de expresión. Un compoñente podería ter unha propiedade de acción chamada AddRecord que permite á aplicación engadir un rexistro a unha colección dentro do compoñente, ou unha Reset acción que despexa variables ou coleccións dentro do compoñente.

No exemplo dos exemplos deslizantes utilizados para a propiedade de datos antes, podemos introducir unha propiedade de acción chamada a ResetValue configurar o deslizador de volta ao seu valor predeterminado. Podemos usar a fórmula Reset( Slider1 ) para iso. Agora, os casos do noso compoñente na aplicación poden chamar Component1.ResetValue() para configurar o deslizador de volta ao valor predeterminado.

Propiedade de eventos

Hai moitas propiedades comúns de tipo evento, propiedades efectivamente de función do comportamento de entrada, en controis estándar. OnSelect no control do botón é o exemplo máis obvio. Un compoñente podería definir calquera número de propiedades do evento e chamar a estes eventos como unha función. Por exemplo, un compoñente que teña un control de botóns podería ter unha propiedade de evento nomeada OnButtonClicked. No control do botón OnSelect o compoñente pode chamar á súa Component1.OnButtonClicked() propiedade. Unha aplicación consumidora pode entón definir a súa propia lóxica para esta propiedade, para actuar cando se preme o botón dentro do compoñente.

Valores predefinidos para propiedades ou argumentos

Os valores predeterminados poden proporcionar un valor predeterminado para un argumento ou propiedade no caso de que non se estableza ningún. Isto non ten sentido para algúns tipos de propiedades. Non obstante, nalgúns casos poden usarse para proporcionar un esquema esperado para un rexistro. Ao proporcionar un rexistro por defecto, establécese un tipo de rexistro como o esquema esperado.

Por exemplo, unha propiedade de Acción chamada acepta un rexistro que se engadirá a unha AddRecord colección local. Para proporcionar o esquema do rexistro esperado, un fabricante ten que engadir un valor por defecto para o argumento desta AddRecord propiedade.