1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="vspx_textarea">
<refmeta>
<refentrytitle>vspx_textarea</refentrytitle>
<refmiscinfo>vspx_control</refmiscinfo>
</refmeta>
<refnamediv>
<refname>vspx_textarea</refname>
<refpurpose>generic text-area input</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="syn_vspx_textarea">
<funcprototype id="proto_vspx_textarea">
<funcdef>
<function>textarea</function>
</funcdef>
<attributes>
<attribute>name (required) </attribute>
<attribute>annotation (optional) </attribute>
<attribute>initial-enable (optional) </attribute>
<attribute>default (optional) </attribute>
<attribute>value (optional) </attribute>
</attributes>
<childs>
<child>after-data-bind</child>
<child>after-data-bind-container</child>
<child>before-data-bind</child>
<child>before-data-bind-container</child>
<child>on-post</child>
<child>on-post-container</child>
<child>before-render</child>
<child>before-render-container</child>
<child>validator</child>
</childs>
<class>
<screen><![CDATA[
create type vspx_textarea under vspx_text temporary self as ref
constructor method vspx_textarea (name varchar, parent vspx_control),
overriding method vc_render () returns any
;
]]>
</screen>
</class>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_vspx_textarea">
<title>Description</title>
<para>
<function>vspx_textarea</function>Scriptable, databindable representation of HTML text area.</para>
</refsect1>
<refsect1 id="attrs_vspx_textarea">
<title>Attributes</title>
<refsect2>
<title>name</title>
<para>A unique name identifying the control.</para>
</refsect2>
<refsect2>
<title>annotation</title>
<para>A human readable comment.</para>
</refsect2>
<refsect2>
<title>initial-enable</title>
<para>Designates is control visible or not initially. Could be data-bound to an SQL expression.</para>
</refsect2>
<refsect2>
<title>default</title>
<para>The default value of the field. Can be accessed via control.ufl_value n data bind stage.</para>
</refsect2>
<refsect2>
<title>value</title>
<para>A data-bound expression for calculating field's value.</para>
</refsect2>
</refsect1>
<refsect1 id="childs_vspx_textarea">
<title>Children</title>
<refsect2>
<title>validator</title>
<para>validator that is applied to user input.
the validator objects are invoked when the element's control gets posted. the validator elements only make sense inside field or form types of controls. the validators are invoked in the order given, and the first one to fail stops the invocation chain, so that no later ones are attempted.
furthermore the vc_is_valid member of the containing page class will be reset to false (0) to stop further processing. see also error-summary element and error-glyph attribute of field element.
</para>
</refsect2>
</refsect1>
<refsect1 id="examples_vspx_textarea">
<title>Examples</title>
<example id="ex_vspx_textarea">
<title>Simple example</title>
<para>This is to draw a single text area in a form
</para>
<screen><![CDATA[
<v:textarea name="ta1"
default="enter your text here"
value="--coalesce ({?'ta1'}, control.ufl_value)" >
</v:textarea>
]]>
</screen>
</example>
</refsect1>
</refentry>
|
