Share via


CustomViewPort.Rectangle Property

Gets or sets the rectangle representing the bounding box for the custom view port. Width, height, and position properties must be set for the custom view port to display.

Note   This property has been deprecated.

Syntax

  CustomViewPort.Rectangle

Property Value

A Rectangle representing the bounding box.

Remarks

The values for the rectangle are defined in pixels. Values for the left, top, width, and height properties must be established before the custom view port can be made visible. The function to show the custom view port cannot be called until the page has completed loading. Calling that function from the onload event for the BODY will be successful, but calling it from script somewhere else on the page will not provide the correct result, if it is called before the onload event for the page is fired.

Setting dimension or position properties to negative numbers may not give you the result you expect. If you set the height or width to a negative number, the size will become full-screen for that dimension. If you set the height or width to zero, the size will become slightly more than half of the screen for that dimension. If you set the Left or Top properties to a negative number, the content of the view port will display partly off the screen, but the view port itself will display as if you had set that property to zero; a gap of the color of your MediaCenter.BGColor property will show between the content and the edge of the view port.

Requirements

Platform: HTML application hosted within Windows XP Media Center Edition 2004 through Windows Vista

See Also