Documentation/fr/texidocs/displaying-grob-ancestry.texidoc

   1 %% Translation of GIT committish: 9d1f4d4d16abf95cccf6bea9cf98c312e55a3ebf
   2   texidocfr = "
   3 Lorsque l'on manipule des rappels d'objet (@emph{grob callbacks}), il
   4 peut être intéressant d'en maîtriser les ascendants.  La plupart des
   5 objets graphiques ont des parents, lesquels auront une influence sur le
   6 positionnement de l'objet en question.  Ainsi, les parents des côtés X
   7 et Y influenceront respectivement les positions horizontale et verticale
   8 de l'objet.  De plus, chacun des parents peut avoir ses propres parents.
   9
  10 Certains aspects de la lignée d'un objet peuvent toutefois porter à
  11 confusion :
  12
  13 -- Les types de parents d'un @emph{grob} peuvent dépendre du contexte.
  14
  15 -- Dans le cas de certains @emph{grobs}, les parents X et Y peuvent être
  16    le même.
  17
  18 -- Un « ascendant » particulier peut dépendre d'un @emph{grob} de
  19    différentes manières.
  20
  21 -- Le concept de « générations » est trompeur.
  22
  23 Par exemple, l'objet @code{System} peut, vis à vis d'un objet
  24 @code{VerticalAlignment}, être à la fois parent (par son côté Y) et
  25 grand parent (par deux fois du côté X).
  26
  27 La macro ci-dessous affiche à l'écran une représentation textuelle de
  28 l'ascendance d'un @emph{grob}.
  29
  30
  31 Elle se lance ainsi :
  32
  33 @code{@{ \\once \\override NoteHead.before-line-breaking =
  34   #display-ancestry c @}}
  35
  36
  37 et génère la sortie suivante :
  38
  39 @code{NoteHead X,Y: NoteColumn
  40      X: PaperColumn
  41         X,Y: System
  42      Y: VerticalAxisGroup
  43         X: NonMusicalPaperColumn
  44            X,Y: System
  45         Y: VerticalAlignment
  46            X: NonMusicalPaperColumn
  47               X,Y: System
  48            Y: System}
  49
  50 "
  51   doctitlefr = "Affichage de la généalogie d'un objet"