165
165
clickContext:(id)clickContext
166
166
identifier:(NSString *)identifier;
169
* @method notifyWithTitle:description:notificationName:iconData:priority:isSticky:clickContext:identifier:
170
* @abstract Send a Growl notification.
171
* @discussion This is the preferred means for sending a Growl notification.
172
* The notification name and at least one of the title and description are
173
* required (all three are preferred). All other parameters may be
174
* <code>nil</code> (or 0 or NO as appropriate) to accept default values.
176
* If using the Growl-WithInstaller framework, if Growl is not installed the
177
* user will be prompted to install Growl. If the user cancels, this method
178
* will have no effect until the next application session, at which time when
179
* it is called the user will be prompted again. The user is also given the
180
* option to not be prompted again. If the user does choose to install Growl,
181
* the requested notification will be displayed once Growl is installed and
184
* @param title The title of the notification displayed to the user.
185
* @param description The full description of the notification displayed to the user.
186
* @param notifName The internal name of the notification. Should be human-readable, as it will be displayed in the Growl preference pane.
187
* @param iconData <code>NSData</code> object to show with the notification as its icon. If <code>nil</code>, the application's icon will be used instead.
188
* @param priority The priority of the notification. The default value is 0; positive values are higher priority and negative values are lower priority. Not all Growl displays support priority.
189
* @param isSticky If YES, the notification will remain on screen until clicked. Not all Growl displays support sticky notifications.
190
* @param clickContext A context passed back to the Growl delegate if it implements -(void)growlNotificationWasClicked: and the notification is clicked. Not all display plugins support clicking. The clickContext must be plist-encodable (completely of <code>NSString</code>, <code>NSArray</code>, <code>NSNumber</code>, <code>NSDictionary</code>, and <code>NSData</code> types).
191
* @param identifier An identifier for this notification. Notifications with equal identifiers are coalesced.
193
+ (void) notifyWithTitle:(NSString *)title
194
description:(NSString *)description
195
notificationName:(NSString *)notifName
196
iconData:(NSData *)iconData
197
priority:(signed int)priority
198
isSticky:(BOOL)isSticky
199
clickContext:(id)clickContext
200
identifier:(NSString *)identifier;
202
168
/*! @method notifyWithDictionary:
203
169
* @abstract Notifies using a userInfo dictionary suitable for passing to
204
170
* <code>NSDistributedNotificationCenter</code>.