Struct MFMailComposeViewController

#[repr(C)]
pub struct MFMailComposeViewController { /* private fields */ }

Available on crate features MFMailComposeViewController and objc2-ui-kit only.

The MFMailComposeViewController class provides an interface for editing and sending email.

The MFMailComposeViewController class manages all user interaction. The client needs to set the recipient or recipients. The client may also set the subject and the body of the message. Attachments may be added, if so desired. After setup, the client needs to only display the view.

The provided delegate will be informed of the user's composition completion and how they chose to complete the operation.

Prior to use, clients should verify the user has set up the device for sending email via +[MFMailComposeViewController canSendMail] .

See also Apple’s documentation

Implementations

impl MFMailComposeViewController

pub unsafe fn canSendMail(mtm: MainThreadMarker) -> bool

Returns YES if the user has set up the device for sending email.

The client may continue to set the recipients and content if the return value was YES . If NO was the result, the client has a couple options. It may choose to simply notify the user of the inability to send mail, or it may issue a “mailto” URL via -[UIApplication openURL:] .

pub unsafe fn mailComposeDelegate( &self, ) -> Option<Retained<ProtocolObject<dyn MFMailComposeViewControllerDelegate>>>

This property is the delegate for the MFMailComposeViewControllerDelegate method callbacks.

pub unsafe fn setMailComposeDelegate( &self, mail_compose_delegate: Option<&ProtocolObject<dyn MFMailComposeViewControllerDelegate>>, )

This is a weak property. Setter for mailComposeDelegate.

pub unsafe fn setSubject(&self, subject: &NSString)

This method sets the Subject header for the email message.

This method will set the Subject header for the email message. This should be called prior to display. Newlines are removed from the parameter.

After the view has been presented to the user, this method will no longer change the value.

Parameter subject: A NSString specifying the message’s Subject header.

pub unsafe fn setToRecipients(&self, to_recipients: Option<&NSArray<NSString>>)

This method sets the To header for the email message to the specified email addresses.

This method will set the To header for the email message. This should be called prior to display.

Recipient addresses should be specified as per RFC5322.

After the view has been presented to the user, this method will no longer change the value.

Parameter toRecipients: A NSArray of NSString instances specifying the email addresses of recipients.

pub unsafe fn setCcRecipients(&self, cc_recipients: Option<&NSArray<NSString>>)

This method sets the CC header for the email message to the specified email addresses.

This method will set the CC header for the email message. This should be called prior to display.

Recipient addresses should be specified as per RFC5322.

After the view has been presented to the user, this method will no longer change the value.

Parameter ccRecipients: A NSArray of NSString instances specifying the email addresses of recipients.

pub unsafe fn setBccRecipients( &self, bcc_recipients: Option<&NSArray<NSString>>, )

This method sets the BCC header for the email message to the specified email addresses.

This method will set the BCC header for the email message. This should be called prior to display.

Recipient addresses should be specified as per RFC5322.

After the view has been presented to the user, this method will no longer change the value.

Parameter bccRecipients: A NSArray of NSString instances specifying the email addresses of recipients.

pub unsafe fn setMessageBody_isHTML(&self, body: &NSString, is_html: bool)

This method sets the body of the email message to the specified content.

This method will set the body of the email message. This should be called prior to display. The user’s signature, if specified, will be added after the body content.

Parameter body: A NSString containing the body contents of the email message.

Parameter isHTML: A boolean value indicating if the body argument is to be interpreted as HTML content.

pub unsafe fn addAttachmentData_mimeType_fileName( &self, attachment: &NSData, mime_type: &NSString, filename: &NSString, )

This method adds the specified attachment to the email message.

This method adds the specified attachment to the email message. This should be called prior to display. Attachments will be appended to the end of the message.

Parameter attachment: NSData containing the contents of the attachment. Must not be nil .

Parameter mimeType: NSString specifying the MIME type for the attachment, as specified by the IANA (http://www.iana.org/assignments/media-types/). Must not be nil .

Parameter filename: NSString specifying the intended filename for the attachment. This is displayed below the attachment’s icon if the attachment is not decoded when displayed. Must not be nil .

pub unsafe fn setPreferredSendingEmailAddress(&self, email_address: &NSString)

This method sets the preferred sending account of the email message.

This method will set the sending account of the message to the specified email address if the user has an account with such an address set up. If there is no account with such an address, the default account will be used instead. The sending email address should be specified as per RFC5322. After the view has been presented to the user, this method will no longer change the value.

Parameter emailAddress: A NSString specifying the preferred email address used to send this message.

impl MFMailComposeViewController

Methods declared on superclass UINavigationController.

pub unsafe fn initWithNavigationBarClass_toolbarClass( this: Allocated<Self>, navigation_bar_class: Option<&AnyClass>, toolbar_class: Option<&AnyClass>, ) -> Retained<Self>

pub unsafe fn initWithRootViewController( this: Allocated<Self>, root_view_controller: &UIViewController, ) -> Retained<Self>

pub unsafe fn initWithNibName_bundle( this: Allocated<Self>, nib_name_or_nil: Option<&NSString>, nib_bundle_or_nil: Option<&NSBundle>, ) -> Retained<Self>

pub unsafe fn initWithCoder( this: Allocated<Self>, a_decoder: &NSCoder, ) -> Option<Retained<Self>>

impl MFMailComposeViewController

Methods declared on superclass NSObject.

pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>

pub unsafe fn new(mtm: MainThreadMarker) -> Retained<Self>

Methods from Deref<Target = UINavigationController>

pub unsafe fn pushViewController_animated( &self, view_controller: &UIViewController, animated: bool, )

Available on crate features UIResponder and UIViewController only.

pub unsafe fn popViewControllerAnimated( &self, animated: bool, ) -> Option<Retained<UIViewController>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn popToViewController_animated( &self, view_controller: &UIViewController, animated: bool, ) -> Option<Retained<NSArray<UIViewController>>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn popToRootViewControllerAnimated( &self, animated: bool, ) -> Option<Retained<NSArray<UIViewController>>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn topViewController(&self) -> Option<Retained<UIViewController>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn visibleViewController(&self) -> Option<Retained<UIViewController>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn viewControllers(&self) -> Retained<NSArray<UIViewController>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn setViewControllers( &self, view_controllers: &NSArray<UIViewController>, )

Available on crate features UIResponder and UIViewController only.

Setter for viewControllers.

pub unsafe fn setViewControllers_animated( &self, view_controllers: &NSArray<UIViewController>, animated: bool, )

Available on crate features UIResponder and UIViewController only.

pub unsafe fn isNavigationBarHidden(&self) -> bool

Available on crate features UIResponder and UIViewController only.

pub unsafe fn setNavigationBarHidden(&self, navigation_bar_hidden: bool)

Available on crate features UIResponder and UIViewController only.

Setter for isNavigationBarHidden.

pub unsafe fn setNavigationBarHidden_animated( &self, hidden: bool, animated: bool, )

Available on crate features UIResponder and UIViewController only.

pub unsafe fn isToolbarHidden(&self) -> bool

Available on crate features UIResponder and UIViewController only.

pub unsafe fn setToolbarHidden(&self, toolbar_hidden: bool)

Available on crate features UIResponder and UIViewController only.

Setter for isToolbarHidden.

pub unsafe fn setToolbarHidden_animated(&self, hidden: bool, animated: bool)

Available on crate features UIResponder and UIViewController only.

pub unsafe fn delegate( &self, ) -> Option<Retained<ProtocolObject<dyn UINavigationControllerDelegate>>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn setDelegate( &self, delegate: Option<&ProtocolObject<dyn UINavigationControllerDelegate>>, )

Available on crate features UIResponder and UIViewController only.

This is a weak property. Setter for delegate.

pub unsafe fn showViewController_sender( &self, vc: &UIViewController, sender: Option<&AnyObject>, )

Available on crate features UIResponder and UIViewController only.

pub unsafe fn hidesBarsWhenKeyboardAppears(&self) -> bool

Available on crate features UIResponder and UIViewController only.

When the keyboard appears, the navigation controller’s navigationBar toolbar will be hidden. The bars will remain hidden when the keyboard dismisses, but a tap in the content area will show them.

pub unsafe fn setHidesBarsWhenKeyboardAppears( &self, hides_bars_when_keyboard_appears: bool, )

Available on crate features UIResponder and UIViewController only.

Setter for hidesBarsWhenKeyboardAppears.

pub unsafe fn hidesBarsOnSwipe(&self) -> bool

Available on crate features UIResponder and UIViewController only.

When the user swipes, the navigation controller’s navigationBar & toolbar will be hidden (on a swipe up) or shown (on a swipe down). The toolbar only participates if it has items.

pub unsafe fn setHidesBarsOnSwipe(&self, hides_bars_on_swipe: bool)

Available on crate features UIResponder and UIViewController only.

Setter for hidesBarsOnSwipe.

pub unsafe fn hidesBarsWhenVerticallyCompact(&self) -> bool

Available on crate features UIResponder and UIViewController only.

When the UINavigationController’s vertical size class is compact, hide the UINavigationBar and UIToolbar. Unhandled taps in the regions that would normally be occupied by these bars will reveal the bars.

pub unsafe fn setHidesBarsWhenVerticallyCompact( &self, hides_bars_when_vertically_compact: bool, )

Available on crate features UIResponder and UIViewController only.

Setter for hidesBarsWhenVerticallyCompact.

pub unsafe fn hidesBarsOnTap(&self) -> bool

Available on crate features UIResponder and UIViewController only.

When the user taps, the navigation controller’s navigationBar & toolbar will be hidden or shown, depending on the hidden state of the navigationBar. The toolbar will only be shown if it has items to display.

pub unsafe fn setHidesBarsOnTap(&self, hides_bars_on_tap: bool)

Available on crate features UIResponder and UIViewController only.

Setter for hidesBarsOnTap.

Methods from Deref<Target = UIViewController>

pub unsafe fn hidesBottomBarWhenPushed(&self) -> bool

Available on crate features UIResponder and UIViewController only.

pub unsafe fn setHidesBottomBarWhenPushed( &self, hides_bottom_bar_when_pushed: bool, )

Available on crate features UIResponder and UIViewController only.

Setter for hidesBottomBarWhenPushed.

pub unsafe fn navigationController( &self, ) -> Option<Retained<UINavigationController>>

Available on crate features UIResponder and UIViewController only.

pub unsafe fn loadView(&self)

Available on crate feature UIResponder only.

pub unsafe fn loadViewIfNeeded(&self)

Available on crate feature UIResponder only.

pub unsafe fn viewWillUnload(&self)

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn viewDidUnload(&self)

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn viewDidLoad(&self)

Available on crate feature UIResponder only.

pub unsafe fn isViewLoaded(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn nibName(&self) -> Option<Retained<NSString>>

👎Deprecated: Loading Interface Builder products will not be supported in a future version of visionOS.

Available on crate feature UIResponder only.

pub unsafe fn nibBundle(&self) -> Option<Retained<NSBundle>>

👎Deprecated: Loading Interface Builder products will not be supported in a future version of visionOS.

Available on crate feature UIResponder only.

pub unsafe fn performSegueWithIdentifier_sender( &self, identifier: &NSString, sender: Option<&AnyObject>, )

👎Deprecated: Loading Interface Builder products will not be supported in a future version of visionOS.

Available on crate feature UIResponder only.

pub unsafe fn shouldPerformSegueWithIdentifier_sender( &self, identifier: &NSString, sender: Option<&AnyObject>, ) -> bool

👎Deprecated: Loading Interface Builder products will not be supported in a future version of visionOS.

Available on crate feature UIResponder only.

pub unsafe fn canPerformUnwindSegueAction_fromViewController_sender( &self, action: Sel, from_view_controller: &UIViewController, sender: Option<&AnyObject>, ) -> bool

👎Deprecated: Loading Interface Builder products will not be supported in a future version of visionOS.

Available on crate feature UIResponder only.

pub unsafe fn canPerformUnwindSegueAction_fromViewController_withSender( &self, action: Sel, from_view_controller: &UIViewController, sender: &AnyObject, ) -> bool

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn viewControllerForUnwindSegueAction_fromViewController_withSender( &self, action: Sel, from_view_controller: &UIViewController, sender: Option<&AnyObject>, ) -> Option<Retained<UIViewController>>

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn viewWillAppear(&self, animated: bool)

Available on crate feature UIResponder only.

Called when the view is about to made visible, before it is added to the hierarchy. Because the view is not yet in the hierarchy at the time this method is called, it is too early in the appearance transition for many usages. Prefer -viewIsAppearing: instead of this method when possible. Only use this method when its exact timing before the appearance transition starts running is desired, such as to set up an alongside animation with a transition coordinator, or as a counterpart for paired code in a viewWillDisappear/viewDidDisappear callback that does not rely on the view or view controller’s trait collection or the view hierarchy.

pub unsafe fn viewIsAppearing(&self, animated: bool)

Available on crate feature UIResponder only.

Called when the view is becoming visible at the beginning of the appearance transition, after it has been added to the hierarchy and been laid out by its superview. This method is very similar to -viewWillAppear: and is always called shortly afterwards (so changes made in either callback will be visible to the user at the same time), but unlike -viewWillAppear:, at the time when -viewIsAppearing: is called all of the following are valid for the view controller and its own view:

• View controller and view’s trait collection
• View’s superview chain and window
• View’s geometry (e.g. frame/bounds, safe area insets, layout margins) Choose this method instead of -viewWillAppear: by default, as it is a direct replacement that provides equivalent or superior behavior in nearly all cases.

pub unsafe fn viewDidAppear(&self, animated: bool)

Available on crate feature UIResponder only.

Called after the view has fully transitioned to visible, when any transition animations have completed.

pub unsafe fn viewWillDisappear(&self, animated: bool)

Available on crate feature UIResponder only.

Called when the view is about to be dismissed, covered, or otherwise hidden.

pub unsafe fn viewDidDisappear(&self, animated: bool)

Available on crate feature UIResponder only.

Called after the view has fully been dismissed, covered, or otherwise hidden, when any transition animations have completed.

pub unsafe fn viewWillLayoutSubviews(&self)

Available on crate feature UIResponder only.

pub unsafe fn viewDidLayoutSubviews(&self)

Available on crate feature UIResponder only.

pub unsafe fn title(&self) -> Option<Retained<NSString>>

Available on crate feature UIResponder only.

pub unsafe fn setTitle(&self, title: Option<&NSString>)

Available on crate feature UIResponder only.

Setter for title.

pub unsafe fn didReceiveMemoryWarning(&self)

Available on crate feature UIResponder only.

pub unsafe fn parentViewController(&self) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn modalViewController(&self) -> Option<Retained<UIViewController>>

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn presentedViewController( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn presentingViewController( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn definesPresentationContext(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setDefinesPresentationContext( &self, defines_presentation_context: bool, )

Available on crate feature UIResponder only.

Setter for definesPresentationContext.

pub unsafe fn providesPresentationContextTransitionStyle(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setProvidesPresentationContextTransitionStyle( &self, provides_presentation_context_transition_style: bool, )

Available on crate feature UIResponder only.

Setter for providesPresentationContextTransitionStyle.

pub unsafe fn restoresFocusAfterTransition(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setRestoresFocusAfterTransition( &self, restores_focus_after_transition: bool, )

Available on crate feature UIResponder only.

Setter for restoresFocusAfterTransition.

pub unsafe fn focusGroupIdentifier(&self) -> Option<Retained<NSString>>

Available on crate feature UIResponder only.

The identifier of the focus group that this view controller belongs to. If this is nil, the view controller inherits the focus group of its parent focus environment.

pub unsafe fn setFocusGroupIdentifier( &self, focus_group_identifier: Option<&NSString>, )

Available on crate feature UIResponder only.

Setter for focusGroupIdentifier.

pub unsafe fn interactionActivityTrackingBaseName( &self, ) -> Option<Retained<NSString>>

Available on crate feature UIResponder only.

The base name for tracking user interactions as activities hosted by this view controller.

pub unsafe fn setInteractionActivityTrackingBaseName( &self, interaction_activity_tracking_base_name: Option<&NSString>, )

Available on crate feature UIResponder only.

Setter for interactionActivityTrackingBaseName.

pub unsafe fn isBeingPresented(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn isBeingDismissed(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn isMovingToParentViewController(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn isMovingFromParentViewController(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn presentModalViewController_animated( &self, modal_view_controller: &UIViewController, animated: bool, )

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn dismissModalViewControllerAnimated(&self, animated: bool)

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn modalTransitionStyle(&self) -> UIModalTransitionStyle

Available on crate feature UIResponder only.

pub unsafe fn setModalTransitionStyle( &self, modal_transition_style: UIModalTransitionStyle, )

Available on crate feature UIResponder only.

Setter for modalTransitionStyle.

pub unsafe fn modalPresentationStyle(&self) -> UIModalPresentationStyle

Available on crate feature UIResponder only.

pub unsafe fn setModalPresentationStyle( &self, modal_presentation_style: UIModalPresentationStyle, )

Available on crate feature UIResponder only.

Setter for modalPresentationStyle.

pub unsafe fn modalPresentationCapturesStatusBarAppearance(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setModalPresentationCapturesStatusBarAppearance( &self, modal_presentation_captures_status_bar_appearance: bool, )

Available on crate feature UIResponder only.

Setter for modalPresentationCapturesStatusBarAppearance.

pub unsafe fn disablesAutomaticKeyboardDismissal(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn wantsFullScreenLayout(&self) -> bool

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn setWantsFullScreenLayout(&self, wants_full_screen_layout: bool)

👎Deprecated

Available on crate feature UIResponder only.

Setter for wantsFullScreenLayout.

pub unsafe fn extendedLayoutIncludesOpaqueBars(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setExtendedLayoutIncludesOpaqueBars( &self, extended_layout_includes_opaque_bars: bool, )

Available on crate feature UIResponder only.

Setter for extendedLayoutIncludesOpaqueBars.

pub unsafe fn automaticallyAdjustsScrollViewInsets(&self) -> bool

👎Deprecated: Use UIScrollView’s contentInsetAdjustmentBehavior instead

Available on crate feature UIResponder only.

pub unsafe fn setAutomaticallyAdjustsScrollViewInsets( &self, automatically_adjusts_scroll_view_insets: bool, )

👎Deprecated: Use UIScrollView’s contentInsetAdjustmentBehavior instead

Available on crate feature UIResponder only.

Setter for automaticallyAdjustsScrollViewInsets.

pub unsafe fn prefersStatusBarHidden(&self) -> bool

👎Deprecated: Has no effect on visionOS

Available on crate feature UIResponder only.

pub fn setNeedsStatusBarAppearanceUpdate(&self)

Available on crate feature UIResponder only.

pub unsafe fn targetViewControllerForAction_sender( &self, action: Sel, sender: Option<&AnyObject>, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn showViewController_sender( &self, vc: &UIViewController, sender: Option<&AnyObject>, )

Available on crate feature UIResponder only.

pub unsafe fn showDetailViewController_sender( &self, vc: &UIViewController, sender: Option<&AnyObject>, )

Available on crate feature UIResponder only.

pub unsafe fn setNeedsUserInterfaceAppearanceUpdate(&self)

Available on crate feature UIResponder only.

pub unsafe fn shouldAutorotate(&self) -> bool

👎Deprecated: Update supported interface orientations and call setNeedsUpdateOfSupportedInterfaceOrientations to indicate a change.

Available on crate feature UIResponder only.

pub unsafe fn setNeedsUpdateOfSupportedInterfaceOrientations(&self)

Available on crate feature UIResponder only.

Notifies the view controller that a change occurred that affects supported interface orientations or the preferred interface orientation for presentation. By default, this will animate any changes to orientation. To perform a non-animated update, call within [UIView performWithoutAnimation:].

pub unsafe fn isEditing(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setEditing(&self, editing: bool)

Available on crate feature UIResponder only.

Setter for isEditing.

pub unsafe fn setEditing_animated(&self, editing: bool, animated: bool)

Available on crate feature UIResponder only.

pub unsafe fn childViewControllers(&self) -> Retained<NSArray<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn addChildViewController(&self, child_controller: &UIViewController)

Available on crate feature UIResponder only.

pub unsafe fn removeFromParentViewController(&self)

Available on crate feature UIResponder only.

pub unsafe fn beginAppearanceTransition_animated( &self, is_appearing: bool, animated: bool, )

Available on crate feature UIResponder only.

pub unsafe fn endAppearanceTransition(&self)

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForStatusBarStyle( &self, ) -> Option<Retained<UIViewController>>

👎Deprecated: Has no effect on visionOS

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForStatusBarHidden( &self, ) -> Option<Retained<UIViewController>>

👎Deprecated: Has no effect on visionOS

Available on crate feature UIResponder only.

pub unsafe fn setOverrideTraitCollection_forChildViewController( &self, collection: Option<&UITraitCollection>, child_view_controller: &UIViewController, )

👎Deprecated: Use the traitOverrides property on the child view controller instead

Available on crate features UIResponder and UITraitCollection only.

pub unsafe fn overrideTraitCollectionForChildViewController( &self, child_view_controller: &UIViewController, ) -> Option<Retained<UITraitCollection>>

👎Deprecated: Use the traitOverrides property on the child view controller instead

Available on crate features UIResponder and UITraitCollection only.

pub unsafe fn childViewControllerForUserInterfaceStyle( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn automaticallyForwardAppearanceAndRotationMethodsToChildViewControllers( &self, ) -> bool

👎Deprecated

Available on crate feature UIResponder only.

pub unsafe fn shouldAutomaticallyForwardRotationMethods(&self) -> bool

👎Deprecated: Manually forward viewWillTransitionToSize:withTransitionCoordinator: if necessary

Available on crate feature UIResponder only.

pub unsafe fn shouldAutomaticallyForwardAppearanceMethods(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn willMoveToParentViewController( &self, parent: Option<&UIViewController>, )

Available on crate feature UIResponder only.

pub unsafe fn didMoveToParentViewController( &self, parent: Option<&UIViewController>, )

Available on crate feature UIResponder only.

pub unsafe fn restorationIdentifier(&self) -> Option<Retained<NSString>>

Available on crate feature UIResponder only.

pub unsafe fn setRestorationIdentifier( &self, restoration_identifier: Option<&NSString>, )

Available on crate feature UIResponder only.

Setter for restorationIdentifier.

pub unsafe fn encodeRestorableStateWithCoder(&self, coder: &NSCoder)

Available on crate feature UIResponder only.

pub unsafe fn decodeRestorableStateWithCoder(&self, coder: &NSCoder)

Available on crate feature UIResponder only.

pub unsafe fn applicationFinishedRestoringState(&self)

Available on crate feature UIResponder only.

pub unsafe fn updateViewConstraints(&self)

Available on crate feature UIResponder only.

pub unsafe fn viewRespectsSystemMinimumLayoutMargins(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setViewRespectsSystemMinimumLayoutMargins( &self, view_respects_system_minimum_layout_margins: bool, )

Available on crate feature UIResponder only.

Setter for viewRespectsSystemMinimumLayoutMargins.

pub unsafe fn viewLayoutMarginsDidChange(&self)

Available on crate feature UIResponder only.

pub unsafe fn viewSafeAreaInsetsDidChange(&self)

Available on crate feature UIResponder only.

pub unsafe fn performsActionsWhilePresentingModally(&self) -> bool

Available on crate feature UIResponder only.

Determines whether the receiver continues to respond to actions while it is presenting a view controller modally.

Defaults to YES. You can change the default return value by providing a value for UIViewControllerPerformsActionsWhilePresentingModally in your Info.plist file.

pub unsafe fn extensionContext(&self) -> Option<Retained<NSExtensionContext>>

Available on crate feature UIResponder only.

pub unsafe fn isModalInPresentation(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setModalInPresentation(&self, modal_in_presentation: bool)

Available on crate feature UIResponder only.

Setter for isModalInPresentation.

pub unsafe fn unregisterForPreviewingWithContext( &self, previewing: &ProtocolObject<dyn UIViewControllerPreviewing>, )

👎Deprecated: UIViewControllerPreviewing is deprecated. Please use UIContextMenuInteraction.

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForScreenEdgesDeferringSystemGestures( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub fn setNeedsUpdateOfScreenEdgesDeferringSystemGestures(&self)

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForHomeIndicatorAutoHidden( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn prefersHomeIndicatorAutoHidden(&self) -> bool

Available on crate feature UIResponder only.

pub fn setNeedsUpdateOfHomeIndicatorAutoHidden(&self)

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForPointerLock( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn prefersPointerLocked(&self) -> bool

Available on crate feature UIResponder only.

pub unsafe fn setNeedsUpdateOfPrefersPointerLocked(&self)

Available on crate feature UIResponder only.

pub unsafe fn setNeedsUpdateContentUnavailableConfiguration(&self)

Available on crate feature UIResponder only.

Requests the view update its content unavailable configuration for its current state. This method is called automatically when the view’s contentUnavailableConfigurationState may have changed, as well as in other circumstances where an update may be required. Multiple requests may be coalesced into a single update at the appropriate time.

pub unsafe fn previewActionItems( &self, ) -> Retained<NSArray<ProtocolObject<dyn UIPreviewActionItem>>>

👎Deprecated: UIViewControllerPreviewing is deprecated. Please use UIContextMenuInteraction.

Available on crate feature UIResponder only.

pub unsafe fn traitOverrides( &self, ) -> Retained<ProtocolObject<dyn UITraitOverrides>>

Available on crate features UIResponder and UITraitCollection only.

pub unsafe fn updateTraitsIfNeeded(&self)

Available on crate feature UIResponder only.

Forces an immediate trait update for this view controller and its view, including any view controllers and views in this subtree. Any trait change callbacks are sent synchronously.

pub unsafe fn preferredContainerBackgroundStyle( &self, ) -> UIContainerBackgroundStyle

Available on crate feature UIResponder only.

pub unsafe fn childViewControllerForPreferredContainerBackgroundStyle( &self, ) -> Option<Retained<UIViewController>>

Available on crate feature UIResponder only.

pub unsafe fn setNeedsUpdateOfPreferredContainerBackgroundStyle(&self)

Available on crate feature UIResponder only.

Methods from Deref<Target = UIResponder>

pub unsafe fn nextResponder(&self) -> Option<Retained<UIResponder>>

pub unsafe fn canBecomeFirstResponder(&self) -> bool

pub unsafe fn becomeFirstResponder(&self) -> bool

pub unsafe fn canResignFirstResponder(&self) -> bool

pub unsafe fn resignFirstResponder(&self) -> bool

pub unsafe fn isFirstResponder(&self) -> bool

pub unsafe fn canPerformAction_withSender( &self, action: Sel, sender: Option<&AnyObject>, ) -> bool

pub unsafe fn targetForAction_withSender( &self, action: Sel, sender: Option<&AnyObject>, ) -> Option<Retained<AnyObject>>

pub unsafe fn undoManager(&self) -> Option<Retained<NSUndoManager>>

pub unsafe fn editingInteractionConfiguration( &self, ) -> UIEditingInteractionConfiguration

pub unsafe fn textInputContextIdentifier(&self) -> Option<Retained<NSString>>

pub unsafe fn reloadInputViews(&self)

pub unsafe fn userActivity(&self) -> Option<Retained<NSUserActivity>>

pub unsafe fn setUserActivity(&self, user_activity: Option<&NSUserActivity>)

Setter for userActivity.

pub unsafe fn updateUserActivityState(&self, activity: &NSUserActivity)

pub unsafe fn restoreUserActivityState(&self, activity: &NSUserActivity)

pub unsafe fn captureTextFromCamera(&self, sender: Option<&AnyObject>)

Methods from Deref<Target = NSObject>

pub fn doesNotRecognizeSelector(&self, sel: Sel) -> !

Handle messages the object doesn’t recognize.

See Apple’s documentation for details.

Methods from Deref<Target = AnyObject>

pub fn class(&self) -> &'static AnyClass

Dynamically find the class of this object.

Example

Check that an instance of NSObject has the precise class NSObject.

use objc2::ClassType;
use objc2::runtime::NSObject;

let obj = NSObject::new();
assert_eq!(obj.class(), NSObject::class());

pub unsafe fn get_ivar<T>(&self, name: &str) -> &T

where T: Encode,

👎Deprecated: this is difficult to use correctly, use Ivar::load instead.

Use Ivar::load instead.

Safety

The object must have an instance variable with the given name, and it must be of type T.

See Ivar::load_ptr for details surrounding this.

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: DowncastTarget,

Attempt to downcast the object to a class of type T.

This is the reference-variant. Use Retained::downcast if you want to convert a retained object to another type.

Mutable classes

Some classes have immutable and mutable variants, such as NSString and NSMutableString.

When some Objective-C API signature says it gives you an immutable class, it generally expects you to not mutate that, even though it may technically be mutable “under the hood”.

So using this method to convert a NSString to a NSMutableString, while not unsound, is generally frowned upon unless you created the string yourself, or the API explicitly documents the string to be mutable.

See Apple’s documentation on mutability and on isKindOfClass: for more details.

Generic classes

Objective-C generics are called “lightweight generics”, and that’s because they aren’t exposed in the runtime. This makes it impossible to safely downcast to generic collections, so this is disallowed by this method.

You can, however, safely downcast to generic collections where all the type-parameters are AnyObject.

Panics

This works internally by calling isKindOfClass:. That means that the object must have the instance method of that name, and an exception will be thrown (if CoreFoundation is linked) or the process will abort if that is not the case. In the vast majority of cases, you don’t need to worry about this, since both root objects NSObject and NSProxy implement this method.

Examples

Cast an NSString back and forth from NSObject.

use objc2::rc::Retained;
use objc2_foundation::{NSObject, NSString};

let obj: Retained<NSObject> = NSString::new().into_super();
let string = obj.downcast_ref::<NSString>().unwrap();
// Or with `downcast`, if we do not need the object afterwards
let string = obj.downcast::<NSString>().unwrap();

Try (and fail) to cast an NSObject to an NSString.

use objc2_foundation::{NSObject, NSString};

let obj = NSObject::new();
assert!(obj.downcast_ref::<NSString>().is_none());

Try to cast to an array of strings.

use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);
// This is invalid and doesn't type check.
let arr = arr.downcast_ref::<NSArray<NSString>>();

This fails to compile, since it would require enumerating over the array to ensure that each element is of the desired type, which is a performance pitfall.

Downcast when processing each element instead.

use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);

for elem in arr {
    if let Some(data) = elem.downcast_ref::<NSString>() {
        // handle `data`
    }
}

Trait Implementations

impl AsRef<AnyObject> for MFMailComposeViewController

fn as_ref(&self) -> &AnyObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<MFMailComposeViewController> for MFMailComposeViewController

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<NSObject> for MFMailComposeViewController

fn as_ref(&self) -> &NSObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UINavigationController> for MFMailComposeViewController

fn as_ref(&self) -> &UINavigationController

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UIResponder> for MFMailComposeViewController

fn as_ref(&self) -> &UIResponder

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UIViewController> for MFMailComposeViewController

fn as_ref(&self) -> &UIViewController

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<AnyObject> for MFMailComposeViewController

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<NSObject> for MFMailComposeViewController

fn borrow(&self) -> &NSObject

Immutably borrows from an owned value.

impl Borrow<UINavigationController> for MFMailComposeViewController

fn borrow(&self) -> &UINavigationController

Immutably borrows from an owned value.

impl Borrow<UIResponder> for MFMailComposeViewController

fn borrow(&self) -> &UIResponder

Immutably borrows from an owned value.

impl Borrow<UIViewController> for MFMailComposeViewController

fn borrow(&self) -> &UIViewController

Immutably borrows from an owned value.

impl ClassType for MFMailComposeViewController

const NAME: &'static str = "MFMailComposeViewController"

The name of the Objective-C class that this type represents.

type Super = UINavigationController

The superclass of this class.

type ThreadKind = <<MFMailComposeViewController as ClassType>::Super as ClassType>::ThreadKind

Whether the type can be used from any thread, or from only the main thread.

fn class() -> &'static AnyClass

Get a reference to the Objective-C class that this type represents.

fn as_super(&self) -> &Self::Super

Get an immutable reference to the superclass.

impl Debug for MFMailComposeViewController

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for MFMailComposeViewController

type Target = UINavigationController

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Hash for MFMailComposeViewController

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for MFMailComposeViewController

fn retain(&self) -> Retained<Self>

where Self: Sized,

Increment the reference count of the receiver.

impl NSCoding for MFMailComposeViewController

unsafe fn encodeWithCoder(&self, coder: &NSCoder)

where Self: Sized + Message,

Available on crate feature NSCoder only.

unsafe fn initWithCoder( this: Allocated<Self>, coder: &NSCoder, ) -> Option<Retained<Self>>

where Self: Sized + Message,

Available on crate feature NSCoder only.

impl NSObjectProtocol for MFMailComposeViewController

fn isEqual(&self, other: Option<&AnyObject>) -> bool

where Self: Sized + Message,

Check whether the object is equal to an arbitrary other object.

fn hash(&self) -> usize

where Self: Sized + Message,

An integer that can be used as a table address in a hash table structure.

fn isKindOfClass(&self, cls: &AnyClass) -> bool

where Self: Sized + Message,

Check if the object is an instance of the class, or one of its subclasses.

fn is_kind_of<T>(&self) -> bool

where T: ClassType, Self: Sized + Message,

👎Deprecated: use isKindOfClass directly, or cast your objects with AnyObject::downcast_ref

Check if the object is an instance of the class type, or one of its subclasses.

fn isMemberOfClass(&self, cls: &AnyClass) -> bool

where Self: Sized + Message,

Check if the object is an instance of a specific class, without checking subclasses.

fn respondsToSelector(&self, aSelector: Sel) -> bool

where Self: Sized + Message,

Check whether the object implements or inherits a method with the given selector.

fn conformsToProtocol(&self, aProtocol: &AnyProtocol) -> bool

where Self: Sized + Message,

Check whether the object conforms to a given protocol.

fn description(&self) -> Retained<NSObject>

where Self: Sized + Message,

A textual representation of the object.

fn debugDescription(&self) -> Retained<NSObject>

where Self: Sized + Message,

A textual representation of the object to use when debugging.

fn isProxy(&self) -> bool

where Self: Sized + Message,

Check whether the receiver is a subclass of the NSProxy root class instead of the usual NSObject.

fn retainCount(&self) -> usize

where Self: Sized + Message,

The reference count of the object.

impl PartialEq for MFMailComposeViewController

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RefEncode for MFMailComposeViewController

const ENCODING_REF: Encoding = <UINavigationController as ::objc2::RefEncode>::ENCODING_REF

The Objective-C type-encoding for a reference of this type.

impl UIContentContainer for MFMailComposeViewController

unsafe fn preferredContentSizeDidChangeForChildContentContainer( &self, container: &ProtocolObject<dyn UIContentContainer>, )

where Self: Sized + Message,

unsafe fn systemLayoutFittingSizeDidChangeForChildContentContainer( &self, container: &ProtocolObject<dyn UIContentContainer>, )

where Self: Sized + Message,

impl UIFocusEnvironment for MFMailComposeViewController

unsafe fn preferredFocusEnvironments( &self, ) -> Retained<NSArray<ProtocolObject<dyn UIFocusEnvironment>>>

where Self: Sized + Message,

The preferred focus environments define where to search for the default focused item in an environment, such as when focus updates programmatically. Starting from the target environment, each preferred focus environment is recursively searched in the order of the array until an eligible, focusable item is found. Preferred focus environments can include focusable and non-focusable items, in addition to non-item environments. Returning an empty array is equivalent to returning an array containing only ‘self’.

unsafe fn parentFocusEnvironment( &self, ) -> Option<Retained<ProtocolObject<dyn UIFocusEnvironment>>>

where Self: Sized + Message,

The parent focus environment of this environment, or nil if no parent exists. NOTE: If you implement this method, you must return a non-nil value for parent focus environment, otherwise your focus environment will not participate in focus interactions.

unsafe fn focusItemContainer( &self, ) -> Option<Retained<ProtocolObject<dyn UIFocusItemContainer>>>

where Self: Sized + Message,

The container of any child focus items in this focus environment, or nil if no container exists.

unsafe fn setNeedsFocusUpdate(&self)

where Self: Sized + Message,

Marks this environment as needing a focus update, which if accepted will attempt to reset focus to this environment, or one of its preferred focus environments, on the next update cycle. If this environment does not currently contain the focused item, then calling this method has no effect. If a parent of this environment is also requesting focus, then this environment’s request is rejected in favor of the parent’s. NOTE: If you provide your own implementation, it must call [[UIFocusSystem focusSystemForEnvironment:self] requestFocusUpdateToEnvironment:self];

unsafe fn updateFocusIfNeeded(&self)

where Self: Sized + Message,

Forces focus to be updated immediately. If there is an environment that has requested a focus update via -setNeedsFocusUpdate, and the request was accepted, then focus will be updated to that environment or one of its preferred focus environments. NOTE: If you provide your own implementation, it must call [[UIFocusSystem focusSystemForEnvironment:self] updateFocusIfNeeded];.

unsafe fn shouldUpdateFocusInContext( &self, context: &UIFocusUpdateContext, ) -> bool

where Self: Sized + Message,

Asks whether the system should allow a focus update to occur.

unsafe fn soundIdentifierForFocusUpdateInContext( &self, context: &UIFocusUpdateContext, ) -> Option<Retained<NSString>>

where Self: Sized + Message,

Specifies an identifier corresponding to a sound that should be played for a focus update. Return UIFocusSoundIdentifierNone to opt out of sounds, UIFocusSoundIdentifierDefault for the system default sounds, a previously registered identifier for a custom sound, or nil to defer the decision to the parent.

unsafe fn focusGroupIdentifier(&self) -> Option<Retained<NSString>>

where Self: Sized + Message,

The identifier of the focus group that this view belongs to. If this is nil, subviews inherit their superview’s focus group.

impl UIResponderStandardEditActions for MFMailComposeViewController

unsafe fn cut(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn copy(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn paste(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn pasteAndMatchStyle(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn pasteAndGo(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn pasteAndSearch(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn select(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn selectAll(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn delete(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn makeTextWritingDirectionLeftToRight(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn makeTextWritingDirectionRightToLeft(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn toggleBoldface(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn toggleItalics(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn toggleUnderline(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn increaseSize(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn decreaseSize(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn find(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn findAndReplace(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn findNext(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn findPrevious(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn useSelectionForFind(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn print(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn rename(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn duplicate(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn move(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn export(&self, sender: Option<&AnyObject>)

where Self: Sized + Message,

unsafe fn showWritingTools(&self, sender: &AnyObject)

where Self: Sized + Message,

impl UITraitEnvironment for MFMailComposeViewController

fn traitCollection(&self) -> Retained<UITraitCollection>

where Self: Sized + Message,

unsafe fn traitCollectionDidChange( &self, previous_trait_collection: Option<&UITraitCollection>, )

where Self: Sized + Message,

👎Deprecated: Use the trait change registration APIs declared in the UITraitChangeObservable protocol

To be overridden as needed to provide custom behavior when the environment’s traits change.

impl DowncastTarget for MFMailComposeViewController

impl Eq for MFMailComposeViewController

impl UIAppearanceContainer for MFMailComposeViewController