Eigenschappen van canvasonderdelen

Met Canvasonderdelen kunnen makers verschillende typen eigenschappen maken om waarden of logica door te geven tussen het onderdeel en de app die het onderdeel host. Eigenschappen zijn essentieel voor het bouwen van interactieve, herbruikbare componenten.

Voorwaarden

Deze functie is standaard ingeschakeld voor nieuwe apps. Voor bestaande apps moet u dit inschakelen in uw app-instellingen.

1. Open uw canvas-app voor bewerking in Power Apps Studio. Selecteer Instellingen>Updates in de opdrachtbalk.

2. Zoek op het tabblad Nieuw de instelling Uitgebreide componenteigenschappen en schakel deze in.

Typen eigenschappen

Er zijn vier typen eigenschappen beschikbaar voor makers.

1. Gegevenseigenschappen: gegevenseigenschappen hebben betrekking op gegevens, zoals een kleur- of tekstwaarde. Een gegevenseigenschap kan worden ingesteld op Invoer of Uitvoer, wat aangeeft of de component gegevens aan de app levert (Uitvoer) of de app gegevens aan de component levert (Invoer). Gegevenseigenschappen zijn de enige eigenschappen s die deelnemen aan de app-gegevensstroom.
2. Functie-eigenschappen: functie-eigenschappen hebben betrekking op logica, zoals het uitvoeren van een berekening op basis van specifieke parameters of het wijzigen van tekst. Een functie-eigenschap kan worden ingesteld op Invoer of Uitvoer, wat aangeeft of de component een functie levert die door de app kan worden aangeroepen(Uitvoer) of de app een functie levert die door de component kan orden aangeroepen (Invoer). Functie-eigenschappen nemen niet deel aan de gegevensstroom van een app en kunnen geen component- of app-variabelen gebruiken.
3. Actie-eigenschappen: actie-eigenschappen zijn een type eigenschap dat zich bezighoudt met logica en zich gedraagt als een functieUitvoer. De component heeft dus de logica gedefinieerd, en die logica kan geketende uitdrukkingen gebruiken en verzamelingen of variabelen ("gedrag") bewerken. Een Clear()actie-eigenschap kan bijvoorbeeld functionaliteit bieden die de app kan aanroepen om bepaalde waarden in de component te wissen of een Save()actie-eigenschap die een gegevensbron bijwerkt.
4. Gebeurteniseigenschappen: gebeurteniseigenschappen zijn een eigenschapscategorie die logica omvat en functioneert als een functieInvoer. De app definieert dus de logica, die door de component kan worden aangeroepen en die logica kan geketende uitdrukkingen gebruiken en verzamelingen of variabelen ("gedrag") bewerken. Meestal geven de namen van deze eigenschappen een gebeurtenis weer zoals OnSelect of OnChanged.

Gegevenseigenschap

Het gebruik van een gegevenseigenschap is gemakkelijk voor te stellen. Standaardbesturingselementen in apps hebben meestal verschillende gegevenseigenschappen voor het instellen van standaardwaarden, tekstkleur, grootte enz. Laten we eens kijken naar een eenvoudig voorbeeld waarin u eigenschappen van een besturingselement binnen het onderdeel beschikbaar wilt maken voor de hosting-app. In dit voorbeeld heet het onderdeel Component1. Plaats een schuifregelaar in het component. Voeg een Invoer-eigenschap toe om de kleur van de verbruikende app op te geven en een Uitvoer-eigenschap zodat het onderdeel de app kan vertellen wat de huidige waarde van de schuifregelaar is. In dit voorbeeld wordt ervan uitgegaan dat het onderdeel een Schuifregelaar-besturingselement heeft met de naam Slider.

1. Selecteer in het eigenschappenvenster van de component de optie Nieuwe aangepaste eigenschap.
2. Voer in het deelvenster Nieuwe aangepaste eigenschap de weergavenaam Slider Color in.
3. Selecteer Gegevens bij Eigenschapstype en selecteer de waarde Invoer bij Eigenschapsdefinitie.
4. Selecteer tot slot in de vervolgkeuzelijst Gegevenstype de optie Kleur.
5. Klik op Maken.

Selecteer vervolgens het besturingselement Slider1Schuifregelaar. Zoek de eigenschap ValueFill en typ Component1.SliderColor in de formulebalk. Component1 is de naam van het onderdeel en SliderColor is de naam van de eigenschap die u hebt toegevoegd.

Het onderdeel heeft nu een eigenschap SliderColor die kan worden ingesteld in de verbruikende app om een kleur door te geven aan het onderdeel en de eigenschap ValueFill van de schuifregelaar in te stellen.

Mogelijk wilt u de waarde van de schuifregelaar ook doorgeven aan de verbruikende app. Voeg hiervoor een eigenschap Uitvoer toe.

1. Selecteer in het eigenschappenvenster van de component de optie Nieuwe aangepaste eigenschap.
2. Voer in het deelvenster Nieuwe aangepaste eigenschap de weergavenaam Slider Value in.
3. Selecteer Gegevens bij Eigenschapstype en selecteer de waarde Uitvoer bij Eigenschapsdefinitie.
4. Selecteer tot slot in de vervolgkeuzelijst Gegevenstype de optie Getal.
5. Klik op Maken.

Bij een gegevenseigenschap van het type Uitvoer levert de component de waarde aan de verbruiktende app. Om de formule in te stellen, stelt u de nieuwe eigenschap SliderValue in het onderdeel in op de eigenschap Waarde van de schuifregelaar.

1. Klik in het eigenschappenvenster van de component op de eigenschap Slider Value.
2. Vervang in de formulebalk de standaardwaarde 100 door de volgende formule: Slider1.Value.

De eigenschap SliderValue van het onderdeel weerspiegelt nu de waarde van de schuifregelaar binnen het onderdeel die de gebruikende app kan lezen.

Functie-eigenschap

Een functie-eigenschap bevat een uitdrukking die een waarde retourneert. Normaal gesproken accepteert de functie argumenten die worden gebruikt om de te retourneren waarde te berekenen.

Notitie

Functie-eigenschappen hebben momenteel geen toegang tot variabelen of componentwaarden en eigenschappen, en kunnen geen gegevensstroom activeren. Eventuele vereiste waarden moeten als argumenten worden doorgegeven.

Een functie Uitvoer is een eenvoudige manier om een ​​aangepaste functie voor Power Apps te maken. De component definieert een functie Uitvoer met een uitdrukking waaraan enkele argumenten moeten worden doorgegeven en die een waarde retourneert. Deze functie kan vervolgens in een app worden gebruikt met de naam van de component (bijvoorbeeld Component1)door Component1.MyFunction(arg1, arg2) aan te roepen.

Met een Invoer-functie kan een gebruikende app logica aan een onderdeel leveren, vergelijkbaar met een functieaanwijzer of terugbelfunctie. Als het onderdeel bijvoorbeeld met namen van personen werkt, kan het een invoerfunctie hebben met de argumenten firstname en lastname en verwacht het een tekenreeks terug. De app kan de functie-expressie definiëren om $"{firstname} {lastname}" of $"{lastname}, {firstname}" te retourneren. Het onderdeel roept de functie aan die de appmaker aanbiedt en gebruikt de geretourneerde tekenreeks.

Actie-eigenschap

Actie-eigenschappen zijn vergelijkbaar met functie-eigenschappen van het type Uitvoer, maar ze staan neveneffectformules en expressieketens toe. Een onderdeel kan een actie-eigenschap hebben met de naam AddRecord waarmee de app een record kan toevoegen aan een verzameling in het onderdeel of een Reset-actie waarmee variabelen of verzamelingen in het onderdeel worden gewist.

In het eerdere voorbeeld met de schuifregelaar voor de Gegevenseigenschap kunt u een actie-eigenschap met de naam ResetValue toevoegen om de schuifregelaar terug te zetten naar de standaardwaarde. Gebruik hiervoor de formule Reset( Slider1 ). Nu kunnen instanties van het onderdeel in de app Component1.ResetValue() aanroepen om de schuifregelaar terug te zetten naar de standaardwaarde.

Gebeurteniseigenschap

Veel standaard besturingselementen hebben gemeenschappelijke typen Gebeurtenis-eigenschappen, wat eigenschappen van invoergedragsfuncties zijn. OnSelect op de knopbesturing is een veelvoorkomend voorbeeld. Een component kan gebeurteniseigenschappen definiëren en deze gebeurtenissen aanroepen als een functie. Een onderdeel met een knopbesturingselement kan bijvoorbeeld een gebeurteniseigenschap hebben met de naam OnButtonClicked. In het knopbesturingselement OnSelect kan het onderdeel de bijbehorende eigenschap Component1.OnButtonClicked() aanroepen. Een gebruikende app kan zijn eigen logica definiëren voor deze eigenschap die moet worden uitgevoerd wanneer op de knop in het onderdeel wordt gedrukt.

Standaardwaarden voor eigenschappen of argumenten

Standaardwaarden geven een argument of eigenschap een waarde als er geen is ingesteld. Voor sommige soorten eigenschappen is dit niet logisch. In sommige gevallen kunt u standaardwaarden gebruiken om het verwachte schema voor een record weer te geven. Door een standaardrecord op te geven, stelt u het recordtype in als het verwachte schema.

Een Actie-eigenschap met de naam AddRecord heeft bijvoorbeeld een record nodig om aan een lokale verzameling toe te voegen. Om het schema van de verwachte record weer te geven, voegt u een standaardwaarde toe voor het argument van de eigenschap AddRecord.