Displaying hyperlink(s) associated with an entity

By Balaji Ramamoorthy

The code below demonstrates the use of the Hyperlink classes. (AcDbHyperlink, AcDbEntityHyperlinkPE and AcDbHyperlinkCollection ). There is a protocol extension associated with every entity in the AutoCAD database and this code example displays the hyperlink associated with an entity.

NOTE: See the “Hyperlink Example” in the ObjectARX Developer’s Guide for another example for accessing hyperlinks. That example shows how to add a hyperlink to a selected entity.

ads_name ename;
ads_point pt;
 
int ret;
ret = acedEntSel
        (
            _T("nSelect an entity with hyper link(s): "),
            ename, 
            pt
        );
if(ret != RTNORM)
    return;
 
AcDbObjectId gId;
acdbGetObjectId(gId, ename);
 
AcDbEntity* pEnt = NULL;
if(acdbOpenAcDbEntity(pEnt, gId, AcDb::kForRead) == Acad::eOk)
{
    bool bHasHyperLink = false;
 
    AcDbEntityHyperlinkPE *pHyperLinkPE = ACRX_X_CALL(pEnt, AcDbEntityHyperlinkPE);
    pHyperLinkPE->hasHyperlink
        (
            (AcDbObject*)pEnt, 
            bHasHyperLink
        );
 
    if(bHasHyperLink == true)
    {
        AcDbHyperlinkCollection* phlc;
 
        pHyperLinkPE->getHyperlinkCollection((AcDbObject*)pEnt, phlc);
        for(int i=0; icount(); i++)
        {
            AcDbHyperlink* phl = phlc->item(i);
            acutPrintf(_T("nHyperlink on this entity = %s"),phl->name());
        }
        delete phlc;
    }
    pEnt->close();
}