atk/auto/

text.rs

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

#[cfg(feature = "v2_32")]
#[cfg_attr(docsrs, doc(cfg(feature = "v2_32")))]
use crate::ScrollType;
use crate::{
    CoordType, TextBoundary, TextClipType, TextGranularity, TextRange, TextRectangle, ffi,
};
use glib::{
    object::ObjectType as _,
    prelude::*,
    signal::{SignalHandlerId, connect_raw},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// The ATK interface implemented by components with text content.
    ///
    /// [`Text`][crate::Text] should be implemented by `AtkObjects` on behalf of widgets
    /// that have text content which is either attributed or otherwise
    /// non-trivial. `AtkObjects` whose text content is simple,
    /// unattributed, and very brief may expose that content via
    /// `atk_object_get_name` instead; however if the text is editable,
    /// multi-line, typically longer than three or four words, attributed,
    /// selectable, or if the object already uses the 'name' ATK property
    /// for other information, the [`Text`][crate::Text] interface should be used to
    /// expose the text content. In the case of editable text content,
    /// [`EditableText`][crate::EditableText] (a subtype of the [`Text`][crate::Text] interface) should be
    /// implemented instead.
    ///
    ///  [`Text`][crate::Text] provides not only traversal facilities and change
    /// notification for text content, but also caret tracking and glyph
    /// bounding box calculations. Note that the text strings are exposed
    /// as UTF-8, and are therefore potentially multi-byte, and
    /// caret-to-byte offset mapping makes no assumptions about the
    /// character length; also bounding box glyph-to-offset mapping may be
    /// complex for languages which use ligatures.
    ///
    /// ## Signals
    ///
    ///
    /// #### `text-attributes-changed`
    ///  The "text-attributes-changed" signal is emitted when the text
    /// attributes of the text of an object which implements AtkText
    /// changes.
    ///
    ///
    ///
    ///
    /// #### `text-caret-moved`
    ///  The "text-caret-moved" signal is emitted when the caret
    /// position of the text of an object which implements AtkText
    /// changes.
    ///
    ///
    ///
    ///
    /// #### `text-changed`
    ///  The "text-changed" signal is emitted when the text of the
    /// object which implements the AtkText interface changes, This
    /// signal will have a detail which is either "insert" or
    /// "delete" which identifies whether the text change was an
    /// insertion or a deletion.
    ///
    /// Detailed
    ///
    ///
    /// #### `text-insert`
    ///  The "text-insert" signal is emitted when a new text is
    /// inserted. If the signal was not triggered by the user
    /// (e.g. typing or pasting text), the "system" detail should be
    /// included.
    ///
    /// Detailed
    ///
    ///
    /// #### `text-remove`
    ///  The "text-remove" signal is emitted when a new text is
    /// removed. If the signal was not triggered by the user
    /// (e.g. typing or pasting text), the "system" detail should be
    /// included.
    ///
    /// Detailed
    ///
    ///
    /// #### `text-selection-changed`
    ///  The "text-selection-changed" signal is emitted when the
    /// selected text of an object which implements AtkText changes.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`TextExt`][trait@crate::prelude::TextExt]
    #[doc(alias = "AtkText")]
    pub struct Text(Interface<ffi::AtkText, ffi::AtkTextIface>);

    match fn {
        type_ => || ffi::atk_text_get_type(),
    }
}

impl Text {
    pub const NONE: Option<&'static Text> = None;
}

/// Trait containing all [`struct@Text`] methods.
///
/// # Implementors
///
/// [`NoOpObject`][struct@crate::NoOpObject], [`Text`][struct@crate::Text]
pub trait TextExt: IsA<Text> + 'static {
    /// Adds a selection bounded by the specified offsets.
    /// ## `start_offset`
    /// the starting character offset of the selected region
    /// ## `end_offset`
    /// the offset of the first character after the selected region.
    ///
    /// # Returns
    ///
    /// [`true`] if successful, [`false`] otherwise
    #[doc(alias = "atk_text_add_selection")]
    fn add_selection(&self, start_offset: i32, end_offset: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_text_add_selection(
                self.as_ref().to_glib_none().0,
                start_offset,
                end_offset,
            ))
        }
    }

    /// Get the ranges of text in the specified bounding box.
    /// ## `rect`
    /// An AtkTextRectangle giving the dimensions of the bounding box.
    /// ## `coord_type`
    /// Specify whether coordinates are relative to the screen or widget window.
    /// ## `x_clip_type`
    /// Specify the horizontal clip type.
    /// ## `y_clip_type`
    /// Specify the vertical clip type.
    ///
    /// # Returns
    ///
    /// Array of AtkTextRange. The last
    ///  element of the array returned by this function will be NULL.
    #[doc(alias = "atk_text_get_bounded_ranges")]
    #[doc(alias = "get_bounded_ranges")]
    fn bounded_ranges(
        &self,
        rect: &mut TextRectangle,
        coord_type: CoordType,
        x_clip_type: TextClipType,
        y_clip_type: TextClipType,
    ) -> Vec<TextRange> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::atk_text_get_bounded_ranges(
                self.as_ref().to_glib_none().0,
                rect.to_glib_none_mut().0,
                coord_type.into_glib(),
                x_clip_type.into_glib(),
                y_clip_type.into_glib(),
            ))
        }
    }

    /// Gets the offset of the position of the caret (cursor).
    ///
    /// # Returns
    ///
    /// the character offset of the position of the caret or -1 if
    ///  the caret is not located inside the element or in the case of
    ///  any other failure.
    #[doc(alias = "atk_text_get_caret_offset")]
    #[doc(alias = "get_caret_offset")]
    fn caret_offset(&self) -> i32 {
        unsafe { ffi::atk_text_get_caret_offset(self.as_ref().to_glib_none().0) }
    }

    /// Gets the specified text.
    /// ## `offset`
    /// a character offset within `self`
    ///
    /// # Returns
    ///
    /// the character at `offset` or 0 in the case of failure.
    #[doc(alias = "atk_text_get_character_at_offset")]
    #[doc(alias = "get_character_at_offset")]
    fn character_at_offset(&self, offset: i32) -> char {
        unsafe {
            std::convert::TryFrom::try_from(ffi::atk_text_get_character_at_offset(
                self.as_ref().to_glib_none().0,
                offset,
            ))
            .expect("conversion from an invalid Unicode value attempted")
        }
    }

    /// Gets the character count.
    ///
    /// # Returns
    ///
    /// the number of characters or -1 in case of failure.
    #[doc(alias = "atk_text_get_character_count")]
    #[doc(alias = "get_character_count")]
    fn character_count(&self) -> i32 {
        unsafe { ffi::atk_text_get_character_count(self.as_ref().to_glib_none().0) }
    }

    /// If the extent can not be obtained (e.g. missing support), all of x, y, width,
    /// height are set to -1.
    ///
    /// Get the bounding box containing the glyph representing the character at
    ///  a particular text offset.
    /// ## `offset`
    /// The offset of the text character for which bounding information is required.
    /// ## `coords`
    /// specify whether coordinates are relative to the screen or widget window
    ///
    /// # Returns
    ///
    ///
    /// ## `x`
    /// Pointer for the x coordinate of the bounding box
    ///
    /// ## `y`
    /// Pointer for the y coordinate of the bounding box
    ///
    /// ## `width`
    /// Pointer for the width of the bounding box
    ///
    /// ## `height`
    /// Pointer for the height of the bounding box
    #[doc(alias = "atk_text_get_character_extents")]
    #[doc(alias = "get_character_extents")]
    fn character_extents(&self, offset: i32, coords: CoordType) -> (i32, i32, i32, i32) {
        unsafe {
            let mut x = std::mem::MaybeUninit::uninit();
            let mut y = std::mem::MaybeUninit::uninit();
            let mut width = std::mem::MaybeUninit::uninit();
            let mut height = std::mem::MaybeUninit::uninit();
            ffi::atk_text_get_character_extents(
                self.as_ref().to_glib_none().0,
                offset,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
                width.as_mut_ptr(),
                height.as_mut_ptr(),
                coords.into_glib(),
            );
            (
                x.assume_init(),
                y.assume_init(),
                width.assume_init(),
                height.assume_init(),
            )
        }
    }

    //#[doc(alias = "atk_text_get_default_attributes")]
    //#[doc(alias = "get_default_attributes")]
    //fn default_attributes(&self) -> /*Ignored*/Option<AttributeSet> {
    //    unsafe { TODO: call ffi:atk_text_get_default_attributes() }
    //}

    /// Gets the number of selected regions.
    ///
    /// # Returns
    ///
    /// The number of selected regions, or -1 in the case of failure.
    #[doc(alias = "atk_text_get_n_selections")]
    #[doc(alias = "get_n_selections")]
    fn n_selections(&self) -> i32 {
        unsafe { ffi::atk_text_get_n_selections(self.as_ref().to_glib_none().0) }
    }

    /// Gets the offset of the character located at coordinates `x` and `y`. `x` and `y`
    /// are interpreted as being relative to the screen or this widget's window
    /// depending on `coords`.
    /// ## `x`
    /// screen x-position of character
    /// ## `y`
    /// screen y-position of character
    /// ## `coords`
    /// specify whether coordinates are relative to the screen or
    /// widget window
    ///
    /// # Returns
    ///
    /// the offset to the character which is located at the specified
    ///  `x` and `y` coordinates of -1 in case of failure.
    #[doc(alias = "atk_text_get_offset_at_point")]
    #[doc(alias = "get_offset_at_point")]
    fn offset_at_point(&self, x: i32, y: i32, coords: CoordType) -> i32 {
        unsafe {
            ffi::atk_text_get_offset_at_point(
                self.as_ref().to_glib_none().0,
                x,
                y,
                coords.into_glib(),
            )
        }
    }

    /// Get the bounding box for text within the specified range.
    ///
    /// If the extents can not be obtained (e.g. or missing support), the rectangle
    /// fields are set to -1.
    /// ## `start_offset`
    /// The offset of the first text character for which boundary
    ///  information is required.
    /// ## `end_offset`
    /// The offset of the text character after the last character
    ///  for which boundary information is required.
    /// ## `coord_type`
    /// Specify whether coordinates are relative to the screen or widget window.
    ///
    /// # Returns
    ///
    ///
    /// ## `rect`
    /// A pointer to a AtkTextRectangle which is filled in by this function.
    #[doc(alias = "atk_text_get_range_extents")]
    #[doc(alias = "get_range_extents")]
    fn range_extents(
        &self,
        start_offset: i32,
        end_offset: i32,
        coord_type: CoordType,
    ) -> TextRectangle {
        unsafe {
            let mut rect = TextRectangle::uninitialized();
            ffi::atk_text_get_range_extents(
                self.as_ref().to_glib_none().0,
                start_offset,
                end_offset,
                coord_type.into_glib(),
                rect.to_glib_none_mut().0,
            );
            rect
        }
    }

    //#[doc(alias = "atk_text_get_run_attributes")]
    //#[doc(alias = "get_run_attributes")]
    //fn run_attributes(&self, offset: i32) -> (/*Ignored*/AttributeSet, i32, i32) {
    //    unsafe { TODO: call ffi:atk_text_get_run_attributes() }
    //}

    /// Gets the text from the specified selection.
    /// ## `selection_num`
    /// The selection number. The selected regions are
    /// assigned numbers that correspond to how far the region is from the
    /// start of the text. The selected region closest to the beginning
    /// of the text region is assigned the number 0, etc. Note that adding,
    /// moving or deleting a selected region can change the numbering.
    ///
    /// # Returns
    ///
    /// a newly allocated string containing the selected text. Use `g_free()`
    ///  to free the returned string.
    ///
    /// ## `start_offset`
    /// passes back the starting character offset of the selected region
    ///
    /// ## `end_offset`
    /// passes back the ending character offset (offset immediately past)
    /// of the selected region
    #[doc(alias = "atk_text_get_selection")]
    #[doc(alias = "get_selection")]
    fn selection(&self, selection_num: i32) -> (glib::GString, i32, i32) {
        unsafe {
            let mut start_offset = std::mem::MaybeUninit::uninit();
            let mut end_offset = std::mem::MaybeUninit::uninit();
            let ret = from_glib_full(ffi::atk_text_get_selection(
                self.as_ref().to_glib_none().0,
                selection_num,
                start_offset.as_mut_ptr(),
                end_offset.as_mut_ptr(),
            ));
            (ret, start_offset.assume_init(), end_offset.assume_init())
        }
    }

    /// Gets a portion of the text exposed through an [`Text`][crate::Text] according to a given `offset`
    /// and a specific `granularity`, along with the start and end offsets defining the
    /// boundaries of such a portion of text.
    ///
    /// If `granularity` is ATK_TEXT_GRANULARITY_CHAR the character at the
    /// offset is returned.
    ///
    /// If `granularity` is ATK_TEXT_GRANULARITY_WORD the returned string
    /// is from the word start at or before the offset to the word start after
    /// the offset.
    ///
    /// The returned string will contain the word at the offset if the offset
    /// is inside a word and will contain the word before the offset if the
    /// offset is not inside a word.
    ///
    /// If `granularity` is ATK_TEXT_GRANULARITY_SENTENCE the returned string
    /// is from the sentence start at or before the offset to the sentence
    /// start after the offset.
    ///
    /// The returned string will contain the sentence at the offset if the offset
    /// is inside a sentence and will contain the sentence before the offset
    /// if the offset is not inside a sentence.
    ///
    /// If `granularity` is ATK_TEXT_GRANULARITY_LINE the returned string
    /// is from the line start at or before the offset to the line
    /// start after the offset.
    ///
    /// If `granularity` is ATK_TEXT_GRANULARITY_PARAGRAPH the returned string
    /// is from the start of the paragraph at or before the offset to the start
    /// of the following paragraph after the offset.
    /// ## `offset`
    /// position
    /// ## `granularity`
    /// An [`TextGranularity`][crate::TextGranularity]
    ///
    /// # Returns
    ///
    /// a newly allocated string containing the text at
    ///  the `offset` bounded by the specified `granularity`. Use `g_free()`
    ///  to free the returned string. Returns [`None`] if the offset is invalid
    ///  or no implementation is available.
    ///
    /// ## `start_offset`
    /// the starting character offset of the returned string, or -1
    ///  in the case of error (e.g. invalid offset, not implemented)
    ///
    /// ## `end_offset`
    /// the offset of the first character after the returned string,
    ///  or -1 in the case of error (e.g. invalid offset, not implemented)
    #[doc(alias = "atk_text_get_string_at_offset")]
    #[doc(alias = "get_string_at_offset")]
    fn string_at_offset(
        &self,
        offset: i32,
        granularity: TextGranularity,
    ) -> (Option<glib::GString>, i32, i32) {
        unsafe {
            let mut start_offset = std::mem::MaybeUninit::uninit();
            let mut end_offset = std::mem::MaybeUninit::uninit();
            let ret = from_glib_full(ffi::atk_text_get_string_at_offset(
                self.as_ref().to_glib_none().0,
                offset,
                granularity.into_glib(),
                start_offset.as_mut_ptr(),
                end_offset.as_mut_ptr(),
            ));
            (ret, start_offset.assume_init(), end_offset.assume_init())
        }
    }

    /// Gets the specified text.
    /// ## `start_offset`
    /// a starting character offset within `self`
    /// ## `end_offset`
    /// an ending character offset within `self`, or -1 for the end of the string.
    ///
    /// # Returns
    ///
    /// a newly allocated string containing the text from `start_offset` up
    ///  to, but not including `end_offset`. Use `g_free()` to free the returned
    ///  string.
    #[doc(alias = "atk_text_get_text")]
    #[doc(alias = "get_text")]
    fn text(&self, start_offset: i32, end_offset: i32) -> Option<glib::GString> {
        unsafe {
            from_glib_full(ffi::atk_text_get_text(
                self.as_ref().to_glib_none().0,
                start_offset,
                end_offset,
            ))
        }
    }

    /// Gets the specified text.
    ///
    /// If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
    /// offset is returned.
    ///
    /// If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
    /// is from the word start at or before the offset to the word start after
    /// the offset.
    ///
    /// The returned string will contain the word at the offset if the offset
    /// is inside a word and will contain the word before the offset if the
    /// offset is not inside a word.
    ///
    /// If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
    /// string is from the sentence start at or before the offset to the sentence
    /// start after the offset.
    ///
    /// The returned string will contain the sentence at the offset if the offset
    /// is inside a sentence and will contain the sentence before the offset
    /// if the offset is not inside a sentence.
    ///
    /// If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
    /// string is from the line start at or before the offset to the line
    /// start after the offset.
    ///
    /// # Deprecated
    ///
    /// This method is deprecated since ATK version
    /// 2.9.4. Please use [`string_at_offset()`][Self::string_at_offset()] instead.
    /// ## `offset`
    /// position
    /// ## `boundary_type`
    /// An [`TextBoundary`][crate::TextBoundary]
    ///
    /// # Returns
    ///
    /// a newly allocated string containing the text at `offset` bounded
    ///  by the specified `boundary_type`. Use `g_free()` to free the returned
    ///  string.
    ///
    /// ## `start_offset`
    /// the starting character offset of the returned string
    ///
    /// ## `end_offset`
    /// the offset of the first character after the
    ///  returned substring
    #[doc(alias = "atk_text_get_text_at_offset")]
    #[doc(alias = "get_text_at_offset")]
    fn text_at_offset(
        &self,
        offset: i32,
        boundary_type: TextBoundary,
    ) -> (glib::GString, i32, i32) {
        unsafe {
            let mut start_offset = std::mem::MaybeUninit::uninit();
            let mut end_offset = std::mem::MaybeUninit::uninit();
            let ret = from_glib_full(ffi::atk_text_get_text_at_offset(
                self.as_ref().to_glib_none().0,
                offset,
                boundary_type.into_glib(),
                start_offset.as_mut_ptr(),
                end_offset.as_mut_ptr(),
            ));
            (ret, start_offset.assume_init(), end_offset.assume_init())
        }
    }

    /// Removes the specified selection.
    /// ## `selection_num`
    /// The selection number. The selected regions are
    /// assigned numbers that correspond to how far the region is from the
    /// start of the text. The selected region closest to the beginning
    /// of the text region is assigned the number 0, etc. Note that adding,
    /// moving or deleting a selected region can change the numbering.
    ///
    /// # Returns
    ///
    /// [`true`] if successful, [`false`] otherwise
    #[doc(alias = "atk_text_remove_selection")]
    fn remove_selection(&self, selection_num: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_text_remove_selection(
                self.as_ref().to_glib_none().0,
                selection_num,
            ))
        }
    }

    /// Makes a substring of `self` visible on the screen by scrolling all necessary parents.
    /// ## `start_offset`
    /// start offset in the `self`
    /// ## `end_offset`
    /// end offset in the `self`, or -1 for the end of the text.
    /// ## `type_`
    /// specify where the object should be made visible.
    ///
    /// # Returns
    ///
    /// whether scrolling was successful.
    #[cfg(feature = "v2_32")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v2_32")))]
    #[doc(alias = "atk_text_scroll_substring_to")]
    fn scroll_substring_to(&self, start_offset: i32, end_offset: i32, type_: ScrollType) -> bool {
        unsafe {
            from_glib(ffi::atk_text_scroll_substring_to(
                self.as_ref().to_glib_none().0,
                start_offset,
                end_offset,
                type_.into_glib(),
            ))
        }
    }

    /// Move the top-left of a substring of `self` to a given position of the screen
    /// by scrolling all necessary parents.
    /// ## `start_offset`
    /// start offset in the `self`
    /// ## `end_offset`
    /// end offset in the `self`, or -1 for the end of the text.
    /// ## `coords`
    /// specify whether coordinates are relative to the screen or to the
    /// parent object.
    /// ## `x`
    /// x-position where to scroll to
    /// ## `y`
    /// y-position where to scroll to
    ///
    /// # Returns
    ///
    /// whether scrolling was successful.
    #[cfg(feature = "v2_32")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v2_32")))]
    #[doc(alias = "atk_text_scroll_substring_to_point")]
    fn scroll_substring_to_point(
        &self,
        start_offset: i32,
        end_offset: i32,
        coords: CoordType,
        x: i32,
        y: i32,
    ) -> bool {
        unsafe {
            from_glib(ffi::atk_text_scroll_substring_to_point(
                self.as_ref().to_glib_none().0,
                start_offset,
                end_offset,
                coords.into_glib(),
                x,
                y,
            ))
        }
    }

    /// Sets the caret (cursor) position to the specified `offset`.
    ///
    /// In the case of rich-text content, this method should either grab focus
    /// or move the sequential focus navigation starting point (if the application
    /// supports this concept) as if the user had clicked on the new caret position.
    /// Typically, this means that the target of this operation is the node containing
    /// the new caret position or one of its ancestors. In other words, after this
    /// method is called, if the user advances focus, it should move to the first
    /// focusable node following the new caret position.
    ///
    /// Calling this method should also scroll the application viewport in a way
    /// that matches the behavior of the application's typical caret motion or tab
    /// navigation as closely as possible. This also means that if the application's
    /// caret motion or focus navigation does not trigger a scroll operation, this
    /// method should not trigger one either. If the application does not have a caret
    /// motion or focus navigation operation, this method should try to scroll the new
    /// caret position into view while minimizing unnecessary scroll motion.
    /// ## `offset`
    /// the character offset of the new caret position
    ///
    /// # Returns
    ///
    /// [`true`] if successful, [`false`] otherwise.
    #[doc(alias = "atk_text_set_caret_offset")]
    fn set_caret_offset(&self, offset: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_text_set_caret_offset(
                self.as_ref().to_glib_none().0,
                offset,
            ))
        }
    }

    /// Changes the start and end offset of the specified selection.
    /// ## `selection_num`
    /// The selection number. The selected regions are
    /// assigned numbers that correspond to how far the region is from the
    /// start of the text. The selected region closest to the beginning
    /// of the text region is assigned the number 0, etc. Note that adding,
    /// moving or deleting a selected region can change the numbering.
    /// ## `start_offset`
    /// the new starting character offset of the selection
    /// ## `end_offset`
    /// the new end position of (e.g. offset immediately past)
    /// the selection
    ///
    /// # Returns
    ///
    /// [`true`] if successful, [`false`] otherwise
    #[doc(alias = "atk_text_set_selection")]
    fn set_selection(&self, selection_num: i32, start_offset: i32, end_offset: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_text_set_selection(
                self.as_ref().to_glib_none().0,
                selection_num,
                start_offset,
                end_offset,
            ))
        }
    }

    /// The "text-attributes-changed" signal is emitted when the text
    /// attributes of the text of an object which implements AtkText
    /// changes.
    #[doc(alias = "text-attributes-changed")]
    fn connect_text_attributes_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn text_attributes_changed_trampoline<
            P: IsA<Text>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::AtkText,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Text::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"text-attributes-changed".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    text_attributes_changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// The "text-caret-moved" signal is emitted when the caret
    /// position of the text of an object which implements AtkText
    /// changes.
    /// ## `arg1`
    /// The new position of the text caret.
    #[doc(alias = "text-caret-moved")]
    fn connect_text_caret_moved<F: Fn(&Self, i32) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn text_caret_moved_trampoline<P: IsA<Text>, F: Fn(&P, i32) + 'static>(
            this: *mut ffi::AtkText,
            arg1: std::ffi::c_int,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Text::from_glib_borrow(this).unsafe_cast_ref(), arg1)
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"text-caret-moved".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    text_caret_moved_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// The "text-insert" signal is emitted when a new text is
    /// inserted. If the signal was not triggered by the user
    /// (e.g. typing or pasting text), the "system" detail should be
    /// included.
    /// ## `arg1`
    /// The position (character offset) of the insertion.
    /// ## `arg2`
    /// The length (in characters) of text inserted.
    /// ## `arg3`
    /// The new text inserted
    #[doc(alias = "text-insert")]
    fn connect_text_insert<F: Fn(&Self, i32, i32, &str) + 'static>(
        &self,
        detail: Option<&str>,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn text_insert_trampoline<
            P: IsA<Text>,
            F: Fn(&P, i32, i32, &str) + 'static,
        >(
            this: *mut ffi::AtkText,
            arg1: std::ffi::c_int,
            arg2: std::ffi::c_int,
            arg3: *mut std::ffi::c_char,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    Text::from_glib_borrow(this).unsafe_cast_ref(),
                    arg1,
                    arg2,
                    &glib::GString::from_glib_borrow(arg3),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            let detailed_signal_name = detail.map(|name| format!("text-insert::{name}\0"));
            let signal_name = detailed_signal_name.as_ref().map_or(c"text-insert", |n| {
                std::ffi::CStr::from_bytes_with_nul_unchecked(n.as_bytes())
            });
            connect_raw(
                self.as_ptr() as *mut _,
                signal_name.as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    text_insert_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// The "text-remove" signal is emitted when a new text is
    /// removed. If the signal was not triggered by the user
    /// (e.g. typing or pasting text), the "system" detail should be
    /// included.
    /// ## `arg1`
    /// The position (character offset) of the removal.
    /// ## `arg2`
    /// The length (in characters) of text removed.
    /// ## `arg3`
    /// The old text removed
    #[doc(alias = "text-remove")]
    fn connect_text_remove<F: Fn(&Self, i32, i32, &str) + 'static>(
        &self,
        detail: Option<&str>,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn text_remove_trampoline<
            P: IsA<Text>,
            F: Fn(&P, i32, i32, &str) + 'static,
        >(
            this: *mut ffi::AtkText,
            arg1: std::ffi::c_int,
            arg2: std::ffi::c_int,
            arg3: *mut std::ffi::c_char,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    Text::from_glib_borrow(this).unsafe_cast_ref(),
                    arg1,
                    arg2,
                    &glib::GString::from_glib_borrow(arg3),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            let detailed_signal_name = detail.map(|name| format!("text-remove::{name}\0"));
            let signal_name = detailed_signal_name.as_ref().map_or(c"text-remove", |n| {
                std::ffi::CStr::from_bytes_with_nul_unchecked(n.as_bytes())
            });
            connect_raw(
                self.as_ptr() as *mut _,
                signal_name.as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    text_remove_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// The "text-selection-changed" signal is emitted when the
    /// selected text of an object which implements AtkText changes.
    #[doc(alias = "text-selection-changed")]
    fn connect_text_selection_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn text_selection_changed_trampoline<
            P: IsA<Text>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::AtkText,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Text::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"text-selection-changed".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    text_selection_changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<Text>> TextExt for O {}