Web
Dynpro TextView API - IWDTextView 
Definition
The TextView UI element provides an area for displaying a multiline text.
Use
When using a TextView user interface element, you should always add a label to ensure accessibility.
Description of the UI Element Properties
·
design
Describes the appearance of
the TextView UI element. The Cascading Style Sheet (CSS) provided by SAP
describes the variations of the design attribute display.
emphasized |
Highlights the text and applies the standard font size. |
header 1 |
Highlights the text and applies the standard font size +4. |
header 2 |
Highlights the text and applies the standard font size +2. |
header 3 |
Highlights the text and applies the standard font size. |
header 4 |
Highlights the text and applies the standard font size –1 (small) -> (like the legend value, highlighted). |
label |
Displays the text using the standard font, a blank is inserted after the text. |
label_small |
Displays the text using the standard font like the label value and the standard font size –1 like the font size for the header4 value. |
legend |
Displays the text using the standard font size –1. |
monospace |
Displays the text using a non-proportional font size. Each letter takes up the same space. |
reference |
Displays the text in italics and applies the standard font size. |
standard |
Displays the text using the standard font size. No text attributes are defined for this value. |
·
layout
Describes the text
alignment.
block |
Displays the TextView UI element in a <div> tag. |
native |
Displays the TextView UI element in a < span > tag. |
paragraph |
Displays the TextView UI element in a < p > tag. |
·
text
Describes the text to be
displayed.
·
wrapping
Specifies whether the text
can be wrapped.
Overview of Inherited and Additional Properties
Name |
Interface |
Type |
Initial Value |
Bindable |
Value Required |
design |
IWDTextView |
WDTextViewDesign |
standard |
bindable |
No |
IWDUIElement |
boolean |
true |
bindable |
No |
|
layout |
IWDTextView |
WDTextViewLayout |
native |
bindable |
No |
text |
IWDTextView |
String (TranslatableText) |
|
bindable |
No |
IWDUIElement |
String (TranslatableText) |
|
bindable |
No |
|
IWDUIElement |
WDVisibility |
visible |
bindable |
No |
|
wrapping |
IWDTextView |
boolean |
false |
bindable |
No |
The enabled property is ignored and does not affect the browser.
Mobile Characteristics
The UI element TextView supports the development of mobile applications for pocket PCs and BlackBerry wireless handhelds (see Mobile Web Dynpro).
However, several properties supported in the desktop browser cannot be used. These include:
Variances of the properties
Properties |
Pocket PC |
BlackBerry wireless handheld |
enabled |
ignored |
ignored |
layout |
ignored |
ignored |
tooltip |
ignored |
ignored |
wrapping |
ignored |
ignored |
Methods in the Web Dynpro IWDTextView API
Method Name |
Parameter |
Return Value |
Short Description |
bindDesign |
(String path) |
|
Binds the value of the design property to the context element specified by the path. |
bindingOfDesign |
|
String |
Returns the path of the context element to which the design property is bound. Returns NULL if no binding exists. |
bindingOfLayout |
|
String |
Returns the path of the context element to which the layout property is bound. Returns NULL if no binding exists. |
bindingOfText |
|
String |
Returns the path of the context element to which the text property is bound. Returns NULL if no binding exists. |
bindingOfWrapping |
|
String |
Returns the path of the context element to which the wrapping property is bound. Returns NULL if no binding exists. |
bindLayout |
(String path) |
|
Binds the value of the layout property to the context element specified by the path. |
bindText |
(String path) |
|
Binds the text property to the context node specified by a path. |
bindWrapping |
(String path) |
|
Binds the wrapping property to the context node specified by a path. |
getDesign |
|
WDTextViewDesign |
Returns the value of the design property. |
getLayout |
|
WDTextViewLayout |
Returns the value of the layout property. |
getText |
|
String |
Returns the value of the text property. |
getWrapping |
|
boolean |
Returns the value of the wrapping property. |
setDesign |
(WDTextViewDesign design) |
|
Sets the value of the design property. |
setLayout |
(WDTextViewLayout layout) |
|
Sets the value of the layout property. |
setText |
(String text) |
|
Sets the value of the text property. |
setWrapping |
(boolean wrapping) |
|
Sets the value of the wrapping property. |
Additional methods are available using inheritance: IWDUIElement, IWDViewElement.
For detailed documentation of all inherited methods, see the documentation for the relevant APIs.