1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149
// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// from webkit-gir-files
// DO NOT EDIT
use crate::{ffi, OptionMenuItem};
use glib::{
prelude::*,
signal::{connect_raw, SignalHandlerId},
translate::*,
};
use std::boxed::Box as Box_;
glib::wrapper! {
/// Represents the dropdown menu of a `select` element in a #WebKitWebView.
///
/// When a select element in a #WebKitWebView needs to display a dropdown menu, the signal
/// #WebKitWebView::show-option-menu is emitted, providing a WebKitOptionMenu with the
/// #WebKitOptionMenuItem<!-- -->s that should be displayed.
///
/// ## Signals
///
///
/// #### `close`
/// Emitted when closing a #WebKitOptionMenu is requested. This can happen
/// when the user explicitly calls webkit_option_menu_close() or when the
/// element is detached from the current page.
///
///
#[doc(alias = "WebKitOptionMenu")]
pub struct OptionMenu(Object<ffi::WebKitOptionMenu, ffi::WebKitOptionMenuClass>);
match fn {
type_ => || ffi::webkit_option_menu_get_type(),
}
}
impl OptionMenu {
/// Activates the #WebKitOptionMenuItem at @index in @self.
///
/// Activating an item changes the value
/// of the element making the item the active one. You are expected to close the menu with
/// webkit_option_menu_close() after activating an item, calling this function again will have no
/// effect.
/// ## `index`
/// the index of the item
#[doc(alias = "webkit_option_menu_activate_item")]
pub fn activate_item(&self, index: u32) {
unsafe {
ffi::webkit_option_menu_activate_item(self.to_glib_none().0, index);
}
}
/// Request to close a #WebKitOptionMenu.
///
/// 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 webkit_option_menu_select_item()
/// nor webkit_option_menu_activate_item() have been called, the element value remains
/// unchanged.
#[doc(alias = "webkit_option_menu_close")]
pub fn close(&self) {
unsafe {
ffi::webkit_option_menu_close(self.to_glib_none().0);
}
}
/// Gets the #GdkEvent that triggered the dropdown menu.
/// If @self was not triggered by a user interaction, like a mouse click,
/// [`None`] is returned.
///
/// # Returns
///
/// the menu event or [`None`].
#[doc(alias = "webkit_option_menu_get_event")]
#[doc(alias = "get_event")]
pub fn event(&self) -> Option<gdk::Event> {
unsafe { from_glib_none(ffi::webkit_option_menu_get_event(self.to_glib_none().0)) }
}
/// Returns the #WebKitOptionMenuItem at @index in @self.
/// ## `index`
/// the index of the item
///
/// # Returns
///
/// a #WebKitOptionMenuItem of @self.
#[doc(alias = "webkit_option_menu_get_item")]
#[doc(alias = "get_item")]
pub fn item(&self, index: u32) -> Option<OptionMenuItem> {
unsafe {
from_glib_none(ffi::webkit_option_menu_get_item(
self.to_glib_none().0,
index,
))
}
}
/// Gets the length of the @self.
///
/// # Returns
///
/// the number of #WebKitOptionMenuItem<!-- -->s in @self
#[doc(alias = "webkit_option_menu_get_n_items")]
#[doc(alias = "get_n_items")]
pub fn n_items(&self) -> u32 {
unsafe { ffi::webkit_option_menu_get_n_items(self.to_glib_none().0) }
}
/// Selects the #WebKitOptionMenuItem at @index in @self.
///
/// 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 webkit_option_menu_select_item() or close the menu with
/// webkit_option_menu_close() in which case the currently selected item will be activated.
/// ## `index`
/// the index of the item
#[doc(alias = "webkit_option_menu_select_item")]
pub fn select_item(&self, index: u32) {
unsafe {
ffi::webkit_option_menu_select_item(self.to_glib_none().0, index);
}
}
/// Emitted when closing a #WebKitOptionMenu is requested. This can happen
/// when the user explicitly calls webkit_option_menu_close() or when the
/// element is detached from the current page.
#[doc(alias = "close")]
pub fn connect_close<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
unsafe extern "C" fn close_trampoline<F: Fn(&OptionMenu) + 'static>(
this: *mut ffi::WebKitOptionMenu,
f: glib::ffi::gpointer,
) {
let f: &F = &*(f as *const F);
f(&from_glib_borrow(this))
}
unsafe {
let f: Box_<F> = Box_::new(f);
connect_raw(
self.as_ptr() as *mut _,
b"close\0".as_ptr() as *const _,
Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
close_trampoline::<F> as *const (),
)),
Box_::into_raw(f),
)
}
}
}