Section courante

A propos

Section administrative du site

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 :

  1. #define INCL_WINMESSAGEMGR
  2. #include "os2.h"
  3.  
  4. #define ID_CLIENT 3
  5.  
  6. void main(void) {
  7.     HWND hwndFrame;
  8.     WinCreateWindow(hwndFrame, "CLIENT", NULL, WS_VISIBLE, 0, 0, 50, 50, hwndFrame, HWND_BOTTOM, ID_CLIENT, NULL, NULL);
  9. }

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