Improve description of callback_type property in uicontrol_properties help page.
[scilab.git] / scilab / modules / gui / help / ja_JP / uicontrol_properties.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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="uicontrol_properties" xml:lang="ja">
3     <refnamediv>
4         <refname>uicontrolプロパティ</refname>
5         <refpurpose>uicontrolプロパティの説明.</refpurpose>
6     </refnamediv>
7     <refsection>
8         <title>説明</title>
9         <para>
10             これらのプロパティは
11             <link linkend="set">set</link> または <link linkend="uicontrol">uicontrol</link>
12             関数により設定できます.
13             これらの値は<link linkend="get">get</link>により取得可能です.
14         </para>
15     </refsection>
16     <refsection>
17         <title>プロパティ</title>
18         <variablelist>
19             <varlistentry>
20                 <term>BackgroundColor</term>
21                 <listitem>
22                     <para>[1,3] 実数ベクトルまたは文字列</para>
23                     <para>
24                         uicontrolの背景色です.
25                         色は赤,緑および青の値として指定されます.
26                         これらの値は[0,1]の範囲の実数です.
27                         色は[R,G,B]のような実数ベクトルまたは"R|G|B|"のように
28                         "|"で区切られた文字列で指定できます.
29                     </para>
30                     <para>
31                         このプロパティを<literal>[-1 -1 -1]</literal>に設定すると
32                         ルックアンドフィールをデフォルトの背景色に設定します.
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>Border</term>
38                 <listitem>
39                     <para>Borderオブジェクト.</para>
40                     <para>
41                         <literal>frame</literal>スタイルのuicontrolsでのみ使用され,
42                         このオブジェクトは <link linkend="createBorder">createBorder</link>
43                         により作成されます.
44                     </para>
45                     <para>
46                         この値に <literal>[]</literal> を設定すると
47                         フレームの境界が削除されます.
48                     </para>
49                 </listitem>
50             </varlistentry>
51             <varlistentry>
52                 <term>Callback</term>
53                 <listitem>
54                     <para>文字列</para>
55                     <para>
56                         uicontrolが有効な時(例えばボタンをクリックした時),
57                         Scilabインタプリタで評価される命令.
58                     </para>
59                     <para>
60                         このプロパティは <literal>layer</literal>,
61                         <literal>frame</literal> および <literal>text</literal> スタイルの
62                         uicontrolsでは使用されません.
63                     </para>
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>Callback_Type</term>
68                 <listitem>
69                     <para>Scalar</para>
70                     <para>The type of callback transmitted to the uicontrol (see example below).</para>
71                     <itemizedlist>
72                         <listitem>
73                             <para>
74                                 <literal>-1</literal> none (callback desactivated)
75                             </para>
76                         </listitem>
77                         <listitem>
78                             <para>
79                                 <literal>0</literal> (by default) or <literal>2</literal> a non prioritary, interruptible Scilab instruction
80                             </para>
81                             <para>
82                                 <literal>10</literal> or <literal>12</literal> a prioritary, non-interruptible Scilab instruction
83                             </para>
84                         </listitem>
85                         <listitem>
86                             <para>
87                                 <literal>1</literal> a C or a Fortran function
88                             </para>
89                         </listitem>
90                     </itemizedlist>
91                 </listitem>
92             </varlistentry>
93             <varlistentry>
94                 <term>Constraints</term>
95                 <listitem>
96                     <para>Constraintsオブジェクト.</para>
97                     <para>
98                         このオブジェクトは <link linkend="createConstraints">createConstraints</link>
99                         により作成され,uicontrolのその親の対する位置と大きさに関する拘束条件を
100                         記述します.
101                     </para>
102                     <para>
103                         この値に <literal>[]</literal> を設定すると拘束条件を消去します.
104                     </para>
105                 </listitem>
106             </varlistentry>
107             <varlistentry>
108                 <term>Enable</term>
109                 <listitem>
110                     <para>{on} | off</para>
111                     <para>
112                         uicontrolを有効または無効にします.
113                         このプロパティを<literal>"on"</literal> (デフォルト)に
114                         設定した場合, uicontrolは有効となりますが,
115                         このプロパティに<literal>"off"</literal>を指定すると
116                         uicontrolはマウスの操作に応答せず,グレイアウトされます.
117                     </para>
118                 </listitem>
119             </varlistentry>
120             <varlistentry>
121                 <term>FontAngle</term>
122                 <listitem>
123                     <para>{normal} | italic | oblique</para>
124                     <para>
125                         コントロールが何らかのテキストを含む場合,
126                         このプロパティはフォントの傾きを設定します.
127                     </para>
128                 </listitem>
129             </varlistentry>
130             <varlistentry>
131                 <term>FontSize</term>
132                 <listitem>
133                     <para>スカラー</para>
134                     <para>
135                         コントロールが何らかのテキストを含む場合,
136                         このプロパティはフォントの大きさをFontUnits単位で設定します.
137                     </para>
138                 </listitem>
139             </varlistentry>
140             <varlistentry>
141                 <term>FontUnits</term>
142                 <listitem>
143                     <para>{points} | pixels | normalized</para>
144                     <para>
145                         コントロールが何らかのテキストを含む場合,
146                         このプロパティはFontSizeを指定する単位を指定します.
147                     </para>
148                 </listitem>
149             </varlistentry>
150             <varlistentry>
151                 <term>FontWeight</term>
152                 <listitem>
153                     <para>light | {normal} | demi | bold</para>
154                     <para>
155                         コントロールが何らかのテキストを含む場合,
156                         このプロパティは使用するフォントの重みを指定します.
157                     </para>
158                 </listitem>
159             </varlistentry>
160             <varlistentry>
161                 <term>FontName</term>
162                 <listitem>
163                     <para>文字列</para>
164                     <para>
165                         コントロールのテキストを表示する際に
166                         選択されたフォントの名前を選ぶ際に使用されます.
167                     </para>
168                 </listitem>
169             </varlistentry>
170             <varlistentry>
171                 <term>ForegroundColor</term>
172                 <listitem>
173                     <para>[1,3] 実数ベクトルまたは文字列</para>
174                     <para>
175                         uicontrolの前景色です.
176                         色は赤,緑および青の値として指定されます.
177                         これらの値は[0,1]の範囲の実数です.
178                         色は[R,G,B]のような実数ベクトルまたは"R|G|B|"のように
179                         "|"で区切られた文字列で指定できます.
180                     </para>
181                     <para>
182                         このプロパティを<literal>[-1 -1 -1]</literal>に設定すると,
183                         ルックアンドフィールによりデフォルトの表示色を設定します.
184                     </para>
185                 </listitem>
186             </varlistentry>
187             <varlistentry>
188                 <term>Groupname</term>
189                 <listitem>
190                     <para>文字列</para>
191                     <para>
192                         <literal>radiobutton</literal> および <literal>checkbox</literal>
193                         スタイルuicontrolsの場合,
194                         本プロパティにより同じグループ全体のuicontrolを
195                         管理できるようになります.
196                         例えば<literal>checkbox</literal> uicontrolのグループは,
197                         選択の単一性を自動的に管理します.
198                     </para>
199                 </listitem>
200             </varlistentry>
201             <varlistentry>
202                 <term>HorizontalAlignment</term>
203                 <listitem>
204                     <para>left | {center} | right</para>
205                     <para>uicontrolのテキスト水平アラインメントを設定します.</para>
206                 </listitem>
207             </varlistentry>
208             <varlistentry>
209                 <term>Icon</term>
210                 <listitem>
211                     <para>文字列.</para>
212                     <para>
213                         このプロパティは,
214                         (<link linkend="pwd">Scilabワーキングディレクトリ</link>に対する)
215                         相対パス,または,
216                         <literal>pushbutton</literal> または <literal>text</literal>
217                         uicontrolで使用される
218                         使用する画像ファイルの絶対パスを表します.
219                     </para>
220                     <para>
221                         <literal>tab</literal> uicontrols内の
222                         <literal>frame</literal> uicontrols の場合,
223                         iconプロパティはシートのアイコンを設定します.
224                     </para>
225                 </listitem>
226             </varlistentry>
227             <varlistentry>
228                 <term>Layout: </term>
229                 <listitem>
230                     <para>
231                         このプロパティは,
232                         <literal>frame</literal> uicontrols の子を配置する
233                         際に使用するレイアウトを設定します.
234                         利用可能なレイアウトに関する詳細については,
235                         <link linkend="layout">レイアウト</link>のページを参照ください.
236                     </para>
237                 </listitem>
238             </varlistentry>
239             <varlistentry>
240                 <term>Layout_options: </term>
241                 <listitem>
242                     <para>
243                         このプロパティは<literal>frame</literal>の子を
244                         配置する際に使用されるレイアウトのオプションを設定します.
245                         利用可能なオプションに関する詳細については,
246                         <link linkend="layout">レイアウト</link>のページを参照ください.
247                     </para>
248                 </listitem>
249             </varlistentry>
250             <varlistentry>
251                 <term>ListboxTop</term>
252                 <listitem>
253                     <para>スカラー</para>
254                     <para>
255                         <literal>listbox</literal> uicontrolsのみで使用され,
256                         このプロパティは,
257                         リストの可視領域の最初の行に現れるリストの要素を
258                         指定します.
259                     </para>
260                 </listitem>
261             </varlistentry>
262             <varlistentry>
263                 <term>Margins</term>
264                 <listitem>
265                     <para>[1,4] 実数ベクトル.</para>
266                     <para>
267                         <literal>[top, left, bottom, right]</literal> (ピクセル単位)で
268                         uicontrolの周りの空き空間を設定します.
269                     </para>
270                 </listitem>
271             </varlistentry>
272             <varlistentry>
273                 <term>Max</term>
274                 <listitem>
275                     <para>スカラー</para>
276                     <para>
277                         "Value"プロパティで設定できる最大値を指定します.
278                         しかし,各uicontrolにおいて以下のように異なる意味を
279                         有します:
280                     </para>
281                     <itemizedlist>
282                                                  <listitem>
283                             <para>
284                                 <literal>checkbox</literal> および
285                                 <literal>radiobutton</literal> uicontrols:
286                                 Max はコントロールがチェックされた際に
287                                 とる"Value"プロパティの値です.
288                             </para>
289                         </listitem>
290                         <listitem>
291                             <para>
292                                 <literal>slider</literal> および
293                                 <literal>spinner</literal> uicontrols:
294                                 要素の最大値.
295                             </para>
296                         </listitem>
297                         <listitem>
298                             <para>
299                                 <literal>listbox</literal> uicontrols: (Max-Min)&gt;1 の場合,
300                                 リストは複数の選択が可能です.
301                             </para>
302                         </listitem>
303                         <listitem>
304                             <para>
305                                 <literal>edit</literal> uicontrols: (Max-Min)&gt;1 の場合,
306                                 editは複数行の選択が可能です.
307                             </para>
308                         </listitem>
309                     </itemizedlist>
310                 </listitem>
311             </varlistentry>
312             <varlistentry>
313                 <term>Min</term>
314                 <listitem>
315                     <para>スカラー</para>
316                     <para>
317                         "Value"プロパティで設定できる最小値を指定します.
318                         しかし,各uicontrolにおいて以下のように異なる意味を
319                         有します:
320                     </para>
321                     <itemizedlist>
322                         <listitem>
323                             <para>
324                                 <literal>checkbox</literal> および <literal>radiobutton</literal>
325                                 uicontrols:
326                                 Minはコントロールのチェックが外された際に
327                                 "Value"プロパティがとる値です.
328                             </para>
329                         </listitem>
330                         <listitem>
331                             <para>
332                                 <literal>slider</literal> および
333                                 <literal>spinner</literal> uicontrols:
334                                 要素の最小値.
335                             </para>
336                         </listitem>
337                         <listitem>
338                             <para>
339                                 <literal>listbox</literal> uicontrols:
340                                 (Max-Min)&gt;1 の場合,リストで複数の選択を行うことができます.
341                             </para>
342                         </listitem>
343                         <listitem>
344                             <para>
345                                 <literal>edit</literal> uicontrols:
346                                 (Max-Min)&gt;1 の場合, edit は複数行を選択することができます.
347                             </para>
348                         </listitem>
349                     </itemizedlist>
350                 </listitem>
351             </varlistentry>
352             <varlistentry>
353                 <term>Parent</term>
354                 <listitem>
355                     <para>ハンドル</para>
356                     <para>
357                         uicontrolの親のハンドル.
358                         このプロパティを変更すると,
359                         コントロールをある図から別の図に移動することができます.
360                     </para>
361                 </listitem>
362             </varlistentry>
363             <varlistentry>
364                 <term>Position</term>
365                 <listitem>
366                     <para>[1,4] 実数ベクトルまたは文字列.</para>
367                     <para>
368                         このプロパティは,
369                         コントロールの形状を設定または取得する際に使用されます.
370                         このプロパティはベクトル [x y w h]です.
371                         ただし,各文字は左上隅のx位置,左上隅のy位置,
372                         uicontrolの幅および高さを表します.
373                         "x|y|w|h"のように
374                         各文字を"|"で区切った文字列で表すこともできます.
375                         単位は,"Units"プロパティで定義されます.
376                     </para>
377                     <para>
378                         幅と高さはスライダの向きを定義します.
379                         幅が高さよりも大きい場合,スライダは水平の向きとなり,
380                         それ以外の場合は垂直に配置されます.
381                     </para>
382                 </listitem>
383             </varlistentry>
384             <varlistentry>
385                 <term>Relief</term>
386                 <listitem>
387                     <para>{default} | flat | groove | raised | ridge | solid | sunken</para>
388                     <para>
389                         uicontrolの境界の外観.
390                         <literal>"default"</literal> はアプリケーションの
391                         ルックアンドフィールがreliefを設定する際に使用されることを意味します.
392                     </para>
393                     <para>
394                         古くなったuicontrol用のskinを使用した場合,
395                         デフォルト値はuicontrolのスタイルに関係します:
396                     </para>
397                     <itemizedlist>
398                         <listitem>
399                             <para>
400                                 <literal>pushbutton</literal> uicontrols:
401                                 "Relief" プロパティのデフォルト値は "raised"です.
402                             </para>
403                         </listitem>
404                         <listitem>
405                             <para>
406                                 <literal>edit</literal> uicontrols:
407                                 "Relief" プロパティのデフォルト値は "sunken"です.
408                             </para>
409                         </listitem>
410                         <listitem>
411                             <para>他の uicontrols:
412                                 "Relief"プロパティのデフォルト値は "flat"です.
413                             </para>
414                         </listitem>
415                     </itemizedlist>
416                 </listitem>
417             </varlistentry>
418             <varlistentry>
419                 <term>Scrollable</term>
420                 <listitem>
421                     <para>論理値.</para>
422                     <para>
423                         <literal>frame</literal> および <literal>edit</literal> スタイル
424                         uicontrolsで使用され, このプロパティは
425                         uicontrolがスクロール機能を有する(<literal>%T</literal>)または
426                         有さない(デフォルト <literal>%F</literal>)ことを示します.
427                     </para>
428                     <para>
429                         <literal>frame</literal>の場合,この値は生成時に
430                         指定する必要があります.
431                     </para>
432                 </listitem>
433             </varlistentry>
434             <varlistentry>
435                 <term>SliderStep</term>
436                 <listitem>
437                     <para>[1,2] 実数ベクトル</para>
438                     <para>[small big],
439                         smallステップはスライダをクリックした際,
440                         または(スライダにフォーカスがある時に)
441                         キーボード矢印をタッピングした際の移動量を表します;
442                         bigステップはCtrl-keyboard-矢印により移動する量を表します.
443                         bigステップが省略された場合,
444                         スケールの1/10がデフォルト値となります.
445                     </para>
446                     <para>
447                         <literal>spinner</literal> uicontrolの場合,
448                         このプロパティの最初の値が固定ステップとして使用されます.
449                     </para>
450                 </listitem>
451             </varlistentry>
452             <varlistentry>
453                 <term>String</term>
454                 <listitem>
455                     <para>文字列.</para>
456                     <para>
457                         このプロパティは(FrameおよびSliderスタイルを除く)
458                         uicontrolに表示されるテキストを表します.
459                         表の場合,この値は文字列の行列です.
460                         ListBoxesおよびPopupMenusの場合,
461                         この値は文字列のベクトルまたは
462                         各要素を"|"で区切った文字列とすることができます.
463                         Text uicontrolsの場合, テキストを整形するために
464                         この文字列にHTMLコードを含めることができます.
465                     </para>
466                     <itemizedlist>
467                         <listitem>
468                             <para>
469                                 <literal>pushbutton</literal> または <literal>text</literal> uicontrols
470                                 の場合,
471                                 テキストを2つの$ (ドル記号)で括ると,そのテキストは
472                                 LaTeX式とみなされます.
473                                 また,&lt; および &gt; で括ると,MathML式とみなされます.
474                             </para>
475                         </listitem>
476                         <listitem>
477                             <para>
478                                 <literal>layer</literal> および <literal>tab</literal> uicontrolsの場合,
479                                 この値は選択された子のタグを指定します.
480                             </para>
481                         </listitem>
482                         <listitem>
483                             <para>
484                                 <literal>image</literal> uicontrolsの場合,
485                                 この値は画像ファイルのパスを指定します.
486                             </para>
487                         </listitem>
488                         <listitem>
489                             <para>
490                                 <literal>table</literal> uicontrolsの場合,
491                                 この値は以下のように表データを指定します: <literal>[IGNORED COL1-HEADER...COLN-HEADER;ROW1-HEADER, ROW1COL1-DATA, ROW1COLN-DATA;...;ROWM-HEADER, ROWMCOL1-DATA, ROWMCOLN-DATA]</literal>.
492                             </para>
493                         </listitem>
494                         <listitem>
495                             <para>
496                                 色選択, アイコン, 背景および表面色を管理する
497                                 <literal>listbox</literal> および<literal>popupmenu</literal> uicontrols
498                                 の場合,
499                                 <literal>String</literal> プロパティを
500                                 以下の形式に一致する行列に設定できます:
501                                 <literal>["#color1", "Item1", "#background1", "#foreground1"; "#color2", "Item2", ..., ...]</literal>
502                                 <literal>["icon1", "Item1", "#background1", "#foreground1"; "icon2", "Item2", ..., ...]</literal>
503                                 ただし, <literal>"#color1"</literal>,
504                                 <literal>"#background1"</literal> および
505                                 <literal>"#foreground1"</literal> はHTML形式
506                                 <literal>#XXXXXX</literal>です.
507                                 この要素は色付きのボックスまたは関連する文字列の
508                                 左にアイコンを表示し,
509                                 要素毎に異なる背景/表面色で表示します.
510                             </para>
511                         </listitem>
512                     </itemizedlist>
513                 </listitem>
514             </varlistentry>
515             <varlistentry>
516                 <term>Tag</term>
517                 <listitem>
518                     <para>文字列</para>
519                     <para>
520                         このプロパティは一般にコントロールを特定するために使用されます.
521                         これによりコントロールに"名前"を付けることができます.
522                         通常,<literal>findobj()</literal>と組み合わせて使用されます.
523                     </para>
524                 </listitem>
525             </varlistentry>
526             <varlistentry>
527                 <term>Title_position</term>
528                 <listitem>
529                     <para>{top} | left | bottom | right</para>
530                     <para>
531                         <literal>tab</literal> スタイル uicontrolのタブの位置.
532                     </para>
533                 </listitem>
534             </varlistentry>
535             <varlistentry>
536                 <term>Title_scroll</term>
537                 <listitem>
538                     <para>論理値</para>
539                     <para>
540                         <literal>tab</literal>スタイル uicontrol のタブが
541                         ラップされる (<literal>title_scroll=%F</literal>) か
542                         スクロールされる (<literal>title_scroll=%T</literal>)かを示します.
543                     </para>
544                 </listitem>
545             </varlistentry>
546             <varlistentry>
547                 <term>TooltipString</term>
548                 <listitem>
549                     <para>文字列または文字列ベクトル</para>
550                     <para>
551                         このプロパティは,
552                         マウスがこのuicontrolの上を通過した際に表示される
553                         uicontrol tooltipのテキストを表します.
554                     </para>
555                 </listitem>
556             </varlistentry>
557             <varlistentry>
558                 <term>Units</term>
559                 <listitem>
560                     <para>{points} | pixels | normalized</para>
561                     <para>"Position"プロパティを指定するために使用される単位を設定します.</para>
562                 </listitem>
563             </varlistentry>
564             <varlistentry>
565                 <term>Userdata</term>
566                 <listitem>
567                     <para>Scilabデータを</para>
568                     <para>
569                         Scilabオブジェクト(string,string matrix, matrix mxn)をuicontrolに
570                         関連付ける際に使用できます.
571                     </para>
572                 </listitem>
573             </varlistentry>
574             <varlistentry>
575                 <term>Value</term>
576                 <listitem>
577                     <para>スカラーまたはベクトル</para>
578                     <para>
579                         uicontrolの値. 正確な意味はuicontrolのスタイルに依存します:
580                     </para>
581                     <itemizedlist>
582                         <listitem>
583                             <para>
584                                 <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: value is set to Max (see above)
585                                 when on and Min when off.
586                             </para>
587                         </listitem>
588                         <listitem>
589                             <para>
590                                 <literal>listbox</literal> および
591                                 <literal>popupmenu</literal> uicontrols:
592                                 値はリスト内で選択されたエントリの添字に対応する
593                                 添字のベクトルとなります.
594                                 1はリストの最初の要素です.
595                             </para>
596                         </listitem>
597                         <listitem>
598                             <para>
599                                 <literal>slider</literal> および
600                                 <literal>spinner</literal> uicontrols:
601                                 要素により指定された値.
602                             </para>
603                         </listitem>
604                         <listitem>
605                             <para>
606                                 <literal>layer</literal> および <literal>tab</literal> uicontrols:
607                                 表示された要素の添字.
608                             </para>
609                         </listitem>
610                         <listitem>
611                             <para>
612                                 <literal>image</literal> uicontrols:
613                                 値は,画像プロパティ
614                                 <literal>[X-Scale Y-Scale X-Shear Y-Shear RotationAngle]</literal>
615                                 を設定する際に使用されます.
616                             </para>
617                         </listitem>
618                     </itemizedlist>
619                 </listitem>
620             </varlistentry>
621             <varlistentry>
622                 <term>Verticalalignment</term>
623                 <listitem>
624                     <para>top | {middle} | bottom</para>
625                     <para>
626                         uicontrolでテキストの垂直アラインメントを設定します.
627                         このプロパティはText および CheckBoxes スタイルでのみ
628                         効果があります.
629                     </para>
630                 </listitem>
631             </varlistentry>
632             <varlistentry>
633                 <term>Visible</term>
634                 <listitem>
635                     <para>{on} | off</para>
636                     <para>
637                         uicontrolの可視/不可視を設定します. このプロパティが
638                         <literal>"on"</literal> (デフォルト)に設定された場合,uicontrolは可視です.
639                         しかし,このプロパティが<literal>"off"</literal>に設定された場合,
640                         uicontrolは親の図の中に表示されません.
641                     </para>
642                 </listitem>
643             </varlistentry>
644         </variablelist>
645     </refsection>
646     <refsection>
647         <title>Example for callback_type property</title>
648         <programlisting role="example"><![CDATA[
649 function counter_start()
650     // Callback called after a click on start pushbutton
651     global Stop
652     Stop=%f;
653     while %t
654         i = evstr(get("count", "string"));
655         set("count", "string", string(i+1));
656         if Stop then
657             break
658         end
659     end
660 endfunction
661
662 function counter_stop()
663     // Callback called after a click on stop pushbutton
664     global Stop
665     Stop=%t
666 endfunction
667
668 function counter_reinit()
669     // Callback called after a click on reset pushbutton
670     Stop=%t
671     set("count", "string", "0");
672 endfunction
673
674
675 counter_main_fig = figure( ...
676 "dockable", "off", ...
677 "infobar_visible", "off", ...
678 "toolbar_visible", "off", ...
679 "toolbar", "none", ...
680 "menubar_visible", "off", ...
681 "menubar", "none", ...
682 "layout", "none", ...
683 "visible", "off", ...
684 "resize", "off", ...
685 "figure_position", [0 0], ...
686 "axes_size", [400, 150], ...
687 "figure_name", "Counter", ...
688 "layout", "gridbag", ...
689 "tag", "counter_main_figure");
690
691
692 // Counter frame
693 counter_frame = uicontrol(counter_main_fig, ...
694 "layout", "gridbag", ...
695 "style", "frame", ...
696 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [1, 0.5], "both"));
697
698 uicontrol(counter_frame, ...
699 "style", "text", ...
700 "string", "Counter : ", ...
701 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [0.5, 1], "horizontal", "center"), ...
702 "margins", [5 5 5 5], ...
703 "horizontalAlignment", "center");
704
705 uicontrol(counter_frame, ...
706 "style", "text", ...
707 "string", "0", ...
708 "constraints", createConstraints("gridbag", [2, 1, 1, 1], [1, 1], "horizontal", "center"), ...
709 "tag", "count", ...
710 "margins", [5 5 5 5]);
711
712 // Buttons frame
713 buttons_frame = uicontrol(counter_main_fig, ...
714 "layout", "gridbag", ...
715 "style", "frame", ...
716 "constraints", createConstraints("gridbag", [1, 2, 1, 1], [1, 1], "both"));
717
718 // The associated callback needs to be interruptible (when clicking on stop or reset for example)
719 uicontrol("parent", buttons_frame, ...
720 "Style"     , "pushbutton", ...
721 "String"    , "Start", ...
722 "callback"  , "counter_start()", ...
723 "margins", [5 5 5 5], ...
724 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [1, 1], "horizontal", "center"));
725
726 // The associated callback needs to have priority in order to interrupt the current callback (in other words to stop the counter)
727 uicontrol("parent", buttons_frame, ...
728 "Style"     , "pushbutton", ...
729 "String"    , "Stop", ...
730 "callback"  , "counter_stop()", ...
731 "callback_type", 10, ...
732 "constraints", createConstraints("gridbag", [2, 1, 1, 1], [1, 1], "horizontal", "center"), ...
733 "margins", [5 5 5 5]);
734
735 // The same for the callback which reset the counter: it must have the priority over the callback which has started the counter
736 uicontrol("parent", buttons_frame, ...
737 "Style"     , "pushbutton", ...
738 "String"    , "Reset", ...
739 "callback"  , "counter_reinit()", ...
740 "callback_type", 10, ...
741 "constraints", createConstraints("gridbag", [3, 1, 1, 1], [1, 1], "horizontal", "center"), ...
742 "margins", [5 5 5 5]);
743
744 counter_main_fig.visible = "on";
745  ]]></programlisting>
746     </refsection>
747     <refsection role="see also">
748         <title>参照</title>
749         <simplelist type="inline">
750             <member>
751                 <link linkend="set">set</link>
752             </member>
753             <member>
754                 <link linkend="get">get</link>
755             </member>
756             <member>
757                 <link linkend="uicontrol">uicontrol</link>
758             </member>
759         </simplelist>
760     </refsection>
761     <refsection>
762         <title>履歴</title>
763         <revhistory>
764             <revision>
765                 <revnumber>6.0.0</revnumber>
766                 <revremark>
767                     <para>
768                         By default, callback_type property is now interruptible but non prioritary.
769                     </para>
770                 </revremark>
771             </revision>
772             <revision>
773                 <revnumber>5.5.0</revnumber>
774                 <revremark>
775                     <para>
776                         プロパティが追加・更新されました:
777                     </para>
778                     <itemizedlist>
779                         <listitem>Borderプロパティが追加されました.</listitem>
780                         <listitem>Scrollableプロパティが追加されました.</listitem>
781                         <listitem>Groupnameプロパティが追加されました.</listitem>
782                         <listitem>Iconプロパティが追加されました.</listitem>
783                         <listitem>Marginsプロパティが追加されました.</listitem>
784                         <listitem>Layoutプロパティが追加されました.</listitem>
785                         <listitem>Layout_properties プロパティが追加されました.</listitem>
786                         <listitem>
787                             Stringプロパティが
788                             <literal>listbox</literal>および
789                             <literal>combobox</literal> uicontrolsで色を設定する
790                             際に使用されるようになりました.
791                         </listitem>
792                         <listitem>Backgroundcolor および
793                             Foregroundcolor プロパティが
794                             オペレーティングシステム固有の値を管理するようになりました.
795                         </listitem>
796                     </itemizedlist>
797                 </revremark>
798             </revision>
799         </revhistory>
800     </refsection>
801 </refentry>