Next Page > Hide TOC

Application Kit Data Types Reference

Framework
AppKit/AppKit.h
Declared in
NSApplication.h
NSBrowser.h
NSColorList.h
NSGraphics.h
NSInterfaceStyle.h
NSOpenGL.h
NSSavePanel.h
NSScreen.h
NSSimpleHorizontalTypesetter.h
NSTabViewItem.h

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 Mac OS X v10.3 and later.

Declared in NSGraphics.h.

NSAnimationEffectPoof

An effect showing a puff of smoke.

Available in Mac OS X v10.3 and later.

Declared in NSGraphics.h.

Discussion

These effects are used to indicate that an item was removed from a collection, such as a toolbar, without deleting the underlying data. See NSShowAnimationEffect.

Availability
Declared In
NSGraphics.h

NSBrowserAuxiliaryOpaque

A private data structure used internally by NSBrowser.

typedef struct NSBrowserAuxiliary NSBrowserAuxiliaryOpaque;

Availability
Declared In
NSBrowser.h

NSColorListAuxiliaryOpaque

A private data structure used internally by NSColorList.

typedef struct NSColorListAuxiliary NSColorListAuxiliaryOpaque;

Availability
Declared In
NSColorList.h

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 Mac OS X v10.1 and later.

Declared in NSGraphics.h.

NSFocusRingBelow

Use NSFocusRingBelow to draw the focus ring under text.

Available in Mac OS X v10.1 and later.

Declared in NSGraphics.h.

NSFocusRingOnly

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

Available in Mac OS X v10.1 and later.

Declared in NSGraphics.h.

Availability
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 Mac 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 Mac OS X v10.3 and later.

Declared in NSGraphics.h.

NSFocusRingTypeExterior

The standard Aqua focus ring.

Available in Mac OS X v10.3 and later.

Declared in NSGraphics.h.

Availability
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 Mac OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSNextStepInterfaceStyle

The NextStep interface style.

Available in Mac OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSWindows95InterfaceStyle

The Windows 95 interface style.

Available in Mac OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

NSMacintoshInterfaceStyle

The Macintosh interface style.

Available in Mac OS X v10.0 and later.

Declared in NSInterfaceStyle.h.

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

Availability
Declared In
NSApplication.h

NSOpenGLContextAuxiliary

A private data structure used by NSOpenGLContext.

typedef struct _CGLContextObject NSOpenGLContextAuxiliary;

Availability
Declared In
NSOpenGL.h

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 Mac OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGOClearFormatCache

Resets the pixel format cache if true.

Available in Mac OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGORetainRenderers

Whether to retain loaded renderers in memory.

Available in Mac OS X v10.0 and later.

Declared in NSOpenGL.h.

NSOpenGLGOResetLibrary

Does a soft reset of the CGL library if true.

Available in Mac OS X v10.0 and later.

Declared in NSOpenGL.h.

Availability
Declared In
NSOpenGL.h

NSOpenGLPixelFormatAuxiliary

A private data structure used by NSOpenGLPixelFormat.

typedef struct _CGLPixelFormatObject NSOpenGLPixelFormatAuxiliary;

Availability
Declared In
NSOpenGL.h

NSSavePanelAuxiliaryOpaque

A private data structure used internally by NSSavePanel.

typedef struct NSSavePanelAuxiliary NSSavePanelAuxiliaryOpaque;

Availability
Declared In
NSSavePanel.h

NSScreenAuxiliaryOpaque

A private data structure used internally by NSScreen.

typedef struct NSScreenAuxiliary NSScreenAuxiliaryOpaque;

Availability
Declared In
NSScreen.h

NSTabViewItemAuxiliaryOpaque

A private data structure used by NSTabViewItem.

typedef struct NSTabViewItemAuxiliary NSTabViewItemAuxiliaryOpaque;

Availability
Declared In
NSTabViewItem.h

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.

Availability
Declared In
NSSimpleHorizontalTypesetter.h

Next Page > Hide TOC


© 2006 Apple Computer, Inc. All Rights Reserved. (Last updated: 2006-05-23)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.