Section courante

A propos

Section administrative du site

WinCreateStdWindow

 Fenêtre : Crée une fenêtre standard
PMWIN.DLL os2.h

Syntaxe

HWND WinCreateStdWindow( HWND hwndParent, ULONG flFrameStyle, PULONG pflCreateFlags, PSZ pszClientClass, PSZ pszTitle, ULONG flClientStyle, HMODULE hmodResource, ULONG ulFrameId, PHWND pwhndClient );

Paramètres

Nom Description
hwndParent Ce paramètre permet d'indiquer Handle de la fenêtre parente.
flFrameStyle Ce paramètre permet d'indiquer le style de fenêtre. Voici les styles les plus communs prédéfinit pour le gestionnaire de présentation :
Constante Description
FS_AUTOICON Cette constante permet d'indiquer que le système redessine l'icône pour l'application.
FS_BORDER Cette constante permet d'indiquer une fenêtre avec une fine bordure.
FS_DLGBORDER Cette constante permet d'indiquer une fenêtre avec une bordure de dialogue.
FS_MOUSEALIGN Cette constante permet d'indiquer la position relative de la position de la souris.
FS_NOBYTEALIGN Cette constante permet d'indiquer d'effectuer un déplacement non aligné d'octets proches. Lent, mais très beau.
FS_NOMOVEWITHOWNER Cette constante permet d'indiquer que la fenêtre ne doit pas être déplacer quand le propriétaire en fait la demande.
FS_SCREENALIGN Cette constante permet d'indiquer les coordonnées relatives en haut à gauche de l'écran.
FS_SIZEBORDER Cette constante permet d'indiquer que la fenêtre est avec des bordures de redimensionnement normal.
FS_SYSMODAL Cette constante permet d'indiquer une fenêtre de modèle système.
FS_TASKLIST Cette constante permet d'indiquer une fenêtre à ajouter dans la liste de tâche.
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_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.
pflCreateFlags 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 Description
FCF_ACCELTABLE Cette classe permet de spécifié les accélérateurs de raccourci clavier devant être chargé avec la ressource du fichier.
FCF_AUTOICON Cette classe permet d'automatiquement gérer les messages WM_PAINT tant que l'application en icône.
FCF_BORDER Cette classe permet de créer une fenêtre avec de fine bordure.
FCF_DLGBORDER Cette classe permet de créer une fenêtre avec des bordures fixe de style boite de dialogue.
FCF_HIDEBUTTON Cette classe permet d'ajouter un bouton caché dans un cadre.
FCF_HIDEMAX Cette classe permet d'ajouter un bouton caché et maximisé dans un cadre.
FCF_HORZSCROLL Cette classe permet d'ajouter une barre de défilement horizontal dans la fenêtre client.
FCF_ICON Cette classe permet d'utiliser une icône d'un fichier ressource d'une application d'icône.
FCF_MAXBUTTON Cette classe permet d'ajouter un bouton maximiser au cadre.
FCF_MENU Cette classe permet de charger un menu d'un fichier de ressource.
FCF_MINBUTTON Cette classe permet d'ajouter un bouton minimiser au cadre.
FCF_MINMAX Cette classe permet d'ajouter des boutons minimiser et maximiser au cadre.
FCF_MOUSEALIGN Cette classe permet de créer une fenêtre d'application relative à la position de la souris au moment de la création.
FCF_NOBYTEALIGN Cette classe permet de ne pas forcer l'alignement de la fenêtre dans un octet paire, contrairement aux fenêtres VIO.
FCF_NOMOVEWITHOWNER Cette classe permet de désactiver le mouvement de la fenêtre quand le propriétaire la déplace.
FCF_SCREENALIGN Cette classe permet de créer une fenêtre d'application relative au coin supérieur gauche de l'écran.
FCF_SHELLPOSITION Cette classe permet de redimensionnement automatiquement la taille d'une fenêtre d'application et de positionner la fenêtre avec le gestionnaire de présentation.
FCF_SIZEBORDER Cette classe permet de créer un cadre de fenêtre avec une bordure redimensionnable normalement.
FCF_STANDARD Cette classe permet de créer une fenêtre avec un système de fichier, un barre de titre, de minimiser et maximiser les boutons, le menu, la bordure redimensionnable, un icône, les raccourcis clavier, la position et la taille par défaut et une entrée dans la liste de tâche.
FCF_SYSMENU Cette classe permet de créer un cadre de fenêtre avec un menu système dans le coin supérieur gauche.
FCF_SYSMODAL Cette classe permet de créer une fenêtre de modèle système.
FCF_TASKLIST Cette classe permet de créer une entrée dans la liste de fenêtre pour les applications.
FCF_TITLEBAR Cette classe permet de créer un cadre de fenêtre avec une barre de titre.
FCF_VERTSCROLL Cette classe permet de créer une barre de défilement vertical dans une fenêtre client.
pszClientClass Ce paramètre permet d'indiquer une classe ayant un nom préenregistré.
pszTitle Ce paramètre permet d'indiquer un titre de fenêtre.
flClientStyle Ce paramètre permet d'indiquer des drapeaux indiquant le style de la fenêtre client.
hmodResource Ce paramètre permet d'indiquer le Handle du module ressource lequel est requis pour l'icône, le menu et la table d'accélérateur.
ulFrameId Ce paramètre permet d'indiquer la valeur donné par le programmeur afin d'identifier le propriétaire de la fenêtre.
pwhndClient Ce paramètre permet de retourner le HWND pour la nouvelle création de fenêtre.

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.

Description

Cette fonction permet de créer une fenêtre de type de standard, dans une fenêtre principal d'une application.

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_APPLICATIONNAME 3
  5.  
  6. void main(void) {
  7.     HWND hwndMain, hwndClient;
  8.     PFNWP ClientWndProc;
  9.     ULONG pflCreateFlags = FCF_ACCELTABLE | FCF_ICON | FCF_MENU | FCF_MINMAX | FCF_SIZEBORDER | FCF_SYSMENU | FCF_TASKLIST | FCF_TITLEBAR;
  10.     CHAR szTitle;
  11.     HAB myhab = WinInitialize(0);
  12.     HMQ hmq = WinCreateMsgQueue(myhab, 0);
  13.     if(WinRegisterClass(myhab, "CLIENT",ClientWndProc, 0, 0)) {
  14.         WinLoadString(myhab, 0, ID_APPLICATIONNAME, sizeof(szTitle), szTitle);
  15.         hwndMain = WinCreateStdWindow(HWND_DESKTOP, WS_VISIBLE, &pflCreateFlags, "CLIENT", szTitle, 0, 0, ID_APPLICATIONNAME, &hwndClient);
  16.     }
  17. }

Voir également

Langage de programmation - C pour OS/2 - WinCreateWindow

Références

OS/2 Warp Presentation Manager API, Edition John Wiley, Joel Barnum, 1995, ISBN: 0-471-03873-3, page 17

Dernière mise à jour : Lundi, le 19 juillet 2010