NPP SetWindow

par 3 contributeurs :

« 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.

NOTE: NPP_SetWindow est utile uniquement pour les greffons embarqués (NP_EMBED) ou plein-écran (NP_FULL), qui sont affichés dans une fenêtre. NPP_SetWindow est hors de propos pour les greffons cachés.

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.

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : Delapouite, tregagnon, Demos
Dernière mise à jour par : Delapouite,