Embedded

Applies to

StaticHyperLink controls

Description

When you set the Embedded property to true for a StaticHyperLink control, the IFRAME element is used to embed the Web page that you defined in the control’s URL property. The Web page displays inline on the Web Forms page.

Usage


In scripts

The following code sets the Embedded property to “true”. You must surround the Embedded property in a conditional compilation code block for Web Forms applications:

#IF DEFINED PBWEBFORM THEN
   shl_1.Embedded = true 	  
#END IF

If you place the above code in the Open event for a window containing the StaticHyperLink control, or in the control’s Constructor event, the hyperlink text does not display, but the page referenced in the URL property opens in the area defined by the control in the Web Forms page.

When you enable the Embedded property, you must consider enlarging the size of the StaticHyperLink control to permit adequate viewing of the embedded Web page, although at runtime, the IFRAME element that replaces the control includes horizontal and vertical scroll bars if the page size exceeds the size of the original control.

Some Web sites use JavaScript code to make sure their pages display as top level HTML windows. This can cause JavaScript errors and erratic behavior when Embedded is set to true.