Mercurial > pidgin.yaz
comparison src/ft.h @ 8585:e4087b5c0627
[gaim-migrate @ 9335]
Patch from Pekka Riikonen to allow a prpl to accept a file transfer
without choosing the save filename, and then to later complete this
selection. This also provides some API extension to allow a prpl to
handle its own connection setups and a posteriori add the connection
to gaim's file transfer list.
committer: Tailor Script <tailor@pidgin.im>
author | Ethan Blanton <elb@pidgin.im> |
---|---|
date | Mon, 05 Apr 2004 20:15:29 +0000 |
parents | f50c059b6384 |
children | 92cbf9713795 |
comparison
equal
deleted
inserted
replaced
8584:058efd3cb86f | 8585:e4087b5c0627 |
---|---|
48 */ | 48 */ |
49 typedef enum | 49 typedef enum |
50 { | 50 { |
51 GAIM_XFER_STATUS_UNKNOWN = 0, /**< Unknown, the xfer may be null. */ | 51 GAIM_XFER_STATUS_UNKNOWN = 0, /**< Unknown, the xfer may be null. */ |
52 GAIM_XFER_STATUS_NOT_STARTED, /**< It hasn't started yet. */ | 52 GAIM_XFER_STATUS_NOT_STARTED, /**< It hasn't started yet. */ |
53 GAIM_XFER_STATUS_ACCEPTED, /**< Receive accepted, but destination file not selected yet */ | |
53 GAIM_XFER_STATUS_STARTED, /**< gaim_xfer_start has been called. */ | 54 GAIM_XFER_STATUS_STARTED, /**< gaim_xfer_start has been called. */ |
54 GAIM_XFER_STATUS_DONE, /**< The xfer completed successfully. */ | 55 GAIM_XFER_STATUS_DONE, /**< The xfer completed successfully. */ |
55 GAIM_XFER_STATUS_CANCEL_LOCAL, /**< The xfer was canceled by us. */ | 56 GAIM_XFER_STATUS_CANCEL_LOCAL, /**< The xfer was canceled by us. */ |
56 GAIM_XFER_STATUS_CANCEL_REMOTE /**< The xfer was canceled by the other end, or we couldn't connect. */ | 57 GAIM_XFER_STATUS_CANCEL_REMOTE /**< The xfer was canceled by the other end, or we couldn't connect. */ |
57 } GaimXferStatusType; | 58 } GaimXferStatusType; |
170 * @param xfer A file transfer handle. | 171 * @param xfer A file transfer handle. |
171 */ | 172 */ |
172 void gaim_xfer_unref(GaimXfer *xfer); | 173 void gaim_xfer_unref(GaimXfer *xfer); |
173 | 174 |
174 /** | 175 /** |
175 * Requests confirmation for a file transfer from the user. | 176 * Requests confirmation for a file transfer from the user. If receiving |
177 * a file which is known at this point, this requests user to accept and | |
178 * save the file. If the filename is unknown (not set) this only requests user | |
179 * to accept the file transfer. In this case protocol must call this function | |
180 * again once the filename is available. | |
176 * | 181 * |
177 * @param xfer The file transfer to request confirmation on. | 182 * @param xfer The file transfer to request confirmation on. |
178 */ | 183 */ |
179 void gaim_xfer_request(GaimXfer *xfer); | 184 void gaim_xfer_request(GaimXfer *xfer); |
180 | 185 |
483 * @param xfer The file transfer. | 488 * @param xfer The file transfer. |
484 */ | 489 */ |
485 void gaim_xfer_end(GaimXfer *xfer); | 490 void gaim_xfer_end(GaimXfer *xfer); |
486 | 491 |
487 /** | 492 /** |
493 * Adds a new file transfer to the list of file transfers. Call this only | |
494 * if you are not using gaim_xfer_start. | |
495 * | |
496 * @param xfer The file transfer. | |
497 */ | |
498 void gaim_xfer_add(GaimXfer *xfer); | |
499 | |
500 /** | |
488 * Cancels a file transfer on the local end. | 501 * Cancels a file transfer on the local end. |
489 * | 502 * |
490 * @param xfer The file transfer. | 503 * @param xfer The file transfer. |
491 */ | 504 */ |
492 void gaim_xfer_cancel_local(GaimXfer *xfer); | 505 void gaim_xfer_cancel_local(GaimXfer *xfer); |
508 * @param type The type of file transfer. | 521 * @param type The type of file transfer. |
509 * @param who The user on the other end of the transfer. | 522 * @param who The user on the other end of the transfer. |
510 * @param msg The message to display. | 523 * @param msg The message to display. |
511 */ | 524 */ |
512 void gaim_xfer_error(GaimXferType type, const char *who, const char *msg); | 525 void gaim_xfer_error(GaimXferType type, const char *who, const char *msg); |
526 | |
527 /** | |
528 * Updates file transfer progress. | |
529 * | |
530 * @param xfer The file transfer. | |
531 */ | |
532 void gaim_xfer_update_progress(GaimXfer *xfer); | |
513 | 533 |
514 /*@}*/ | 534 /*@}*/ |
515 | 535 |
516 /**************************************************************************/ | 536 /**************************************************************************/ |
517 /** @name UI Registration Functions */ | 537 /** @name UI Registration Functions */ |