AcApLayoutManager::pointInViewports

C++

virtual Acad::ErrorStatus pointInViewports(
    const AcGePoint3d & pickPt, 
    AcDbObjectIdArray & viewports
) = 0;

Description

This function takes a Paperspace pick point, and passes back a list, in the form of an AcDbObjectIdArray, of the AcDbObjectId entities of every AcDbViewport that overlays the pick point, including non-rectangular viewports.

If viewports overlap each other at the pick point, all of them will be returned, but the first AcDbViewport Id in the array will be the viewport that would be selected if the user double-clicked at the point. The PaperSpace viewport will never be included in the array. If no viewports are at the pick point, ePointNotOnEntity will be returned, and the AcDbObjectIdArray will not be created. If at least one viewport is in the array, eOk will be returned. The caller must delete the returned AcDbObjectIdArray when finished with it. This routine allows an application to easily determine if a given point lies within a non-rectangular (clipped) viewport.

Parameters

Links

AcApLayoutManager