<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Types of properties - GNU LilyPond Learning Manual</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Learning Manual">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.fr.html#Top">
<link rel="up" href="The-Internals-Reference-manual.fr.html#The-Internals-Reference-manual" title="The Internals Reference manual">
<link rel="prev" href="Properties-found-in-interfaces.fr.html#Properties-found-in-interfaces" title="Properties found in interfaces">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Types-of-properties"></a>
Previous: <a rel="previous" accesskey="p" href="Properties-found-in-interfaces.fr.html#Properties-found-in-interfaces">Properties found in interfaces</a>,
Up: <a rel="up" accesskey="u" href="The-Internals-Reference-manual.fr.html#The-Internals-Reference-manual">The Internals Reference manual</a>
<hr>
</div>
<h4 class="subsection">4.2.3 Types of properties</h4>
<p><a name="index-Property-types-371"></a>
So far we have seen two types of property: <code>number</code> and
<code>symbol</code>. To be valid, the value given to a property
must be of the correct type and obey the rules for that type.
The type of property is always shown in brackets after the
property name in the IR. Here is a list of the types you may
need, together with the rules for that type, and some examples.
You must always add a hash symbol, <code>#</code>, of course,
to the front of these values when they are entered in the
<code>\override</code> command.
<p><table summary=""><tr align="left"><th valign="top" width="20%">Property type
</th><th valign="top" width="45%">Rules
</th><th valign="top" width="35%">Examples
<br></th></tr><tr align="left"><td valign="top" width="20%">Boolean
</td><td valign="top" width="45%">Either True or False, represented by #t or #f
</td><td valign="top" width="35%"><code>#t</code>, <code>#f</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Dimension (in staff space)
</td><td valign="top" width="45%">A positive decimal number (in units of staff space)
</td><td valign="top" width="35%"><code>2.5</code>, <code>0.34</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Direction
</td><td valign="top" width="45%">A valid direction constant or its numerical equivalent
</td><td valign="top" width="35%"><code>LEFT</code>, <code>CENTER</code>, <code>UP</code>,
<code>1</code>, <code>-1</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Integer
</td><td valign="top" width="45%">A positive whole number
</td><td valign="top" width="35%"><code>3</code>, <code>1</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">List
</td><td valign="top" width="45%">A bracketed set of items separated by spaces,
preceded by an apostrophe
</td><td valign="top" width="35%"><code>'(left-edge staff-bar)</code>, <code>'(1)</code>,
<code>'(1.0 0.25 0.5)</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Markup
</td><td valign="top" width="45%">Any valid markup
</td><td valign="top" width="35%"><code>\markup { \italic "cresc." }</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Moment
</td><td valign="top" width="45%">A fraction of a whole note constructed with the
make-moment function
</td><td valign="top" width="35%"><code>(ly:make-moment 1 4)</code>,
<code>(ly:make-moment 3 8)</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Number
</td><td valign="top" width="45%">Any positive or negative decimal value
</td><td valign="top" width="35%"><code>3.5</code>, <code>-2.45</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Pair (of numbers)
</td><td valign="top" width="45%">Two numbers separated by a ‘space . space’ and enclosed
in brackets preceded by an apostrophe
</td><td valign="top" width="35%"><code>'(2 . 3.5)</code>, <code>'(0.1 . -3.2)</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Symbol
</td><td valign="top" width="45%">Any of the set of permitted symbols for that property,
preceded by an apostrophe
</td><td valign="top" width="35%"><code>'italic</code>, <code>'inside</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Unknown
</td><td valign="top" width="45%">A procedure or <code>#f</code> (to cause no action)
</td><td valign="top" width="35%"><code>bend::print</code>, <code>ly:text-interface::print</code>,
<code>#f</code>
<br></td></tr><tr align="left"><td valign="top" width="20%">Vector
</td><td valign="top" width="45%">A list of three items enclosed in brackets and preceded
by apostrophe-hash, <code>'#</code>.
</td><td valign="top" width="35%"><code>'#(#t #t #f)</code>
<br></td></tr></table>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Previous: <a rel="previous" accesskey="p" href="Properties-found-in-interfaces.fr.html#Properties-found-in-interfaces">Properties found in interfaces</a>,
Up: <a rel="up" accesskey="u" href="The-Internals-Reference-manual.fr.html#The-Internals-Reference-manual">The Internals Reference manual</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Cette page documente LilyPond-2.11.57 (branche de développement).
<br>
<address>
Rapportez toute anomalie en français à <a href="mailto:lilypond-user-fr@gnu.org">lilypond-user-fr@gnu.org</a> ou en anglais à <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a> </address>
<br>
Vos <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions à propos de la documentation</a> sont les bienvenues.
</font>
</p>
</div>
<P>
Autres langues : <a href="Types-of-properties.es.html">español</a>.
<BR>
</P>
</BODY></html>
