Imported Upstream version 2.16.0

[lilypond.git] / Documentation / fr / texidocs / displaying-grob-ancestry.texidoc

diff --git a/Documentation/fr/texidocs/displaying-grob-ancestry.texidoc b/Documentation/fr/texidocs/displaying-grob-ancestry.texidoc
new file mode 100644 (file)
index 0000000..4108d10
--- /dev/null
+++ b/Documentation/fr/texidocs/displaying-grob-ancestry.texidoc
@@ -0,0 +1,58 @@
+%% Translation of GIT committish: cc3b9e1430f4cc9c54da7252e504f3d274a7ea17
+  texidocfr = "
+Lorsque l'on manipule des rappels d'objet (@emph{grob callbacks}), il
+peut être intéressant d'en maîtriser les « ascendants ».  La plupart des
+objets graphiques ont des parents, lesquels auront une influence sur le
+positionnement de l'objet en question.  Ainsi, les parents des côtés X
+et Y influenceront respectivement les positions horizontale et verticale
+de l'objet.  De plus, chacun des parents peut avoir ses propres parents.
+
+Certains aspects de la lignée d'un objet peuvent toutefois porter à
+confusion :
+
+-- Les types de parents d'un @emph{grob} peuvent dépendre du contexte.
+
+-- Dans le cas de certains @emph{grobs}, les parents X et Y peuvent être
+   le même.
+
+-- Un « ascendant » particulier peut dépendre d'un @emph{grob} de
+   différentes manières.
+
+-- Le concept de « génération » est trompeur.
+
+Par exemple, l'objet @code{System} peut, vis à vis d'un objet
+@code{VerticalAlignment},  être à la fois parent (par son
+côté Y) et grand parent (par deux fois du côté X).
+
+La macro ci-dessous affiche à l'écran une représentation textuelle de
+l'ascendance d'un @emph{grob}.
+
+
+Elle se lance ainsi :
+
+@example
+@{
+   \\once \\override NoteHead #'before-line-breaking = #display-ancestry
+   c4
+@}
+@end example
+
+et génère la sortie suivante :
+
+@example
+------------------------------------
+
+NoteHead X,Y: NoteColumn
+    X: PaperColumn
+       X,Y: System
+    Y: VerticalAxisGroup
+       X: NonMusicalPaperColumn
+          X,Y: System
+       Y: VerticalAlignment
+          X: NonMusicalPaperColumn
+             X,Y: System
+          Y: System
+@end example
+
+"
+  doctitlefr = "Affichage de la généalogie d'un objet"