Commit d4d4bb53 authored by Alberto Garcia's avatar Alberto Garcia
Browse files

New upstream version 2.17.4

parent fecc5089
......@@ -7,7 +7,7 @@
<link rel="home" href="index.html" title="WebKit2GTK+ Reference Manual">
<link rel="up" href="ch01.html" title="Class Overview">
<link rel="prev" href="WebKitContextMenu.html" title="WebKitContextMenu">
<link rel="next" href="WebKitFormSubmissionRequest.html" title="WebKitFormSubmissionRequest">
<link rel="next" href="WebKitOptionMenu.html" title="WebKitOptionMenu">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
......@@ -21,7 +21,7 @@
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="WebKitContextMenu.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="WebKitFormSubmissionRequest.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
<td><a accesskey="n" href="WebKitOptionMenu.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="WebKitContextMenuItem"></a><div class="titlepage"></div>
......
......@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="WebKit2GTK+ Reference Manual">
<link rel="up" href="ch01.html" title="Class Overview">
<link rel="prev" href="WebKitContextMenuItem.html" title="WebKitContextMenuItem">
<link rel="prev" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">
<link rel="next" href="WebKitSecurityManager.html" title="WebKitSecurityManager">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
......@@ -20,7 +20,7 @@
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="WebKitContextMenuItem.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="p" href="WebKitOptionMenuItem.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="WebKitSecurityManager.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>WebKitOptionMenu: WebKit2GTK+ Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="WebKit2GTK+ Reference Manual">
<link rel="up" href="ch01.html" title="Class Overview">
<link rel="prev" href="WebKitContextMenuItem.html" title="WebKitContextMenuItem">
<link rel="next" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#WebKitOptionMenu.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
<a href="#WebKitOptionMenu.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_signals">  <span class="dim">|</span> 
<a href="#WebKitOptionMenu.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="WebKitContextMenuItem.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="WebKitOptionMenuItem.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="WebKitOptionMenu"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="WebKitOptionMenu.top_of_page"></a>WebKitOptionMenu</span></h2>
<p>WebKitOptionMenu</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="WebKitOptionMenu.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
</td>
<td class="function_name">
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-get-n-items" title="webkit_option_menu_get_n_items ()">webkit_option_menu_get_n_items</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="returnvalue">WebKitOptionMenuItem</span></a> *
</td>
<td class="function_name">
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-get-item" title="webkit_option_menu_get_item ()">webkit_option_menu_get_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-select-item" title="webkit_option_menu_select_item ()">webkit_option_menu_select_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-activate-item" title="webkit_option_menu_activate_item ()">webkit_option_menu_activate_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-close" title="webkit_option_menu_close ()">webkit_option_menu_close</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody><tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="WebKitOptionMenu.html#WebKitOptionMenu-close" title="The “close” signal">close</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody><tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="WebKitOptionMenu.html#WebKitOptionMenu-struct" title="struct WebKitOptionMenu">WebKitOptionMenu</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> WebKitOptionMenu
</pre>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.description"></a><h2>Description</h2>
<p>WebKitOptionMenu represents the dropdown menu of a select element in a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>.</p>
<p>When a select element in a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> needs to display a dropdown menu, the signal
<a class="link" href="WebKitWebView.html#WebKitWebView-show-option-menu" title="The “show-option-menu” signal"><span class="type">“show-option-menu”</span></a> is emitted, providing a WebKitOptionMenu with the
<a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a>s that should be displayed.</p>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="webkit-option-menu-get-n-items"></a><h3>webkit_option_menu_get_n_items ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
webkit_option_menu_get_n_items (<em class="parameter"><code><a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu</code></em>);</pre>
<p>Gets the length of the <em class="parameter"><code>menu</code></em>
.</p>
<div class="refsect3">
<a name="webkit-option-menu-get-n-items.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="webkit-option-menu-get-n-items.returns"></a><h4>Returns</h4>
<p> the number of <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a>s in <em class="parameter"><code>menu</code></em>
</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
<hr>
<div class="refsect2">
<a name="webkit-option-menu-get-item"></a><h3>webkit_option_menu_get_item ()</h3>
<pre class="programlisting"><a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="returnvalue">WebKitOptionMenuItem</span></a> *
webkit_option_menu_get_item (<em class="parameter"><code><a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<p>Returns the <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a> at <em class="parameter"><code>index</code></em>
in <em class="parameter"><code>menu</code></em>
.</p>
<div class="refsect3">
<a name="webkit-option-menu-get-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>the index of the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="webkit-option-menu-get-item.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a> of <em class="parameter"><code>menu</code></em>
. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
<hr>
<div class="refsect2">
<a name="webkit-option-menu-select-item"></a><h3>webkit_option_menu_select_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
webkit_option_menu_select_item (<em class="parameter"><code><a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<p>Selects the <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a> at <em class="parameter"><code>index</code></em>
in <em class="parameter"><code>menu</code></em>
. Selecting an item changes the
text shown by the combo button, but it doesn't change the value of the element. You need to
explicitly activate the item with <a class="link" href="WebKitOptionMenu.html#webkit-option-menu-select-item" title="webkit_option_menu_select_item ()"><code class="function">webkit_option_menu_select_item()</code></a> or close the menu with
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-close" title="webkit_option_menu_close ()"><code class="function">webkit_option_menu_close()</code></a> in which case the currently selected item will be activated.</p>
<div class="refsect3">
<a name="webkit-option-menu-select-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>the index of the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
<hr>
<div class="refsect2">
<a name="webkit-option-menu-activate-item"></a><h3>webkit_option_menu_activate_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
webkit_option_menu_activate_item (<em class="parameter"><code><a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<p>Activates the <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem"><span class="type">WebKitOptionMenuItem</span></a> at <em class="parameter"><code>index</code></em>
in <em class="parameter"><code>menu</code></em>
. Activating an item changes the value
of the element making the item the active one. You are expected to close the menu with
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-close" title="webkit_option_menu_close ()"><code class="function">webkit_option_menu_close()</code></a> after activating an item, calling this function again will have no
effect.</p>
<div class="refsect3">
<a name="webkit-option-menu-activate-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>the index of the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
<hr>
<div class="refsect2">
<a name="webkit-option-menu-close"></a><h3>webkit_option_menu_close ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
webkit_option_menu_close (<em class="parameter"><code><a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu</code></em>);</pre>
<p>Request to close a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a>. This emits WebKitOptionMenu::close signal.
This function should always be called to notify WebKit that the associated
menu has been closed. If the menu is closed and neither <a class="link" href="WebKitOptionMenu.html#webkit-option-menu-select-item" title="webkit_option_menu_select_item ()"><code class="function">webkit_option_menu_select_item()</code></a>
nor <a class="link" href="WebKitOptionMenu.html#webkit-option-menu-activate-item" title="webkit_option_menu_activate_item ()"><code class="function">webkit_option_menu_activate_item()</code></a> have been called, the element value remains
unchanged.</p>
<div class="refsect3">
<a name="webkit-option-menu-close.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="WebKitOptionMenu-struct"></a><h3>struct WebKitOptionMenu</h3>
<pre class="programlisting">struct WebKitOptionMenu;</pre>
</div>
</div>
<div class="refsect1">
<a name="WebKitOptionMenu.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="WebKitOptionMenu-close"></a><h3>The <code class="literal">“close”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Emitted when closing a <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> is requested. This can happen
when the user explicitly calls <a class="link" href="WebKitOptionMenu.html#webkit-option-menu-close" title="webkit_option_menu_close ()"><code class="function">webkit_option_menu_close()</code></a> or when the
element is detached from the current page.</p>
<div class="refsect3">
<a name="WebKitOptionMenu-close.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>the <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
</body>
</html>
\ No newline at end of file
This diff is collapsed.
......@@ -898,6 +898,11 @@
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr>
<tr>
<td class="signal_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-show-option-menu" title="The “show-option-menu” signal">show-option-menu</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-submit-form" title="The “submit-form” signal">submit-form</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
......@@ -5896,6 +5901,73 @@ support for it.</p>
</div>
<hr>
<div class="refsect2">
<a name="WebKitWebView-show-option-menu"></a><h3>The <code class="literal">“show-option-menu”</code> signal</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view,
<a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a> *menu,
<a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="../gdk3/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>This signal is emitted when a select element in <em class="parameter"><code>web_view</code></em>
needs to display a
dropdown menu. This signal can be used to show a custom menu, using <em class="parameter"><code>menu</code></em>
to get
the details of all items that should be displayed. The area of the element in the
<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is given as <em class="parameter"><code>rectangle</code></em>
parameter, it can be used to position the
menu. If this was triggered by a user interaction, like a mouse click,
<em class="parameter"><code>event</code></em>
parameter provides the <a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>.
To handle this signal asynchronously you should keep a ref of the <em class="parameter"><code>menu</code></em>
.</p>
<p>The default signal handler will pop up a <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a>.</p>
<div class="refsect3">
<a name="WebKitWebView-show-option-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>web_view</p></td>
<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>menu</p></td>
<td class="parameter_description"><p>the <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu"><span class="type">WebKitOptionMenu</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that triggered the menu, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rectangle</p></td>
<td class="parameter_description"><p>the option element area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="WebKitWebView-show-option-menu.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event.
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p class="since">Since: 2.18.</p>
</div>
<hr>
<div class="refsect2">
<a name="WebKitWebView-submit-form"></a><h3>The <code class="literal">“submit-form”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view,
......
......@@ -17,6 +17,8 @@
 <span class="dim">|</span> 
<a class="shortcut" href="#idxC">C</a>
 <span class="dim">|</span> 
<a class="shortcut" href="#idxO">O</a>
 <span class="dim">|</span> 
<a class="shortcut" href="#idxW">W</a></span></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
......@@ -48,6 +50,63 @@
<a class="link" href="WebKitContextMenuItem.html#webkit-context-menu-item-new-from-gaction" title="webkit_context_menu_item_new_from_gaction ()">webkit_context_menu_item_new_from_gaction</a>, function in <a class="link" href="WebKitContextMenuItem.html" title="WebKitContextMenuItem">WebKitContextMenuItem</a>
</dt>
<dd></dd>
<a name="idxO"></a><h3 class="title">O</h3>
<dt>
<a class="link" href="WebKitOptionMenu.html#WebKitOptionMenu-close" title="The “close” signal">WebKitOptionMenu::close</a>, object signal in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-activate-item" title="webkit_option_menu_activate_item ()">webkit_option_menu_activate_item</a>, function in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-close" title="webkit_option_menu_close ()">webkit_option_menu_close</a>, function in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-get-item" title="webkit_option_menu_get_item ()">webkit_option_menu_get_item</a>, function in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-get-n-items" title="webkit_option_menu_get_n_items ()">webkit_option_menu_get_n_items</a>, function in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-copy" title="webkit_option_menu_item_copy ()">webkit_option_menu_item_copy</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-free" title="webkit_option_menu_item_free ()">webkit_option_menu_item_free</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-get-label" title="webkit_option_menu_item_get_label ()">webkit_option_menu_item_get_label</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-get-tooltip" title="webkit_option_menu_item_get_tooltip ()">webkit_option_menu_item_get_tooltip</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-is-enabled" title="webkit_option_menu_item_is_enabled ()">webkit_option_menu_item_is_enabled</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-is-group-child" title="webkit_option_menu_item_is_group_child ()">webkit_option_menu_item_is_group_child</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-is-group-label" title="webkit_option_menu_item_is_group_label ()">webkit_option_menu_item_is_group_label</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenuItem.html#webkit-option-menu-item-is-selected" title="webkit_option_menu_item_is_selected ()">webkit_option_menu_item_is_selected</a>, function in <a class="link" href="WebKitOptionMenuItem.html" title="WebKitOptionMenuItem">WebKitOptionMenuItem</a>
</dt>
<dd></dd>
<dt>
<a class="link" href="WebKitOptionMenu.html#webkit-option-menu-select-item" title="webkit_option_menu_select_item ()">webkit_option_menu_select_item</a>, function in <a class="link" href="WebKitOptionMenu.html" title="WebKitOptionMenu">WebKitOptionMenu</a>
</dt>
<dd></dd>
<a name="idxW"></a><h3 class="title">W</h3>
<dt>
<a class="link" href="WebKitWebContext.html#WebKitWebContext-automation-started" title="The “automation-started” signal">WebKitWebContext::automation-started</a>, object signal in <a class="link" href="WebKitWebContext.html" title="WebKitWebContext">WebKitWebContext</a>
......
......@@ -129,6 +129,12 @@
<span class="refentrytitle"><a href="WebKitContextMenuItem.html">WebKitContextMenuItem</a></span><span class="refpurpose"> — One item of the <span class="type">WebKitContextMenu</span></span>
</dt>
<dt>
<span class="refentrytitle"><a href="WebKitOptionMenu.html">WebKitOptionMenu</a></span><span class="refpurpose"></span>
</dt>
<dt>
<span class="refentrytitle"><a href="WebKitOptionMenuItem.html">WebKitOptionMenuItem</a></span><span class="refpurpose"> — One item of the <span class="type">WebKitOptionMenu</span></span>
</dt>
<dt>
<span class="refentrytitle"><a href="WebKitFormSubmissionRequest.html">WebKitFormSubmissionRequest</a></span><span class="refpurpose"> — Represents a form submission request</span>
</dt>
<dt>
......
This source diff could not be displayed because it is too large. You can view the blob instead.
......@@ -14,7 +14,7 @@
<div class="titlepage">
<div>
<div><table class="navigation"