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