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 :
- #define INCL_WINMESSAGEMGR
- #include "os2.h"
-
- #define ID_APPLICATIONNAME 3
-
- void main(void) {
- HWND hwndMain, hwndClient;
- PFNWP ClientWndProc;
- ULONG pflCreateFlags = FCF_ACCELTABLE | FCF_ICON | FCF_MENU | FCF_MINMAX | FCF_SIZEBORDER | FCF_SYSMENU | FCF_TASKLIST | FCF_TITLEBAR;
- CHAR szTitle;
- HAB myhab = WinInitialize(0);
- HMQ hmq = WinCreateMsgQueue(myhab, 0);
- if(WinRegisterClass(myhab, "CLIENT",ClientWndProc, 0, 0)) {
- WinLoadString(myhab, 0, ID_APPLICATIONNAME, sizeof(szTitle), szTitle);
- hwndMain = WinCreateStdWindow(HWND_DESKTOP, WS_VISIBLE, &pflCreateFlags, "CLIENT", szTitle, 0, 0, ID_APPLICATIONNAME, &hwndClient);
- }
- }
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