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, 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 een 4 stemmige koorpartij op twee balken zet en omgekeerd:

!# REQUIRE( nParts=4, Alleen mogelijk met 4 partijen );
!# 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.

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

!# USETEMPLATE()

De knop standaard aan een sjabloon gekoppeld dat dit toepast.

Sjabloonfuncties

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

FAQ • gereedschapskist • speciale constructies • condities • maken • parameters • speellijst • variabelen • vertaling