Netscape DevEdge

Skip to: [content] [navigation]

TOC PREV NEXT

plug-ins!

NPN_InvalidateRect

Invalidates specified drawing area prior to repainting or refreshing a windowless plug-in.

Syntax 

#include <npapi.h>
 
void NPN_InvalidateRect(NPP instance,
 
                        NP_Rect *invalidRect);

Parameters

The function has the following parameters: 

instance
Pointer to the current plug-in instance.
 
invalidRect
The area to invalidate, specified in a coordinate system that originates at the top left of the plug-in.

Description

Before a windowless plug-in can repaint or refresh part of its drawing area, the plug-in must first invalidate the area with either NPN_InvalidateRect or NPN_InvalidateRegion.

NPN_InvalidateRect causes the NPP_HandleEvent method to pass an update event or a paint message to the plug-in. After calling this method, the plug-in receives a paint message asynchronously.

The browser redraws invalid areas of the document and any windowless plug-ins at regularly timed intervals. To force a paint message, the plug-in can call NPN_ForceRedraw after calling this method.

See Also 

NPN_ForceRedraw, NPN_InvalidateRegion, NP_Rect, NPP

Netscape Communications
http://developer.netscape.com
TOC PREV NEXT
A–+R