USETEMPLATE

Uit MusiCAD

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. 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.