Berichtvensters

Communiceren met gebruikers en om invoer vragen via berichtvensters

Bericht weergeven
Dialoogvenster voor invoer weergeven
Dialoogvenster voor het selecteren van een datum weergeven
Dialoogvenster voor het selecteren in een lijst weergeven
Dialoogvenster voor het selecteren van bestanden weergeven
Dialoogvenster voor het selecteren van mappen weergeven

Aan de slag met berichtvensters

Berichtvensters kunnen in stromen worden gebruikt voor communicatie met een gebruiker om invoer te vragen of om uitvoer van stroomgegevens te verstrekken.

Als u een bericht aan de gebruiker wilt weergeven terwijl het proces wordt uitgevoerd, gebruikt u de actie Bericht weergeven. In de onderstaande afbeelding toont deze actie een berichtvenster waarin de gebruiker wordt geïnformeerd dat het parseren is voltooid en worden twee opties geboden (Ja/Nee) of een extra bestand moet worden geparseerd. Het berichtvenster is ingesteld om het vraagpictogram weer te geven en om altijd boven op andere vensters te worden weergegeven. De selectie van de gebruiker wordt opgeslagen in een variabele.

Schermopname van de actie Bericht weergeven.

Het resulterende bericht ziet eruit als de volgende afbeelding:

Schermopname van een berichtvenster.

Als u een dialoogvenster wilt weergeven voor de gebruiker om gegevens in te voeren, gebruikt u de actie Invoerdialoogvenster weergeven. Voor de actie is een titel voor het invoerdialoogvenster vereist en een bericht als prompt voor de gebruiker. Stel optioneel een standaardwaarde in en een invoertype (één regel, meerdere regels of wachtwoord).

Gebruik Dialoogvenster Bestand selecteren weergeven om een gebruiker te vragen naar een bestand te bladeren. In de volgende afbeelding is de actie ingesteld om de gebruiker te vragen een afbeeldingsbestand te selecteren. De oorspronkelijke map is ingesteld op een variabele en het bestandsfilter is ingesteld om alleen specifieke bestandsextensies toe te staan.

Schermopname van de actie Dialoogvenster voor het selecteren van bestanden weergeven.

Het dialoogvenster Bestand selecteren ziet eruit als de volgende afbeelding. Let op het bestandsfilter in de rechterbenedenhoek van de afbeelding waarmee kan worden geschakeld tussen de indelingen die zijn opgegeven in de actie-eigenschappen:

Schermopname van een voorbeeld van een dialoogvenster Bestand selecteren.

Berichtvensteracties

Bericht weergeven

Hiermee wordt een berichtvenster weergegeven

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Message box title Ja Tekstwaarde De tekst die moet worden gebruikt als de titel van het berichtvenster
Message to display Ja Tekstwaarde De tekst die moet worden weergegeven als het werkelijke bericht
Message box icon N.v.t. Geen, Informatie, Vraag, Waarschuwing, Fout Geen Het pictogram bij het berichtvenster moet worden weergegeven
Message box buttons N.v.t. OK, OK - Annuleren, Ja - Nee, Ja - Nee - Annuleren, Afbreken - Opnieuw proberen - Negeren, Opnieuw proberen - Annuleren OK De knoppen die moeten worden weergegeven in het berichtvenster
Default button N.v.t. Eerste knop, Tweede knop, Derde knop Eerste knop De knop die standaard moet worden gemarkeerd. Als de gebruiker op Enter drukt, wordt op deze knop gedrukt
Berichtvenster altijd op de voorgrond houden N.v.t. Booleaanse waarde Onwaar Geef op of het berichtvenster altijd op de voorgrond van alle andere vensters moet blijven
Close message box automatically N.v.t. Booleaanse waarde Onwaar Geef op of het berichtvenster automatisch moet worden gesloten na een vooraf ingestelde tijd, net alsof de standaardknop is ingedrukt. Anders wacht de stroom totdat een knop wordt ingedrukt door de gebruiker
Timeout Ja Numerieke waarde 3 De seconden die de automatisering wordt onderbroken om te wachten op invoer voordat deze automatisch wordt voortgezet
Variabelen gemaakt
Argument Type Beschrijving
ButtonPressed Tekstwaarde De tekst op de ingedrukte knop
Uitzonderingen
Uitzondering Beschrijving
Het berichtvenster kan niet worden weergegeven Duidt op een probleem bij het weergeven van het berichtdialoogvenster
Het berichtvenster kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het berichtdialoogvenster in de niet-interactieve modus

Dialoogvenster voor invoer weergeven

Hiermee wordt een dialoogvenster weergegeven waarin de gebruiker wordt gevraagd tekst in te voeren

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Input dialog title Ja Tekstwaarde De titel van het dialoogvenster
Input dialog message Ja Tekstwaarde Het bericht in het dialoogvenster
Default value Ja Tekstwaarde Geef de tekst op die standaard moet worden weergegeven. Als de gebruiker deze wil wijzigen, kan hij/zij over de tekst heen typen. Anders wordt de standaardtekst gebruikt
Input type N.v.t. Enkele regel, Wachtwoord, Meerdere regels Enkele regel De indeling voor de invoertekst. Kies Eén regel - wachtwoord om de tekst te verbergen of Meerdere regels zodat in een groter weergavevak meer dan één regel tekst zichtbaar is
Keep input dialog always on top N.v.t. Booleaanse waarde Onwaar Geef op of het dialoogvenster voor invoer altijd op de voorgrond van alle andere vensters moet blijven
Variabelen gemaakt
Argument Type Beschrijving
UserInput Tekstwaarde De door de gebruiker ingevoerde tekst of de standaardtekst
ButtonPressed Tekstwaarde De tekst op de ingedrukte knop. De gebruiker krijgt automatisch de keuze uit OK of Annuleren
Uitzonderingen
Uitzondering Beschrijving
Het dialoogvenster voor invoer kan niet worden weergeven Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer
Het dialoogvenster voor invoer kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer in de niet-interactieve modus

Dialoogvenster voor het selecteren van een datum weergeven

Hiermee wordt een dialoogvenster weergegeven waarin de gebruiker wordt gevraagd een datum of datumbereik in te voeren

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Dialog title Ja Tekstwaarde De titel van het dialoogvenster
Dialog message Ja Tekstwaarde Het bericht in het dialoogvenster
Dialog type N.v.t. Enkele datum, Datumbereik (2 datums) Eén datum Geeft aan of de gebruiker één datum of twee datums zal invoeren als de eindpunten van een datumbereik
Prompt for N.v.t. Alleen datum, Datum en tijd Alleen datum Geef op of de gebruiker alleen de datum zal invoeren of de datum en tijd
Default value Ja Datum/tijd De standaardwaarde voor de datum
Default value for second date Ja Datum/tijd De standaardwaarde voor de einddatum van een bereik
Keep date selection dialog always on top N.v.t. Booleaanse waarde Onwaar Geef op of het dialoogvenster voor het selecteren van een datum altijd op de voorgrond van alle andere vensters moet blijven
Variabelen gemaakt
Argument Type Beschrijving
SelectedDate Datum/tijd De datum die is ingevoerd door de gebruiker of de standaarddatum
SecondSelectedDate Datum/tijd De tweede datum die is ingevoerd door de gebruiker of de standaarddatum hiervoor
ButtonPressed Tekstwaarde De tekst van de knop die is ingedrukt door de gebruiker. De gebruiker krijgt automatisch de keuze uit OK of Annuleren
Uitzonderingen
Uitzondering Beschrijving
Het dialoogvenster voor het selecteren van een datum kan niet worden weergegeven Duidt op een probleem bij het weergeven van het dialoogvenster voor het selecteren van een datum
Het dialoogvenster voor het selecteren van een datum kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer in de niet-interactieve modus

Dialoogvenster voor het selecteren in een lijst weergeven

Hiermee wordt een dialoogvenster weergegeven met opties waarmee de gebruiker iets in een lijst kan kiezen

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Dialog title Ja Tekstwaarde De titel van het dialoogvenster
Dialog message Ja Tekstwaarde Het bericht in het dialoogvenster
List to choose from Nee Algemene waarde De lijst die wordt weergegeven als vervolgmenu waar de gebruiker uit kan kiezen
Keep select dialog always on top N.v.t. Booleaanse waarde Onwaar Geef op of het dialoogvenster voor selecteren altijd op de voorgrond van alle andere vensters moet blijven
Limit to list N.v.t. Booleaanse waarde Waar Of de gebruiker een eigen antwoord kan invoeren en niet noodzakelijkerwijs een dat in de lijst voorkomt
Allow empty selection N.v.t. Booleaanse waarde Onwaar De gebruiker toestaan om niets te selecteren en er uitvoer in de vorm van een leeg geselecteerd item wordt gemaakt
Allow multiple selection N.v.t. Booleaanse waarde Onwaar De gebruiker toestaan om meer dan één keuze te selecteren. Dit betekent dat de variabelen voor het geselecteerde item en de geselecteerde index een lijst met items bevatten
Preselect items starting with a + sign N.v.t. Booleaanse waarde Onwaar Geef op of de items met het voorvoegsel '+' worden weergegeven als ze automatisch vooraf zijn geselecteerd
Variabelen gemaakt
Argument Type Beschrijving
SelectedItem Tekstwaarde Het item dat in de lijst is geselecteerd als tekst
SelectedItems Lijst met tekstwaarden De items die in de lijst zijn geselecteerd als een lijst met tekst
SelectedIndex Numerieke waarde Het indexnummer van het item dat in de lijst is geselecteerd. Hierdoor kan de gebruiker het itemnummer gebruiken in plaats van de volledige tekst van de gebruikerskeuze
SelectedIndexes Lijst met numerieke waarden Het indexnummer van de items die in de lijst zijn geselecteerd. Hierdoor kan de gebruiker het itemnummer gebruiken in plaats van de volledige tekst van de gebruikerskeuze
ButtonPressed Tekstwaarde De naam van de knop die door de gebruiker is ingedrukt (OK of Annuleren)
Uitzonderingen
Uitzondering Beschrijving
Het dialoogvenster voor selecteren kan niet worden weergegeven Duidt op een probleem bij het weergeven van het dialoogvenster voor selecteren
Het dialoogvenster voor selecteren kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer in de niet-interactieve modus

Dialoogvenster voor het selecteren van bestanden weergeven

Hiermee wordt het dialoogvenster voor het selecteren van bestanden weergegeven en wordt de gebruiker gevraagd om één of meerdere bestanden te selecteren

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Dialog title Ja Tekstwaarde De titel van het dialoogvenster
Initial folder Ja Folder De oorspronkelijke map die wordt geopend bij het zoeken naar een bestand. Dit is de plaats waar de gebruiker de actie voor het vinden van een bestand of bestanden in het dialoogvenster voor het selecteren van bestanden start
File filter Ja Tekstwaarde Een filter om het aantal opgehaalde bestanden te beperken. Hierbij zijn jokertekens mogelijk, bijvoorbeeld '.txt' of 'document?.doc' (zonder aanhalingstekens). Als u meerdere bestandsfilters wilt toestaan, scheidt u de keuzen met een puntkomma, bijvoorbeeld '.txt;*.exe'
Keep file selection dialog always on top N.v.t. Booleaanse waarde Onwaar Of het dialoogvenster voor het selecteren van bestanden altijd op de voorgrond van alle andere vensters moet blijven
Allow multiple selection N.v.t. Booleaanse waarde Onwaar Of de gebruiker meer dan één bestand kan selecteren of niet
Check if file exists N.v.t. Booleaanse waarde Onwaar Of alleen bestaande bestanden worden geaccepteerd
Variabelen gemaakt
Argument Type Beschrijving
SelectedFile File Het bestand dat wordt geselecteerd via het dialoogvenster
SelectedFiles Lijst met bestanden Geselecteerd(e) bestand(en)
ButtonPressed Tekstwaarde De tekst op de ingedrukte knop. De gebruiker krijgt automatisch de keuze uit Openen of Annuleren
Uitzonderingen
Uitzondering Beschrijving
Het dialoogvenster voor het selecteren van bestanden kan niet worden weergegeven Duidt op een probleem bij het weergeven van het dialoogvenster voor selecteren van bestanden
Het dialoogvenster voor het selecteren van bestanden kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer in de niet-interactieve modus

Dialoogvenster voor het selecteren van mappen weergeven

Hiermee wordt het dialoogvenster voor het selecteren van mappen weergegeven en wordt de gebruiker gevraagd om een map te selecteren

Invoerparameters
Argument Optioneel Accepteert Standaardwaarde Beschrijving
Dialog description Ja Tekstwaarde De beschrijving van het dialoogvenster voor het selecteren van mappen. Bijvoorbeeld 'Selecteer de map waar u de bestanden naar wilt kopiëren'
Initial folder Ja Folder De oorspronkelijke map die moet worden geopend. Dit is de standaardmap tenzij de gebruiker een nieuwe map kiest
Keep folder selection dialog always on top N.v.t. Booleaanse waarde Onwaar Of het dialoogvenster voor het selecteren van mappen altijd op de voorgrond van alle andere vensters moet blijven
Variabelen gemaakt
Argument Type Beschrijving
SelectedFolder Folder De geselecteerde map
ButtonPressed Tekstwaarde De tekst op de ingedrukte knop. De gebruiker krijgt automatisch de keuze uit OK of Annuleren
Uitzonderingen
Uitzondering Beschrijving
Het dialoogvenster voor het selecteren van mappen kan niet worden weergegeven Duidt op een probleem bij het weergeven van het dialoogvenster voor het selecteren van mappen
Het dialoogvenster voor het selecteren van mappen kan niet worden weergegeven in de niet-interactieve modus Duidt op een probleem bij het weergeven van het dialoogvenster voor invoer in de niet-interactieve modus