Struct MSMessagesAppViewController 

pub struct MSMessagesAppViewController { /* private fields */ }

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

Apple’s documentation

Implementations

impl MSMessagesAppViewController

pub unsafe fn activeConversation(&self) -> Option<Retained<MSConversation>>

Available on crate feature MSConversation only.

Current active conversation.

pub unsafe fn presentationStyle(&self) -> MSMessagesAppPresentationStyle

Get the presentation extension’s current presentation style.

pub unsafe fn presentationContext(&self) -> MSMessagesAppPresentationContext

The context for which the extension was launched

pub unsafe fn requestPresentationStyle( &self, presentation_style: MSMessagesAppPresentationStyle, )

Requests that Messages transition the extension to the specified presentation style.

When the current presentationStyle is MSMessagesAppPresentationStyleTranscript, a new instance of MSMessagesAppViewController will be instantiated with the requested presentation style if needed.

Parameter presentationStyle: The presentation style to transition to. MSMessagesAppPresentationStyleTranscript is not a valid presentation style to request.

pub unsafe fn willBecomeActiveWithConversation( &self, conversation: &MSConversation, )

Available on crate feature MSConversation only.

Called when the extension is about to become active.

Parameter conversation: The current conversation.

pub unsafe fn didBecomeActiveWithConversation( &self, conversation: &MSConversation, )

Available on crate feature MSConversation only.

Called when the extension has become active.

Parameter conversation: The current conversation.

pub unsafe fn willResignActiveWithConversation( &self, conversation: &MSConversation, )

Available on crate feature MSConversation only.

Called when the extension will resign active.

Parameter conversation: The current conversation.

pub unsafe fn didResignActiveWithConversation( &self, conversation: &MSConversation, )

Available on crate feature MSConversation only.

Called when the extension has resigned active.

Parameter conversation: The current conversation.

impl MSMessagesAppViewController

Methods declared on superclass UIViewController.

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>, coder: &NSCoder, ) -> Option<Retained<Self>>

Safety

coder possibly has further requirements.

impl MSMessagesAppViewController

Methods declared on superclass NSObject.

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

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

impl MSMessagesAppViewController

CompactOrExpandedPresentation.

pub unsafe fn dismiss(&self)

Tells Messages to dismiss the extension and present the keyboard.

Calling this method does nothing when the presentationStyle is MSMessagesAppPresentationStyleTranscript.

pub unsafe fn willSelectMessage_conversation( &self, message: &MSMessage, conversation: &MSConversation, )

Available on crate features MSConversation and MSMessage only.

Informs the extension that a new message will be selected in the conversation.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript or the presentationContext is MSMessagesAppPresentationContextMedia.

Parameter message: The message selected.

Parameter conversation: The conversation.

pub unsafe fn didSelectMessage_conversation( &self, message: &MSMessage, conversation: &MSConversation, )

Available on crate features MSConversation and MSMessage only.

Informs the extension that a new message has been selected in the conversation.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript or the presentationContext is MSMessagesAppPresentationContextMedia.

Parameter message: The message selected.

Parameter conversation: The conversation.

pub unsafe fn didReceiveMessage_conversation( &self, message: &MSMessage, conversation: &MSConversation, )

Available on crate features MSConversation and MSMessage only.

Informs the extension that a new message has arrived.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript or the presentationContext is MSMessagesAppPresentationContextMedia.

Parameter message: The message received.

Parameter conversation: The conversation.

pub unsafe fn didStartSendingMessage_conversation( &self, message: &MSMessage, conversation: &MSConversation, )

Available on crate features MSConversation and MSMessage only.

Informs the extension that the message send has been triggered.

This is called when a user interaction with Messages start the message send process. It does not guarantee the message will be successfully sent or delivered. This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript or the presentationContext is MSMessagesAppPresentationContextMedia.

Parameter message: The message being sent.

Parameter conversation: The conversation the message belongs to.

pub unsafe fn didCancelSendingMessage_conversation( &self, message: &MSMessage, conversation: &MSConversation, )

Available on crate features MSConversation and MSMessage only.

Informs the extension that the user has removed the message from the input field.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript or the presentationContext is MSMessagesAppPresentationContextMedia.

Parameter message: The message sent.

Parameter conversation: The conversation.

pub unsafe fn willTransitionToPresentationStyle( &self, presentation_style: MSMessagesAppPresentationStyle, )

Called when the extension is about to transition to a new presentation style.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript.

Parameter presentationStyle: The new presentation style.

pub unsafe fn didTransitionToPresentationStyle( &self, presentation_style: MSMessagesAppPresentationStyle, )

Called when the extension finished transitioning to a presentation style.

This method will not be called when the presentationStyle is MSMessagesAppPresentationStyleTranscript.

Parameter presentationStyle: The new presentation style.

Methods from Deref<Target = UIViewController>

pub fn view(&self) -> Option<Retained<UIView>>

pub fn setView(&self, view: Option<&UIView>)

Setter for view.

pub fn loadView(&self)

pub fn loadViewIfNeeded(&self)

pub fn viewIfLoaded(&self) -> Option<Retained<UIView>>

pub fn viewWillUnload(&self)

👎Deprecated

pub fn viewDidUnload(&self)

👎Deprecated

pub fn viewDidLoad(&self)

pub fn isViewLoaded(&self) -> bool

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

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

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

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

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.

Safety

sender should be of the correct type.

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.

Safety

sender should be of the correct type.

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.

Safety

• action must be a valid selector.
• sender should be of the correct type.

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

👎Deprecated

Safety

• action must be a valid selector.
• sender should be of the correct type.

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

👎Deprecated

Safety

• action must be a valid selector.
• sender should be of the correct type.

pub fn viewWillAppear(&self, animated: bool)

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 fn viewIsAppearing(&self, animated: bool)

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 fn viewDidAppear(&self, animated: bool)

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

pub fn viewWillDisappear(&self, animated: bool)

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

pub fn viewDidDisappear(&self, animated: bool)

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

pub fn setNeedsUpdateProperties(&self)

Call to manually request a properties update for the view controller. Multiple requests may be coalesced into a single update alongside the next layout pass.

pub fn updateProperties(&self)

Override point for subclasses to update properties of this view controller or its view. Never call this method directly; use setNeedsUpdateProperties to schedule an update.

pub fn updatePropertiesIfNeeded(&self)

Forces an immediate properties update for this view controller and its view, including any view controllers and views in this subtree.

pub fn viewWillLayoutSubviews(&self)

pub fn viewDidLayoutSubviews(&self)

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

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

Setter for title.

This is copied when set.

pub fn didReceiveMemoryWarning(&self)

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

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

👎Deprecated

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

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

pub fn definesPresentationContext(&self) -> bool

pub fn setDefinesPresentationContext(&self, defines_presentation_context: bool)

Setter for definesPresentationContext.

pub fn providesPresentationContextTransitionStyle(&self) -> bool

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

Setter for providesPresentationContextTransitionStyle.

pub fn restoresFocusAfterTransition(&self) -> bool

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

Setter for restoresFocusAfterTransition.

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

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 fn setFocusGroupIdentifier(&self, focus_group_identifier: Option<&NSString>)

Setter for focusGroupIdentifier.

This is copied when set.

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

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

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

Setter for interactionActivityTrackingBaseName.

This is copied when set.

pub fn isBeingPresented(&self) -> bool

pub fn isBeingDismissed(&self) -> bool

pub fn isMovingToParentViewController(&self) -> bool

pub fn isMovingFromParentViewController(&self) -> bool

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

👎Deprecated

pub fn dismissModalViewControllerAnimated(&self, animated: bool)

👎Deprecated

pub fn modalTransitionStyle(&self) -> UIModalTransitionStyle

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

Setter for modalTransitionStyle.

pub fn modalPresentationStyle(&self) -> UIModalPresentationStyle

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

Setter for modalPresentationStyle.

pub fn modalPresentationCapturesStatusBarAppearance(&self) -> bool

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

Setter for modalPresentationCapturesStatusBarAppearance.

pub fn disablesAutomaticKeyboardDismissal(&self) -> bool

pub fn wantsFullScreenLayout(&self) -> bool

👎Deprecated

pub fn setWantsFullScreenLayout(&self, wants_full_screen_layout: bool)

👎Deprecated

Setter for wantsFullScreenLayout.

pub fn edgesForExtendedLayout(&self) -> UIRectEdge

pub fn setEdgesForExtendedLayout(&self, edges_for_extended_layout: UIRectEdge)

Setter for edgesForExtendedLayout.

pub fn extendedLayoutIncludesOpaqueBars(&self) -> bool

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

Setter for extendedLayoutIncludesOpaqueBars.

pub fn automaticallyAdjustsScrollViewInsets(&self) -> bool

👎Deprecated: Use UIScrollView’s contentInsetAdjustmentBehavior instead

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

👎Deprecated: Use UIScrollView’s contentInsetAdjustmentBehavior instead

Setter for automaticallyAdjustsScrollViewInsets.

pub fn preferredContentSize(&self) -> CGSize

pub fn setPreferredContentSize(&self, preferred_content_size: CGSize)

Setter for preferredContentSize.

pub fn prefersStatusBarHidden(&self) -> bool

👎Deprecated: Has no effect on visionOS

pub fn setNeedsStatusBarAppearanceUpdate(&self)

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

Safety

• action must be a valid selector.
• sender should be of the correct type.

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

Safety

sender should be of the correct type.

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

Safety

sender should be of the correct type.

pub fn setNeedsUserInterfaceAppearanceUpdate(&self)

pub fn shouldAutorotate(&self) -> bool

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

pub fn setNeedsUpdateOfSupportedInterfaceOrientations(&self)

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 fn rotatingHeaderView(&self) -> Option<Retained<UIView>>

👎Deprecated: Header views are animated along with the rest of the view hierarchy

pub fn rotatingFooterView(&self) -> Option<Retained<UIView>>

👎Deprecated: Footer views are animated along with the rest of the view hierarchy

pub fn isEditing(&self) -> bool

pub fn setEditing(&self, editing: bool)

Setter for isEditing.

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

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

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

pub fn removeFromParentViewController(&self)

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

pub fn endAppearanceTransition(&self)

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

👎Deprecated: Has no effect on visionOS

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

👎Deprecated: Has no effect on visionOS

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

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

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

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

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

pub fn automaticallyForwardAppearanceAndRotationMethodsToChildViewControllers( &self, ) -> bool

👎Deprecated

pub fn shouldAutomaticallyForwardRotationMethods(&self) -> bool

👎Deprecated: Manually forward viewWillTransitionToSize:withTransitionCoordinator: if necessary

pub fn shouldAutomaticallyForwardAppearanceMethods(&self) -> bool

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

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

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

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

Setter for restorationIdentifier.

This is copied when set.

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

Safety

coder possibly has further requirements.

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

Safety

coder possibly has further requirements.

pub fn applicationFinishedRestoringState(&self)

pub fn updateViewConstraints(&self)

pub fn additionalSafeAreaInsets(&self) -> UIEdgeInsets

pub fn setAdditionalSafeAreaInsets( &self, additional_safe_area_insets: UIEdgeInsets, )

Setter for additionalSafeAreaInsets.

pub fn systemMinimumLayoutMargins(&self) -> NSDirectionalEdgeInsets

pub fn viewRespectsSystemMinimumLayoutMargins(&self) -> bool

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

Setter for viewRespectsSystemMinimumLayoutMargins.

pub fn viewLayoutMarginsDidChange(&self)

pub fn viewSafeAreaInsetsDidChange(&self)

pub fn performsActionsWhilePresentingModally(&self) -> bool

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 fn extensionContext(&self) -> Option<Retained<NSExtensionContext>>

pub fn isModalInPresentation(&self) -> bool

pub fn setModalInPresentation(&self, modal_in_presentation: bool)

Setter for isModalInPresentation.

pub fn registerForPreviewingWithDelegate_sourceView( &self, delegate: &ProtocolObject<dyn UIViewControllerPreviewingDelegate>, source_view: &UIView, ) -> Retained<ProtocolObject<dyn UIViewControllerPreviewing>>

👎Deprecated: UIViewControllerPreviewing is deprecated. Please use UIContextMenuInteraction.

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

👎Deprecated: UIViewControllerPreviewing is deprecated. Please use UIContextMenuInteraction.

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

pub fn preferredScreenEdgesDeferringSystemGestures(&self) -> UIRectEdge

pub fn setNeedsUpdateOfScreenEdgesDeferringSystemGestures(&self)

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

pub fn prefersHomeIndicatorAutoHidden(&self) -> bool

pub fn setNeedsUpdateOfHomeIndicatorAutoHidden(&self)

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

pub fn prefersPointerLocked(&self) -> bool

pub fn setNeedsUpdateOfPrefersPointerLocked(&self)

pub fn setNeedsUpdateContentUnavailableConfiguration(&self)

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 fn childViewControllerForInterfaceOrientationLock( &self, ) -> Option<Retained<UIViewController>>

Override to return a child view controller or nil. If non-nil, that view controller’s preference for interface orientation lock will be used. If nil, self is used. Whenever the return value changes, call setNeedsUpdateOfPrefersInterfaceOrientationLocked().

pub fn prefersInterfaceOrientationLocked(&self) -> bool

Whether this view controller prefers the scene’s interface orientation to be locked when shown. The default is NO. Note that this preference may or may not be honored. See UIWindowScene.Geometry for the current state of interface orientation lock.

pub fn setNeedsUpdateOfPrefersInterfaceOrientationLocked(&self)

Call whenever the view controller’s preference for interface orientation lock has changed

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

👎Deprecated: UIViewControllerPreviewing is deprecated. Please use UIContextMenuInteraction.

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

pub fn updateTraitsIfNeeded(&self)

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 fn preferredContainerBackgroundStyle(&self) -> UIContainerBackgroundStyle

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

pub fn setNeedsUpdateOfPreferredContainerBackgroundStyle(&self)

Methods from Deref<Target = UIResponder>

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

pub fn canBecomeFirstResponder(&self) -> bool

pub fn becomeFirstResponder(&self) -> bool

pub fn canResignFirstResponder(&self) -> bool

pub fn resignFirstResponder(&self) -> bool

pub fn isFirstResponder(&self) -> bool

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

Safety

• action must be a valid selector.
• sender should be of the correct type.

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

Safety

• action must be a valid selector.
• sender should be of the correct type.

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

pub fn editingInteractionConfiguration( &self, ) -> UIEditingInteractionConfiguration

pub fn inputView(&self) -> Option<Retained<UIView>>

pub fn inputAccessoryView(&self) -> Option<Retained<UIView>>

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

pub fn reloadInputViews(&self)

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

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

Setter for userActivity.

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

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

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

Safety

sender should be of the correct type.

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.

Panics

May panic if the object is invalid (which may be the case for objects returned from unavailable init/new methods).

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 MSMessagesAppViewController

fn as_ref(&self) -> &AnyObject

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

impl AsRef<MSMessagesAppViewController> for MSMessagesAppViewController

fn as_ref(&self) -> &Self

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

impl AsRef<NSObject> for MSMessagesAppViewController

fn as_ref(&self) -> &NSObject

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

impl AsRef<UIResponder> for MSMessagesAppViewController

fn as_ref(&self) -> &UIResponder

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

impl AsRef<UIViewController> for MSMessagesAppViewController

fn as_ref(&self) -> &UIViewController

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

impl Borrow<AnyObject> for MSMessagesAppViewController

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<NSObject> for MSMessagesAppViewController

fn borrow(&self) -> &NSObject

Immutably borrows from an owned value.

impl Borrow<UIResponder> for MSMessagesAppViewController

fn borrow(&self) -> &UIResponder

Immutably borrows from an owned value.

impl Borrow<UIViewController> for MSMessagesAppViewController

fn borrow(&self) -> &UIViewController

Immutably borrows from an owned value.

impl ClassType for MSMessagesAppViewController

const NAME: &'static str = "MSMessagesAppViewController"

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

type Super = UIViewController

The superclass of this class.

type ThreadKind = <<MSMessagesAppViewController 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 MSMessagesAppViewController

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

Formats the value using the given formatter.

impl Deref for MSMessagesAppViewController

type Target = UIViewController

The resulting type after dereferencing.

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

Dereferences the value.

impl Hash for MSMessagesAppViewController

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 MSMessagesAppTranscriptPresentation for MSMessagesAppViewController

unsafe fn contentSizeThatFits(&self, size: CGSize) -> CGSize

where Self: Sized + Message,

Available on crate feature objc2-core-foundation only.

The content size of the view controller’s view fitting the constraining size.

unsafe fn messageTintColor(&self) -> Option<Retained<UIColor>>

where Self: Sized + Message,

Available on crate feature objc2-ui-kit only.

Override to provide a message tint color, e.g. to match the content of the message, or your app’s brand color.

unsafe fn messageCornerRadius(&self) -> CGFloat

where Self: Sized + Message,

Available on crate feature objc2-core-foundation only.

The corner radius of the message when presented in the transcript. Use this value to create concentric rounded subviews inside your view. Use continuous corners (kCACornerCurveContinuous) on your view.

unsafe fn invalidateMessageTintColor(&self)

where Self: Sized + Message,

Call this when messageTintColor changes, e.g. due to change in app state or trait collection.

impl Message for MSMessagesAppViewController

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

where Self: Sized,

Increment the reference count of the receiver.

impl NSCoding for MSMessagesAppViewController

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

impl NSObjectProtocol for MSMessagesAppViewController

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 MSMessagesAppViewController

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 MSMessagesAppViewController

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

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

impl UIContentContainer for MSMessagesAppViewController

fn preferredContentSize(&self) -> CGSize

where Self: Sized + Message,

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

where Self: Sized + Message,

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

where Self: Sized + Message,

fn sizeForChildContentContainer_withParentContainerSize( &self, container: &ProtocolObject<dyn UIContentContainer>, parent_size: CGSize, ) -> CGSize

where Self: Sized + Message,

impl UIFocusEnvironment for MSMessagesAppViewController

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’.

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.

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.

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];

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];.

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

where Self: Sized + Message,

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

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.

fn preferredFocusedView(&self) -> Option<Retained<UIView>>

where Self: Sized + Message,

👎Deprecated

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 MSMessagesAppViewController

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

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

where Self: Sized + Message,

Safety

impl UITraitEnvironment for MSMessagesAppViewController

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

where Self: Sized + Message,

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 MSMessagesAppViewController

impl Eq for MSMessagesAppViewController

impl UIAppearanceContainer for MSMessagesAppViewController