--- title: NPP New slug: NPP_New translation_of: Archive/Plugins/Reference/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]

{{ languages( { "ja": "ja/NPP_New", "en": "en/NPP_New" } ) }}