NPN Status
From MDC
« Gecko Plugin API Reference « Browser Side Plug-in API
Contents |
[edit] Summary
Displays a message on the status line of the browser window.
[edit] Syntax
#include <npapi.h> void NPN_Status(NPP instance, const char* message);
[edit] 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.
[edit] Description
You can use this function to make your plug-in user interface simulate the browser `s behavior. When the user moves the cursor over a link in a browser window, Communicator displays information about it in the status message area (on the lower edge of the browser window). 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.