Learn what Felgo offers to help your business succeed. Start your free evaluation today! Felgo for Your Business

QPdfLinkModel Class

The QPdfLinkModel class holds the geometry and the destination for each link that the specified page contains. More...

Header: #include <QPdfLinkModel>
Since: Qt 6.6
Inherits: QAbstractListModel

Public Types

enum class Role { Link, Rectangle, Url, Page, Location, Zoom }

Properties

Public Functions

QPdfLinkModel(QObject *parent = nullptr)
virtual ~QPdfLinkModel() override
QPdfDocument * document() const
QPdfLink linkAt(QPointF point) const
int page() const

Reimplemented Public Functions

virtual QVariant data(const QModelIndex &index, int role) const override
virtual int rowCount(const QModelIndex &parent) const override

Public Slots

void setDocument(QPdfDocument *document)
void setPage(int page)

Signals

void documentChanged()
void pageChanged(int page)

Detailed Description

This is used in PDF viewers to implement the hyperlink mechanism.

Member Type Documentation

enum class QPdfLinkModel::Role

Constant Value Description
QPdfLinkModel::Role::Link Qt::UserRole A QPdfLink object.
QPdfLinkModel::Role::Rectangle 257 Bounding rectangle around the link.
QPdfLinkModel::Role::Url 258 If the link is a web link, the URL for that; otherwise an empty URL.
QPdfLinkModel::Role::Page 259 If the link is an internal link, the page number to which the link should jump; otherwise -1.
QPdfLinkModel::Role::Location 260 If the link is an internal link, the location on the page to which the link should jump.
QPdfLinkModel::Role::Zoom 261 If the link is an internal link, the suggested zoom level on the destination page.

Property Documentation

document : QPdfDocument*

This property holds the document to load links from.

Access functions:

QPdfDocument * document() const
void setDocument(QPdfDocument *document)

Notifier signal:

void documentChanged()

page : int

This property holds the page to load links from.

Access functions:

int page() const
void setPage(int page)

Notifier signal:

void pageChanged(int page)

Member Function Documentation

[explicit] QPdfLinkModel::QPdfLinkModel(QObject *parent = nullptr)

Constructs a new link model with parent object parent.

[override virtual noexcept] QPdfLinkModel::~QPdfLinkModel()

Destroys the model.

[override virtual] QVariant QPdfLinkModel::data(const QModelIndex &index, int role) const

Reimplements: QAbstractItemModel::data(const QModelIndex &index, int role) const.

QPdfLink QPdfLinkModel::linkAt(QPointF point) const

Returns a valid link if found under the point (given in units of points, 1/72 of an inch), or an invalid link if it is not found. In other words, this function is useful for picking, to handle mouse click or hover.

[override virtual] int QPdfLinkModel::rowCount(const QModelIndex &parent) const

Reimplements: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Qt_Technology_Partner_RGB_475 Qt_Service_Partner_RGB_475_padded