NPP New

 

« Gecko Plugin API Reference « Plug-in Side Plug-in API

Résumé

Crées une nouvelle instance de greffon (plugin).

Syntaxe

#include <npapi.h>
 
NPError NPP_New(NPMIMEType    pluginType,
                NPP instance, uint16 mode,
                int16 argc,   char *argn[],
                char *argv[], NPSavedData *saved);

Paramètres

La fonction dispose des paramètres suivants :

pluginType
Pointeur sur le type MIME de la nouvelle instance du greffon.
instance
Données privées spécifiques à l'instance accessibles au greffon et au navigateur (Le navigateur ne les modifie pas). Elles sont stockées dans instance->pdata.
mode
Mode d'affichage du greffon. Valeurs:
  • NP_EMBED: (1) L'instance a été créée via un tag EMBED et partage la fenêtre du navigateur avec d'autres contenus.
  • NP_FULL: (2) L'instance a été créée par un fichier séparé et est le contenu premier de la fenêtre
argc
Nombre d'arguments HTML dans le tag EMBED pour un greffon embarqué (détermine le nombre d'attributs dans les vecteurs argn et rgv).
argn[]
Vecteur des noms des attributs transmis au greffon depuis le tag EMBED.
argv[]
Vecteur des valeurs des attributs transmis au greffon depuis le tag EMBED.
saved
Pointer to data saved by NPP_Destroy [en-ja] for a previous instance of this plug-in at the same URL. If non-null, the browser passes ownership of the NPSavedData [en-ja] object back to the plug-in. The plug-in is responsible for freeing the memory for the NPSavedData [en-ja] and the buffer it contains.

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

NPP_New crée une nouvelle instance de greffon. Elle est appelée après NP_Initialize [en-ja] et transmet le type MIME, le mode d'affichage et, pour les greffons embarqués, des informations concernant arguments du tag EMBED.

Un nouveau pointeur d'instance de NPP  [en-ja] est crée par le greffon. Il reste valide jusqu'à la destruction de l'instance par NPP_Destroy [en-ja].

Si les données d'une ancienne instance ont été sauvées lors de l'appel de NPP_Destroy [en-ja], l'instance crée redémarre selon les paramètres en question.

Tous les attributs du tag EMBED (privés comme standards) sont transmis à NPP_New dans les vecteurs argn et argv. Le navigateur ignore tous les attributs non-standards issus du tag EMBED. Cela permet aux développeurs d'utiliser des attributs privés pour définir des options spécifiques à l'instance (ou de nouvelles informations pour le greffon). Placez les options privées à la fin de la liste des attributs standards dans le tag EMBED.

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]

Étiquettes et contributeurs liés au document

Contributeurs ayant participé à cette page : Demos
Dernière mise à jour par : Demos,