IPXV_DocSelChangedEvent / IPXV_DocSelection / Cluster  SOLVED

PDF-XChange Editor SDK for Developers

Moderators: TrackerSupp-Daniel, Tracker Support, Chris - Tracker Supp, Vasyl-Tracker Dev Team, Sean - Tracker, Paul - Tracker Supp, Tracker Supp-Stefan, Ivan - Tracker Software

Forum rules
DO NOT post your license/serial key, or your activation code - these forums, and all posts within, are public and we will be forced to immediately deactivate your license.

When experiencing some errors, use the IAUX_Inst::FormatHRESULT method to see their description and include it in your post along with the error code.
Post Reply
Posts: 1034
Joined: Thu Sep 05, 2019 12:35 pm

IPXV_DocSelChangedEvent / IPXV_DocSelection / Cluster

Post by zarkogajic » Thu May 13, 2021 2:53 pm

Hi Support,

What is "Cluster" in IPXV_DocSelection ?

And (I guess related):

ClusterID in IUIX_Layout

GetSelCluster in IPXV_Document


User avatar
Vasyl-Tracker Dev Team
Site Admin
Posts: 2056
Joined: Thu Jun 30, 2005 4:11 pm
Location: Canada

Re: IPXV_DocSelChangedEvent / IPXV_DocSelection / Cluster

Post by Vasyl-Tracker Dev Team » Tue May 18, 2021 6:40 pm

Hi žarko.

About IPXV_DocSelection::ClusterID. Editor has many types of selections in UI: selection of comments, content(s) selection, bookmark(s) selection, link(s) selection, etc. So user may select bookmarks in Bookmarks pane then he also may select some comments on pages(or in Comments pane) and both such selections can coexist well. However, when you try to selected some comments and then try to select some content items on pages (or via Content pane) - then comments-selection will be immediately replaced by new content-selection. Because: content- and comment- selection are in the same virtual cluster of selections (clusterID='pagesView') and cannot be both in the same time and cluster. While the bookmarks-selection belongs to own 'bookmarksView'-cluster and doesn't 'conflict' with any selection from 'pagesView'-cluster and stays alive while you select content/comment. So, selection-clusters is a simple mechanism that allows you to determine which types of selections conflict with each other and which do not and can coexist in document at the same time.
IPXV_Document::GetSelCluster(selClusterID) - it returns current selection for specified cluster. For example IPXV_Document::GetSelCluster(Str2ID('pagesView')) may return existing comment-selection OR content-selection, OR links-selection, OR formField-selection.

IUIX_Layout::ClusterID - there is the similar idea but for other purpose: user will be able to D&D panes between two different layout-objects only when both of them have the same ClusterID. Currently we have only one case where many layout-objects have the same clusterID -- 'documentViewsArea' layout-objects which all have the same clusterID (it also equals to Str2ID('documentViewsArea')). As result - user can D&D document-tabs between different mainFrames but he still cannot put document-tab inside other document-tab for example (because inside document-tab exists layout-object with another clusterID='documentView').

Vasyl Yaremyn
Tracker Software Products
Project Developer

Please archive any files posted to a ZIP, 7z or RAR file or they will be removed and not posted.

Posts: 1034
Joined: Thu Sep 05, 2019 12:35 pm

Re: IPXV_DocSelChangedEvent / IPXV_DocSelection / Cluster  SOLVED

Post by zarkogajic » Tue May 18, 2021 8:41 pm

Great. Thanks Vasyl for the detailed answer.

User avatar
Sasha - Tracker Dev Team
Posts: 5496
Joined: Fri Nov 21, 2014 8:27 am

IPXV_DocSelChangedEvent / IPXV_DocSelection / Cluster

Post by Sasha - Tracker Dev Team » Wed May 19, 2021 5:55 am

Subscribe at:

Post Reply