Mac Developer Library

Developer

AppKit Framework Reference NSImageCell Class Reference

Options
Deployment Target:

On This Page
Language:

NSImageCell

An NSImageCell object displays a single image (encapsulated in an NSImage object) in a frame. This class provides methods for choosing the frame and for aligning and scaling the image to fit the frame. More...

Inheritance


  • NSObject
  • NSCell
  • NSImageCell
  • IOBluetoothAccessibilityIgnoredImageCell
  • NSObject
  • NSCell
  • NSImageCell
  • IOBluetoothAccessibilityIgnoredImageCell

Import Statement


import AppKit @import AppKit;

Availability


Available in OS X v10.0 and later.
  • Returns the alignment of the receiver’s image relative to its frame.

    Declaration

    Swift

    var imageAlignment: NSImageAlignment

    Objective-C

    @property NSImageAlignment imageAlignment

    Return Value

    One of the image alignment constants. For a list of possible values, see NSImageAlignment. The default value is NSImageAlignCenter.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the alignment of the image in its frame.

    Declaration

    Swift

    var imageAlignment: NSImageAlignment

    Objective-C

    @property NSImageAlignment imageAlignment

    Parameters

    alignment

    One of the image alignment constants. For a list of possible values, see NSImageAlignment.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the scaling mode used to fit the receiver's image into the frame.

    Declaration

    Swift

    var imageScaling: NSImageScaling

    Objective-C

    @property NSImageScaling imageScaling

    Return Value

    One of the image scaling constants. For a list of possible values, see NSImageScaling. The default value is NSImageScaleProportionallyDown.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the scaling mode used to fit the receiver's image into the frame.

    Declaration

    Swift

    var imageScaling: NSImageScaling

    Objective-C

    @property NSImageScaling imageScaling

    Parameters

    scaling

    One of the image scaling constants. For a list of possible values, see NSImageScaling.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • These constants allow you to specify the location of the image in the frame and are used by imageAlignment and setImageAlignment:.

    Declaration

    Swift

    enum NSImageAlignment : UInt { case AlignCenter case AlignTop case AlignTopLeft case AlignTopRight case AlignLeft case AlignBottom case AlignBottomLeft case AlignBottomRight case AlignRight }

    Objective-C

    enum { NSImageAlignCenter = 0, NSImageAlignTop, NSImageAlignTopLeft, NSImageAlignTopRight, NSImageAlignLeft, NSImageAlignBottom, NSImageAlignBottomLeft, NSImageAlignBottomRight, NSImageAlignRight }; typedef NSUInteger NSImageAlignment;

    Constants

    • AlignCenter

      NSImageAlignCenter

      Center the image in the cell.

      Available in OS X v10.0 and later.

    • AlignTop

      NSImageAlignTop

      Position the image along the top edge of the cell.

      Available in OS X v10.0 and later.

    • AlignTopLeft

      NSImageAlignTopLeft

      Align the image with the top and left edges of the cell.

      Available in OS X v10.0 and later.

    • AlignTopRight

      NSImageAlignTopRight

      Align the image with the top and right edges of the cell.

      Available in OS X v10.0 and later.

    • AlignLeft

      NSImageAlignLeft

      Align the image with the left edge of the cell.

      Available in OS X v10.0 and later.

    • AlignBottom

      NSImageAlignBottom

      Align the image with the bottom edge of the cell.

      Available in OS X v10.0 and later.

    • AlignBottomLeft

      NSImageAlignBottomLeft

      Align the image with the bottom and left edges of the cell.

      Available in OS X v10.0 and later.

    • AlignBottomRight

      NSImageAlignBottomRight

      Align the image with the bottom and right edges of the cell.

      Available in OS X v10.0 and later.

    • AlignRight

      NSImageAlignRight

      Position the image along the right edge of the cell.

      Available in OS X v10.0 and later.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • These constants allow you to specify the kind of frame bordering the image and are used by imageFrameStyle and setImageFrameStyle:. Note that some of these constants are stylistically obsolete and should be considered deprecated.

    Declaration

    Swift

    enum NSImageFrameStyle : UInt { case None case Photo case GrayBezel case Groove case Button }

    Objective-C

    enum { NSImageFrameNone = 0, NSImageFramePhoto, NSImageFrameGrayBezel, NSImageFrameGroove, NSImageFrameButton }; typedef NSUInteger NSImageFrameStyle;

    Constants

    • None

      NSImageFrameNone

      An invisible frame

      Available in OS X v10.0 and later.

    • Photo

      NSImageFramePhoto

      A thin black outline and a dropped shadow.

      This constant is stylistically obsolete and should be considered deprecated.

      Available in OS X v10.0 and later.

    • GrayBezel

      NSImageFrameGrayBezel

      A gray, concave bezel that makes the image look sunken.

      Available in OS X v10.0 and later.

    • Groove

      NSImageFrameGroove

      A thin groove that looks etched around the image.

      This constant is stylistically obsolete and should be considered deprecated.

      Available in OS X v10.0 and later.

    • Button

      NSImageFrameButton

      A convex bezel that makes the image stand out in relief, like a button.

      This constant is stylistically obsolete and should be considered deprecated.

      Available in OS X v10.0 and later.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.