« Gecko Plugin API Reference « Plug-in Side Plug-in API
Résumé
Indique au greffon (plugin) qu'une fenêtre est créée, déplacée, redimensionnée ou détruite.
Syntaxe
#include <npapi.h> NPError NPP_SetWindow(NPP instance, NPWindow *window);
Paramètres
La fonction a les paramètres suivants :
- instance
- Pointeur vers l'instance du greffon courant (Doit être embarqué ou en plein-écran).
- window
-
Pointeur vers la fenêtre où l'instance s'affiche. La structure de la fenêtre contient un "gestionnaire de fenêtre" (trad incertaine de "a window handle") et les valeurs suivantes :
Coordonnées (coin haut-gauche), largeur, hauteur et "rectangle de coupure" (trad incertaine de "clipping rectangle") (voir les notes concernant Unix ci-dessous).
Valeurs retournées
- En cas de succès : NPERR_NO_ERROR.
- En cas d'erreur : Le greffon n'est pas chargé et un code d'erreur est retourné (Codes Erreurs [en-ja]).
Description
Le navigateur appelle NPP_SetWindow après avoir créé l'instance pour permettre le début de l'affichage. Les appels suivants à NPP_SetWindow indiquent des changements de taille ou de position. Ces appels transmettent le même objet NPWindow [en-ja] à chaque fois mais avec des valeurs différentes. Si les gestionnaire de fenêtre est défini à null, la fenêtre est supprimée. Dans ce cas le greffon ne doit provoquer aucune opération graphique supplémentaire sur la fenêtre et doit libérer toute ressource associée.
La structure de données fournie à NPP_SetWindowest un objet NPWindow [en-ja] contenant les coordonnées de la zone de l'instance (et différentes données spécifiques à la plateforme). Cette fenêtre est valide tant que l'instance existe ou jusqu'à ce que NPP_SetWindow soit de nouveau appelé avec d'autres valeurs.
Pour des greffons fenêtrés sous Unix et Windows, le paramètre window contient un gestionnaire de sous-fenêtre de la hiérarchie des fenêtres du navigateur. Sur Mac OS, ce champs pointe sur une structure NP_Port [en-ja]. Pour des greffons sans fenêtre, c'est un gestionnaire d'affichage (handle to drawable) spécifique à la plateforme.
Avant de faire pointer le paramètre window sur une nouvelle fenêtre, il est conseillé de comparer les informations cette dernière et l'ancienne (si elle existe) pour relever tout changement.
Voir aussi
NPP [en-ja] -> NPP_New [en-ja], NPP_Destroy [en-ja], NPP_HandleEvent [en-ja], NPP_SetWindow [en-ja]
NP_Shutdown [en-ja], NP_Initialize [en-ja]
NPWindow [en-ja]
NPSavedData [en-ja]
NP_Port [en-ja]
Codes Erreurs [en-ja]
Notes de traduction
- Cette traduction est faite à partir de la version anglaise datant du 3 Avril 2010. Il se peut qu'elle ait été enrichie depuis (ou que d'autres langues aient été ajoutées).
- Le liens vers d'autres ressources sont indiqués dans chaque langue pour contourner les problèmes de liens morts.
- Cette traduction est un brouillon à corriger/valider.