int ViewAdd(char *filename, int x, int y, int (*callback)(int id, int event, int x, int y), int id);
Add a View with an Image and a Touch callback
Return Value
Returns an int handle to the view.
Parameters
filename The file must be located in the folder where the exe is running. This is typically inside your Visual C++ project in your /Debug folder. A filename "Ball.png" will be loaded from Debug/Ball.png. If the filename specified is "Images/Ball.png" the file will be loaded from Debug/Images/Ball.png. If a path is included in the filename, it is a relative path from the Debug folder (where the exe is running from). Use forward slashes / as needed (not backslash) and never start a filename path with a slash.
The path to the file named in this parameter must be in the Assets folder where your application resides. (Typically, your project's Debug or Release folder. For example, if your project is in C:\DragonFireSDK\, your Assets folder will be C:\DragonFireSDK\Debug\Assets or C:\DragonFireSDK\Release\Assets.)
NOTE: The file system used by iOS is case sensitive, so be sure to match the case of the file name in your code to that of the file on your computer.
x x coordinate.
y y coordinate.
callback Specifies a function that will be called when the image in this view is touched.
int OnBall(int id, int event, int x, int y) //event: 1=down, 2=move, 3=up { if (event == 3) { // touch up (touched and released) //...do something } return 0; }
id Touch id to be sent to callback.
Remarks
The ViewAdd() function makes an image visible. This function internally calls ImageAdd() for you and assigns the image specified by the filename to the view. It also internally calls TouchAdd() to setup a touch area the size of the image and the callback you specify will be called when the View/Image/Touch is touched. The callback must be defined with the parameters listed.
Availability
Available in DragonFireSDK 1.0 and later.
Example
This example adds a view with an image of a card to the screen and sets a callback.
#include "DragonFireSDK.h"
int OnTouch(int id,int event,int x, int y) { printf("You touched the card!\n"); return(id); }
void AppMain() { ViewAdd("Cards/Card01.png",0,0,OnTouch,1); }
void AppExit() {
}
void OnTimer() {
} |