Functions

Authors

Generated by fedor

Contents -

NSApplication functions
NSDataLinkManager functions
NSEvent functions
NSFont functions
NSGraphicsContext functions
NSInterfaceStyle functions
NSPanel functions
NSPasteboard functions
NSSound functions
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.