Functies voor in- en uitvoer
Invoer kan worden gelezen van de gebruiker, d.m.v vragen door een schermpje; of door lezen uit een tekstbestand.
Voor het lezen van invoer van een scherm is het niet nodig om een invoerstroom te openen.
Voor het lezen van een bestand is dat wel nodig, hiervoor is de functie OpenIn beschikbaar. Deze invoerstroom moet ook weer worden gesloten d.m.v. SluitIn.
Uitvoer kan worden geschreven naar de meldingenlijst in het plugin-scherm van GENEAAL. Deze uitvoerstroom heeft nummer 0, en behoeft niet te worden geopend of gesloten.
Voor uitvoer naar een bestand wordt gebruik gemaakt van uitvoerstroom 1. Deze uitvoer moet wel worden geopend, d.m.v OpenUit, en gesloten d.m.v. de functie SluitUit.
Functie
|
Open een bestand voor de invoerstroom
|
Functiekop
|
function OpenIn(Filenaam: stringvar; Ext, Titel: string): number
|
Parameters
|
Filenaam:
|
De naam van het te openen bestand, invoer/uitvoer
Wanneer de naam de lege tekenrij bevat, wordt een standaard Windows-opendialoog getoond. Hiermee kan een bestand worden gekozen op de standaard manier. Is een bestand gekozen, dan bevat na terug keer uit de functie de parameter Filenaam de naam van het gekozen bestand (incl. de mapnaam).
Wanneer Fileaam een geldige bestandsnaam bevat tijdens de aanroep, wordt geen open-dialoog gestart, maar geprobeerd om dit bestand zonder tussenkomst van de gebruiker te openen.
|
Ext:
|
wanneer de parameter Filenaam leeg is wordt de opendialoog gestart met de instelling zoeken naar bestanden met extentie Ext, invoer
|
Titel:
|
wanneer de parameter Filenaam leeg is wordt de opendialoog gestart met de titel Titel, invoer
|
|
Resultaat
|
0:
|
de aanroep is mislukt.
|
1:
|
het bestand met naam Filenaam is geopend voor invoer.
|
|
Functie
|
Open een bestand voor de uitvoerstroom 1
|
Functiekop
|
function OpenUit(Filenaam: stringvar; Ext, Titel: string): number
|
Parameters
|
Filenaam:
|
De naam van het te openen bestand, invoer/uitvoer
Wanneer de naam de lege tekenrij bevat, wordt een standaard Windows-save-dialoog getoond. Hiermee kan een bestand worden gekozen op de standaard manier. Is een bestand gekozen, dan bevat na terug keer uit de functie de parameter Filenaam de naam van het gekozen bestand (incl. de mapnaam).
Wanneer Fileaam een geldige bestandsnaam bevat tijdens de aanroep, wordt geen save-dialoog gestart, maar geprobeerd om dit bestand zonder tussenkomst van de gebruiker te openen.
|
Ext:
|
wanneer de parameter Filenaam leeg is wordt de savedialoog gestart met de instelling zoeken naar bestanden met extentie Ext, invoer
|
Titel:
|
wanneer de parameter Filenaam leeg is wordt de savedialoog gestart met de titel Titel, invoer
|
|
Resultaat
|
0:
|
de aanroep is mislukt.
|
1:
|
het bestand met naam Filenaam is geopend voor uitvoerstroom 1.
|
|
Functie
|
Sluit een invoerbestand
|
Functiekop
|
function SluitIn( ): number
|
Resultaat
|
0:
|
komt niet voor.
|
1:
|
het invoerbestand is gesloten.
|
|
Opmerking
|
wanneer de invoerstroom niet open is, wordt het programma afgebroken.
|
Functie
|
Sluit een uitvoerbestand
|
Functiekop
|
function SluitUit( ): number
|
Resultaat
|
0:
|
komt niet voor.
|
1:
|
het uitvoerbestand is gesloten.
|
|
Opmerking
|
wanneer de uitvoerstroom niet open is, wordt het programma afgebroken.
|
Functie
|
Bepaal of een bestand aanwezig is
|
Functiekop
|
function BestandBestaat( Filenaam: string): number
|
Resultaat
|
0:
|
bestand bestaat niet
|
1:
|
het bestand is aanwezig
|
|
Functie
|
Vraag een tekst van de gebruiker d.m.v een scherm
|
Functiekop
|
function Vraag(TitelTekst: string; Vraag: string; Antwoord stringvar ): number
|
Parameters
|
TitelTekst:
|
de tekst die als titel van het scherm fungeert, invoer
|
Vraag:
|
de tekst die de vraag inhoudt, invoer
|
Antwoord:
|
de, door de gebruiker teruggegeven tekst, uitvoer
|
|
Resultaat
|
0:
|
de gebruiker heeft op de Annuleren-knop gedrukt
|
1:
|
de vraag is beantwoord, Antwoord bevat de tekst van de gebruiker.
|
|
Functie
|
Meldt een tekst aan de gebruiker d.m.v een scherm
|
Functiekop
|
function Melding(TitelTekst: string; Tekst: string ): number
|
Parameters
|
TitelTekst:
|
de tekst die als titel van het scherm fungeert, invoer
|
Tekst:
|
de inhoud van de melding, invoer
|
|
Resultaat
|
0:
|
komt niet voor
|
1:
|
de melding is gegeven en gezien door de gebruiker.
|
|
Functie
|
Vraag initiële waarden aan de gebruiker
|
Functiekop
|
function Initscherm(OpbouwRes: stringlist ): number
|
Parameters
|
OpbouwRes:
|
een tekenrijlijst waarin de opbouw van het vraagscherm staat. De uitvoer wordt ook in de zelfde lijst gegeven, in-, uitvoer
De lijst kan een aantal regels (tekenrijen) bevatten. Er zijn drie soorten regels:
- regel voor een checkbox. De inhoud van de regel is: CB:tekst bij de box
- regel voor een radiobutton. De inhoud van de regel is: RB:tekst bij de button
- regel voor een editbox. De inhoud van de regel is: EB:opschrijft editbox
Na de uitvoering van de functie bevat OpbouwRes de antwoorden van de gebruiker:
- voor een checkboxregel bevat de regel 0 of 1 (resp. niet of wel aangevinkt)
- voor een radiobuttonregel bevat de regel 0 of 1 (resp. niet of wel gekozen)
- voor een editbox bevat de regel het antwoord van de gebruiker.
|
|
Resultaat
|
0:
|
de gebruiker heeft op Annuleren gedrukt
|
1:
|
de gewenste informatie staat in de lijst.
|
|
Functie
|
Laat Windows een bestand openen (afhankelijk van de extensie, wordt een bijbehorend programma gestart)
|
Functiekop
|
function OpenBestand(Filenaam: string ): number
|
Parameters
|
Filenaam:
|
de naam van het bestand dat Windows moet openen, invoer
|
|
Resultaat
|
0:
|
komt niet voor
|
1:
|
het bestand is aan Windows doorgegeven voor openen/verwerken.
|
|
Functie
|
Lees een tekstregel uit de invoerstroom
|
Functiekop
|
function LeesTekst( Tekst: stringvar ): number
|
Parameters
|
Tekst:
|
de tekstregel uit de invoerstroom, uitvoer
|
|
Resultaat
|
0:
|
komt niet voor.
|
1:
|
het inlezen is gelukt.
|
|
Opmerking
|
wanneer de invoerstroom niet open is, of wanneer er een fout optreedt tijdens het lezen, wordt het programma afgebroken.
|
Functie
|
Schrijf een tekst naar een uitvoerkanaal
|
Functiekop
|
function SchrijfTekst(Kanaal: number; Tekst: string ): number
|
Parameters
|
Kanaal:
|
0: meldinglijst Plugin-scherm van GENEAAL,
1: uitvoerstroom die gekoppeld is met een uitvoerbestand, invoer
|
Tekst:
|
de tekst die moet worden geschreven, invoer
Opm: de Tekst wordt altijd gecompleteerd met een einderegel-symbool.
|
|
Resultaat
|
0:
|
onbekend kanaal
|
1:
|
de tekst is geschreven
|
|
Opmerking
|
wanneer er een schrijffout optreedt in de uitvoerstroom wordt het programma afgebroken.
|
Functie
|
Schrijf een einderegel-symbool naar een uitvoerkanaal
|
Functiekop
|
function SchrijfNR(Kanaal: number ): number
|
Parameters
|
Kanaal:
|
0: meldinglijst Plugin-scherm van GENEAAL,
1: uitvoerstroom die gekoppeld is met een uitvoerbestand, invoer
|
|
Resultaat
|
0:
|
onbekend kanaal
|
1:
|
de nieuwe regel is geschreven
|
|
Opmerking
|
wanneer er een schrijffout optreedt in de uitvoerstroom wordt het programma afgebroken.
|
Functie
|
Maak een map aan onder Windows
|
Functiekop
|
function MaakMap(S: string ): number
|
Parameters
|
S:
|
de naam van de te creeëren map,
|
|
Resultaat
|
0:
|
het maken van de map is mislukt
|
1:
|
de nieuwe map is gemaakt
|
|
Functie
|
Kopieer een bestand onder Windows
|
Functiekop
|
function KopieerBestand(Van, Naar: string ): number
|
Parameters
|
Van:
|
de naam van de te kopiëren bestand (incl. map),
|
Naar:
|
de naam van de kopie (incl. map)
|
|
Resultaat
|
0:
|
het kopiëren van de map is mislukt
|
1:
|
het bestand is gekopieerd.
|
|
Functie
|
Hernoem een bestand onder Windows
|
Functiekop
|
function HernoemBestand(Van, Naar: string ): number
|
Parameters
|
Van:
|
de oude naam van het bestand (incl. map),
|
Naar:
|
de nieuwe naam van het bestand (incl. map)
|
|
Resultaat
|
0:
|
het hernoemen is mislukt
|
1:
|
het bestand is hernoemd.
|
|
Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator