1/** @page xfer-signals File Transfer Signals 2 3 @signals 4 @signal file-recv-accept 5 @signal file-recv-start 6 @signal file-recv-cancel 7 @signal file-recv-complete 8 @signal file-recv-request 9 @signal file-send-accept 10 @signal file-send-start 11 @signal file-send-cancel 12 @signal file-send-complete 13 @endsignals 14 15 @see ft.h 16 17 <hr> 18 19 @signaldef file-recv-accept 20 @signalproto 21void (*file_recv_accept)(PurpleXfer *xfer, gpointer data); 22 @endsignalproto 23 @signaldesc 24 Emitted when an incoming file transfer has been accepted. 25 @param xfer The file transfer 26 @param data User data 27 @endsignaldef 28 29 @signaldef file-recv-start 30 @signalproto 31void (*file_recv_start)(PurpleXfer *xfer, gpointer data); 32 @endsignalproto 33 @signaldesc 34 Emitted when an incoming file transfer has been started. 35 @param xfer The file transfer 36 @param data User data 37 @endsignaldef 38 39 @signaldef file-recv-cancel 40 @signalproto 41void (*file_recv_cancel)(PurpleXfer *xfer, gpointer data); 42 @endsignalproto 43 @signaldesc 44 Emitted when an incoming file transfer has been canceled. 45 @param xfer The file transfer 46 @param data User data 47 @endsignaldef 48 49 @signaldef file-recv-complete 50 @signalproto 51void (*file_recv_complete)(PurpleXfer *xfer, gpointer data); 52 @endsignalproto 53 @signaldesc 54 Emitted when an incoming file transfer has been completed. 55 @param xfer The file transfer 56 @param data User data 57 @endsignaldef 58 59 @signaldef file-recv-request 60 @signalproto 61void (*file_recv_request)(PurpleXfer *xfer, gpointer data); 62 @endsignalproto 63 @signaldesc 64 Emitted before the user is prompted for an incoming file-transfer. 65 Plugins can intercept the signal to auto-accept/auto-reject the 66 requests. To auto-accept the file transfer, use 67 purple_xfer_request_accepted(). To auto-reject, set the status of the 68 xfer to PURPLE_XFER_STATUS_CANCEL_LOCAL. 69 @param xfer The file transfer 70 @param data User data 71 @endsignaldef 72 73 @signaldef file-send-accept 74 @signalproto 75void (*file_send_accept)(PurpleXfer *xfer, gpointer data); 76 @endsignalproto 77 @signaldesc 78 Emitted when an outgoing file transfer has been accepted. 79 @param xfer The file transfer 80 @param data User data 81 @endsignaldef 82 83 @signaldef file-send-start 84 @signalproto 85void (*file_send_start)(PurpleXfer *xfer, gpointer data); 86 @endsignalproto 87 @signaldesc 88 Emitted when an outgoing file transfer has started. 89 @param xfer The file transfer 90 @param data User data 91 @endsignaldef 92 93 @signaldef file-send-cancel 94 @signalproto 95void (*file_send_cancel)(PurpleXfer *xfer, gpointer data); 96 @endsignalproto 97 @signaldesc 98 Emitted when an outgoing file transfer has been canceled. 99 @param xfer The file transfer 100 @param data User data 101 @endsignaldef 102 103 @signaldef file-send-complete 104 @signalproto 105void (*file_send_complete)(PurpleXfer *xfer, gpointer data); 106 @endsignalproto 107 @signaldesc 108 Emitted when an outgoing file transfer has been completed. 109 @param xfer The file transfer 110 @param data User data 111 @endsignaldef 112 113 */ 114// vim: syntax=c.doxygen tw=75 et 115