LinkToURL API 
Definition
The LinkToURL UI element is a kind of hypertext link.Navigating to this link leads to a user-defined Web resource (URL).
You can
assign a popup menu to LinkToURL which the user can recognize by this symbol:
.
Description of UI Element Properties
·
imageFirst
Defines the position of the icon in relation to the corresponding text. If the
value of this property is true, the icon
is displayed to the left of the text.
·
imageHeight
Specifies
the height of the graphic next to the link. You can specify the height in CSS
units like em, ex, pixels, or percentage.
·
imageSource
Specifies the Web address (URL) of the icon to be displayed. You can assign an
absolute Web address – http:// … to this property.
If you store the icons in the directory mimes/Components/<component
class> of the Web
Dynpro project in the Navigator using the menu item Import, you
only need to enter the name of the icon - for example, icon.gif. The URL
Generation Service automatically determines the URL of the icon (see also URL Generation
Service).
You can also store the icons in directory mimes/Applications/<application
class>. In this
case, you must create the URL manually using the URL Generation Service.
If you use the SAP icons and want to refer to them, you can use the alias
~sapicons. If you
assign the alias ~sapicons/<name>.gif to the
imageSource
property, you refer to an icon called <name>.gif of the SAP
icons. For a description and a listing of all possible SAP icons, see the SAP
Design Guild under http://www.sapdesignguild.org/. Select
the following path:
Sitemap ® Resources ® Visual
Design & Icons ® SAP R/3
Icons ® R/3 Icon
Lists.
The filename of the icon consists of the bitmap name entered in the table and
the prefix “s_”. If the bitmap name in the table is F_CUTO, you
need to enter ~sapicons/s_f_cuto.gif to reference to the SAP icon 
.
·
imageWidth
Specifies
the width of the graphic next to the LinkToURL. You can specify the width in
CSS units like em, ex, pixel, or percentage.
·
reference
Describes the address of the Web page to be opened.
·
size
Specifies
the size of the Link UI element. The size property can
take the following values and is represented by the enumeration type
WDLinkSize.
small |
The UI element is displayed with a small font. |
standard |
A default size is displayed. |
·
target
Specifies the browser window in which the page is to be opened. You can
manually specify the name of the target window or use the following
values:
¡
""
The page is opened in a new window without a name. This is the default
value.
¡ _self is no longer supported. Use exit plugs instead and specify the URL there.
·
text
Describes
the label text.
·
textDirection
Specifies the text direction and allows you to use a LinkToURL element for
texts in languages that require a specific text direction. The textDirection property
can be filled with the following values and is represented by the enumeration
type WDTextDirection.
The text direction is inherited from the parent element. Therefore, the text direction is identical to the one of the parent element. |
|
The default value for this property is inherit.
·
type
Specifies
the graphical design of the UI element. The typeproperty can
be filled with the following values and is represented by the enumeration type
WDLinkType.
function |
|
Link is displayed underlined in the standard design. |
navigation |
|
Link is displayed underlined and with a font color that is used for links already visited. |
reporting |
|
Link is displayed not underlined in the standard design. |
result |
|
Link is displayed not underlined. |
·
wrapping
Indicates whether or not the link text is wrapped. If the initial value is
false, the link
text is not wrapped.
Overview of Inherited and Additional Properties
Name |
Interface |
Type |
Initial Value |
Bindable |
Value Required |
enabled |
IWDUIElement |
boolean |
true |
bindable |
No |
imageFirst |
IWDAbstractCaption |
boolean |
true |
bindable |
No |
imageHeight |
IWDLink |
String (CSS size) |
|
bindable |
No |
imageSource |
IWDAbstractCaption |
String |
|
bindable |
No |
imageWidth |
IWDLink |
String (CSS size) |
|
bindable |
No |
reference |
IWDLinkToURL |
String |
|
bindable |
Yes |
size |
IWDLink |
WDLinkSize |
standard |
bindable |
No |
target |
IWDLinkToURL |
String |
|
bindable |
No |
text |
IWDLink |
String (TranslatableText) |
|
bindable |
No |
textDirection |
IWDAbstractCaption |
WDTextDirection |
inherit |
bindable |
No |
tooltip |
IWDUIElement |
String (TranslatableText) |
|
bindable |
No |
type |
IWDLinkToURL |
WDLinkType |
navigation |
bindable |
No |
visible |
IWDUIElement |
WDVisibility |
visible |
bindable |
No |
wrapping |
IWDLink |
boolean |
false |
bindable |
No |