NPN_Status

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

Summary

Lets a plug-in display a message on the browser's status line.

Syntax

#include <npapi.h>

void NPN_Status(NPP instance, const char* message);

Parameters

The function has the following parameters:

instance
Pointer to the current plug-in instance.
message
Pointer the buffer that contains the status message string to display.

Description

You can use this function to make your plug-in display status information in the browser window, in the same place the browser does. If your plug-in has a button or other object that acts as a link when clicked, you can call NPN_Status() to display a description or URL when the user moves the cursor over it.

The browser always displays the last status line message it receives, regardless of the message source. Your message is always displayed, but you have no control over how long it stays in the status line before another message replaces it.

See also