Concepts - Source : www.pcsoft-windev-webdev.com

Concepts

WinDev Mobile 12 - Concepts 

Version 12 - (1) 0208 

Remember to visit the PC SOFT site (www.windev.com) on a regular basis to find out whether upgraded 

versions are available. 

Email address of Free Technical Support: freetechnicalsupport@windev.com. 

This documentation is not contractually binding. PC Soft reserves the right to modify or delete any topic 

dealt with in this document. 

All product names or other trademarks mentioned in this publication are registered trademarks of their respective owners. 

© PC SOFT 2008: This publication may not be reproduced in part or in while in any form without the express permission of PC SOFT.

3WinDev Mobile Concepts 

SUMMARY 

PART 1 - DEVELOPING AN APPLICATION 

Development environment ..................................................................................................................... 8 

Developing an application for Pocket PC .............................................................................................. 9 

Project and Analysis .............................................................................................................................. 10 

Dashboard of the project ..................................................................................................................... 11 

Custom-folders: Organize your project ................................................................................................ 12 

WinDev, WebDev, WinDev mobile: same project ............................................................................... 13 

Project configuration ............................................................................................................................ 14 

Multiple generation ............................................................................................................................... 15 

WinDev Mobile and Windows ............................................................................................................... 16 

WinDev Mobile and the processors ..................................................................................................... 17 

The different types of windows ............................................................................................................ 18 

The controls available in a window ...................................................................................................... 19 

The menus ............................................................................................................................................. 20 

Window template .................................................................................................................................. 21 

Control templates ................................................................................................................................. 22 

RAD ........................................................................................................................................................ 23 

RID ......................................................................................................................................................... 24 

Component ............................................................................................................................................ 25 

Multi-product components ................................................................................................................... 26 

The reports ............................................................................................................................................ 27 

Source Code Manager (SCM) ............................................................................................................... 28 

Project Monitoring Center .................................................................................................................... 30 

ActiveSync ............................................................................................................................................. 31 

Running the test of a WinDev Mobile application .............................................................................. 32 

Unit tests ............................................................................................................................................... 33 

Unit tests on the executable ................................................................................................................ 34 

Installing an application for Pocket PC ............................................................................................... 35 

PART 2 - DATABASE 

Data handled by an application for Pocket PC ...................................................................................40 

Hyper File Mobile database ................................................................................................................. 41 

Hyper File Client/Server database ...................................................................................................... 42 

Standard CEDB database .................................................................................................................... 43 

Handling custom CEDB databases ...................................................................................................... 45 

Handling the CEDB databases in WLanguage .................................................................................... 48 

Comparing Hyper File Mobile and CEDB ............................................................................................. 49 

The queries ............................................................................................................................................ 51 

The embedded queries ......................................................................................................................... 52 

Synchronizing the data ......................................................................................................................... 53 

3-tier ....................................................................................................................................................... 55

4 

PART 3 - PROGRAMMING IN WLANGUAGE 

WLanguage functions ...........................................................................................................................58 

Handling character strings ...................................................................................................................59 

File picker and paths on Pocket PC .....................................................................................................61 

Managing the keyboard ........................................................................................................................62 

Functions specific to Pocket PC ...........................................................................................................63 

PART 4 - COMMUNICATION 

Communication with WinDev Mobile ...................................................................................................66 

Managing emails (POP3/SMTP protocol) ............................................................................................69 

Managing emails (CEMAPI) ...................................................................................................................70 

Handling files on an FTP server ............................................................................................................72 

Managing SMSs .....................................................................................................................................73 

PART 5 - INTERACTIONS BETWEEN WINDEV - WINDEV MOBILE 

Interaction with a standard WinDev application .................................................................................76 

Pocket PC: Sharing WinDev elements .................................................................................................77 

Handling a Pocket PC from a standard WinDev application ..............................................................78 

PART 6 - APPENDICES 

New features in WinDev Mobile 12 .....................................................................................................82 

Tools available for WinDev Mobile .......................................................................................................84 

Components supplied with WinDev Mobile .........................................................................................85 

Examples supplied with WinDev Mobile ..............................................................................................86 

WinDev Mobile Concepts

5WinDev Mobile Concepts 

IN WHICH ORDER SHOULD THESE GUIDES 

BE READ? 

WinDev Mobile is a powerful tool used to develop applications for Pocket PCs (Smartphone, Psion, 

and so on). 

To quickly and efficiently learn how to use WinDev Mobile, we advise you to work in the 

following order: 

1 

2 

3 

Read the "Concepts". 

This guide presents the main concepts required to create a WinDev Mobile application. 

"Tutorial" (book + exercises) 

The Tutorial provides a first "hands-on" approach to WinDev Mobile. It enables you 

to familiarize yourself with the main editors of WinDev Mobile. 

Test the examples 

Test the examples supplied with WinDev Mobile in the fields you are interested in 

(SMS, poll, and so on). 

The online help enables you to easily find out the syntax of a WLanguage function, to display help 

pages for the interface, to discover the programming concepts associated with a feature, and so on. 

We hope you enjoy getting started with WinDev Mobile.

6 

WinDev Mobile Concepts

PART 1 

Developing an application

8 

Part 1: Development of an application

9 

DEVELOPMENT ENVIRONMENT 

WinDev Mobile is a development environment for PC that allows you to develop applications for 

Pocket PC, Smartphone, and so on. 

Windows PC 

Installing 

WinDev Mobile 

Pocket PC 

Developing the 

application 

GO 

Running the 

application 

test 

Creating the 

executable 

Note: The applications generated by WinDev Mobile operate on one of the following platforms 

(equipped with the ARM processor, the ARM v4T processor or the x86 processor): 

• Pocket PC (2002, 2003, and so on) 

• Windows Mobile phone (Smartphone, and so on) 

• Windows CE 3, 4 and 5 (Psion, and so on) 

These applications do not operate on Windows PCs. 

Connection: USB, Wi-Fi, Bluetooth... 

SETUP or 

direct COPY 

Using the 

WinDev Mobile 

application 

Note: In this book, "Pocket PC" represents all the available runtime platforms (Pocket PC, 

Smartphone, Psion, and so on). For special cases, the name of the relevant platform is specifically 

mentioned. 

Part 1: Developing an application

10 

DEVELOPING AN APPLICATION FOR 

POCKET PC 

Specifications 

Creating the project 

Importing existing files 

Creating the analysis 

Development 

Part 1: Developing an application 

- Project RAD 

- Window RAD 

- Queries 

- Report 

- Source code 

GO 

Library 

(*.WDL) 

Running the 

application test 

Creating the executable 

Preparing for 

setup 

Executable 

(*.EXE) 

Setup

11 

PROJECT AND ANALYSIS 

A WinDev Mobile project is a set of windows, controls, classes, components, ... whose purpose is to 

create a Windows application. 

A WinDev Mobile analysis groups the description of the data files. 

In most cases, a project is associated with an analysis. 

An analysis can be associated with one or more projects. 

Project 2 

Classes 

Windows and 

controls 

Style sheet 

Analysis 

Project 1 

Project N 

Classes 

Style 

sheet 

Windows and 

controls 

Classes 

Style 

sheet 

To create the "lovelyeyes" application, create the "lovelyeyes" project. 

Windows and 

controls 


12 

DASHBOARD OF THE PROJECT 

The project dashboard is a main element for managing the WinDev Mobile projects. The project 

dashboard gives an overall view of the progress status of a project. 

The project dashboard is made of: 

- lights: Everything is OK when the lights are green. The red lights indicate a possible problem. 

- lists of elements, giving quick access to the main options of the project. 

- counters, used to manage new features and requests, and so on. 


13 

CUSTOM-FOLDERS: ORGANIZE YOUR 

PROJECT 

The project editor of WinDev Mobile is used to represent the diagram of the project. 

With large projects, this representation may be difficult to read. The "custom-folders" are used to 

improve this representation 

A "custom-folder" contains the elements stored by yourself, for instance: the application elements 

that can be used in Pocket PC and those that can be used in Smartphone. 

Some elements can be common to several "custom-folders". 

It makes it easier to work on part of the application. 

Windows, reports, queries 

relating to Pocket PCs 

Content of 

custom-folder 

Pocket PC 

Content of 

custom-folder 

Smartphone 

Windows, reports, queries 

relating to Smartphones 


14 

WINDEV, WEBDEV, WINDEV MOBILE: 

SAME PROJECT 

The projects are often multi-target projects. 

For instance, for an ERP system intended for Windows, it is very likely that beside the main 

application, that will be the backbone of the solution, there will be sales people equipped 

with PDAs or Smartphones, shops that will use mobile terminals to manage inventory and 

that Intranet and Internet sites will be implemented. 

Now, this information is grouped in a global project. 

Regardless of the product where the project was created, it can be opened by the other 

products. 

When a project is opened in a product other than 

the one where it was created, a wizard is displayed, 

allowing you to create a project configuration specific 

to the product used. 


For instance, if a WinDev project is opened by Web- 

Dev, you will have the ability to create a project configuration 

named "WEBSite" used to group all the 

elements required by the WebDev site. 

In each phase of the environment, you can now view 

the elements of each target. A project in WinDev displays 

the thumbnails of the WebDev pages and the 

WinDev Mobile windows for instance. 

Clicking a WebDev page from the project editor of 

WinDev opens the WebDev page (WebDev must be 

installed on the computer). 

The following elements are also shared: the 

documents, the modeling descriptions, the 

components, the classes, and so on.

15 

PROJECT CONFIGURATION 

The project configurations are used to create several different "targets" from the same project. 

For instance, from the same project, you can create: 

- 2 or 3 executables that do not contain the same elements, with different names, and so on. 

- 3 or 4 components 

- and so on. 

You can work on a specific configuration at any time: the elements that do not belong to this 

configuration are grayed in the project graph. 

Mobile project 

WinDev Mobile 

executable 

Project configurations 

Config 1 Config 2 Config 3 

Library 

… 

Component 

The multiple generation allows you to generate all the project configurations (or some of them) in a 

single operation. 


16 

MULTIPLE GENERATION 

The project configurations are used to easily define the different "targets" of your project. Several 

executables, several components and several libraries can be defined for the same project. 

To generate the result of each configuration, you can select each configuration one by one and 

generate the corresponding program. 

Another faster method is available: the multiple generation. In a single operation, you select the 

configurations to generate, and the result is immediate. 


To start a multiple generation, select "Workshop .. Multiple generation".

17 

WINDEV MOBILE AND WINDOWS 

The applications developed with WinDev Mobile can operate with the following versions of 

Windows: 

• Windows Pocket PC 2002. 

• Windows Mobile 2003 / 2003 SE (VGA) for Pocket PC and for Smartphone. 

• Windows Mobile 5.0 for Pocket PC and for Smartphone. 

The diagram below presents the different Windows families available for Pocket PCs. 


18 

WINDEV MOBILE AND THE PROCESSORS 

The applications developed with WinDev Mobile can operate on the Pocket PCs equipped with the 

following processors: 

• ARM and compatible (Strong ARM, XScale, Samsung, Texas Instrument, and so on) 

• ARM v4T and compatible (XScale, and so on) 

• x86 and compatible (AMD Geode, Transmeta Crusoe, VIA C3, C7, Eden, and so on) 


19 

THE DIFFERENT TYPES OF WINDOWS 

Two types of windows can be used by the WinDev Mobile applications: 

• The maximized windows (most often used). A maximized window takes up the entire screen 

on a Pocket PC. 

• The non-maximized windows. A non-maximized window can be resized by the user and it can 

take up part of the screen only. 

The maximized windows 

The main elements of a maximized window are as follows: 

The non-maximized windows 

The main elements of a non-maximized window are as follows: 

"OK/Close" button 

"OK/Close" button is used to validate the current window or to close this window. This button is 

associated with a specific process of the window ("Before closing via the OK/Close button") run 

before the closing code of the window. 


20 

THE CONTROLS AVAILABLE IN A WINDOW 

Several controls are available in WinDev Mobile: 

You want to… 

Use a control of the 

following type 


Display text, a title, and so on. 

Display a price, a quantity, an address, a date, a time, and 

so on. 

Select a value from a list (country, city, currency, and so on) 

Select several values from a list 

Display a graphic image (photo, statistics, chart, and so on) 

Display an animation (animated Gif) 

Display the content of a file in a table (list of customers, order 

details, and so on) 

Repeat controls in a window (product catalog with photo, 

and so on) 

Display a bar chart, a line chart, a pie chart 

Enter information 

Display the progress of an operation 

Program an action in a window (display another window, 

start a printout, and so on) 

Group the controls by theme and display the themes one by 

one 

Static control 

Edit control 

Radio button, Combo box, List 

box, ListView 

Check box, List box 

Image 

Image 

Browsing table or memory table 

Looper 

Chart control 

Edit control 

Progress Bar control 

Button 

Tab, sidebar

21 

THE MENUS 

the menus created by WinDev Mobile automatically adapt to the runtime platform. 

Pocket PC 

The menus are displayed at the bottom of 

the window. 

Smartphone 

The menus are displayed at the bottom 

of the window. 

The menu options can be easily selected 

with the stylus of Pocket PC. 

The menu options are automatically 

numbered: numbers are automatically 

added in front of the caption of each 

sub-option. These numbers are used to 

access the sub-options by pressing the 

Smartphone keys. 

The menu options can also be accessed 

via the "joystick" of Smartphone. 

Note: Only two menus can be displayed 

simultaneously in an application for 

Smartphone. These menus can be 

accessed via the buttons found below 

the Smartphone screen. 


22 

WINDOW TEMPLATE 

WinDev Mobile enables you to create window templates. These templates contain all the graphic 

elements common to all the windows of your application. 

The modifications made to a window template are automatically applied to all the windows that use 

this template. 

A window template enables you to comply with the style book defined for an application. 

Defining a window template. 

The template is enclosed by a 

green line in the editor. 


Using the template in several windows. 

The elements belonging to the template are identified by a yellow square. 

A window template can be created: 

- directly ("File .. New .. Window template"). 

- from the current window ("File .. Save as template"). 

To create a window based on a template, select the template that will be used when creating the 

window. 

Note: The template elements can be programmed in the template itself. 

The characteristics of the elements can be dissociated from the template. For example, the position 

of a control can be dissociated from the template so that the control can be located somewhere 

else while it still benefits from the other features (code, style, and so on). We talk of control 

inheritance. In this case, the elements are identified by a blue square.

23 

CONTROL TEMPLATES 

WinDev Mobile enables you to create control templates. A control template is a set of controls that 

can be reused in several windows. 

The modifications made to a control template are automatically applied to all the windows that use 

this template. 

A control template is used to: 

- group a set a controls for a specific purpose. 

- make the controls independent of the window hosting them. 

Defining a control template. 

The template is enclosed by a green line in the editor. 

Using the template in a window. 

The elements belonging to the template are enclosed 

by a blue line and identified by a yellow square. 

A control template can be created: 

- directly ("File .. New .. Control template") 

- from the controls found in the window ("Control .. Refactoring .. Create a control template from 

the selection"). 

To create a window based on a control template, create a "Control Template" control. 

Note: The template elements can be programmed in the template itself. 

The characteristics of the elements can be dissociated from the template. For example, the position 

of a control can be dissociated from the template so that the control can be located somewhere 

else while it still benefits from the other features (code, style, and so on). We talk of control 

inheritance. In this case, the elements are identified by a blue square. 


24 

RAD 

RAD (Rapid Application Development) is used to create windows from: 

• the analysis linked to the project, 

• standard RAD patterns, 

•custom RAD patterns, 

•skin templates. 

The generated windows contain the necessary source code. The test of these windows can be 

immediately run with the data found on the development computer. 

Analysis 

RAD pattern 

Custom RAD pattern 

Skin template 


RAD 

Full application RAD 

Window RAD 

Example of window 

generated by RAD 

Example of code 

generated by RAD

25 

RID 

RID (Rapid graphical Interface Design) is used to create windows from: 

• the analysis linked to the project, 

•standard RAD patterns, 

•custom RAD patterns, 

•skin templates. 

The generated windows only contain the controls linked to the analysis items. The source code 

required for these windows to operate must be written by the developer. Your custom code can be 

entered directly. 

Analysis 

RAD pattern 

Custom RAD pattern 

Skin template 

RID 

Window RID 


Example of window generated by RID 

This window contains no source code

26 

COMPONENT 

A component is a set of WinDev Mobile elements: windows, reports, analysis, and so on. This set of 

elements performs a specific feature. For example, a component can correspond to one of the 

following features: 

• Send an SMS, 

• Send emails, 

• and so on. 

A WinDev Mobile component can be distributed to other WinDev Mobile developers (free of charge 

or not). These developers will be able to easily include the feature proposed by the component in 

their application. The component will be included in the application and distributed along with it. 

WinDev Mobile 

project 

Developing the 

component 

Generating the component 


WinDev 


Using the 


.WDK file 

Importing the component 

into different WinDev 

Mobile projects 

WinDev Mobile 

project 

Using the 


WinDev 


Using the 

component

27 

MULTI-PRODUCT COMPONENTS 

WinDev, WebDev and WinDev Mobile give you the ability to create multi-product components. These 

components can contain windows, pages, ... and they can be used in a WinDev, WebDev or WinDev 

Mobile project. 

The principle is as follows: 

Unique project 

Projet common to WinDev, WebDev, WinDev Mobile 

HTML pages to include in the component 

Window to include in the component 

Creating the component 

- Selecting the elements 

- Choosing the target products 

(WinDev, WebDev, and so on) 

WDK and WDI files 

Usable in the projects of the selected 

target products 


28 

THE REPORTS 

WinDev Mobile enables you to easily create and print all types of reports with the report editor. 

The generated reports can be printed in PCL format (".PCL" file or print on a PCL printer). 

Report Sources 

Table Controls 

Print 

(PCL format) 

Queries 

Report 


Data Files 

Txt 

Text files 

PCL file 

Other print modes 

WinDev Mobile also enables you to pint in WLanguage (iXXX functions). 

You also have the ability to directly send sequences of commands to a printer (if this one is not in 

PCL format).

29 

SOURCE CODE MANAGER (SCM) 

Overview 

To simplify teamwork, a Source Code Manager is now available in WinDev Mobile. This Source Code 

Manager enables several developers to work together on the same project at the same time and to 

share elements among several projects. 

A database groups the project elements, each computer 

has a local copy of the elements required for the development 


30 

Operating mode of Source Code Manager 

The following example presents the Source Code Manager: 


If a project element (window, report, and so on) is checked out, this element cannot be checked out 

twice. 

Once the cheked-out element are modified, these elements must be checked back in to take these 

modifications into account. Indeed, the SCM database stores a history of all the project elements 

since their creation. 

Whenever an element is checked in, the version number of the source project is incremented by 1.

31 

PROJECT MONITORING CENTER 

The Project Monitoring Center helps you organize and schedule a project. It enables you to define 

the tasks that must be performed in a project, the developers, the durations, the progress status of 

the project, and so on. 

Operating mode of Project Monitoring Center 

Once the project tasks are listed, the Project Monitoring Center takes care of everything. Entering 

the time spent is almost automatic, it requires no specific action and it creates no particular 

constraint. 

When the relevant project is opened, the Project Monitoring Center requests or indicates the 

current task. As soon as a task is completed, all you have to do is indicate that this task is over and 

specify the new task. 

A task can be linked to a project element (window, report, and so on). Whenever the relevant 

element is opened, the time spent on this element is counted and stored in the Monitoring Center. 

Conversely, the element corresponding to the task you want to perform can be automatically 

opened from the task list. 

Each developer can also view his own task list in the "Project Monitoring Center" pane. 


32 

ACTIVESYNC 

ActiveSync is a program used to synchronize data (WinDev application, email, calendar, contacts, 

tasks, notes, and so on) between a PC and a Pocket PC. 

In most cases, ActiveSync is supplied with the Pocket PC but it can also be downloaded from the 

Internet. 

ActiveSync automatically starts on the PC when the connection is established between the Pocket 

PC and the PC. 

The data to synchronize is configured in ActiveSync ("Options" icon). 


Features of ActiveSync 

ActiveSync is used to: 

• synchronize the data between a PC and a Pocket PC. See "Synchronizing the data" (page 54) 

for more details. 

• access the Pocket PC from a standard WinDev application. 

• handle a CEDB database from a standard WinDev application. 

• view from the PC the files found on the Pocket PC ("Explore" icon). 

• copy a file found on he PC to the Pocket PC (with the file explorer). 

• automatically convert the files copied to the Pocket PC. The format of the copied files will 

then correspond to the format of the files supported by the Pocket PC (for example, a ".DOC" 

file is converted into a ".PSW" file). 

• save the data found on the Pocket PC ("Tools .. Backup/Restore"). 

• add applications to the Pocket PC and/or delete applications from the Pocket PC ("Tools .. 

Add/Remove programs"). 

• transfer the Access databases to and from the Pocket PC ("Tools .. Import/Export database 

tables"). The Access databases correspond to CEDB databases on the Pocket PC. 

•etc.

33 

RUNNING THE TEST OF A WINDEV 

MOBILE APPLICATION 

Running the test of the entire project is used to simulate the start of the application by the 

executable. This enables you to run the test of the entire application, even if its development is not 

finished. 

Several types of project test are available in WinDev Mobile: 

• Run the test on the development computer: this test simulates a Pocket PC on the 

development computer. During this test, no connection to a Pocket PC is required. This test 

allows the use of the debugger. However, this test being run on a PC and not on a Pocket PC, 

the application may behave differently in some ways. 

• Run the test and debug on the Pocket PC connected to the development computer. This test 

allows the use of the debugger while being directly run on the Pocket PC. 

• Run the test on the Pocket PC connected to the development computer. In this case, the 

executable corresponding to the project is created, copied to the Pocket PC and run. When 

the program is run on the Pocket PC, the Pocket PC can be disconnected from the PC. The 

debugger is not available. 


34 

UNIT TESTS 

The unit tests are used to run the test of windows, procedures and classes found in an application 

at different steps of development. 

To do so, select (or create) the test scenario that will be run. 

These scenarios are generated in WLanguage and they can be directly modified. 

These scenarios are grouped in the test editor. The test editor that analyzes the result of the unit 

tests and calculates the level of validation for the application. 

When creating the application executable, WinDev Mobile: 

- displays the level of validation for the application. 

- indicates the elements modified and not tested. 

Creating a test scenario 

Using a test scenario 

Window, class 

or procedure 

Test Editor 


Recording the 

test scenario 

WLanguage code of 

test scenario 

Running the test 

Result of the test 

Correction 

To create a unit test on the current window, click . 

To create a unit test on a procedure or a class, select this procedure or this class in the "Code" pane 

and select "Create a unit test" from the popup menu.

35 

UNIT TESTS ON THE EXECUTABLE 

WinDev Mobile enables you to run unit tests on the windows. However, these unit tests can only be 

run on the Pocket PC via the test robot. The test robot is used to run all the unit tests in real 

configuration on the Pocket PC. 

Configuring the test 

robot 

Test robot 

- Path of the executable (on 

the Pocket PC) 

- Path of the test data (on 

the Pocket PC) 

Saving the 

result 

Database of Control 

Centers 

Result of the tests 

WP120Test.DLL 

Running the executable on the 

Pocket PC in test mode. The test 

data is used. 

Executable deployed on 

the Pocket PC 

with: 

- its framework 

- its data files 

Test data on the Pocket PC 

with: 

-the test library (.WDL file) 

- the test data ("Automatic test data" 

directory) 

-the data files used for test (if 

necessary). 

The test robot runs the executable deployed on the Pocket PC in "test mode", via "WP120Test.DLL". 

The test data (scenarios, test data files if necessary, and so on) is automatically used. 


36 

INSTALLING AN APPLICATION FOR POCKET 

PC 

Several methods can be used to install a WinDev application on a Pocket PC: 

• setup in CAB format. This setup program is run on a Pocket PC. 

• setup in MSI format. This setup program is run on a PC under Windows connected to a 

Pocket PC. 

• setup by direct copy of the executable from the PC to the Pocket PC. 

Setup in CAB format 

This setup consists in: 

• creating the application executable on the development computer with WinDev Mobile. 

• generating the setup program of the application on the development computer with WinDev 

Mobile. This setup program corresponds to a ".CAB" file. 

• copying the setup program on the Pocket PCs of the end users (via a memory card, by GPRS 

from an Internet site or via the file explorer). 

• running this setup program on the Pocket PCs. This program installs all the files required by 

the application. At the end of setup, the ".CAB" file is automatically deleted from the Pocket 

PC. 


To use this application, run the application on the Pocket PC (double-click the ".EXE" file for 

instance).

37 

Setup in MSI format 

This setup consists in: 


• generating the setup program of the application on the development computer with WinDev 

Mobile. This setup program corresponds to a ".MSI" file. 

• distributing this setup program to the end users. 

• running this setup program on the PCs. The application will be automatically installed on the 

Pocket PC connected to the current computer. 

Note: If no Pocket PC is connected, the setup will be performed during the next 

synchronization between the PC and the Pocket PC. 

To use this application, run the application on the Pocket PC (double-click the ".EXE" file for 

instance). 


38 

Setup by direct copy 

This feature is used to: 


• automatically copy this executable to the Pocket PC connected to the current PC. 

To use this application, run this executable on the Pocket PC (double-click the ".EXE" file for 

instance). 

Windows PC 

Pocket PC 

Creating the 

executable 

(Pocket EXE) 


Direct COPY 

Execution 

Development 

Deployment 


PART 2 

Database

41 

DATA HANDLED BY AN APPLICATION FOR 

POCKET PC 

The data handled by a WinDev Mobile application can come from: 

• a Hyper File Mobile or Hyper File Client/Server database (".Fic" files). 

• an Oracle Lite, AS/400 or SQL Server Mobile database. 

• a CEDB database (".cdb" files). 

•".INI" files. 

• text files (in ANSI or UNICODE format). 

• the registry. 

Part 2: Database

42 

HYPER FILE MOBILE DATABASE 

The Hyper File Mobile format is the database format supplied with WinDev Mobile. This database 

format is compatible with WinDev, WinDev Mobile and WebDev. 

It is a freely distributable Relational DBMS. 

This format is identical to the Hyper File format of WinDev and WebDev (".WDD" file, data files, and 

so on). 

However, the available size on Pocket PC being restricted and the operating system of Pocket PC 

being limited, the following features are not supported by Hyper File Mobile in Classic mode: 

• the transactions. 

• the log process. 

• the management of file locks and record locks. 

• the management of files in Hyper File 5.5 format. 

Note: Only the files in Hyper File 5.5 format are not supported by Hyper File Mobile in Client/Server 

mode. 

Handling a Hyper File Mobile database from the Pocket PC 

A Hyper File Mobile database corresponds to a set of ".FIC", ".NDX" and ".MMO" files. 

Each data file can be handled by a WinDev Mobile application. These operations are performed via 

the Hyper File functions (Hxxx functions). 

Pocket PC 

WinDev Mobile 

application 

Part 2: Database 

Database 

Hxxx 

functions 

(Read, 

Write, ...)

43 

HYPER FILE CLIENT/SERVER DATABASE 

A Hyper File WinDev Mobile application can also operate in Client/Server mode. 

The characteristics of Client/Server mode are as follows: 

• A Hyper File Client/Server application is run on the different Pockets PCs (called client 

computers). 

• The data files are found on a server. Only the server physically accesses the data files. 

• All the processes (query, read/add to file, and so on) are performed on the server. 

Part 2: Database

44 

STANDARD CEDB DATABASE 

The standard Pocket PC applications 

The Pocket PCs are supplied with a set of standard applications that handle the standard CEDB 

databases. 

These databases correspond to the databases found by default on the Pocket PC. These databases 

contain the "Tasks", "Contacts" and "Calendar" data files, and so on. 

These databases can be handled by a WinDev Mobile application. 

Part 2: Database

45 

Handling a standard database of Pocket PC (from a PC) 

A standard database (containing the data files for managing tasks, contacts, and so on) is found on 

the Pocket PC. This database can be handled by a WinDev Mobile application. 

If you own WinDev, you also have the ability to create a WinDev application used to directly handle 

this standard database of Pocket PC. 

These operations are performed via the cdbXXX functions. 

The synchronization between the database of Pocket PC and the data viewed via Outlook is 

performed by ActiveSync. 

Windows PC 

Pocket PC 

WinDev 

Application 


cdbxxx functions (Read, Write...) 

WinDev Mobile 

Application 

Outlook 

Synchronization via ActiveSync 

Standard 

database 

cdbxxx 

functions 

(Read, 

Write, ...) 

Note: To handle a Pocket PC database from a standard WinDev application, the Windows PC must 

be connected to the Pocket PC (ceConnect). 

Part 2: Database

46 

HANDLING CUSTOM CEDB DATABASES 

CEDB database 

The custom CEDB databases correspond to Access databases (".MDB" file) previously exported 

from a PC. 

When an Access database (".MDB" file) is copied to a Pocket PC from the file explorer, this database 

is automatically changed into a CEDB database (".CDB" file). 

Handling a Pocket PC database (CEDB) from the Pocket PC 

A CEDB database can be handled by a WinDev Mobile application. These operations are performed 

via the cdbXXX functions. 

Pocket PC 

WinDev Mobile 

Application 


Database 

cdbxxx 

functions 

(Read, 

Write, ...)

47 

Handling a Pocket PC database (CEDB) from the Windows PC 

If you own WinDev, you also have the ability to create a WinDev application used to directly handle a 

CEDB database found on the Pocket PC. These operations are also performed via the cdbXXX 

functions. 

Windows PC 

Pocket PC 

WinDev Mobile 

Application 


WinDev 

Application 

cdbxxx functions (Read, Write, ...) 

Database 

cdbxxx 

functions 

(Read, 

Write...) 

Note: To handle a Pocket PC database from a standard WinDev application, the Windows PC must 

be connected to the Pocket PC (ceConnect). 

Part 2: Database

48 

Synchronizing a Pocket PC database (CEDB) with an Access database 

An Access database (".MDB" file) is found on the Windows PC. This database is exported to the 

Pocket PC: ActiveSync automatically transforms it into a Pocket PC database (".CDB" file). 

This Pocket PC database can be handled by a WinDev Mobile application. 

If you own WinDev, you also have the ability to create a WinDev application used to handle the 

Pocket PC database. 

These operations are performed via the cdbXXX functions. The synchronization between the 

database of Pocket PC and the Access database is performed by ActiveSync. 

Windows PC 

Pocket PC 

WinDev 

Application 


cdbxxx functions (Read, Write ...) 


WinDev Mobile 

Application 

cdbxxx 

functions 

(Read, 

Write...) 

Database 

Database 


Notes: 

• To handle a Pocket PC database from a standard WinDev application, a connection must be 

established between the Windows PC and the Pocket PC (ceConnect). 

• The standard WinDev application can also handle the Access database via the native Access 

access.

49 

HANDLING THE CEDB DATABASES IN 

WLANGUAGE 

WLanguage functions used to handle the CEDB databases: 

cdbAdd 

cdbCancelSearch 

cdbClose 

cdbCol 

cdbDateTimeToInteger 

cdbDelete 

cdbFound 

cdbIntegerToDateTime 

cdbListFile 

cdbModify 

cdbNbCol 

cdbNbRec 

cdbOpen 

cdbOut 

cdbRead 

cdbReadFirst 

Adds the record found in memory to a data file 

Cancels the current search criterion 

Closes a database (".CDB" file) 

Returns information about a column found in the current record 

Transforms a DateTime variable into a value compatible with a Date and Time 

column (unsigned 8-byte integer) 

Deletes the current record or the specified record from the data file 

Checks whether the current record matches the current search 

Transforms the value of a Date and Time column (unsigned 8-byte integer) into a 

DateTime variable 

Lists the data files found in a CEDB database 

Modifies the specified record (or the record found in memory) in the data file 

Returns the number of columns found in the record in memory 

Returns the number of records found in a data file 

Opens a database (".CDB") on the pocket PC connected to the current computer 

Enables you to find out whether the record you want to point to is outside the file 

Reads a record in a file according to a record number 

Points to the first record in a file and reads it 

cdbReadLast 

cdbReadNext 

cdbReadPrevious 

cdbReadSeek 

cdbRecNum 

cdbReset 

Points to the last record in a file and reads it 

Points to the next record in a file and reads it 

Points to the previous record in a file and reads it 

Points to the first file record whose value for a specific column is equal to a sought 

value 

Returns the number of the current record in the data file 

Resets all the variables found in a structure of the standard database 


cdbWriteCol 

Modifies the value of a column for a record in memory

50 

COMPARING HYPER FILE MOBILE AND 

CEDB 

To display information coming from a database in a window, the controls of this window must be 

linked to the different items of the database. 

The method for displaying and retrieving information depends on the database used (Hyper File 

Mobile or CEDB). 

File link between a window and a Hyper File Mobile database 

In most cases, the link between a control and an item is defined in the window editor when the 

control is described ("File" tab). This link enables you to specify the file item that will be used by 

ScreenToFile and FileToScreen. 

Pocket PC 

HYPER FILE 

1 LINE 

PER WINDOW 

( File link ) 


ScreenToFile 

FileToScreen

51 

File link between a window and a Pocket PC database (CEDB) 

This link can be defined by programming only (cdbXXX functions). 

Pocket PC 

CEDB 

1 LINE 

PER CONTROL 

( No file link ) 

cdbWriteCol("MyDataBase",... 

"Schedule","Caption",ctlCaption) 

cdbWriteCol("MyDataBase",... 

"Schedule","Contrib",ctlContrib) 

... 

ctlCaption=cdbCol("MyDataBase",... 

"Schedule","Caption") 

ctlContrib=cdbCol("MyDataBase",... 

"Schedule","Contrib") 

... 

Other differences 

The use of Hyper File Mobile databases enables you to access the following features (nonexhaustive 

list): 

• Speed of the Hyper File Mobile database. 

• Queries on Hyper File Mobile databases (created by the query editor). 

• Fast application development via Full Application RAD. 

• Features specific to the Hyper File Mobile database (encryption, and so on) 

Part 2: Database

52 

THE QUERIES 

A query is used to interrogate a database in order to view, insert, modify or delete data. The 

structure of the query defines the data used. 

A query can interrogate one or more files. 

The query editor is used to easily create queries, without programming. 

Window and controls of 

a window ("Content" 

tab) 

Query 

Reports 

The result of the query 

is handled as a file 

Programming 

(use in the WLanguage 

functions) 


Data coming from one or more 

files (Hyper File, Oracle, and 

so on) 

Queries

53 

THE EMBEDDED QUERIES 

The controls found in a window can be linked to a data file or to an existing query. These controls 

can also be linked to a query created when the control is designed. 

Embedded query: MyWindow_1$Query 

In this case, the query is embedded in the window. It is found in the WPW file corresponding to the 

window. If the WPW file is transmitted, the embedded queries used by this window will also be 

supplied. 

Part 2: Database

54 

SYNCHRONIZING THE DATA 

WinDev Mobile can be used to synchronize the records used by several applications. 

The two applications manage the same data independently of each other. During the 

synchronization, the changes made to the database handled by the PC are automatically applied to 

the Pocket PC (and conversely). 

This synchronization is automatically performed by: 

• ActiveSync when the Pocket PC is connected to the Windows PC. 

•the Universal Replication when the Pocket PC is connected (or not) to the Windows PC. 

ActiveSync 

ActiveSync is used to update databases of same format used by both a standard WinDev 

application and a WinDev Mobile application. 

The synchronization can be adapted to special cases. For instance, you have the ability to retrieve 

the records concerning a specified product or the records created at a given date, manage the 

conflicts, display a setting window, and so on. 

These changes must be done by programming in a set of procedures called "WDSynchro.wdg". This 

set of procedures is supplied with WinDev Mobile. 

Note: No programming is required to perform a full synchronization. 

Windows PC 

Pocket PC 

WinDev 

Application 

ActiveSync 



WinDev 

Mobile 

Application 

File 1 


File 1 

File 2 

File 3 

Note: WDSynchro is used to configure ActiveSync in order to synchronize the Hyper File database 

(PC) and the Hyper File Mobile database (Pocket PC). This tool can be used on the development 

computer only. 

File 2

55 

Universal replication 

The universal replication is used to update databases of same format or databases of different 

formats used by several applications. You can for instance perform a synchronization between a 

Hyper File Mobile database and an Oracle Lite database. 

The universal replication uses a centralized model: all the databases are synchronized with a 

master database. Then, the master database propagates the modifications to the other databases. 

The synchronization can be adapted to special cases. For instance, you have the ability to retrieve 

the records concerning a specified product or the records created at a given date, manage the 

conflicts, display a setting window, and so on. 

These changes must be done by programming via HRplFilterProcedure. 

Part 2: Database

56 

3-TIER 

The 3-tier architecture is designed to separate the 3 "tiers" of an application: UI, processes and 

data. 

An application will be made of 3 separate tiers: 

• a presentation tier, 

• a process tier, 

• a data tier. 

The reason for separating them is to facilitate maintenance and future upgrades of the application. 

This ensures higher security because the access to the database is allowed via the process tier 

only. It also optimizes teamwork and multi-target development. 

Part 2: Database

PART 3 

Programming in 

WLanguage

59 

WLANGUAGE FUNCTIONS 

Most of the WLanguage functions found in WinDev are also available in WinDev Mobile. These 

functions are common to the two products. 

Only the functions specific to Windows are not available in WinDev Mobile, because Windows for 

Pocket PC is more limited. 

The following diagram presents the WLanguage functions that can be used according to the type of 

application developed: 

Common 

functions 

WinDev Mobile 

functions only 

Functions that can only be 

used on Pocket PC 

(management of SIM card 

for instance) 

WinDev functions 

for Windows only 

Functions not available due to 

the limits of Pocket PC (for 

instance, fCurrentDir cannot be 

used as no current directory 

exists on Pocket PC) 

for instance: 

HReadFirst, 

FileToScreen, 

ExtractString... 

Part 3: Programming in WLanguage

60 

HANDLING CHARACTER STRINGS 

Different formats of character strings are available: 

• The UNICODE format is used to describe a very large set of characters by representing each 

letter on 2 bytes. This format means that 65,536 characters can be encoded. All the 

characters of the 24 most common character sets are represented in a single set. Each 

character has a unique identifier. This format is used to simultaneously handle characters 

coming from different character sets. 

• The ANSI format represents each character on one byte. This format can encode 256 

characters in the Indo-European character sets. This format can represent all the character 

sets. However, a single character set can be used at a time. 

Character strings in Pocket PC 

In most cases, the Windows applications for Pocket PC handle character strings in UNICODE 

format. 

Pocket PC 

Part 3: Programming in WLanguage 

Using Text files 

or 

ANSI 

UNICODE 

S is string 

... 

fOpen(MyFile,ANSI) 

fReadLine(...) 

fOpen(MyFile,Unicode) 


UNICODE 

string 

UNICODE 

string 

UNICODE 

string 

In pocket PC, when using text files containing character string in ANSI format, WinDev Mobile 

automatically converts these character strings into UNICODE format. This conversion is performed

61 

even if the opening of this file in ANSI format is explicitly requested. 

This conversion is completely transparent. 

Reminder: Character string in Windows PC 

The Windows applications for PC handle character strings in ANSI format. 

On a PC, text files can be opened in ANSI format and in UNICODE format. No conversion is 

performed by default. 

Windows PC 

S is string 

... 

ANSI 

string 

Using Text files 

or 

ANSI 

UNICODE 

fOpen(MyFile,ANSI) 


fOpen(MyFile,Unicode) 


ANSI 

string 

UNICODE 

string 

The character strings are programmed in the same way in WinDev and in WinDev Mobile (with 

very few exceptions). WinDev automatically performs the necessary conversions. 


62 

FILE PICKER AND PATHS ON POCKET PC 

File picker 

In Pocket PC, the file picker is used to select the files found: 

• in the "\My Documents" directory or in one of its immediate sub-directories. 

• in a directory found at the root of a storage card. 

Therefore, fSelect can only be used to select a file found in one of these directories. 


Path of directories and files 

The directories are managed in different ways on a PC and on a Pocket PC. 

On a PC, the paths have the following format: "C:\MyDocuments\MyFile.txt". On a Pocket PC, the 

paths have the following format: "\MyDocuments\MyFile.txt". There are several tree structures and 

the notion of drive does not exist. 

Note: The notion of current directory does not exist in Windows for Pocket PC (limit of the operating 

system). This is the reason why the functions that handle the current directory (fCurrentDir for 

instance) are not available in WinDev Mobile.

63 

MANAGING THE KEYBOARD 

To allow the users of your applications to enter information, the keyboard of the Pocket PC (also 

called SIP for "Software Input Panel") must be managed. This keyboard is used to: 

•display a miniature keyboard at the bottom of 

the screen. The user clicks this keyboard with 

the stylus to enter information: 

•automatically recognize the different 

words written directly on the screen with 

the stylus (method called "Transcriber"). 

•automatically recognize the letters entered in a 

specific character set (method called "Letter 

Recognizer"): 

•automatically recognize the blocks of 

words entered in a specific character set 

(method called "Block Recognizer"): 

WinDev Mobile enables you to easily manage this keyboard via the WLanguage functions (SIPXXX 

functions). 

Note: On a Smartphone, the input is performed via the numeric keypad. 


64 

FUNCTIONS SPECIFIC TO POCKET PC 

Functions for managing the keyboard 

These functions enable you to easily manage the keyboard used on the Pocket PC: 

SIPList 

SIPMode 

SIPVisible 

Returns the list of keyboards available for the Pocket PC 

Enables you to find out and modify the keyboard currently used 

Enables you to find out whether the current keyboard is enabled/ 

visible and to make the keyboard enabled/visible 

Functions for managing the SIM card 

These functions enable you to easily manage the information found in the personal directory 

present on a SIM card. These functions are available for "Pocket phones" and Smartphones only. 

SIMDelete 

Deletes an entry from the directory of the SIM card 


SIMNbContact 

SIMRead 

SIMWrite 

Returns the number of entries found in the directory of the SIM card 

Reads an entry in the directory of the SIM card 

Writes or modifies an entry in the directory of the SIM card 

Functions for managing the automatic start of an application 

These functions enable you to manage the automatic start of an application: 

AutoRunAdd 

AutoRunDelete 

Automatically starts a WinDev Mobile application when a specific event 

occurs. This startup is defined from a WinDev Mobile application. 

Stops the automatic startup of a WinDev Mobile application.

PART 4 

Communication

67 

COMMUNICATION WITH WINDEV MOBILE 

WinDev Mobile can be used to establish communication between two Pocket PCs, a Pocket PC and 

a Smartphone, a Pocket PC and a PC, and so on. 

These "dialogs" are performed by infrared, Wi-Fi, GPRS, and so on. 

Summary table 

The table below presents the communication modes available for each feature proposed by WinDev 

Mobile. 

Remote 

access (RPC 

on Hyper 

File) 

Email FTP HTTP Telephony 

SOAP 

J2EE 

.NET 

Socket 

SMS 

ActiveSync X X X X X X 

Network card X X X X X X 

GPRS X X X X X X 

Infrared 

X 

Smartphone 

or access 

by phone 

(GSM type) 

X 

X 

Wi-Fi X X X X X X 

Part 4: Communication

68 

Some examples 

1. Communication by Infrared 

The communication via infrared is performed by the Socket functions (SocketConnectInfrared, 

SocketCreateInfrared, and so on). The following devices can communicate: 

• two Pocket PCs between themselves. 

• a Pocket PC with a Smartphone. 

• a Pocket PC with a PC. 

• a Pocket PC with any device equipped with an infrared port (printer, electric gate, and so on). 

2. Communication by Wi-Fi 

The communication by Wi-Fi can be used to transfer files by FTP for instance. 

Part 4: Communication 

FTP Server 

FTP account 

Anonymous 

File transfer 

by Wi-Fi 

(FTPxxxx functions ) 

Pocket PC 

WinDev 

Mobile 

application 

Connection to server 

(FTPConnect function)

69 

3. Communication by GPRS 

The communication by GPRS can be used to access a remote Hyper File database via the Internet 

for instance. 

PC 

Pocket PC 

WinDev 

Mobile 

application 

Internet 

Intranet 

Gprs 

Connection to remote database 

(HConnectRemoteAccess function) 

Gprs 

Connection to Internet 

(NetOpenRemoteAccess function) 


70 

MANAGING EMAILS (POP3/SMTP 

PROTOCOL) 

The POP3 and SMTP protocols are email management protocols supported by all the Internet 

Service Providers. These protocols allow you to dialog with the email server available at your ISP. 

Notes: 

• The POP3 protocol is used to receive emails. 

• The SMTP protocol is used to send emails. 

Pocket PC 

WinDev 

Mobile 

Application 

POP3 Protocol 

Incoming emails 

SMTP Protocol 

Outgoing emails 

Connection : Ethernet card, 

Wi-Fi, Modem GPRS... 

Incoming and 

outgoing emails 

Email server 

(Host) 


Principle 

1. Connect the Pocket PC to a PC (required if the Pocket PC if not equipped with an Ethernet 

card or a GPRS modem). 

2. Connect to the Internet Service Provider (if necessary). 

3. Start an email session with EmailStartSession. 

4. Send and read messages. 

5. Close the email session with EmailCloseSession.

71 

MANAGING EMAILS (CEMAPI) 

CEMAPI is an email management API used by most of the Pocket PC applications to send and 

receive emails (Pocket Outlook in most cases). 

CEMAPI simplifies the management of the emails received by the host. When an email is read, it is 

automatically loaded in the local message box and deleted from the server (at the host). 

All the characteristics required to manage the emails (POP3 protocol, SMTP protocol, remote 

access, and so on) are grouped in the "User Account". 

With the email functions of WLanguage, a WinDev application can directly handle the emails 

managed in a application that uses "CEMAPI". 

Using the "ActiveSync" user account 

A user account defined in Pocket Outlook is required to manage the emails with CEMAPI. By 

default, Pocket Outlook manages the "ActiveSync" user account. 

Pocket PC 

WinDev 

Mobile 

application 

Outlook 

Pocket 

ActiveSync 

account 

Connection: USB, 

Wi-Fi, Bluetooth... 

Synchronization 

via ActiveSync 

PC 

Outlook 

Connection: Internet 



Email server 

(Host) 


72 

Using a specific user account 

To use another user account, you must define one. 

If the Pocket PC has no direct Internet link, a synchronization with the PC is required to send and 

receive emails. 

Pocket PC 

WinDev 

Mobile 

Application 

Outlook 

Pocket 

Connection: USB, 

Wi-Fi, Bluetooth... 



PC 

Other 

accounts 

Connection: Internet 



Email server 

(Host) 


If the Pocket PC has direct Internet access (by Wi-Fi, and so on), no synchronization with the PC is 

required.

73 

HANDLING FILES ON AN FTP SERVER 

FTP (File Transfer Protocol) is a standard protocol used to transfer files from one site to another. 

This protocol is used to exchange files via TCP/IP, Wi-Fi Internet or Active Sync. 

Several thousand file servers can be accessed by FTP on Internet. These servers propose 

shareware or freeware to the public. 

Several WLanguage functions allow you to manage files on an FTP server from your WinDev Mobile 

applications. 

Transferring files by direct link between a Pocket PC and an FTP server by Wi-Fi: 

FTP Server 

FTP account 

Pocket PC 

WinDev 

Mobile 

application 

Anonymous 

File transfer 

by Wi-Fi 

(FTPxxxx functions ) 

Connection to server 

(FTPConnect function) 

Transferring files by Internet: 

FTP Server 

FTP account 

Anonymous 

Internet 

Intranet 

PC 


File recovery 

FTPGet function 

Pocket PC 

WinDev 

Mobile 

application 


74 

MANAGING SMSS 

With the WLanguage functions, WinDev Mobile enables you to: 

• send SMSs. 

• read the incoming SMSs. 

• delete one or more incoming SMSs. 

An SMS (Short Message Service) is a text message (up to 160 characters) sent on a cell phone. 

To use the SMS functions, the Pocket PC application must be installed: 

• on a Pocket PC with phone access (GSM type). 

•on a Smartphone. 

Pocket PC 

SMS 

application 

PCSoft 

Cell phone, 

Smartphone 

Sending the message 

(SMSSend function) 

Creating the message 

(SMS structure) 

Receiving the message 


PART 5 

Interactions between 

WinDev - WinDev Mobile

77 

INTERACTION WITH A STANDARD WINDEV 

APPLICATION 

The functions for accessing the Pockets PCs are used to access the Pocket PCs from a standard 

WinDev application. 

Windows PC 

Pocket PC 

WinDev 

Application 

WD120CE.DLL 

WinDev Mobile is supplied with several examples that use the functions for accessing Pocket PCs: 

•PC Registry. 

•PC Explorer. 

These examples can be run on a PC. 


Copy files 

Run applications 

cdbxxx access (Read, write...) 

File 

WinDev Mobile 

Application 

Database 

Part 5: Interactions between WinDev - WinDev Mobile

78 

POCKET PC: SHARING WINDEV 

ELEMENTS 

Part 5: Interactions between WinDev - WinDev Mobile 

The same WinDev elements (analysis, reports, queries, and so on) can be used in a standard 

WinDev application and in a WinDev Mobile application: 

• Windows: The windows found in WinDev and in WinDev Mobile do not have the same format 

(different size, position of menus, and so on). The WinDev windows can be imported into a 

WinDev Mobile project. The WinDev windows (".WDW" file) are automatically changed into 

windows for Pocket PC (".WPW" file). 

• Help: This type of element does not exist in Pocket PC. 

• Analysis, reports, queries, classes, sets of procedures, and so on: These elements can be 

shared between a standard WinDev application and a WinDev Mobile application. 

WINDEV 

Project (.wdp) 

Windows (.wdw) 

Help 

Share 

Import 

Analysis 

Reports 

Sets of 

procedures 

Classes 

Share 

WINDEV 

Mobile 

Project (.wpp) 

Windows (.wpw)

79 

HANDLING A POCKET PC FROM A 

STANDARD WINDEV APPLICATION 

The following WLanguage functions are used to access the Pocket PCs from a standard WinDev 

application: 

ceConnect 

ceConnectionStatus 

Connects the current computer to a Pocket PC 

Enables you to find out the status of the connection between the current 

computer and the Pocket PC 

ceCopyFile 

ceCreateShortcut 

ceDeleteFile 

ceDeleteShortcut 

ceDir 

ceDisconnect 

ceFileDate 

ceFileExist 

ceFileSize 

ceFileTime 

ceListFile 

ceMachineName 

ceMakeDir 

ceOEMInfo 

cePlatform 

Copies: 

- a file found on the current computer to the connected Pocket PC 

- a file found on the connected Pocket PC to the current computer 

- a file found on the connected Pocket PC to another directory in the 

Pocket PC 

Creates a shortcut on the Pocket PC connected to the current computer 

Deletes a file from the Pocket PC connected to the current computer 

Deletes a shortcut previously created by ceCreateShortcut 

Searches for a file or for a directory on the Pocket PC connected to the 

current computer 

Closes the connection between the current computer and the Pocket PC 

Returns or modifies the different dates associated with a file (creation, 

modification or access) 

Checks the existence of a file 

Returns the size (in bytes) of a file found on the Pocket PC connected to 

the current computer 

Returns or modifies the different times associated with a file (creation, 

modification or access) 

Lists the files found in a directory (and in its sub-directories) and returns 

the number of listed files 

Returns the name of the Pocket PC 

Creates a directory on the Pocket PC connected to the current computer 

Returns the OEM information of the Pocket PC: trademark, model, serial 

number, and so on. 

Returns the name of the Pocket PC platform 


cePowerStatus 

Returns information about the battery (main or spare) of the Pocket PC

80 

ceProcessorType 

ceRegistryCreateKey 

ceRegistryDeleteKey 

ceRegistryDeleteValue 

ceRegistryExist 

ceRegistryFirstSubKey 

Returns the type of processor for the Pocket PC connected to the current 

computer 

Creates a key in the registry of Pocket PC 

Deletes a sub-key from the registry of Pocket PC 

Deletes a value from the registry of Pocket PC 

Checks the existence of a key in the Pocket PC registry 

Identifies the key found after the specified key in the registry of Pocket PC 


ceRegistryListValue 

ceRegistryNextKey 

ceRegistryQueryValue 

ceRegistrySetValue 

ceRegistrySubKey 

ceRemoveDir 

ceRunExe 

ceSysDir 

ceWindowsVersion 

ceWinEnum 

ceWinTitle 

ceXRes 

ceYRes 

Returns the name and possibly the type of the values for a key found in 

the Pocket PC registry 

Identifies the key found after the specified key in the registry of Pocket PC 

Reads the value of a register in the Pocket PC registry 

Writes a value into a register of the Pocket PC registry 

Identifies the path of the Nth specified sub-key in the registry of Pocket PC 

Deletes a directory from the Pocket PC connected to the current computer 

Runs a program (an executable for instance) from the current application 

Returns the path of a system directory for the Pocket PC connected to the 

current computer 

Returns information about the Windows version used on the Pocket PC 

connected to the current computer 

Enables you to enumerate the Windows windows currently opened on the 

Pocket PC 

Returns the title of the specified Windows window 

Returns the horizontal resolution of the screen for the Pocket PC 

connected to the current computer 

Returns the vertical resolution of the screen for the Pocket PC connected 

to the current computer 

Reminder: You can also use the cdbXXX functions (listed page 49).

PART 6 

Appendices

83 

NEW FEATURES IN WINDEV MOBILE 12 

Read this section if you are familiar with WinDev Mobile 11. 

WinDev Mobile 12 presents several new features. 

Work environment 

The new features of the work environment: 

• Project Editor: 

•New RAD (Rapid Application Development) 

•Internet component 

• Data Model Editor: 

•Multilingual name for items and files 

•The analysis groups can be handled by programming 

•Window Editor: 

•New catalog of images. 

•Refactoring a selection of controls into control template. 

•Templates of control templates. 

•Templates of window templates. 

•Style inheritance. 

•New sort options in list boxes and tables. 

•Memory column and ’check box’ column in browsing tables. 

•Table: ’progress bar’ column, cell merge. 

•Browsing table loaded in memory. 

• Code Editor: 

•Go of global procedure. 

•’Trace’ pane of the debugger to display the result of the trace during the last test. 

•Automated test of a window. 

•Iterations in automated tests. 

•Test robot to run tests on the Pocket PC. 

• Hyper File Client/Server: 

•Hot backup. 

•Programmed task on the server 

•Server triggers. 

• Source Code Manager: 

•Window automatically checked out when it is modified. 

•Management of rights. 

•Management of physical change of computer. 

•Masking the analysis files. 

Part 6: Appendices

84 

•Ability to process the tasks and the bugs during the checkout. 

Programming 

The new programming features: 

• Hyper File: unicode items. 

• Emulating cameras and video recording 

• New functions: 

•Functions for managing video resolution 

•ArrayToString and StringToArray 

•SNMP functions 

•Functions for managing services 

•Functions for managing the recycle bin 

•… 

Part 6: Appendices

85 

TOOLS AVAILABLE FOR WINDEV MOBILE 

Specific tools are available for using a Pocket PC from a PC: 

WDExplorer 

Tool used to view the files and directories found on a 

Pocket PC, a Smartphone, etc. 

WDRegistry 

Tool used to view the registry of a Pocket PC, a 

Smartphone, etc. 

WDCEDB 

Tool used to access the standard databases (.cdb) 

found on a Pocket PC, a Smartphone, etc. 

WDCapture 

Tool used to perform screen shots or videos of the 

connected Pocket PC or Smartphone. 

WDSynchro 

Tool for configuring the Hyper File Mobile synchronizations via ActiveSync. 

Part 6: Appendices

86 

COMPONENTS SUPPLIED WITH WINDEV 

MOBILE 

The examples of components supplied with WinDev Mobile are divided into 2 categories: 

• components that can be used from a WinDev Mobile application. 

These components are found in the "Components\Sample Components\Mobile" subdirectory 

of the setup directory of WinDev Mobile. 

Name of the component 

Pocket Directory Picker 

Pocket GANTT 

Description 

Directory picker for Pocket PC. 

Used to display a GANTT chart in a memory table or in a 

window included in the component. 

• components that can be used from a standard WinDev application that handles the files of 

Pocket PC. 

These components are found in the "Components\Sample Components\Windows" subdirectory 

of the setup directory of WinDev Mobile. 

Name of the component 

PC Directory Picker 

PC File Picker 

Description 

Selecting a directory found on a Pocket PC from a standard 


Selecting files found on a Pocket PC from a standard 


Two sub-directories are specific to each one of these examples: 

• the "-Example" sub-directory contains an example of project that uses the 

component. 

• the "-Source" sub-directory contains the component project. 

Part 6: Appendices 

Additional components are supplied with the Newsletter of Technical Support (LST) or can be 

downloaded from our site (www.windev.com).

87 

EXAMPLES SUPPLIED WITH WINDEV 

MOBILE 

The examples supplied with WinDev Mobile are intended to help you learn the features of WinDev 

Mobile. 

Their source code is presented in details. 

These examples are found in the "Examples" sub-directory of the setup directory of WinDev Mobile 

and they can be opened directly from the "Wizards, Examples and Components" pane. 

Different types of examples are supplied with WinDev Mobile: 

• examples that can be used in Pocket PC only. 

• examples containing a project that can be used in Pocket PC and that interacts with a project 

that can be used in PC. 

• examples that can be used in PC only. 

The features of some examples supplied with WinDev Mobile are as follows. 

Examples that can be used in Pocket PC only 

Pocket Animated 

Pocket Explorer 

Pocket Financial 

Functions 

This example explains how animated images can be created by WinDev 

Mobile. 

This example is a file explorer for Windows CE. You have the ability to list 

the files and directories found on a Pocket PC. 

This examples explains how to use the financial functions. 

Pocket Inventory 

Pocket Loan Lite 

Pocket Map 

Pocket MIME 

Extraction 

Pocket Notes 

This example is used to draw up an inventory and to save the results in a 

Hyper File database. 

This example is used to simulate loans and to view their depreciation 

schedules. 

This example is a light version of WDMap. This example is used to view 

and modify the data files in Hyper File Mobile format directly on a Pocket 

PC. 

This example is used to extract the attachments from an email. 

This example is used to draw graphic "notes" and to save them. You have 

the ability to enter keywords to identify your notes. 

Part 6: Appendices

88 

Pocket Password 

Pocket Persistence 

Pocket Registered 

Pocket Regular 

Expressions 

Pocket Slides 

Pocket Statistics 

Pocket Thread Pool 

Pocket Tic Tac Toe 

This example presents a "box" of passwords. It can be used to manage 

the passwords created when using Internet sites but also in applications 

or in everyday’s life. 

This example presents the use of the functions for managing persistent 

values. 

This example is an attendance manager, used to check a meeting 

attendance. 

This database was previously filled with the list of members. A bar code 

reader can be used to read the identifiers of the persons. 

This example explains how to use the regular expressions and how to 

perform searches in character strings. 

This example is an image viewer for Pocket PC. It is used to view the 

images found in a given directory. 

This example performs statistical calculations. 

This example explains how to use threads. 

Reminder: A thread is a process run in parallel of the current application. 

This example is used to play at "Tic Tac Toe" on a Pocket PC. 

The purpose of this game is simple: align 3 dots before your opponent 

does. 

Pocket 

Keyboard 

Pocket ZIP 

Virtual 

This example proposes virtual keyboards that can be fully customized 

and certainly smaller than the standard keyboard of Pocket PCs. 

This example explains how to create and handle archives (".ZIP" files). 

Examples containing a project that can be used in Pocket PC and that interacts 

with a project that can be used in PC 

Part 6: Appendices 

Beach Booking 

•"Pocket Beach" project for Pocket PC 

•"PC Beach" project for PC 

Network Tasks 

•"Pocket NetworkTasks" project for 

Pocket PC 

•"PC Network Tasks" project for PC 

These examples are used to manage bookings for 

private beaches. 

You have he ability to synchronize the data entered 

in the two projects. 

The ’PC Network Tasks’ application is used to enter 

a task list (with management of priorities, deadline, 

automatic reminder, and so on). 

The ’Pocket Network Tasks’ application is used to 

access this task list to specify that a task is in 

progress or completed.

89 

Sending SMS 

• "Pocket Sending SMS" project for 

Pocket PC 

• "PC Sending SMS" project for PC 

Using sockets 

• "Pocket Using sockets" project for 

Pocket PC 

•"PC Using sockets" project for PC 

These examples are used to send SMSs. 

These examples present the use of the functions 

for socket management. 

Additional examples can be downloaded from our site (www.windev.com). 

Part 6: Appendices

90 

Part 6: Appendices

Concepts - Source : www.pcsoft-windev-webdev.com

Create successful ePaper yourself

Delete template?

Save as template?