Embedded

Set the Embedded property to true to use the IFRAME element for a Web page defined in the URL property of a StaticHyperLink control. This causes the Web page to appear inline on the Web Forms page (window) containing the StaticHyperLink control.

Applies to

StaticHyperLink controls

Usage

In scripts, 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 appear, but the page referenced in its 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.