NPSetWindowCallbackStruct

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

Summary

Note: This structure is only used on Unix platforms.

Contains information about the plug-in's Unix window environment.

Syntax

typedef struct
{
    int32         type;
    Display*      display;
    Visual*       visual;
    Colormap      colormap;
    unsigned int  depth;
} NPSetWindowCallbackStruct;

Fields

The data structure has the following fields:

type
Always contains NP_SetWindow.
display
Standard X Toolkit attribute. Pointer to the Display structure that represents the browser-server connection.
visual
Standard X Toolkit attribute. X Visual for the plug-in window or drawable.
colormap
Standard X Toolkit attribute. Colormap for the plug-in window or drawable.
depth
Standard X Toolkit attribute. Depth of the plug-in window or drawable.

Description

Callback structures are used to pass platform-specific information. The NPSetWindowCallbackStruct object, allocated by the browser, contains information required for the ws_info field of an NPWindow.

The NPP_SetWindow() function passes a pointer to this structure to the plug-in. The structure is valid for the lifetime of the NPWindow, that is, until NPP_SetWindow() is called again or the instance is destroyed.

The type field of this structure always contains NP_SetWindow. The remaining fields are Standard X Toolkit attributes of the top-level shell window in the browser window hierarchy.

See also