update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / text / stringbox.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4
5  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6
7  * Copyright (C) INRIA - Jean-Baptiste Silvy
8
9  * 
10
11  * This file must be used under the terms of the CeCILL.
12
13  * This source file is licensed as described in the file COPYING, which
14
15  * you should have received as part of this distribution.  The terms
16
17  * are also available at    
18
19  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
20
21  *
22
23  -->
24
25 <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="ja" xml:id="stringbox">
26     
27     <refnamediv>
28         
29         <refname>stringbox</refname>
30         
31         <refpurpose>テキストまたはラベルのバウンディングボックスを計算</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>rect = stringbox( string, x, y, [angle, [fontStyle, [fontSize]]] )
40             
41             rect = stringbox( Handle )
42             
43         </synopsis>
44         
45     </refsynopsisdiv>
46     
47     <refsection>
48         
49         <title>引数</title>
50         
51         <variablelist>
52             
53             <varlistentry>
54                 
55                 <term>rect</term>
56                 
57                 <listitem>
58                     
59                     <para>バウンディングボックスの4頂点の座標を有する2x4 行列.</para>
60                     
61                 </listitem>
62                 
63             </varlistentry>
64             
65             <varlistentry>
66                 
67                 <term>string</term>
68                 
69                 <listitem>
70                     
71                     <para>囲われる文字列行列.</para>
72                     
73                 </listitem>
74                 
75             </varlistentry>
76             
77             <varlistentry>
78                 
79                 <term>x,y</term>
80                 
81                 <listitem>
82                     
83                     <para>実数スカラー, 文字列の左下の座標.</para>
84                     
85                 </listitem>
86                 
87             </varlistentry>
88             
89             <varlistentry>
90                 
91                 <term>angle</term>
92                 
93                 <listitem>
94                     
95                     <para>
96                         
97                         文字列の点<literal>(x,y)</literal>を中心とする時計回りの回転角(単位:度)
98                         
99                     </para>
100                     
101                 </listitem>
102                 
103             </varlistentry>
104             
105             <varlistentry>
106                 
107                 <term>fonStyle</term>
108                 
109                 <listitem>
110                     
111                     <para>フォントの型を指定する整数.</para>
112                     
113                 </listitem>
114                 
115             </varlistentry>
116             
117             <varlistentry>
118                 
119                 <term>fontSize</term>
120                 
121                 <listitem>
122                     
123                     <para>フォントの大きさを指定する整数.</para>
124                     
125                 </listitem>
126                 
127             </varlistentry>
128             
129             <varlistentry>
130                 
131                 <term>Handle</term>
132                 
133                 <listitem>
134                     
135                     <para>Textまたは Label型のグラフィックハンドル.</para>
136                     
137                 </listitem>
138                 
139             </varlistentry>
140             
141         </variablelist>
142         
143     </refsection>
144     
145     <refsection>
146         
147         <title>説明</title>
148         
149         <para>
150             
151             <literal>stringbox</literal> はtextまたはlabelオブジェクトまたは
152             
153             特定の手段で表示される文字列を囲う矩形の頂点を返します.
154             
155             座標はカレントのグラフィックスケールで指定されます.
156             
157             最初の頂点はテキストの座標 <literal>(x,y)</literal>の
158             
159             回転しない状態で左下の点に対応し,
160             
161             以下の頂点は時計回りに戻り値の行列に指定されます. 
162             
163         </para>
164         
165         <para>結果は PostScriptドライバに指定するにはあまり正確ではない可能性があります.</para>
166         
167     </refsection>
168     
169     <refsection>
170         
171         <title>例</title>
172         
173         <programlisting role="example"><![CDATA[ 
174
175 // 軸を表示
176
177 axes = gca() ;
178
179 axes.axes_visible = 'on' ;
180
181 axes.data_bounds = [ 1, 1 ; 10, 10 ] ;
182
183
184
185 // 軸にラベルを表示
186
187 xtitle( 'stringbox', 'X', 'Y' )  ;
188
189
190
191 // Xラベルのバウンディングボックスを取得
192
193 stringbox( axes.x_label )
194
195
196
197 // 文字列を描画
198
199 str = [ "Scilab", "is" , "not", "Skylab" ] ;
200
201 xstring( 4, 9, str ) ;
202
203
204
205 //テキストを修正
206
207 e = gce() ;
208
209 e.font_angle = 90 ;
210
211 e.font_size    = 6  ;
212
213 e.font_style   = 7 ;
214
215 e.box = 'on' ;
216
217
218
219 // バウンディングボックスを取得
220
221 stringbox( e )
222
223 // または
224
225 rect = stringbox( str, 4, 9, 90, 7, 6 )
226
227
228
229 // クリックし,テキストがヒットしたかどうかを確認
230
231 hit = xclick()  ;
232
233 hit = hit( 2 : 3 ) ;
234
235
236
237 if hit(1) >= rect(1,1)  & hit(1) <=  rect(1,2) & hit(2) <= rect(2,2) & hit(2) >= rect(2,3) then
238
239   disp('You hit the text.') ;
240
241 else
242
243   disp('You missed it.')
244
245 end;
246
247  ]]></programlisting>
248         
249         <scilab:image>
250             
251             axes = gca() ;
252             
253             axes.axes_visible = 'on' ;
254             
255             axes.data_bounds = [ 1, 1 ; 10, 10 ] ;
256             
257             xtitle( 'stringbox', 'X', 'Y' )  ;
258             
259             stringbox( axes.x_label )
260             
261             str = [ "Scilab", "is" , "not", "Skylab" ] ;
262             
263             xstring( 4, 9, str ) ;
264             
265         </scilab:image>
266         
267     </refsection>
268     
269     <refsection role="see also">
270         
271         <title>参照</title>
272         
273         <simplelist type="inline">
274             
275             <member>
276                 
277                 <link linkend="xstring">xstring</link>
278                 
279             </member>
280             
281             <member>
282                 
283                 <link linkend="xstringl">xstringl</link>
284                 
285             </member>
286             
287             <member>
288                 
289                 <link linkend="xstringb">xstringb</link>
290                 
291             </member>
292             
293         </simplelist>
294         
295     </refsection>
296     
297 </refentry>
298