WinCreateObject |
Fenêtre : Crée un objet |
|---|---|
| PMWP.DLL | os2.h |
Syntaxe
| HOBJECT WinCreateObject( PSZ pszClassName, PSZ pszTitle, PSZ pszSetupString, PSZ pszLocation, ULONG ulFlags ); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| pszClassName | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ contenant le nom d'un objet de classe. | ||
| pszTitle | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ contenant le titre d'un objet. | ||
| pszSetupString | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ contenant les ajustements. | ||
| pszLocation | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ contenant un emplacement de dossier (identificateur d'objet). Voici les objets prédéfinies pour les dossiers systèmes : | ||
| Valeur | Description | ||
| "<WP_NOWHERE>" | Cette valeur permet d'indiquer un dossier caché. | ||
| "<LOCATION_DESKTOP>" | Cette valeur permet d'indiquer le bureau actuellement actif. | ||
| "<WP_OS2SYS>" | Cette valeur permet d'indiquer le dossier système. | ||
| "<WP_TEMPS>" | Cette valeur permet d'indiquer le dossier de gabarit. | ||
| "<WP_CONFIG>" | Cette valeur permet d'indiquer le dossier des ajustements systèmes. | ||
| "<WP_START>" | Cette valeur permet d'indiquer le dossier de démarrage. | ||
| "<WP_INFO>" | Cette valeur permet d'indiquer le dossier d'informations. | ||
| "<WP_DRIVES>" | Cette valeur permet d'indiquer le dossier d'unités. | ||
| ulFlags | Ce paramètre permet d'indiquer des drapeaux de création d'objet. Voici la liste des paramètres pouvant être utilisé pour personnalisé la création d'objet : | ||
| Constante | Description | ||
| CO_FAILIFEXISTS | Cette constante permet d'indiquer que l'objet ne peut pas être créé s'il existe déjà. | ||
| CO_REPLACEIFEXISTS | Cette constante permet d'indiquer que l'objet est remplacé par un objet existant si nécessaire. | ||
| CO_UPDATEIFEXISTS | Cette constante permet d'indiquer que si l'objet existe, il peut être mise-à-jour avec les nouvelles informations. | ||
Retour
| Valeur | Description |
|---|---|
| NULLHANDLE | Cette valeurs permet d'indiquer qu'une erreur s'est produite, dans ce cas consulter la fonction WinGetLastError(). |
| entier | Ces valeurs permettent d'indiquer un identificateur de Handle du nouvel objet. |
Description
Cette fonction permet de créer un objet pszClassName avec le titre pszTitle et le place dans l'emplacement pszLocation.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_WINWINDOWMGR
- #include "os2.h"
-
- void main(void) {
- HOBJECT hObj = WinCreateObject("WPProgram", "Mon programme", "PROGTYPE=PM;EXENAME=MONPROG.EXE;", "<WP_OS2SYS>", CO_FAILIFEXISTS);
- }
Voir également
Langage de programmation - C pour OS/2 - WinDestroyObject
Références
OS/2 Warp Presentation Manager API, Edition John Wiley, Joel Barnum, 1995, ISBN: 0-471-03873-3, page 429
Dernière mise à jour : Lundi, le 19 juillet 2010