PCSoft : WDAPI : Utiliser les API dans une application WINDEV

Présentation

Deux des fonctionnalités les plus intéressantes de WDAPI sont les suivantes :

• la possibilité de consulter la liste des fonctions, structures et constantes des API Windows.
  
• la possibilité pour les fonctions et les constantes d’obtenir la syntaxe WLangage correspondante.
  

Ces fonctionnalités sont disponibles dans les volets « Fonctions », « Structures » et « Constantes » de WDAPI.

Rappel : WDAPI peut être lancé depuis WDOutil : sous le volet « Outils », dans le groupe « Utilitaires », cliquez sur « WDOutil ».

Consulter la liste des fonctions, structures et constantes API Windows

Pour rechercher une fonction, une constante ou une structure :

1. Positionnez-vous sur le volet souhaité (« Fonctions », « Structures » ou « Constantes »).
   
2. Cliquez sur la loupe présente dans l’entête de la colonne « Nom de la fonction » (ou « Nom de la structure » ou « Nom de la constante »).
   
3. Tapez les premières lettres du nom de la fonction, constante ou structure recherchée. La table est alors automatiquement positionnée sur l’élément dont le nom se rapproche le plus de celui saisi.
   

Exemple : Dans le volet « Fonctions », la saisie du mot « Move » positionnera la liste sur les fonctions dont le nom commence par « Move ».

Génération et utilisation du code WLangage nécessaire à l’utilisation d’une API Windows

Pour générer et utiliser le code WLangage correspondant à l’API Windows :

• Sélectionnez la fonction ou la structure de l’API Windows à utiliser en WLangage.
  
• WDAPI génère automatiquement le code WLangage nécessaire à l’utilisation de la fonction ou de la structure API.
  Si la fonction API nécessite l’utilisation d’une ou de plusieurs structures, WDAPI génère automatiquement le code WLangage correspondant à la déclaration de la ou des structures utilisées.
  Si vous souhaitez gérer les erreurs, sélectionnez l’option « Ajouter le code WLangage pour afficher un message en cas d’erreur ».
  
• Cliquez sur le bouton « Copier » associé à la syntaxe WLangage.
  
• Dans votre projet WINDEV, sélectionnez le traitement devant appeler la fonction API Windows.
  
• Dans l’éditeur de code, sélectionnez l’option « Coller » du menu contextuel (ou appuyez sur les touches [CTRL] + [V]).
  
• Adaptez le code copié à votre application : initialisez les variables selon votre programme.
  
• Si des structures sont nécessaires, vous devez copier le code de déclaration de ces structures dans votre code WLangage. Pour cela :
  
  • Cliquez sur le bouton « Copier » associé au code de déclaration des structures WLangage.
    
  • Dans votre projet WINDEV, sélectionnez le traitement voulu :
    
  • traitement d’initialisation du projet (conseillé).
    
  • traitement de déclaration des globales de la fenêtre.
    
  • traitement de déclaration des globales de la collection de procédures dans laquelle l’appel à la fonction API est réalisé.
    
  • Dans l’éditeur de code, sélectionnez l’option « Coller » du menu contextuel (ou appuyez sur les touches [CTRL] + [V]).
    

Cas rare : Il se peut que certaines particularités liées à une fonction API Windows ne soit pas interprétées correctement par WDAPI. Vous devrez donc effectuer la conversion par vous-même.

Exemple :