Application Kit Data Types Reference

Overview

This document describes the data types defined in the Application Kit framework and not described in a document for an individual class.

Data Types

NSAnimationEffect

This type defines the standard system animation effects, which include both display and sound.

typedef enum _NSAnimationEffect {
   NSAnimationEffectDisappearingItemDefault = 0,
   NSAnimationEffectPoof = 10
} NSAnimationEffect;

Constants

NSAnimationEffectDisappearingItemDefault

The default effect.

Available in OS X v10.3 and later.

Declared in NSGraphics.h.

NSAnimationEffectPoof

An effect showing a puff of smoke.

Available in OS X v10.3 and later.

Declared in NSGraphics.h.

NSBrowserAuxiliaryOpaque

A private data structure used internally by NSBrowser.

typedef struct NSBrowserAuxiliary NSBrowserAuxiliaryOpaque;

NSColorListAuxiliaryOpaque

A private data structure used internally by NSColorList.

typedef struct NSColorListAuxiliary NSColorListAuxiliaryOpaque;

NSFocusRingPlacement

The focus ring style indicates how the focus ring will be drawn.

typedef enum {
   NSFocusRingOnly  = 0,
   NSFocusRingBelow = 1,
   NSFocusRingAbove = 2
} NSFocusRingPlacement;

Constants

NSFocusRingAbove

Use NSFocusRingAbove to draw over an image.

Fill a shape to add the focus ring around the shape.

Available in OS X v10.1 and later.

Declared in NSGraphics.h.

NSFocusRingBelow

Use NSFocusRingBelow to draw the focus ring under text.

Available in OS X v10.1 and later.

Declared in NSGraphics.h.

NSFocusRingOnly

Use NSFocusRingOnly if you don’t have an image or text.

Available in OS X v10.1 and later.

Declared in NSGraphics.h.

NSFocusRingType

The focus ring type is used by NSView and NSCell to configure if and how a control should draw its focus ring.

typedef enum _NSFocusRingType {
   NSFocusRingTypeDefault  = 0,
   NSFocusRingTypeNone     = 1,
   NSFocusRingTypeExterior = 2
} NSFocusRingType;

Constants

NSFocusRingTypeDefault

The default focus ring type for NSView or NSCell.

Available in OS X v10.3 and later.

Declared in NSGraphics.h.

NSFocusRingTypeNone

No focus ring. If you set the focus ring type to this value, NSView and NSCell will not draw any focus ring.

Available in OS X v10.3 and later.

Declared in NSGraphics.h.

NSFocusRingTypeExterior

The standard Aqua focus ring.

Available in OS X v10.3 and later.

Declared in NSGraphics.h.

NSInterfaceStyle

These constants are used in NSResponder’s interfaceStyle method.

typedef enum {
   NSNoInterfaceStyle        = 0,
   NSNextStepInterfaceStyle  = 1,
   NSWindows95InterfaceStyle = 2,
   NSMacintoshInterfaceStyle = 3
} NSInterfaceStyle;

Constants

NSNoInterfaceStyle

The default interface style.

Available in OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSNextStepInterfaceStyle

The NextStep interface style.

Available in OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSWindows95InterfaceStyle

The Windows 95 interface style.

Available in OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSMacintoshInterfaceStyle

The Macintosh interface style.

Available in OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSModalSession

Variables of type NSModalSession point to information used by the system between NSApplication’s beginModalSessionForWindow: and endModalSession: messages.

typedef struct _NSModalSession *NSModalSession;

NSOpenGLContextAuxiliary

A private data structure used by NSOpenGLContext.

typedef struct _CGLContextObject NSOpenGLContextAuxiliary;

NSOpenGLGlobalOption

These constants are option names for NSOpenGLSetOption and NSOpenGLGetOption.

typedef enum {
   NSOpenGLGOFormatCacheSize  = 501,
   NSOpenGLGOClearFormatCache = 502,
   NSOpenGLGORetainRenderers  = 503,
   NSOpenGLGOResetLibrary     = 504
} NSOpenGLGlobalOption;

Constants

NSOpenGLGOFormatCacheSize

Sets the size of the pixel format cache.

Available in OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGOClearFormatCache

Resets the pixel format cache if true.

Available in OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGORetainRenderers

Whether to retain loaded renderers in memory.

Available in OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGOResetLibrary

Does a soft reset of the CGL library if true.

Available in OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLPixelFormatAuxiliary

A private data structure used by NSOpenGLPixelFormat.

typedef struct _CGLPixelFormatObject NSOpenGLPixelFormatAuxiliary;

NSSavePanelAuxiliaryOpaque

A private data structure used internally by NSSavePanel.

typedef struct NSSavePanelAuxiliary NSSavePanelAuxiliaryOpaque;

NSScreenAuxiliaryOpaque

A private data structure used internally by NSScreen.

typedef struct NSScreenAuxiliary NSScreenAuxiliaryOpaque;

NSTabViewItemAuxiliaryOpaque

A private data structure used by NSTabViewItem.

typedef struct NSTabViewItemAuxiliary NSTabViewItemAuxiliaryOpaque;

NSTypesetterGlyphInfo

This type is a caching structure used by NSSimpleHorizontalTypesetter.

typedef struct _NSTypesetterGlyphInfo {
      NSPoint curLocation;
      float extent;
      float belowBaseline;
      float aboveBaseline;
      unsigned glyphCharacterIndex;
      NSFont *font;
      NSSize attachmentSize;
      struct {
         BOOL defaultPositioning:1;
         BOOL dontShow:1;
         BOOL isAttachment:1;
   } _giflags;
} NSTypesetterGlyphInfo;

Fields

curLocation

Location (relative to the baseline) for laying this glyph out.

extent

Required space from curLocation to lay this glyph out; –1.0 if not set.

belowBaseline

Distance from baseline to bottom of the line fragment required for all the glyphs so far, including this one (positive if baseline is above the bottom of the line fragment).

aboveBaseline

Distance from baseline to top of the line fragment required for all the glyphs so far, including this one (positive if baseline is below the top of the line fragment).

glyphCharacterIndex

Character index.

font

Font.

attachmentSize

Size of the character if it’s an attachment; otherwise meaningless.

defaultPositioning

This block needs to be “show”ed.

dontShow

Don’t show this glyph.

isAttachment

Whether the glyph is an attachment.