Top | ![]() |
![]() |
![]() |
![]() |
WebKitWebNavigationActionWebKitWebNavigationAction — Object used to report details of navigation actions |
gint | button | Read / Write / Construct Only |
gint | modifier-state | Read / Write / Construct Only |
gchar * | original-uri | Read / Write / Construct |
WebKitWebNavigationReason | reason | Read / Write / Construct |
gchar * | target-frame | Read / Write / Construct Only |
WebKitWebNavigationAction is used in signals to provide details about what led the navigation to happen. This includes, for instance, if the user clicked a link to start that navigation, and what mouse button was used.
gint
webkit_web_navigation_action_get_button
(WebKitWebNavigationAction *navigationAction
);
The GTK+ identifier for the mouse button used to click. Notice that GTK+ button values are 1, 2 and 3 for left, middle and right buttons, so they are DOM button values +1. If the action was not initiated by a mouse click the value will be -1.
Since 1.0.3
gint
webkit_web_navigation_action_get_modifier_state
(WebKitWebNavigationAction *navigationAction
);
Returns a bitmask with the the state of the modifier keys.
Since 1.0.3
const gchar *
webkit_web_navigation_action_get_original_uri
(WebKitWebNavigationAction *navigationAction
);
Returns the URI that was originally requested. This may differ from the navigation target, for instance because of a redirect.
Since 1.0.3
WebKitWebNavigationReason
webkit_web_navigation_action_get_reason
(WebKitWebNavigationAction *navigationAction
);
Returns the reason why WebKit is requesting a navigation.
Since 1.0.3
const gchar *
webkit_web_navigation_action_get_target_frame
(WebKitWebNavigationAction *navigationAction
);
Returns the target frame of the action.
Since 1.1.13
void webkit_web_navigation_action_set_original_uri (WebKitWebNavigationAction *navigationAction
,const gchar *originalUri
);
Sets the URI that was originally requested. This may differ from the navigation target, for instance because of a redirect.
Since 1.0.3
void webkit_web_navigation_action_set_reason (WebKitWebNavigationAction *navigationAction
,WebKitWebNavigationReason reason
);
Sets the reason why WebKit is requesting a navigation.
Since 1.0.3
Enum values used to denote the various navigation reasons.
The navigation was triggered by clicking a link. |
||
The navigation was triggered by submitting a form. |
||
The navigation was triggered by navigating forward or backward. |
||
The navigation was triggered by reloading. |
||
The navigation was triggered by resubmitting a form. |
||
The navigation was triggered by some other action. |
“button”
property“button” gint
The GTK+ identifier for the mouse button used to click. Notice that GTK+ button values are 1, 2 and 3 for left, middle and right buttons, so they are DOM button values +1. If the action was not initiated by a mouse click the value will be -1.
Flags: Read / Write / Construct Only
Allowed values: >= -1
Default value: -1
Since 1.0.3
“modifier-state”
property“modifier-state” gint
The state of the modifier keys when the action was requested.
Flags: Read / Write / Construct Only
Allowed values: >= 0
Default value: 0
Since 1.0.3
“original-uri”
property“original-uri” gchar *
The URI that was requested as the target for the navigation.
Flags: Read / Write / Construct
Default value: ""
Since 1.0.3
“reason”
property“reason” WebKitWebNavigationReason
The reason why this navigation is occuring.
Flags: Read / Write / Construct
Default value: WEBKIT_WEB_NAVIGATION_REASON_OTHER
Since 1.0.3
“target-frame”
property“target-frame” gchar *
The target frame for the navigation.
Flags: Read / Write / Construct Only
Default value: NULL
Since 1.1.13