c79350810ed289915bd222c4bf1fbb3380901477
[scilab.git] / scilab / modules / graphics / help / fr_FR / text / xstringl.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="xstringl">
3     <refnamediv>
4         <refname>xstringl</refname>
5         <refpurpose>calcule les dimensions d'une boîte
6             entourant des chaînes de caractères
7         </refpurpose>
8     </refnamediv>
9     <refsynopsisdiv>
10         <title>Séquence d'appel</title>
11         <synopsis>rect=xstringl(x,y,str,[fontId,fontSize])</synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>Paramètres</title>
15         <variablelist>
16             <varlistentry>
17                 <term>rect</term>
18                 <listitem>
19                     <para>vecteur de 4 scalaires définissant la boîte</para>
20                 </listitem>
21             </varlistentry>
22             <varlistentry>
23                 <term>x,y</term>
24                 <listitem>
25                     <para>scalaires réels, coordonnées du point en bas à
26                         gauche des chaînes de caractères.
27                     </para>
28                 </listitem>
29             </varlistentry>
30             <varlistentry>
31                 <term>str</term>
32                 <listitem>
33                     <para>matrice de chaînes de caractères.</para>
34                     <para>
35                         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>
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>fonId</term>
41                 <listitem>
42                     <para>un entier specifiant le type de la fonte.</para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>fontSize</term>
47                 <listitem>
48                     <para>un entier specifiant la taille de la fonte.</para>
49                 </listitem>
50             </varlistentry>
51         </variablelist>
52     </refsection>
53     <refsection>
54         <title>Description</title>
55         <para>
56             <literal>xstringl</literal> renvoie dans <literal>rect=[x,y,w,h]</literal> (point
57             en haut à gauche, largeur, hauteur) les dimensions d'un
58             rectangle dans l'échelle graphique courante entourant les chaînes de
59             caractères <literal>str</literal> dessinées à la position
60             <literal>x,y</literal> (point en bas à gauche).
61         </para>
62         <para>Le résultat est approximatif avec le pilote PostScript.</para>
63     </refsection>
64     <refsection>
65         <title>Exemples</title>
66         <programlisting role="example"><![CDATA[ 
67 plot2d([0;1],[0;1],0)
68 str=["Scilab" "n''est ";"$\varinjlim pas$" "Matlab"]; // LaTeX rendering (>= Scilab 5.2)
69 r=xstringl(0.5,0.5,str)
70 xrects([r(1) r(2)+r(4) r(3) r(4)]')
71 xstring(r(1),r(2),str)
72
73 plot2d([0;1],[0;1],0)
74 str=["Scilab" "n''est ";"pas" "Matlab"];
75 r2 = xstringl(0.5,0.5,str,2,5)
76 xrects([r2(1) r2(2)+r2(4) r2(3) r2(4)]')
77 xstring(r2(1),r2(2),str)
78
79 txt2=gce();
80 txt2.font_size = 5;
81 txt2.font_style = 2;
82  ]]></programlisting>
83         <scilab:image>
84             plot2d([0;1],[0;1],0)
85             str=["$\underleftrightarrow{Scilab}$" "is";"not" "elisaB"];
86             r=xstringl(0.5,0.5,str)
87             xrects([r(1) r(2)+r(4) r(3) r(4)]')
88             xstring(r(1),r(2),str)
89         </scilab:image>
90     </refsection>
91     <refsection role="see also">
92         <title>Voir aussi</title>
93         <simplelist type="inline">
94             <member>
95                 <link linkend="titlepage">titlepage</link>
96             </member>
97             <member>
98                 <link linkend="xstring">xstring</link>
99             </member>
100             <member>
101                 <link linkend="xstringl">xstringl</link>
102             </member>
103             <member>
104                 <link linkend="xtitle">xtitle</link>
105             </member>
106             <member>
107                 <link linkend="stringbox">stringbox</link>
108             </member>
109         </simplelist>
110     </refsection>
111 </refentry>