WinCreateWindow |
Fenêtre : Crée une fenêtre |
|---|---|
| PMWIN.DLL | os2.h |
Syntaxe
| HWND WinCreateWindow( HWND hwndParent, PSZ pszClass , PSZ pszText, ULONG flStyle, LONG x, LONG y, LONG cx, LONG cy, HWND hwndOwner, HWND hwndBehind, ULONG id, PVOID pCtrlData, PVOID pPresParams ); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| hwndParent | Ce paramètre permet d'indiquer le Handle de la fenêtre parent. | ||
| pszClass | Ce paramètre permet d'indiquer le nom de la classe. Doit déjà être enregistré via la fonction WinRegisterClass ou une classe prédéfinit du gestionnaire de présentation. Voici quelques unes des classes possibles : | ||
| Classe | Données de contrôle | Description | |
| WC_BUTTON | BTNCDATA | Cette classe permet d'indiquer des types de touches. | |
| WC_CIRCULARSLIDER | Cette classe est adopté par MMOS2 et une aspect comme un contrôle de volume. | ||
| WC_COMBOBOX | COMBOCDATA | Cette classe contient une combinaison de boite de liste d'entrée de champ. | |
| WC_CONTAINER | CNRINFO | Cette classe contient un conteneur de contrôle. | |
| WC_ENTRYFIELD | ENTRYFDATA | Cette classe contient un champ d'entrée. | |
| WC_FRAME | FRAMECDATA | Cette classe contient un contrôle de cadre de fenêtre. | |
| WC_LISTBOX | LBOXINFO | Cette classe contient un contrôle de boite de liste. | |
| WC_MENU | Cette classe contient un contrôle de menu. | ||
| WC_MLE | MLECTLDATA | Cette classe contient un contrôle d'éditeur multi-ligne. | |
| WC_NOTEBOOK | BOOKPAGEINFO | Cette classe contient un contrôle Notebook. | |
| WC_SCROLLBAR | SBCDATA | Cette classe contient une barre de défilement horizontal ou vertical. | |
| WC_SLIDER | SLDCDATA | Cette classe contient une curseur horizontal ou vertical. | |
| WC_SPINBUTTON | SPBCDATA | Cette classe contient un contrôle de bouton radio de volume. | |
| WC_STATIC | Cette classe permet d'effectuer un affichage de texte ou Bitmap statique. | ||
| WC_TITLEBAR | Cette classe permet d'effectuer l'affichage du barre de titre. | ||
| WC_VALUESET | VSCDATA | Cette classe contient un contrôle d'ensemble de valeur. Vous devrez fournir quelques Bitmap pour utilisé cette classe. | |
| ... | ... | ... | |
| pszText | Ce paramètre permet d'indiquer la fenêtre texte. | ||
| flStyle | Ce paramètre permet d'indiquer le style de la fenêtre. Ce paramètre est habituellement choisis à partir de constantes de gestionnaire de présentation prédéfinis, mais vous pouvez également créer vos propres styles pour vos classes. Voici les styles les plus communs prédéfinit pour le gestionnaire de présentation : | ||
| Constante | Description | ||
| WS_ANIMATE | Cette constante permet d'indiquer l'activation d'animation WPS, sauf si l'utilisateur a désactivé cette fonctionnalité. | ||
| WS_CLIPCHILDREN | Cette constante permet d'indiquer une fenêtre n'étant pas dessiné dans un enfant. | ||
| WS_CLIPSIBLINGS | Cette constante permet d'indiquer une fenêtre n'étant pas dessiné entre frère et soeur. | ||
| WS_DISABLED | Cette constante permet d'indiquer que la création de fenêtre est désactivé. | ||
| WS_GROUP | Cette constante permet d'indiquer qu'il faut débuter un nouveau de groupe de boite de dialogue. | ||
| WS_MAXIMIZED | Cette constante permet d'indiquer qu'il faut maximiser la fenêtre. | ||
| WS_MINIMIZED | Cette constante permet d'indiquer qu'il faut minimiser la fenêtre. | ||
| WS_PARENTCLIP | Cette constante permet d'indiquer que la fenêtre créé avec ce style n'est pas dessiné en dehors des limites de leur parent. | ||
| WS_SAVEBITS | Cette constante permet d'indiquer que le gestionnaire de présentation doit sauvegarder les pixels de cette fenêtre pour que quand la fenêtre est fermé ou déplacé, elle se redessine plus vite. | ||
| WS_SYNCPAINTS | Cette constante permet d'indiquer qu'un message WM_PAINT sera envoyé, plutôt que posté. | ||
| WS_TABSTOP | Cette constante permet d'indiquer que lorsqu'on enfonce la touche de tabulation dans une boite de dialogue elle déplacera le focus dans cette fenêtre. | ||
| WS_VISIBLE | Cette constante permet d'indiquer qu'un message WM_PAINT sera envoyé, plutôt que posté. Sans ce style, la fenêtre créé sera invisible, et devra être affichés plus tard avec WinSetWindowPos ou WinShowWindow. | ||
| x | Ce paramètre permet d'indiquer la position X du coin inférieur gauche. | ||
| y | Ce paramètre permet d'indiquer la position Y du coin inférieur gauche. | ||
| cx | Ce paramètre permet d'indiquer la largeur de la fenêtre en pixels. | ||
| cy | Ce paramètre permet d'indiquer la hauteur de la fenêtre en pixels. | ||
| hwndOwner | Ce paramètre permet d'indiquer le propriétaire de la fenêtre. | ||
| hwndBehind | Ce paramètre permet d'indiquer le Handle derrière laquelle cette fenêtre apparaîtra dans un z-order. | ||
| id | Ce paramètre permet d'indiquer une valeur donnée par le programmeur afin d'identifier la fenêtre par le propriétaire. La valeur doit être compris dans l'intervalle 0x0000 et 0xFFFF. | ||
| pCtrlData | Ce paramètre permet d'indiquer une données de classe spécifique dans le message WM_CREATE avec ce paramètre. | ||
| pPresParams | Ce paramètre permet d'indiquer un pointeur de présentation de classe spécifique passé à la procédure de fenêtre dans WM_CREATE. | ||
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 de la nouvelle fenêtre créé. |
Description
Cette fonction permet de demander une représentation de l'espace de dessinage d'une fenêtre spécifié.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_WINMESSAGEMGR
- #include "os2.h"
-
- #define ID_CLIENT 3
-
- void main(void) {
- HWND hwndFrame;
- WinCreateWindow(hwndFrame, "CLIENT", NULL, WS_VISIBLE, 0, 0, 50, 50, hwndFrame, HWND_BOTTOM, ID_CLIENT, NULL, NULL);
- }
Voir également
Langage de programmation - C pour OS/2 - WinCreateStdWindow
Références
OS/2 Warp Presentation Manager API, Edition John Wiley, Joel Barnum, 1995, ISBN: 0-471-03873-3, page 22
Dernière mise à jour : Lundi, le 19 juillet 2010