USETEMPLATE: verschil tussen versies
(Nieuwe pagina aangemaakt met '==zie ook== * ADDPART * SELECTPART * MODIFYPART * SETPART * TRANSPOSE * OPENLIST * SAVEFILE * OPENFILE * USEPATTERN * USETEMPL...') |
Geen bewerkingssamenvatting |
||
(37 tussenliggende versies door dezelfde gebruiker niet weergegeven) | |||
Regel 1: | Regel 1: | ||
'''USETEMPLATE''' is een [[sjabloonfunctie]] die je kunt gebruiken in een [[opmaaksjablonen|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: {{Literal|[[parameter]]<nowiki>=</nowiki>waarde}} | |||
=== Condities === | |||
Condities zijn opgebouwd als {{literal|var operator waarde}} met | |||
:{| | |||
|- | |||
| {{literal|var}} || | |||
een [[sjabloonparameters|eigenschap]] van de huidige melodie (zoals nootgrootte, regelafstand) of<br /> | |||
[[variabele|resultaat]] van het doorrekenen van de melodie (zoals aantal regels/balken, [[witruimte]]). | |||
|- | |||
| {{literal|operator }} | |||
| {{Literal|'''<nowiki>=</nowiki>}}''', '''{{Literal|>}}''', '''{{Literal|<}}''' of '''{{Literal|<>}}''' | |||
|- | |||
| {{literal|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 {{Literal|mc-textbelow}} uit waarmee alle liedteksten onder de balk belanden en de akkoorden er boven (in de veronderstelling dat {{Literal|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 {{literal|#errNeed4Parts}} waardoor de tekst opgehaald wordt uit het [[vertalingsbestand]]. | |||
Om het laatst toegepaste opmaaksjabloon via {{btn|opmaaksjablonen}} nogmaals toe te passen gebruik je: | |||
!# USETEMPLATE() | |||
De knop {{btn|paste}} is standaard aan een sjabloon {{literal|mc-favorite}} gekoppeld dat dit toepast. | |||
{{NavTemplates}} | |||
[[en:USETEMPLATE]] |
Huidige versie van 15 mrt 2024 om 11:15
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 nogmaals toe te passen gebruik je:
!# USETEMPLATE()
De knop is standaard aan een sjabloon mc-favorite gekoppeld dat dit toepast.
ADDPART • CALCULATE • COMMAND • CONFIRM • DELETEPART • ERROR • MESSAGE • MODIFYPART • OPENFILE • OPENLIST • PROMPT • REQUIRE • SAVEFILE • SELECTPART • SET • SETPART • TRANSPOSE • USEPATTERN • USETEMPLATE
FAQ • gereedschapskist • speciale constructies • condities • parameters • speellijst • variabelen • vertaling