User Tools

Site Tools


aximagecanvas

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
aximagecanvas [2019/10/14 04:54]
bloguintosh [Minimum Requirements]
aximagecanvas [2019/10/14 05:23] (current)
bloguintosh [Releases History]
Line 1: Line 1:
 ====== AXImageCanvas ====== ====== AXImageCanvas ======
  
-Canvas based UI control for Desktop ​Xojo developers (Desktop Lite, Desktop, Pro and Pro Plus); both for 32 and 64 Bits deployments on macOS, Windows and Linux.+Canvas based UI control for Xojo Desktop ​developers (Desktop Lite, Desktop, Pro and Pro Plus); both for 32 and 64 Bits deployments on macOS, Windows and Linux.
  
 This Class is available as **Standard Edition** and **Database Edition**. This Class is available as **Standard Edition** and **Database Edition**.
  
 You can work with the AXImageCanvas class from the IDE without restrictions when running your own apps in **Debug Mode**; but a license is required when you're ready to Build any project containing this class. You can work with the AXImageCanvas class from the IDE without restrictions when running your own apps in **Debug Mode**; but a license is required when you're ready to Build any project containing this class.
 +
 +===== Class Description =====
 +
 +AXImageCanvas greately simplifies the task of displaying a Picture into the containing control area (Width and Height), with the ability to correctly display the image maintaining its original aspect ratio whitout touching the original picture. This can be done from any dropped image from inside the app, via a Picture File dropped from the Desktop, or another Picture dropped from another **AXImageCanvas** control or executing App, plus any copied picture from another app or source. Of course, the displayed image can be set programmatically,​ just passing the desired Picture Object (instance).
 +
 +If the dropped image comes from a File, then the AXImageCanvas instance will keep a reference to the original FolderItem, so it is possible to do additional operations on it.
 +
 +AXImageCanvas supports the Copy, Paste, Cut, Clear (Delete) and Undo actions selected from the app menu or using the equivalent keyboard shortcuts.
  
 ===== AXImageCanvas in the Store ===== ===== AXImageCanvas in the Store =====
Line 37: Line 45:
   * MySQLCommunityPlugin.xojo_plugin   * MySQLCommunityPlugin.xojo_plugin
   * PostgreSQLPlugin.xojo_plugin   * PostgreSQLPlugin.xojo_plugin
 +
 +==== AXImageCanvas and Xojo API 1.0 and API 2.0 ====
 +
 +Since version 1.2.0, AXImageCanvas folder contains two demo projects:
 +
 +  * **AXImageCanvas API 1.** Use the class version found inside this Demo project with Xojo 2019r2 (or any of the previous supported releases), when your project uses API 1.0 code.
 +  * **AXImageCanvas API 2.** Use the class version found inside this Demo project with Xojo 2019r2 and later when your project uses API 2.0 code.
  
 ==== Licensing AXImageCanvas ==== ==== Licensing AXImageCanvas ====
Line 46: Line 61:
 Replacing ''​Name'',​ ''​Surname''​ and ''​Data''​ values with the information got from AprendeXojo after purchasing the license. Replacing ''​Name'',​ ''​Surname''​ and ''​Data''​ values with the information got from AprendeXojo after purchasing the license.
  
-==== Dragging Images From AXImageCanvas Instances ==== 
- 
-In order to start the Drag action from any AXImageCanvas Instance, press the ''​Command''​ key while start dragging with the pointing device on **macOS**; press the ''​Alt''​ key while start dragging with the pointing device on **Windows** and **Linux**. 
- 
-===== Class Description ===== 
- 
-AXImageCanvas greately simplifies the task of displaying a Picture into the containing control area (Width and Height), with the ability to correctly display the image maintaining its original aspect ratio whitout touching the original picture. This can be done from any dropped image from inside the app, via a Picture File dropped from the Desktop, or another Picture dropped from another **AXImageCanvas** control or executing App, plus any copied picture from another app or source. Of course, the displayed image can be set programmatically,​ just passing the desired Picture Object (instance). 
- 
-If the dropped image comes from a File, then the AXImageCanvas instance will keep a reference to the original FolderItem, so it is possible to do additional operations on it. 
- 
-AXImageCanvas supports the Copy, Paste, Cut, Clear (Delete) and Undo actions selected from the app menu or using the equivalent keyboard shortcuts. 
  
 ===== How to use AXImageCanvas in your own projects (Install) ===== ===== How to use AXImageCanvas in your own projects (Install) =====
Line 113: Line 117:
 ===== AXImageCanvas Database Error Handling ===== ===== AXImageCanvas Database Error Handling =====
 Since AXImageCanvas 1.2, the component is not silent about errors with the database operations / access, displaying by default a dialog for every database access error during any of the supported CRUD operations. This is configurable via the ''​RaiseDatabaseExceptions As Boolean''​ property. When set to ''​True'',​ the AXImageCanvas instance will raise an exception that must be catched by the calling code for the operation. Since AXImageCanvas 1.2, the component is not silent about errors with the database operations / access, displaying by default a dialog for every database access error during any of the supported CRUD operations. This is configurable via the ''​RaiseDatabaseExceptions As Boolean''​ property. When set to ''​True'',​ the AXImageCanvas instance will raise an exception that must be catched by the calling code for the operation.
 +
 +===== Dragging Images From AXImageCanvas Instances =====
 +
 +In order to start the Drag action from any AXImageCanvas Instance, press the ''​Command''​ key while start dragging with the pointing device on **macOS**; press the ''​Alt''​ key while start dragging with the pointing device on **Windows** and **Linux**.
  
 ===== AXImageCanvas Shared Properties ===== ===== AXImageCanvas Shared Properties =====
Line 177: Line 185:
   * Open (API 1.0)   * Open (API 1.0)
   * **Opening** (API 2.0)   * **Opening** (API 2.0)
 +
 +===== AXImageCanvas Delegates Definition =====
 +
 +^Delegate Signature^Description^Standard Edition^Database Edition^
 +|SelectionCallback(Control As AXImageCanvas)|Use any method in your code with this signature to receive the AXImageCanvas instance that is selected (has the focus). For that, the method has to be assigned to the SelectionDelegate Property.|Yes|Yes|
  
 ===== Releases History ===== ===== Releases History =====
Line 185: Line 198:
 |1.0.2|2019-10-02|[Add] Backwards compatibility to work with Xojo 2017r3 and later. [New] AcceptDroppedImages property. When set, it accepts dropped image files. [New] ImageDeleted event. If implemented,​ this event fires when the user (or code) deletes the image from the instance. [Add] Other minor improvements based on customers requests.| |1.0.2|2019-10-02|[Add] Backwards compatibility to work with Xojo 2017r3 and later. [New] AcceptDroppedImages property. When set, it accepts dropped image files. [New] ImageDeleted event. If implemented,​ this event fires when the user (or code) deletes the image from the instance. [Add] Other minor improvements based on customers requests.|
 |1.1.0|2019-10-09|[Add] New AXImageCanvasEnabledDB public module to better manage the code associated with the supported databases engines at compilation time. That means, among other things, that any project using AXImageCanvas will not include the Xojo database plug-ins for those databases that are not in use in the App. [Change] The DoubleClicked Event Handler Definition is now DoubleClick so it not collides in Xojo 2019r2. [Improved] Compatibility with Xojo 2019r2 "out of the box". The complete rewriting for API 2.0 is under testing.| |1.1.0|2019-10-09|[Add] New AXImageCanvasEnabledDB public module to better manage the code associated with the supported databases engines at compilation time. That means, among other things, that any project using AXImageCanvas will not include the Xojo database plug-ins for those databases that are not in use in the App. [Change] The DoubleClicked Event Handler Definition is now DoubleClick so it not collides in Xojo 2019r2. [Improved] Compatibility with Xojo 2019r2 "out of the box". The complete rewriting for API 2.0 is under testing.|
 +|1.2.0|2019-10-14|[Add] New API 2.0 version of AXImageCanvas,​ so it can be used in combination with any project started using the Xojo API 2.0 in Xojo 2019r2 and later. [Add] New RaiseDatabaseException Property to set the way every instance deals with Database access errors. By default it is set to False what means that it will display a dialog with the error information. When set to True it raises an Exception that must be catched by the calling code.[Improved] AXICL class.|
aximagecanvas.1571021680.txt.gz ยท Last modified: 2019/10/14 04:54 by bloguintosh