Functions

Authors

Generated by Richard Frith-Macdonald

Contents -

DPSOperators functions
NSAccessibilityConstants functions
NSAccessibility functions
NSApplication functions
NSDataLinkManager functions
NSEvent functions
NSFont functions
NSGraphicsContext functions
NSGraphics functions
NSInterfaceStyle functions
NSKeyValueBinding functions
NSPanel functions
NSPasteboard functions
NSSound functions
NSView functions
PSOperators functions
NSAlert macros
NSBezierPath macros
NSController macros
NSDockTile macros
NSDrawer macros
NSEPSImageRep macros
NSImageView macros
NSInputManager macros
NSInputServer macros
NSTextAttachment macros
NSTextContainer macros

Description forthcoming.

NSAccessibilityConstants functions

NSAccessibilityPostNotificationWithUserInfo

void NSAccessibilityPostNotificationWithUserInfo(id element, NSString* notification, NSDictionary* userInfo);

Availability: OpenStep

Description forthcoming.

NSPerformService

BOOL NSPerformService(NSString* serviceItem, NSPasteboard* pboard);

Availability: OpenStep

Given the name of a serviceItem, and some data in a pasteboard this function sends the data to the service provider (launching another application if necessary) and retrieves the result of the service in the pastebaord.

Returns YES on success, NO otherwise.

NSRegisterServicesProvider

void NSRegisterServicesProvider(id provider, NSString* name);

Availability: OpenStep

Registers a services providing object using the specified port name.
Applications should not need to use this, as they can use the [NSApplication -setServicesProvider:] method instead. The NSApplication method will use the name of the application rather than an other port name.

NSSetShowsServicesMenuItem

int NSSetShowsServicesMenuItem(NSString* name, BOOL enabled);

Availability: OpenStep

Controls whether the item name should be included in the services menu.

If enabled is YES then the services menu for each application will include the named item, if enabled is NO then the service will not be shown in application services menus.

Returns 0 if the setting is successfuly changed. Non-zero otherwise.

NSShowSystemInfoPanel

void NSShowSystemInfoPanel(NSDictionary* options);

Availability: OpenStep

Description forthcoming.

NSShowsServicesMenuItem

BOOL NSShowsServicesMenuItem(NSString* name);

Availability: OpenStep

Returns a flag indicating whether the named service is supposed to be displayed in application services menus.

NSUnRegisterServicesProvider

void NSUnRegisterServicesProvider(NSString* name);

Availability: OpenStep

Description forthcoming.

NSUpdateDynamicServices

void NSUpdateDynamicServices();

NSInterfaceStyleForKey

NSInterfaceStyle NSInterfaceStyleForKey(NSString* key, NSResponder* responder);

Availability: MacOS-X 10.0.0

Returns the interface style the responder should use, which affects how a UI element (such as a button or menu) is displayed. If the responder has an interface style set, the key is ignored and the responder's interface style is returned. Otherwise the style associated with the key is returned (if set), otherwise the default style is returned. In no case will the style NSNoInterfaceStyle be returned.

Styles can be set using the user defaults system. Currently available styles are

NSNextStepInterfaceStyle
NSMacintoshInterfaceStyle
NSWindows95InterfaceStyle
GSWindowMakerInterfaceStyle

You can set a default style for all UI elements using the NSInterfaceStyleDefault key:

   defaults write NSGlobalDomain NSInterfaceStyleDefault GSWindowMakerInterfaceStyle

NSKeyValueBinding functions

NSIsControllerMarker

BOOL NSIsControllerMarker(id object);

NSCreateFileContentsPboardType

NSString* NSCreateFileContentsPboardType(NSString* fileType);

Availability: OpenStep

Returns a standardised pasteboard type for file contents, formed from the supplied file extension.

Data written to a pasteboard with a file contents type should be written using the [NSPasteboard -writeFileContents:] or [NSPasteboard -writeFileWrapper:] method. Similarly, the data should be read using the [NSPasteboard -readFileContentsType:toFile:] or [NSPasteboard -readFileWrapper] method.

NSCreateFilenamePboardType

NSString* NSCreateFilenamePboardType(NSString* fileType);

Availability: OpenStep

Returns a standardised pasteboard type for file names, formed from the supplied file extension.

Data written to a pasteboard with a file names type should be a single name written using [NSPasteboard -setString:forType:] or an array of strings written using [NSPasteboard -setPropertyList:forType:] .
Similarly, the data should be read using the [NSPasteboard -stringForType:] or [NSPasteboard -propertyListForType:] method.

See also the NSGetFileType() and NSGetFileTypes() functions.

NSGetFileType

NSString* NSGetFileType(NSString* pboardType);

Availability: OpenStep

Returns the file type (fileType extension) corresponding to the pasteboard type given.
This is a counterpart to the NSCreateFilenamePboardType() function.

NSGetFileTypes

NSArray* NSGetFileTypes(NSArray* pboardTypes);

Availability: OpenStep

Returns the file types (filename extensions) corresponding to the pasteboard types given.

NSSound functions

PlaybackDeviceIdentifiers

NSArray* PlaybackDeviceIdentifiers();

Availability: OpenStep

Function used to retrieve all available playback devices.

This function is the only way to retrieve possible playback device identifiers understood by [NSSound -setPlaybackDeviceIdentifier:].

NSView functions

GSGetDragTypes

NSArray* GSGetDragTypes(NSView* aView);

If the region defined by a text container can change dynamically, the text container should call [GSLayoutManager -textContainerChangedGeometry:] whenever this happens.