This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for

Sets the top window coordinate.


HRESULT put_Top(



New top coordinate, in pixels.

Return Value

Returns an HRESULTvalue.


The window has a position on the desktop. This is expressed in pixels by four coordinates (left, top, right, and bottom).

Interfaces that are automated by OLE typically express this position through left, top, width, and height; this is the convention used in DirectShow.

All coordinates are expressed in pixels, and changing any coordinate will update the window immediately.

Setting the left or top coordinates moves the window left or up, respectively; these coordinates have no effect on the width and height of the window. Likewise, setting the width and height does not affect the left and top coordinates.


Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment