objc2_ui_kit/generated/
UILargeContentViewer.rs

1//! This file has been automatically generated by `objc2`'s `header-translator`.
2//! DO NOT EDIT
3use core::ffi::*;
4use core::ptr::NonNull;
5use objc2::__framework_prelude::*;
6#[cfg(feature = "objc2-core-foundation")]
7use objc2_core_foundation::*;
8use objc2_foundation::*;
9
10use crate::*;
11
12extern_protocol!(
13    /// [Apple's documentation](https://developer.apple.com/documentation/uikit/uilargecontentvieweritem?language=objc)
14    pub unsafe trait UILargeContentViewerItem: NSObjectProtocol + MainThreadOnly {
15        /// Returns whether the item shows the large content viewer.
16        /// In general, only views that cannot scale for the full range of Dynamic Type sizes should return YES.
17        /// For this property to take effect, the item or an ancestor view must have a UILargeContentViewerInteraction.
18        #[unsafe(method(showsLargeContentViewer))]
19        #[unsafe(method_family = none)]
20        unsafe fn showsLargeContentViewer(&self) -> bool;
21
22        /// Returns a title that should be shown in the large content viewer.
23        #[unsafe(method(largeContentTitle))]
24        #[unsafe(method_family = none)]
25        unsafe fn largeContentTitle(&self) -> Option<Retained<NSString>>;
26
27        #[cfg(feature = "UIImage")]
28        /// Returns an image that should be shown in the large content viewer.
29        #[unsafe(method(largeContentImage))]
30        #[unsafe(method_family = none)]
31        unsafe fn largeContentImage(&self) -> Option<Retained<UIImage>>;
32
33        /// Returns whether the image should be scaled to a larger size appropriate for the viewer.
34        /// If not, the image will be shown at its intrinsic size.
35        /// For best results when scaling, use a PDF asset with its "Preserve Vector Data" checkbox checked.
36        #[unsafe(method(scalesLargeContentImage))]
37        #[unsafe(method_family = none)]
38        unsafe fn scalesLargeContentImage(&self) -> bool;
39
40        #[cfg(all(feature = "UIGeometry", feature = "objc2-core-foundation"))]
41        /// Returns insets appropriate for positioning the image in the viewer so that it appears visually centered.
42        #[unsafe(method(largeContentImageInsets))]
43        #[unsafe(method_family = none)]
44        unsafe fn largeContentImageInsets(&self) -> UIEdgeInsets;
45    }
46);
47
48/// UILargeContentViewer.
49#[cfg(all(feature = "UIResponder", feature = "UIView"))]
50impl UIView {
51    extern_methods!(
52        #[unsafe(method(showsLargeContentViewer))]
53        #[unsafe(method_family = none)]
54        pub unsafe fn showsLargeContentViewer(&self) -> bool;
55
56        /// Setter for [`showsLargeContentViewer`][Self::showsLargeContentViewer].
57        #[unsafe(method(setShowsLargeContentViewer:))]
58        #[unsafe(method_family = none)]
59        pub unsafe fn setShowsLargeContentViewer(&self, shows_large_content_viewer: bool);
60
61        #[unsafe(method(largeContentTitle))]
62        #[unsafe(method_family = none)]
63        pub unsafe fn largeContentTitle(&self) -> Option<Retained<NSString>>;
64
65        /// Setter for [`largeContentTitle`][Self::largeContentTitle].
66        #[unsafe(method(setLargeContentTitle:))]
67        #[unsafe(method_family = none)]
68        pub unsafe fn setLargeContentTitle(&self, large_content_title: Option<&NSString>);
69
70        #[cfg(feature = "UIImage")]
71        #[unsafe(method(largeContentImage))]
72        #[unsafe(method_family = none)]
73        pub unsafe fn largeContentImage(&self) -> Option<Retained<UIImage>>;
74
75        #[cfg(feature = "UIImage")]
76        /// Setter for [`largeContentImage`][Self::largeContentImage].
77        #[unsafe(method(setLargeContentImage:))]
78        #[unsafe(method_family = none)]
79        pub unsafe fn setLargeContentImage(&self, large_content_image: Option<&UIImage>);
80
81        #[unsafe(method(scalesLargeContentImage))]
82        #[unsafe(method_family = none)]
83        pub unsafe fn scalesLargeContentImage(&self) -> bool;
84
85        /// Setter for [`scalesLargeContentImage`][Self::scalesLargeContentImage].
86        #[unsafe(method(setScalesLargeContentImage:))]
87        #[unsafe(method_family = none)]
88        pub unsafe fn setScalesLargeContentImage(&self, scales_large_content_image: bool);
89
90        #[cfg(all(feature = "UIGeometry", feature = "objc2-core-foundation"))]
91        #[unsafe(method(largeContentImageInsets))]
92        #[unsafe(method_family = none)]
93        pub unsafe fn largeContentImageInsets(&self) -> UIEdgeInsets;
94
95        #[cfg(all(feature = "UIGeometry", feature = "objc2-core-foundation"))]
96        /// Setter for [`largeContentImageInsets`][Self::largeContentImageInsets].
97        #[unsafe(method(setLargeContentImageInsets:))]
98        #[unsafe(method_family = none)]
99        pub unsafe fn setLargeContentImageInsets(&self, large_content_image_insets: UIEdgeInsets);
100    );
101}
102
103#[cfg(all(feature = "UIResponder", feature = "UIView"))]
104extern_conformance!(
105    unsafe impl UILargeContentViewerItem for UIView {}
106);
107
108extern_class!(
109    /// UILargeContentViewerInteraction enables a gesture to present and dismiss the large content viewer on a device with relevant settings.
110    /// Use methods in
111    /// <UIKit
112    /// /UIInteraction.h> to add the interaction to an appropriate view, such as a custom tab bar.
113    ///
114    /// See also [Apple's documentation](https://developer.apple.com/documentation/uikit/uilargecontentviewerinteraction?language=objc)
115    #[unsafe(super(NSObject))]
116    #[thread_kind = MainThreadOnly]
117    #[derive(Debug, PartialEq, Eq, Hash)]
118    pub struct UILargeContentViewerInteraction;
119);
120
121extern_conformance!(
122    unsafe impl NSObjectProtocol for UILargeContentViewerInteraction {}
123);
124
125#[cfg(feature = "UIInteraction")]
126extern_conformance!(
127    unsafe impl UIInteraction for UILargeContentViewerInteraction {}
128);
129
130impl UILargeContentViewerInteraction {
131    extern_methods!(
132        #[unsafe(method(initWithDelegate:))]
133        #[unsafe(method_family = init)]
134        pub unsafe fn initWithDelegate(
135            this: Allocated<Self>,
136            delegate: Option<&ProtocolObject<dyn UILargeContentViewerInteractionDelegate>>,
137        ) -> Retained<Self>;
138
139        #[unsafe(method(delegate))]
140        #[unsafe(method_family = none)]
141        pub unsafe fn delegate(
142            &self,
143        ) -> Option<Retained<ProtocolObject<dyn UILargeContentViewerInteractionDelegate>>>;
144
145        #[cfg(feature = "UIGestureRecognizer")]
146        /// Returns a gesture recognizer that can be used to set up simultaneous recognition or failure relationships with other gesture recognizers.
147        #[unsafe(method(gestureRecognizerForExclusionRelationship))]
148        #[unsafe(method_family = none)]
149        pub unsafe fn gestureRecognizerForExclusionRelationship(
150            &self,
151        ) -> Retained<UIGestureRecognizer>;
152
153        /// Returns whether the large content viewer is enabled on the device.
154        /// It is not necessary to check this value before adding a UILargeContentViewerInteraction to a view,
155        /// but it may be helpful if you need to adjust the behavior of coexisting gesture handlers.
156        /// For example, a button with a long press handler might increase its long press duration,
157        /// so that a user can read text in the large content viewer first.
158        #[unsafe(method(isEnabled))]
159        #[unsafe(method_family = none)]
160        pub unsafe fn isEnabled(mtm: MainThreadMarker) -> bool;
161    );
162}
163
164/// Methods declared on superclass `NSObject`.
165impl UILargeContentViewerInteraction {
166    extern_methods!(
167        #[unsafe(method(init))]
168        #[unsafe(method_family = init)]
169        pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>;
170
171        #[unsafe(method(new))]
172        #[unsafe(method_family = new)]
173        pub unsafe fn new(mtm: MainThreadMarker) -> Retained<Self>;
174    );
175}
176
177extern_protocol!(
178    /// [Apple's documentation](https://developer.apple.com/documentation/uikit/uilargecontentviewerinteractiondelegate?language=objc)
179    pub unsafe trait UILargeContentViewerInteractionDelegate:
180        NSObjectProtocol + MainThreadOnly
181    {
182        #[cfg(feature = "objc2-core-foundation")]
183        /// Performs an action when the large content viewer gesture ends at the location of the given item.
184        /// (The point in the interaction's view's coordinate system is also provided.)
185        /// For example, you may wish to perform the action that would have occurred if the user had tapped on that item.
186        /// If you don’t implement this method and are using standard UIKit controls, the system performs a default action, such as sending a touchUpInside event to the control.
187        /// This method is called only if the gesture ends successfully (not if it fails or gets canceled).
188        #[optional]
189        #[unsafe(method(largeContentViewerInteraction:didEndOnItem:atPoint:))]
190        #[unsafe(method_family = none)]
191        unsafe fn largeContentViewerInteraction_didEndOnItem_atPoint(
192            &self,
193            interaction: &UILargeContentViewerInteraction,
194            item: Option<&ProtocolObject<dyn UILargeContentViewerItem>>,
195            point: CGPoint,
196        );
197
198        #[cfg(feature = "objc2-core-foundation")]
199        /// Returns the item at a given point in the interaction's view's coordinate system.
200        /// If this is not implemented, -[UIView pointInside:withEvent:] will be called recursively on the interaction's view to find an appropriate view.
201        #[optional]
202        #[unsafe(method(largeContentViewerInteraction:itemAtPoint:))]
203        #[unsafe(method_family = none)]
204        unsafe fn largeContentViewerInteraction_itemAtPoint(
205            &self,
206            interaction: &UILargeContentViewerInteraction,
207            point: CGPoint,
208        ) -> Option<Retained<ProtocolObject<dyn UILargeContentViewerItem>>>;
209
210        #[cfg(all(feature = "UIResponder", feature = "UIViewController"))]
211        /// Returns the view controller whose region of the screen should be used to display the large content viewer.
212        /// If this is not implemented, a view controller that contains the interaction's view will be chosen.
213        #[optional]
214        #[unsafe(method(viewControllerForLargeContentViewerInteraction:))]
215        #[unsafe(method_family = none)]
216        unsafe fn viewControllerForLargeContentViewerInteraction(
217            &self,
218            interaction: &UILargeContentViewerInteraction,
219        ) -> Retained<UIViewController>;
220    }
221);
222
223extern "C" {
224    /// Posted when the large content viewer gets enabled or disabled on the device.
225    ///
226    /// See also [Apple's documentation](https://developer.apple.com/documentation/uikit/uilargecontentviewerinteractionenabledstatusdidchangenotification?language=objc)
227    pub static UILargeContentViewerInteractionEnabledStatusDidChangeNotification:
228        &'static NSNotificationName;
229}
objc2_ui_kit/generated/UILargeContentViewer.rs

objc2_ui_kit/generated/
UILargeContentViewer.rs
