Up

# Functions

### Authors

Generated by root

### Contents -

1. NSApplication functions
2. NSDataLinkManager functions
3. NSEvent functions
4. NSFont functions
5. NSGraphicsContext functions
6. NSInterfaceStyle functions
7. NSPanel functions
8. NSPasteboard functions
9. NSSound functions
10. NSView functions

# NSApplication functions

### GSContactApplication

id GSContactApplication(NSString* appName, NSString* port, NSDate* expire);
Availability: Not in OpenStep/MacOS-X

Establishes an NSConnection to the application listening at port (by convention usually the application name), launching appName if necessary. Returns the proxy to the remote application, or `nil` on failure.

The value of port specifies the name of the distributed objects service to which the connection is to be made. If this is `nil` it will be inferred from appName... by convention, applications use their own name (minus any path or extension) for this.

If appName is `nil` or cannot be launched, this attempts to locate any application in a standard location whose name matches port and launch that application.

The value of expire provides a timeout in case the application cannot be contacted promptly. If it is omitted, a thirty second timeout is used.

### NSApplicationMain

int NSApplicationMain(int argc, const char** argv);
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();
Availability: OpenStep
A services providing application may use this to update the list of services it provides.
In order to update the services advertised, the application must create a .service bundle and place it in `~/Library/Services` before invoking this function.

# NSDataLinkManager functions

### NSFrameLinkRect

void NSFrameLinkRect(NSRect aRect, BOOL isDestination);
Availability: OpenStep
Description forthcoming.

### NSLinkFrameThickness

float NSLinkFrameThickness();
Availability: OpenStep
Description forthcoming.

# NSEvent functions

### NSEventMaskFromType

NSUInteger NSEventMaskFromType(NSEventType type);
Availability: OpenStep
Description forthcoming.

# NSFont functions

### NSConvertGlyphsToPackedGlyphs

int NSConvertGlyphsToPackedGlyphs(NSGlyph* glBuf, int count, NSMultibyteGlyphPacking packing, char* packedGlyphs);
Availability: MacOS-X 10.0.0
Description forthcoming.

# NSGraphicsContext functions

### GSCurrentContext

NSGraphicsContext* GSCurrentContext();
Availability: OpenStep
Description forthcoming.

# NSInterfaceStyle functions

### 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

# NSPanel functions

### GSRunExceptionPanel

NSInteger GSRunExceptionPanel(NSString* title, NSException* exception, NSString* defaultButton, NSString* alternateButton, NSString* otherButton);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSBeginAlertSheet

void NSBeginAlertSheet(NSString* title, NSString* defaultButton, NSString* alternateButton, NSString* otherButton, NSWindow* docWindow, id modalDelegate, SEL willEndSelector, SEL didEndSelector, void* contextInfo, NSString* msg,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSBeginCriticalAlertSheet

void NSBeginCriticalAlertSheet(NSString* title, NSString* defaultButton, NSString* alternateButton, NSString* otherButton, NSWindow* docWindow, id modalDelegate, SEL willEndSelector, SEL didEndSelector, void* contextInfo, NSString* msg,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSBeginInformationalAlertSheet

void NSBeginInformationalAlertSheet(NSString* title, NSString* defaultButton, NSString* alternateButton, NSString* otherButton, NSWindow* docWindow, id modalDelegate, SEL willEndSelector, SEL didEndSelector, void* contextInfo, NSString* msg,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSGetAlertPanel

id NSGetAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: OpenStep
Description forthcoming.

### NSGetCriticalAlertPanel

id NSGetCriticalAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSGetInformationalAlertPanel

id NSGetInformationalAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSReleaseAlertPanel

void NSReleaseAlertPanel(id panel);
Availability: OpenStep
Description forthcoming.

### NSRunAlertPanel

NSInteger NSRunAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: OpenStep
Description forthcoming.

### NSRunCriticalAlertPanel

NSInteger NSRunCriticalAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSRunInformationalAlertPanel

NSInteger NSRunInformationalAlertPanel(NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: MacOS-X 10.0.0
Description forthcoming.

### NSRunLocalizedAlertPanel

NSInteger NSRunLocalizedAlertPanel(NSString* table, NSString* title, NSString* msg, NSString* defaultButton, NSString* alternateButton, NSString* otherButton,...);
Availability: Not in OpenStep/MacOS-X
Description forthcoming.

# NSPasteboard functions

### 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);
Availability: OpenStep
Description forthcoming.

Up