Detect Hyperlink Type with C++

Detect Hyperlink Type

An Excel file can have different types of hyperlinks, such as external links, cell references, file paths, etc. Aspose.Cells provides the ability to detect the type of a hyperlink. The types of hyperlinks are represented by the TargetModeType enumeration. The TargetModeType enumeration has the following members.

• External: External link
• FilePath: Local and full path to files/folders.
• Email: Email link
• CellReference: Link to a cell or named range.

To check the type of a hyperlink, the Hyperlink class provides a LinkType property whose return type is TargetModeType. The following code snippet demonstrates the use of the LinkType property with this source Excel file.

Source Code

#include <iostream>
#include <codecvt>
#include <locale>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    Workbook workbook(srcDir + u"LinkTypes.xlsx");

    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    if (!worksheet)
    {
        std::cerr << "Worksheet not found!" << std::endl;
        Aspose::Cells::Cleanup();
        return 1;
    }

    Range range = worksheet.GetCells().CreateRange(u"A1", u"A7");
    if (!range)
    {
        std::cerr << "Range creation failed!" << std::endl;
        Aspose::Cells::Cleanup();
        return 1;
    }

    Vector<Hyperlink> hyperlinks = range.GetHyperlinks();

    for (int i = 0; i < hyperlinks.GetLength(); ++i)
    {
        Hyperlink link = hyperlinks[i];
        if (link)
        {
            std::cout << link.GetTextToDisplay().ToUtf8() << ": "
                << static_cast<int>(link.GetLinkType()) << std::endl;
        }
    }

    Aspose::Cells::Cleanup();
    return 0;
}

The following is the output generated by the code snippet above.

Console Output

LinkTypes.xlsx: FilePath </br>
C:\Windows\System32\cmd.exe: FilePath </br>
C:\Program Files\Common Files: FilePath </br>
'Test Sheet'!B2: CellReference </br>
FullPathExample: CellReference </br>
https://products.aspose.com/cells/ : External </br>
mailto:[e-mail]?subject=TestLink: Email </br>