Struct NSVisualEffectViewTagged

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

A custom NSVisualEffectView subclass that overrides the tag method to provide a custom tag, to later identify the view

Implementations

impl NSVisualEffectViewTagged

pub unsafe fn initWithFrame( this: Allocated<Self>, frame_rect: NSRect, tag: NSInteger, ) -> Retained<Self>

Safety

This method is unsafe because it calls an Objective-C method.

pub unsafe fn setMaterial(&self, material: NSVisualEffectMaterial)

https://developer.apple.com/documentation/appkit/nsvisualeffectview/material-swift.property

Safety

This method is unsafe because it calls an Objective-C method.

pub unsafe fn setBlendingMode(&self, blending_mode: NSVisualEffectBlendingMode)

https://developer.apple.com/documentation/appkit/nsvisualeffectview/blendingmode-swift.property

Safety

This method is unsafe because it calls an Objective-C method.

pub unsafe fn setState(&self, state: NSVisualEffectState)

https://developer.apple.com/documentation/appkit/nsvisualeffectview/state-swift.property

Safety

This method is unsafe because it calls an Objective-C method.

pub unsafe fn setAutoresizingMask(&self, mask: NSAutoresizingMaskOptions)

NSView inherited method https://developer.apple.com/documentation/appkit/nsview/autoresizingmask-swift.property

Safety

This method is unsafe because it calls an Objective-C method.

pub unsafe fn setCornerRadius(&self, radius: CGFloat)

TODO: Does not seem to be public? Method is not listed in Apple documentation, might be private, but it works

Safety

This method is unsafe because it calls an Objective-C method.

Methods from Deref<Target = NSVisualEffectView>

pub unsafe fn material(&self) -> NSVisualEffectMaterial

A value indicating which material is shown by the NSVisualEffectView. See the comments on NSVisualEffectMaterial. Defaults to NSVisualEffectMaterialAppearanceBased. You should instead specify an appropriate semantic material value. See the comments on NSVisualEffectMaterial.

pub unsafe fn setMaterial(&self, material: NSVisualEffectMaterial)

Setter for material.

pub unsafe fn blendingMode(&self) -> NSVisualEffectBlendingMode

A value controlling how the NSVisualEffectView generates its material. See the comments on NSVisualEffectBlendingMode. Not all materials support both blending modes, so NSVisualEffectView may fall back to a more appropriate blending mode as needed. Defaults to NSVisualEffectBlendingModeBehindWindow.

pub unsafe fn setBlendingMode(&self, blending_mode: NSVisualEffectBlendingMode)

Setter for blendingMode.

pub unsafe fn state(&self) -> NSVisualEffectState

A value controlling when the NSVisualEffectView takes on the active look. See the comments on NSVisualEffectState. Defaults to NSVisualEffectStateFollowsWindowActiveState.

pub unsafe fn setState(&self, state: NSVisualEffectState)

Setter for state.

pub unsafe fn isEmphasized(&self) -> bool

When YES, the material takes on the emphasized look. Defaults to NO. Some, but not all, materials change their look when emphasized. This is used to indicate that an associated view has firstResponder status.

pub unsafe fn setEmphasized(&self, emphasized: bool)

Setter for isEmphasized.

pub unsafe fn viewDidMoveToWindow(&self)

Methods from Deref<Target = NSView>

pub unsafe fn superview(&self) -> Option<Retained<NSView>>

pub unsafe fn subviews(&self) -> Retained<NSArray<NSView>>

pub unsafe fn setSubviews(&self, subviews: &NSArray<NSView>)

Setter for subviews.

pub unsafe fn isDescendantOf(&self, view: &NSView) -> bool

pub unsafe fn ancestorSharedWithView( &self, view: &NSView, ) -> Option<Retained<NSView>>

pub unsafe fn opaqueAncestor(&self) -> Option<Retained<NSView>>

pub unsafe fn isHidden(&self) -> bool

pub fn setHidden(&self, hidden: bool)

Setter for isHidden.

pub unsafe fn isHiddenOrHasHiddenAncestor(&self) -> bool

pub unsafe fn getRectsBeingDrawn_count( &self, rects: *mut *const CGRect, count: *mut isize, )

pub unsafe fn needsToDrawRect(&self, rect: CGRect) -> bool

pub unsafe fn wantsDefaultClipping(&self) -> bool

pub unsafe fn viewDidHide(&self)

pub unsafe fn viewDidUnhide(&self)

pub unsafe fn addSubview(&self, view: &NSView)

pub unsafe fn addSubview_positioned_relativeTo( &self, view: &NSView, place: NSWindowOrderingMode, other_view: Option<&NSView>, )

pub unsafe fn sortSubviewsUsingFunction_context( &self, compare: unsafe extern "C-unwind" fn(_: NonNull<NSView>, _: NonNull<NSView>, _: *mut c_void) -> NSComparisonResult, context: *mut c_void, )

pub unsafe fn viewDidMoveToWindow(&self)

pub unsafe fn viewWillMoveToSuperview(&self, new_superview: Option<&NSView>)

pub unsafe fn viewDidMoveToSuperview(&self)

pub unsafe fn didAddSubview(&self, subview: &NSView)

pub unsafe fn willRemoveSubview(&self, subview: &NSView)

pub unsafe fn removeFromSuperview(&self)

pub unsafe fn replaceSubview_with(&self, old_view: &NSView, new_view: &NSView)

pub unsafe fn removeFromSuperviewWithoutNeedingDisplay(&self)

pub unsafe fn viewDidChangeBackingProperties(&self)

pub unsafe fn postsFrameChangedNotifications(&self) -> bool

pub fn setPostsFrameChangedNotifications( &self, posts_frame_changed_notifications: bool, )

Setter for postsFrameChangedNotifications.

pub unsafe fn resizeSubviewsWithOldSize(&self, old_size: CGSize)

pub unsafe fn resizeWithOldSuperviewSize(&self, old_size: CGSize)

pub unsafe fn autoresizesSubviews(&self) -> bool

pub unsafe fn setAutoresizesSubviews(&self, autoresizes_subviews: bool)

Setter for autoresizesSubviews.

pub unsafe fn autoresizingMask(&self) -> NSAutoresizingMaskOptions

pub unsafe fn setAutoresizingMask( &self, autoresizing_mask: NSAutoresizingMaskOptions, )

Setter for autoresizingMask.

pub unsafe fn setFrameOrigin(&self, new_origin: CGPoint)

pub unsafe fn setFrameSize(&self, new_size: CGSize)

pub fn frame(&self) -> CGRect

pub unsafe fn setFrame(&self, frame: CGRect)

Setter for frame.

pub unsafe fn setBoundsOrigin(&self, new_origin: CGPoint)

pub unsafe fn setBoundsSize(&self, new_size: CGSize)

pub unsafe fn translateOriginToPoint(&self, translation: CGPoint)

pub unsafe fn scaleUnitSquareToSize(&self, new_unit_size: CGSize)

pub fn bounds(&self) -> CGRect

pub unsafe fn setBounds(&self, bounds: CGRect)

Setter for bounds.

pub fn isFlipped(&self) -> bool

pub unsafe fn isRotatedFromBase(&self) -> bool

pub unsafe fn isRotatedOrScaledFromBase(&self) -> bool

pub unsafe fn isOpaque(&self) -> bool

pub fn convertPoint_fromView( &self, point: CGPoint, view: Option<&NSView>, ) -> CGPoint

pub unsafe fn convertPoint_toView( &self, point: CGPoint, view: Option<&NSView>, ) -> CGPoint

pub unsafe fn convertSize_fromView( &self, size: CGSize, view: Option<&NSView>, ) -> CGSize

pub unsafe fn convertSize_toView( &self, size: CGSize, view: Option<&NSView>, ) -> CGSize

pub unsafe fn convertRect_fromView( &self, rect: CGRect, view: Option<&NSView>, ) -> CGRect

pub fn convertRect_toView(&self, rect: CGRect, view: Option<&NSView>) -> CGRect

pub unsafe fn backingAlignedRect_options( &self, rect: CGRect, options: NSAlignmentOptions, ) -> CGRect

pub unsafe fn centerScanRect(&self, rect: CGRect) -> CGRect

pub unsafe fn convertPointToBacking(&self, point: CGPoint) -> CGPoint

pub unsafe fn convertPointFromBacking(&self, point: CGPoint) -> CGPoint

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

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

pub unsafe fn convertRectToBacking(&self, rect: CGRect) -> CGRect

pub unsafe fn convertRectFromBacking(&self, rect: CGRect) -> CGRect

pub unsafe fn convertPointToLayer(&self, point: CGPoint) -> CGPoint

pub unsafe fn convertPointFromLayer(&self, point: CGPoint) -> CGPoint

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

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

pub unsafe fn convertRectToLayer(&self, rect: CGRect) -> CGRect

pub unsafe fn convertRectFromLayer(&self, rect: CGRect) -> CGRect

pub unsafe fn canDrawConcurrently(&self) -> bool

pub unsafe fn setCanDrawConcurrently(&self, can_draw_concurrently: bool)

Setter for canDrawConcurrently.

pub unsafe fn canDraw(&self) -> bool

👎Deprecated: If a view needs display, -drawRect: or -updateLayer will be called automatically when the view is able to draw. To check whether a view is in a window, call -window. To check whether a view is hidden, call -isHiddenOrHasHiddenAncestor.

pub unsafe fn setNeedsDisplayInRect(&self, invalid_rect: CGRect)

pub unsafe fn needsDisplay(&self) -> bool

pub unsafe fn setNeedsDisplay(&self, needs_display: bool)

Setter for needsDisplay.

pub unsafe fn lockFocus(&self)

👎Deprecated: To draw, subclass NSView and implement -drawRect:; AppKit’s automatic deferred display mechanism will call -drawRect: as necessary to display the view.

pub unsafe fn unlockFocus(&self)

👎Deprecated: To draw, subclass NSView and implement -drawRect:; AppKit’s automatic deferred display mechanism will call -drawRect: as necessary to display the view.

pub unsafe fn lockFocusIfCanDraw(&self) -> bool

👎Deprecated: To draw, subclass NSView and implement -drawRect:; AppKit’s automatic deferred display mechanism will call -drawRect: as necessary to display the view.

pub fn visibleRect(&self) -> CGRect

The portion of the view that isn’t clipped by its superviews.

Visibility, as reflected by this property, doesn’t account for whether other view or window objects overlap the current view or whether the current view is installed in a window at all. This value of this property is NSZeroRect if the current view is effectively hidden.

During a printing operation, the visible rectangle is further clipped to the page being imaged.

pub unsafe fn display(&self)

pub unsafe fn displayIfNeeded(&self)

pub unsafe fn displayIfNeededIgnoringOpacity(&self)

pub unsafe fn displayRect(&self, rect: CGRect)

pub unsafe fn displayIfNeededInRect(&self, rect: CGRect)

pub unsafe fn displayRectIgnoringOpacity(&self, rect: CGRect)

pub unsafe fn displayIfNeededInRectIgnoringOpacity(&self, rect: CGRect)

pub unsafe fn drawRect(&self, dirty_rect: CGRect)

pub unsafe fn viewWillDraw(&self)

pub unsafe fn scrollPoint(&self, point: CGPoint)

pub unsafe fn scrollRectToVisible(&self, rect: CGRect) -> bool

pub unsafe fn adjustScroll(&self, new_visible: CGRect) -> CGRect

pub unsafe fn scrollRect_by(&self, rect: CGRect, delta: CGSize)

👎Deprecated: Use NSScrollView to achieve scrolling views.

pub unsafe fn translateRectsNeedingDisplayInRect_by( &self, clip_rect: CGRect, delta: CGSize, )

pub unsafe fn hitTest(&self, point: CGPoint) -> Option<Retained<NSView>>

pub unsafe fn mouse_inRect(&self, point: CGPoint, rect: CGRect) -> bool

pub unsafe fn viewWithTag(&self, tag: isize) -> Option<Retained<NSView>>

pub unsafe fn tag(&self) -> isize

pub unsafe fn needsPanelToBecomeKey(&self) -> bool

pub unsafe fn mouseDownCanMoveWindow(&self) -> bool

pub unsafe fn acceptsTouchEvents(&self) -> bool

👎Deprecated: Use allowedTouchTypes instead

pub unsafe fn setAcceptsTouchEvents(&self, accepts_touch_events: bool)

👎Deprecated: Use allowedTouchTypes instead

Setter for acceptsTouchEvents.

pub unsafe fn wantsRestingTouches(&self) -> bool

pub unsafe fn setWantsRestingTouches(&self, wants_resting_touches: bool)

Setter for wantsRestingTouches.

pub unsafe fn layerContentsRedrawPolicy( &self, ) -> NSViewLayerContentsRedrawPolicy

pub unsafe fn setLayerContentsRedrawPolicy( &self, layer_contents_redraw_policy: NSViewLayerContentsRedrawPolicy, )

Setter for layerContentsRedrawPolicy.

pub unsafe fn layerContentsPlacement(&self) -> NSViewLayerContentsPlacement

pub unsafe fn setLayerContentsPlacement( &self, layer_contents_placement: NSViewLayerContentsPlacement, )

Setter for layerContentsPlacement.

pub unsafe fn wantsLayer(&self) -> bool

pub fn setWantsLayer(&self, wants_layer: bool)

Setter for wantsLayer.

pub unsafe fn wantsUpdateLayer(&self) -> bool

pub unsafe fn updateLayer(&self)

pub unsafe fn canDrawSubviewsIntoLayer(&self) -> bool

pub unsafe fn setCanDrawSubviewsIntoLayer( &self, can_draw_subviews_into_layer: bool, )

Setter for canDrawSubviewsIntoLayer.

pub unsafe fn layoutSubtreeIfNeeded(&self)

pub unsafe fn layout(&self)

pub unsafe fn needsLayout(&self) -> bool

pub unsafe fn setNeedsLayout(&self, needs_layout: bool)

Setter for needsLayout.

pub unsafe fn layerUsesCoreImageFilters(&self) -> bool

pub unsafe fn setLayerUsesCoreImageFilters( &self, layer_uses_core_image_filters: bool, )

Setter for layerUsesCoreImageFilters.

pub unsafe fn clipsToBounds(&self) -> bool

pub unsafe fn setClipsToBounds(&self, clips_to_bounds: bool)

Setter for clipsToBounds.

pub unsafe fn postsBoundsChangedNotifications(&self) -> bool

pub unsafe fn setPostsBoundsChangedNotifications( &self, posts_bounds_changed_notifications: bool, )

Setter for postsBoundsChangedNotifications.

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

pub unsafe fn setToolTip(&self, tool_tip: Option<&NSString>)

Setter for toolTip.

pub unsafe fn addToolTipRect_owner_userData( &self, rect: CGRect, owner: &AnyObject, data: *mut c_void, ) -> isize

pub unsafe fn removeToolTip(&self, tag: isize)

pub unsafe fn removeAllToolTips(&self)

pub unsafe fn viewWillStartLiveResize(&self)

pub unsafe fn viewDidEndLiveResize(&self)

pub unsafe fn inLiveResize(&self) -> bool

pub unsafe fn preservesContentDuringLiveResize(&self) -> bool

pub unsafe fn rectPreservedDuringLiveResize(&self) -> CGRect

pub unsafe fn rectForSmartMagnificationAtPoint_inRect( &self, location: CGPoint, visible_rect: CGRect, ) -> CGRect

pub unsafe fn prepareForReuse(&self)

pub unsafe fn prepareContentInRect(&self, rect: CGRect)

pub unsafe fn preparedContentRect(&self) -> CGRect

pub unsafe fn setPreparedContentRect(&self, prepared_content_rect: CGRect)

Setter for preparedContentRect.

pub unsafe fn allowsVibrancy(&self) -> bool

pub unsafe fn viewDidChangeEffectiveAppearance(&self)

Override point for reacting to the effective appearance of the receiver changing. At this point effectiveAppearance property reflects the new appearance.

pub unsafe fn nextKeyView(&self) -> Option<Retained<NSView>>

pub unsafe fn setNextKeyView(&self, next_key_view: Option<&NSView>)

Setter for nextKeyView.

pub unsafe fn previousKeyView(&self) -> Option<Retained<NSView>>

pub unsafe fn nextValidKeyView(&self) -> Option<Retained<NSView>>

pub unsafe fn previousValidKeyView(&self) -> Option<Retained<NSView>>

pub unsafe fn canBecomeKeyView(&self) -> bool

pub unsafe fn setKeyboardFocusRingNeedsDisplayInRect(&self, rect: CGRect)

pub unsafe fn focusRingType(&self) -> NSFocusRingType

pub unsafe fn setFocusRingType(&self, focus_ring_type: NSFocusRingType)

Setter for focusRingType.

pub unsafe fn drawFocusRingMask(&self)

pub unsafe fn focusRingMaskBounds(&self) -> CGRect

pub unsafe fn noteFocusRingMaskChanged(&self)

pub unsafe fn dataWithEPSInsideRect(&self, rect: CGRect) -> Retained<NSData>

pub unsafe fn dataWithPDFInsideRect(&self, rect: CGRect) -> Retained<NSData>

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

pub unsafe fn knowsPageRange(&self, range: *mut NSRange) -> bool

pub unsafe fn rectForPage(&self, page: isize) -> CGRect

pub unsafe fn locationOfPrintRect(&self, rect: CGRect) -> CGPoint

pub unsafe fn drawPageBorderWithSize(&self, border_size: CGSize)

pub unsafe fn pageHeader(&self) -> Retained<NSAttributedString>

pub unsafe fn pageFooter(&self) -> Retained<NSAttributedString>

pub unsafe fn drawSheetBorderWithSize(&self, border_size: CGSize)

👎Deprecated: This is never invoked and the NSView implementation does nothing

• This method is obsolete. It will never be invoked from within AppKit, and NSView’s implementation of it does nothing. **

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

pub unsafe fn beginDocument(&self)

pub unsafe fn endDocument(&self)

pub unsafe fn beginPageInRect_atPlacement( &self, rect: CGRect, location: CGPoint, )

pub unsafe fn endPage(&self)

pub unsafe fn unregisterDraggedTypes(&self)

pub unsafe fn exitFullScreenModeWithOptions( &self, options: Option<&NSDictionary<NSString>>, )

pub unsafe fn isInFullScreenMode(&self) -> bool

pub unsafe fn showDefinitionForAttributedString_atPoint( &self, attr_string: Option<&NSAttributedString>, text_baseline_origin: CGPoint, )

pub unsafe fn isDrawingFindIndicator(&self) -> bool

pub unsafe fn safeAreaInsets(&self) -> NSEdgeInsets

pub unsafe fn additionalSafeAreaInsets(&self) -> NSEdgeInsets

pub unsafe fn setAdditionalSafeAreaInsets( &self, additional_safe_area_insets: NSEdgeInsets, )

Setter for additionalSafeAreaInsets.

pub unsafe fn safeAreaRect(&self) -> CGRect

pub unsafe fn updateTrackingAreas(&self)

pub unsafe fn discardCursorRects(&self)

pub unsafe fn resetCursorRects(&self)

pub unsafe fn addTrackingRect_owner_userData_assumeInside( &self, rect: CGRect, owner: &AnyObject, data: *mut c_void, flag: bool, ) -> isize

pub fn removeTrackingRect(&self, tag: isize)

pub unsafe fn convertPointToBase(&self, point: CGPoint) -> CGPoint

👎Deprecated

pub unsafe fn convertPointFromBase(&self, point: CGPoint) -> CGPoint

👎Deprecated

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

👎Deprecated

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

👎Deprecated

pub unsafe fn convertRectToBase(&self, rect: CGRect) -> CGRect

👎Deprecated

pub unsafe fn convertRectFromBase(&self, rect: CGRect) -> CGRect

👎Deprecated

pub unsafe fn performMnemonic(&self, string: &NSString) -> bool

👎Deprecated: This has always returned NO and had no effect on macOS

pub unsafe fn shouldDrawColor(&self) -> bool

👎Deprecated: This method no longer does anything

pub unsafe fn gState(&self) -> isize

👎Deprecated

pub unsafe fn allocateGState(&self)

👎Deprecated

pub unsafe fn setUpGState(&self)

👎Deprecated

pub unsafe fn renewGState(&self)

👎Deprecated

Methods from Deref<Target = NSResponder>

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

pub unsafe fn setNextResponder(&self, next_responder: Option<&NSResponder>)

Setter for nextResponder.

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

pub unsafe fn noResponderFor(&self, event_selector: Sel)

pub unsafe fn acceptsFirstResponder(&self) -> bool

pub unsafe fn becomeFirstResponder(&self) -> bool

pub unsafe fn resignFirstResponder(&self) -> bool

pub unsafe fn flushBufferedKeyEvents(&self)

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

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

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

pub unsafe fn presentError(&self, error: &NSError) -> bool

pub unsafe fn willPresentError(&self, error: &NSError) -> Retained<NSError>

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

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

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

pub unsafe fn performMnemonic(&self, string: &NSString) -> bool

👎Deprecated: This has always returned NO and had no effect on macOS

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 NSVisualEffectViewTagged

fn as_ref(&self) -> &AnyObject

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

impl AsRef<NSVisualEffectView> for NSVisualEffectViewTagged

fn as_ref(&self) -> &NSVisualEffectView

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

impl AsRef<NSVisualEffectViewTagged> for NSVisualEffectViewTagged

fn as_ref(&self) -> &Self

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

impl Borrow<AnyObject> for NSVisualEffectViewTagged

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<NSVisualEffectView> for NSVisualEffectViewTagged

fn borrow(&self) -> &NSVisualEffectView

Immutably borrows from an owned value.

impl ClassType for NSVisualEffectViewTagged

const NAME: &'static str = "NSVisualEffectViewTagged"

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

type Super = NSVisualEffectView

The superclass of this class.

type ThreadKind = <<NSVisualEffectViewTagged 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 DefinedClass for NSVisualEffectViewTagged

type Ivars = NSVisualEffectViewTaggedIvars

A type representing the instance variables that this class carries.

fn ivars(&self) -> &Self::Ivars

where Self: Sized,

Get a reference to the instance variable data that this object carries.

impl Deref for NSVisualEffectViewTagged

type Target = NSVisualEffectView

The resulting type after dereferencing.

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

Dereferences the value.

impl Message for NSVisualEffectViewTagged

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

where Self: Sized,

Increment the reference count of the receiver.

impl RefEncode for NSVisualEffectViewTagged

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

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

impl DowncastTarget for NSVisualEffectViewTagged