USETEMPLATE

From 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, conditie, andersjabloonnaam );

In plaats van een aanwezig sjabloon kun je 'abort' gebruikten wanneer de uitvoering van het sjabloon afgebroken moet worden. Ook kan in plaats van een sjabloon een toewijzing gebruikt worden: parameter=waarde

Condities

Condities zijn opgebouwd als var operator waarde met

var

een eigenschap van de huidige melodie (zoals nootgrootte, regelafstand) of
resultaat van het doorrekenen van de melodie (zoals aantal regels/balken, witruimte).

operator    =, >, < of <>
waarde de te testen waarde voor de betreffende eigenschap

Voorbeelden

Om te testen of er minstens een liedtekst-type gebruikt wordt, en als dat het geval is voer dan het sjabloon mc-textbelow uit waarmee alle liedteksten onder de balk belanden en de akkoorden er boven (in de veronderstelling dat mc-textbelow daarvoor zorgt.

In een sjabloon gebruik je dan:

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

Om het laatst toegepaste opmaaksjabloon via opmaaksjablonen nogmaals toe te passen gebruik je:

!# USETEMPLATE()

De knop paste is standaard aan een sjabloon mc-favorite gekoppeld dat dit toepast.