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

   1 %% Translation of GIT committish: cc3b9e1430f4cc9c54da7252e504f3d274a7ea17
   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ération » 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
  25 côté Y) et 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 @example
  34 @{
  35    \\once \\override NoteHead #'before-line-breaking = #display-ancestry
  36    c4
  37 @}
  38 @end example
  39
  40 et génère la sortie suivante :
  41
  42 @example
  43 ------------------------------------
  44
  45 NoteHead X,Y: NoteColumn
  46     X: PaperColumn
  47        X,Y: System
  48     Y: VerticalAxisGroup
  49        X: NonMusicalPaperColumn
  50           X,Y: System
  51        Y: VerticalAlignment
  52           X: NonMusicalPaperColumn
  53              X,Y: System
  54           Y: System
  55 @end example
  56
  57 "
  58   doctitlefr = "Affichage de la généalogie d'un objet"