objc2_ui_kit/generated/

UIIndirectScribbleInteraction.rs

//! This file has been automatically generated by `objc2`'s `header-translator`.
//! DO NOT EDIT
use core::ffi::*;
use core::ptr::NonNull;
use objc2::__framework_prelude::*;
#[cfg(feature = "objc2-core-foundation")]
use objc2_core_foundation::*;
use objc2_foundation::*;

use crate::*;

extern_class!(
    /// An interaction that allows using Scribble to enter text by handwriting on a view that is not formally a text input. Use UIIndirectScribbleInteraction if your app has a view that looks to the user as a text input but does not implement UITextInput. It makes the view act as a container of one or more virtual "Text Input Elements", each of which defines an area the user can write into without having to tap first.
    /// Some examples of when UIIndirectScribbleInteraction can be used:
    /// - A view that looks like a search field or a text field that in reality is a button, but installs a real text field when tapped
    /// - A view that contains multiple virtual text fields which the user can normally tap and type into, but are not full blown text fields all the time
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/uikit/uiindirectscribbleinteraction?language=objc)
    #[unsafe(super(NSObject))]
    #[thread_kind = MainThreadOnly]
    #[derive(Debug, PartialEq, Eq, Hash)]
    pub struct UIIndirectScribbleInteraction;
);

extern_conformance!(
    unsafe impl NSObjectProtocol for UIIndirectScribbleInteraction {}
);

#[cfg(feature = "UIInteraction")]
extern_conformance!(
    unsafe impl UIInteraction for UIIndirectScribbleInteraction {}
);

impl UIIndirectScribbleInteraction {
    extern_methods!(
        #[unsafe(method(init))]
        #[unsafe(method_family = init)]
        pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>;

        #[unsafe(method(new))]
        #[unsafe(method_family = new)]
        pub unsafe fn new(mtm: MainThreadMarker) -> Retained<Self>;

        #[unsafe(method(initWithDelegate:))]
        #[unsafe(method_family = init)]
        pub fn initWithDelegate(
            this: Allocated<Self>,
            delegate: &ProtocolObject<dyn UIIndirectScribbleInteractionDelegate>,
        ) -> Retained<Self>;

        /// The delegate for the interaction, to supply and customize writable elements in the interaction's view.
        #[unsafe(method(delegate))]
        #[unsafe(method_family = none)]
        pub fn delegate(
            &self,
        ) -> Option<Retained<ProtocolObject<dyn UIIndirectScribbleInteractionDelegate>>>;

        /// : Indicates if the user is actively writing. It will be set to YES in between calls to -indirectScribbleInteraction:willBeginWritingInElement: and -indirectScribbleInteraction:didFinishWritingInElement: calls.
        #[unsafe(method(isHandlingWriting))]
        #[unsafe(method_family = none)]
        pub fn isHandlingWriting(&self) -> bool;
    );
}

/// Element identifiers are used to identify writable elements in the interaction's view, and will be supplied in every delegate callback. Any object that conforms to NSCopying and that can be compared for equality can be used. It is recommended to use simple immutable values, like NSString, NSNumber, or NSUUID.
///
/// See also [Apple's documentation](https://developer.apple.com/documentation/uikit/uiscribbleelementidentifier?language=objc)
pub type UIScribbleElementIdentifier = AnyObject;

extern_protocol!(
    /// The protocol to be implemented by the delegate of UIIndirectScribbleInteraction. It will be responsible for supplying a list of writable elements, focusing them, and ultimately providing a real UITextInput that will handle text editing operations.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/uikit/uiindirectscribbleinteractiondelegate?language=objc)
    pub unsafe trait UIIndirectScribbleInteractionDelegate:
        NSObjectProtocol + MainThreadOnly
    {
        #[cfg(all(feature = "block2", feature = "objc2-core-foundation"))]
        /// This method will be called to request the text input elements in a certain rect of the view, each of which represents an area where the user can start writing even if it's not a text input field itself.
        ///
        /// Parameter `interaction`: The interaction asking for the elements.
        ///
        /// Parameter `rect`: The rect around the area where the user is trying to write, in the interaction's view coordinate system. Only elements intersecting this rect should be returned.
        ///
        /// Parameter `completion`: You must call the completion handler, synchronously or asynchronously, with an array of identifiers of the available elements, or an empty array if no elements are available.
        #[unsafe(method(indirectScribbleInteraction:requestElementsInRect:completion:))]
        #[unsafe(method_family = none)]
        fn indirectScribbleInteraction_requestElementsInRect_completion(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            rect: CGRect,
            completion: &block2::DynBlock<dyn Fn(NonNull<NSArray<UIScribbleElementIdentifier>>)>,
        );

        /// Asks the delegate if an element is currently focused, according to the internal state of the interaction's view.
        ///
        /// Parameter `interaction`: The interaction asking for the focused state.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element the interaction is asking about.
        ///
        /// Returns: Return YES if the element is the one currently focused.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[unsafe(method(indirectScribbleInteraction:isElementFocused:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_isElementFocused(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
        ) -> bool;

        #[cfg(feature = "objc2-core-foundation")]
        /// Asks the delegate to provide the frame of an element.
        ///
        /// Parameter `interaction`: The interaction asking for the element's frame.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element the interaction is asking about.
        ///
        /// Returns: Frame for the element, in the interactions's view coordinate system.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[unsafe(method(indirectScribbleInteraction:frameForElement:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_frameForElement(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
        ) -> CGRect;

        #[cfg(all(
            feature = "UIResponder",
            feature = "UITextInput",
            feature = "UITextInputTraits",
            feature = "block2",
            feature = "objc2-core-foundation"
        ))]
        /// Asks the delegate to focus an element to handle text edits. In response, it should make the element the currently focused one, and make the corresponding UITextInput become first responder.
        /// If the element was not focused already, text selection should be set to the character location closest to focusReferencePoint, to avoid any scrolling or shifting of content.
        /// If the element was focused already, no changes in selection should be made and this call can be ignored, but you must still call the completion handler with a reference to the text input.
        ///
        /// Parameter `interaction`: The interaction that is requesting to focus an element.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element that should be focused.
        ///
        /// Parameter `completion`: You must always call the completion handler, either synchronously or asynchronously. On success, the first parameter should be the text input that became first responder and that will handle text operations for this element. On failure, call the completion with a nil parameter.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[unsafe(method(indirectScribbleInteraction:focusElementIfNeeded:referencePoint:completion:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_focusElementIfNeeded_referencePoint_completion(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
            focus_reference_point: CGPoint,
            completion: &block2::DynBlock<dyn Fn(*mut UIResponder)>,
        );

        /// Allow the delegate to delay focusing an element. Normally, Scribble will focus the element as soon as the user begins writing, but if you return YES from this callback, it will wait until the user makes a brief pause. This is useful in cases where the element's frame will shift or transform when becoming focused, which can be disruptive to a user trying to handwrite into it.
        /// Wherever possible it is preferable to adjust the UI behavior to avoid the layout changes, and only use delayed focus as a last resort, since transcription will happen all at once instead of incrementally.
        ///
        /// Parameter `interaction`: The interaction asking about delaying focus.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element the interaction is asking about.
        ///
        /// Returns: Return YES to delay focusing the element.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[optional]
        #[unsafe(method(indirectScribbleInteraction:shouldDelayFocusForElement:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_shouldDelayFocusForElement(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
        ) -> bool;

        /// Will be called when the user begins writing into an element. This call will always be paired with a corresponding call to indirectScribbleInteraction:didFinishWritingInElement:. It is recommended to use this call to hide custom placeholders or other UI elements that can interfere with writing.
        ///
        /// Parameter `interaction`: The interaction notifying about writing state changes.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element the user is writing into.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[optional]
        #[unsafe(method(indirectScribbleInteraction:willBeginWritingInElement:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_willBeginWritingInElement(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
        );

        /// Will be called when the user finished writing into an element, after the last word has been transcribed and committed.
        ///
        /// Parameter `interaction`: The interaction notifying about writing state changes.
        ///
        /// Parameter `elementIdentifier`: The identifier of the element the user finished writing into.
        ///
        /// # Safety
        ///
        /// `element_identifier` should be of the correct type.
        #[optional]
        #[unsafe(method(indirectScribbleInteraction:didFinishWritingInElement:))]
        #[unsafe(method_family = none)]
        unsafe fn indirectScribbleInteraction_didFinishWritingInElement(
            &self,
            interaction: &UIIndirectScribbleInteraction,
            element_identifier: &UIScribbleElementIdentifier,
        );
    }
);