b7f6b1f7debb70100c579ab272dd048b5ccaf8af
[scilab.git] / scilab / modules / graphics / help / fr_FR / text / xstringb.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="xstringb">
3     <refnamediv>
4         <refname>xstringb</refname>
5         <refpurpose>dessine des chaînes de caractères dans une boîte  </refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>xstringb(x,y,str,w,h,[option])</synopsis>
10     </refsynopsisdiv>
11     <refsection>
12         <title>Paramètres</title>
13         <variablelist>
14             <varlistentry>
15                 <term>x,y,w,h  </term>
16                 <listitem>
17                     <para>vecteur de 4 scalaires définissant la boîte
18                     </para>
19                 </listitem>
20             </varlistentry>
21             <varlistentry>
22                 <term>str  </term>
23                 <listitem>
24                     <para>matrice de chaînes de caractères.</para>
25                     <para>
26                         A partir de la version Scilab 5.2, il est possible d'utiliser les expressions <link linkend="math_rendering_features_in_graphic">LaTeX ou MathML</link>
27                     </para>
28                 </listitem>
29             </varlistentry>
30             <varlistentry>
31                 <term>option  </term>
32                 <listitem>
33                     <para>chaîne de caractères.
34                     </para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>Description</title>
41         <para>
42             <literal>xstringb</literal> dessine la matrice de chaînes de caractères <literal>str</literal> centrée dans le 
43             le rectangle <literal>rect=[x,y,w,h]</literal> (point en haut à gauche, largeur, hauteur) en coordonnées utilisateurs.
44             Si <literal>option</literal> est spécifiée avec la valeur <literal>"fill"</literal>, la taille de la police est calculée 
45             de manière à remplir le rectangle au maximum.
46         </para>
47         <para>
48             Taper <literal>xstringb()</literal> pour voir une démonstration de la fonction.
49         </para>
50     </refsection>
51     <refsection>
52         <title>Exemples</title>
53         <programlisting role="example"><![CDATA[ 
54 str=["Scilab" "is";"$\sqrt{not}$" "MatLab"]; // Rendu LaTeX (>= Scilab 5.2)
55 plot2d(0,0,[-1,1],"010"," ",[0,0,1,1]);
56
57 r=[0,0,1,0.5];
58 xstringb(r(1),r(2),str,r(3),r(4),"fill");
59 xrect(r(1),r(2)+r(4),r(3),r(4))
60
61 r=[r(1),r(2)+r(4)+0.01,r(3),r(4)/2];
62 xrect(r(1),r(2)+r(4),r(3),r(4))
63 xstringb(r(1),r(2),str,r(3),r(4),"fill");
64
65 r=[r(1),r(2)+r(4)+0.01,r(3),r(4)/2];
66 xrect(r(1),r(2)+r(4),r(3),r(4))
67 xstringb(r(1),r(2),str,r(3),r(4),"fill");
68  ]]></programlisting>
69         <scilab:image>
70             str=["Scilab" "is";"$\sqrt{not}$" "elisaB"];
71             plot2d(0,0,[-1,1],"010"," ",[0,0,1,1]);
72             
73             r=[0,0,1,0.5];
74             xstringb(r(1),r(2),str,r(3),r(4),"fill");
75             xrect(r(1),r(2)+r(4),r(3),r(4));
76             
77             r=[r(1),r(2)+r(4)+0.01,r(3),r(4)/2];
78             xrect(r(1),r(2)+r(4),r(3),r(4))
79             xstringb(r(1),r(2),str,r(3),r(4),"fill");
80         </scilab:image>
81     </refsection>
82     <refsection role="see also">
83         <title>Voir aussi</title>
84         <simplelist type="inline">
85             <member>
86                 <link linkend="titlepage">titlepage</link>
87             </member>
88             <member>
89                 <link linkend="xstring">xstring</link>
90             </member>
91             <member>
92                 <link linkend="xstringl">xstringl</link>
93             </member>
94             <member>
95                 <link linkend="xtitle">xtitle</link>
96             </member>
97         </simplelist>
98     </refsection>
99 </refentry>