When a program or library is under constant development there will be times where improvements to one functionality will render related functionality obsolete. This is one of those times. Our right click find functionality has become obsolete, when compared to our current search functionality it is slow and cumbersome and we plan on removing the functionality in future releases.
How to use the two functionalities.
To search using the right click you must first highlight a section of text whilst holding the alt key. The right click find does not support multiple highlight areas. Then we must right click on the display area and select the find option. After this a series of 4 option panes pop up in the following order.
- Search Term input.
- Case Sensitive search option.
- Find all comparisons or just first option.
- Search from cross line results (words split over multiple lines) option.
After this a final pop up is shown that displays the top left coordinate of the results found without highlighting them.
To search with the menu bar you type the search term into the menu bar and hit the enter key. The first search term is discovered and highlighted the moment it is found. If this search term is not in the view or on a different page the view is updated to display the result. After this the there are two buttons beside the search area that allow you to find the next / previous results. Should you wish to alter the settings for the search there is a drop down menu beside the search box. Here you can set options including an option to display all results so each is highlighted. These values will remain set for future searchs.
Comparison of the two functionalities and their benefits.
So the search menu bar is faster to use as there is no need to navigate multiple option panes. It actually displays the search results making them easier to find on page and see in context. The menu bar search also has additional functionality including support for regular expressions as search terms.
The only two advantages to the right click method is that coordinates are displayed in the viewer and you can specify an area smaller than a page to search.
Considering the differences in usage it should appear obvious that the right click functionality is becoming out dated for the current state of the viewer.
Plans for removal of the right click find functionality.
In the next release, where the functionality is removed, the actual code will still be present but the option will be removed from the menu. If anyone is still planning on using the right click find functionality it can be activated again by uncommenting the following code from SwingMouseSelector.
// rightClick.addSeparator(); // // rightClick.add(find);
Please note this functionality will not remain commented forever and will be fully removed eventually, if you are currently using it instead of the newer menu bar search functionality please contact us and let us know so we can see what can be done.
IDRsolutions develop a Java PDF library, a PDF forms to HTML5 converter, a PDF to HTML5 or SVG converter and a Java Image Library that doubles as an ImageIO replacement. On the blog our team post about anything interesting they learn about.