USETEMPLATE

USETEMPLATE is een sjabloonfunctie die je kunt gebruiken in een opmaaksjabloon om daarmee een ander sjabloon te gebruiken.

Syntax:

  USETEMPLATE();
  USETEMPLATE( sjabloonnaam );
  USETEMPLATE( sjabloonnaam, conditie );
  USETEMPLATE( sjabloonnaam, parameter );
  USETEMPLATE( sjabloonnaam, conditie, andersjabloonnaam );

In plaats van een aanwezig sjabloon kun je 'abort' gebruikten wanneer de uitvoering van het sjabloon afgebroken moet worden.

Voorbeelden

()

!# USETEMPLATE();

Gebruik het laatst aangeroepen sjabloon nogmaals.

MijnSjabloon

!# USETEMPLATE( MijnSjabloon );

Gebruik het sjabloon MijnSjabloon.

conditie

Als je een sjabloon mc-textbelow alleen wilt uitvoeren als er minstens een liedtekst-type gebruikt wordt gebruik je:

!# USETEMPLATE( mc-textbelow, nLyrics>0 )

Een sjabloon dat 4-stemmige koorpartijen op twee balken zet en omgekeerd:

!# REQUIRE( nParts==4, #errNeed4Parts );
!# USETEMPLATE( mc-4on2, nStaffs==4, mc-4on4 );

Eerst wordt gekeken of er wel 4 precies partijen aanwezig zijn, en afhankelijk van het aantal balken worden de partijen op 2 of 4 balken gezet. In plaats van de letterlijke tekst voor de te geven foutmelding Alleen mogelijk met 4 partijen staat er #errNeed4Parts waardoor de tekst opgehaald wordt uit het vertalingsbestand.

parameter

In een sjabloon dat aangeroepen wordt als

!# USETEMPLATE( GebruikFont, Arial );

is Arial de door te geven parameter aan het sjabloon GebruikFont.msj. Als het sjabloon de inhoud heeft als:

!# SET( fLyrics1.Name, sParameter );
!# SET( fLyrics2.Name, sParameter );
!# SET( fLyrics3.Name, sParameter );
!# SET( fLyrics4.Name, sParameter );

Dan zorgt de aanroep er voor dat alle lyrics met het font 'Arial' genoteerd wordt.

if/else

De constructie

!# USETEMPLATE( sjabloonnaam, conditie, andersjabloonnaam );

is equivalent met:

!# IF( conditie );
!#   USETEMPLATE( sjabloonnaam );
!# ELSE();
!#   USETEMPLATE( andersjabloonnaam );
!# ENDIF();

Sjabloonfuncties

ADDPART • CALCULATE • COMMAND • CONFIRM • DELETEPART • ELSE • ELSEIF • ENDIF • ERROR • IF • MESSAGE • MODIFYPART • OPENFILE • OPENLIST • PROMPT • REQUIRE • SAVEFILE • SELECTPART • SET • SETPART • TRANSPOSE • USEPATTERN • USETEMPLATE

FAQ • gereedschapskist • speciale constructies • condities • fouten • macro's • maken • parameters • speellijst • variabelen • vertaling