This function returns the OID of the object displayed in column 1 on the top line of the window containing the document specified by doc. If doc is omitted or 0, the current document is used. The oid_top_pos function also sets the output variable pos to the character position following the top left column of the window.

This function is useful for restoring a screen position using scroll_to_oid, for example,