mozilla
Vos résultats de recherche

    NPP SetWindow

    « 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 : 
    Contributors to this page: Demos, Delapouite, tregagnon
    Dernière mise à jour par : Delapouite,