|
139 | 139 | when the current action is completed.
|
140 | 140 |
|
141 | 141 | @see return
|
142 |
| - @see returnBlob |
143 |
| - @see returnWithError |
| 142 | + @see returnBlob: |
| 143 | + @see returnWithError: |
144 | 144 |
|
145 | 145 | @return Returns if the current app should return.
|
146 | 146 | */
|
|
149 | 149 |
|
150 | 150 | /**
|
151 | 151 | Bring up the Ink workspace to allow the user to return to the calling application.
|
| 152 | + |
152 | 153 | This method should be called when the user completes an Ink workflow but the
|
153 | 154 | action is one where there is no data to return (i.e. INKActionType_View)
|
154 | 155 |
|
|
166 | 167 |
|
167 | 168 | /**
|
168 | 169 | Bring up the Ink workspace and allow the user to continue their workflow with new data.
|
| 170 | + |
169 | 171 | This method should be called whenever the user completes a workflow and they have new
|
170 | 172 | data to work with, for example for an edit action.
|
171 | 173 |
|
172 | 174 | Before calling this, check the appShouldReturn method.
|
| 175 | + @param blob The new data that was a result of the user completing the desired action. |
173 | 176 | @see appShouldReturn
|
174 | 177 | */
|
175 | 178 | + (void)returnBlob:(INKBlob*)blob;
|
176 | 179 |
|
177 | 180 | /**
|
178 | 181 | Bring up the Ink workspace and allow the user to continue their workflow but show an error.
|
| 182 | + |
179 | 183 | This method should be called when an error occurred when the current app tried to complete the request.
|
180 | 184 |
|
181 | 185 | Before calling this, check the appShouldReturn method.
|
| 186 | + @param error The error that occurred when trying to execute the desired action. |
182 | 187 | @see appShouldReturn
|
183 | 188 | */
|
184 | 189 | + (void)returnWithError:(NSError*)error;
|
|
213 | 218 | loading spinner, so the faster you can return the blob data the better.
|
214 | 219 |
|
215 | 220 | @param UTI The Uniform Type Identifier of the blob, used to filter the aciton list.
|
216 |
| - @param dynamicBlob The block that will be called on a background thread to retrieve the blob. |
| 221 | + @param block The block that will be called on a background thread to retrieve the blob. |
217 | 222 | */
|
218 | 223 | + (void)showWorkspaceWithUTI:(NSString *)UTI dynamicBlob:(INKDynamicBlobBlock)block;
|
219 | 224 |
|
|
235 | 240 | Opens the Ink workspace with a late-binding blob and a return handler.
|
236 | 241 |
|
237 | 242 | This method is a combination of the capabilities of showWorkspaceWithBlob:onReturn: and showWorkspaceWithUTI:dynamicBlob:
|
238 |
| - @see showWorkspaceWithBlob:onReturn |
| 243 | + @see showWorkspaceWithBlob:onReturn: |
239 | 244 | @see showWorkspaceWithUTI:dynamicBlob:
|
240 | 245 |
|
241 | 246 | @param UTI The Uniform Type Identifier of the blob, used to filter the aciton list.
|
242 |
| - @param dynamicBlob The block that will be called on a background thread to retrieve the blob. |
| 247 | + @param block The block that will be called on a background thread to retrieve the blob. |
243 | 248 | @param returnBlock The block to be called with the user finishes their current workflow and returns back to this app.
|
244 | 249 | */
|
245 | 250 | + (void)showWorkspaceWithUTI:(NSString *)UTI dynamicBlob:(INKDynamicBlobBlock)block onReturn:(INKActionCallbackBlock)returnBlock;
|
|
0 commit comments