setInstancePtr()

Allows the Web Browser Engine to pass the correct WebView instance pointer within certain events.

Synopsis:

#include <GFWindow.h>

void setInstancePtr(void *ptr)

Description:

This function allows the Web Browser Engine to pass the correct WebView instance pointer within certain events. The events are received by the launcher's event handler.

The launcher application must use this method if it creates multiple WebView instances. Currently this is only used by expose pulses but may be expanded in the future.

Arguments:

*ptr

A pointer to a WebView instance.

---

The Web Browser Engine exports a global pointer called _webViewInstancePtr. It performs a similar function to the GfWindow object's setInstancePtr() function for WebKit operations, where the GfWindow object is not known. In general, this pointer must be set whenever the launcher has created multiple WebView instances and the launcher's event handler makes calls into WebKit using the WebView API. This is so that the dispatch and timer pulses received back from WebKit always contain correct instance information.

---

See also:

getInstancePtr()