ChatSendFile
Script function world.ChatSendFile Read about scripting Type Method Summary Starts sending a file to the specified chat user Prototype `long ChatSendFile(long ID, BSTR FileName);` View list of data type meanings Description `This starts the process of sending a file to the specified chat ID. If the file name is empty, then you will be prompted with a "choose file" dialog box, so you can pick the file with the normal Window file browser. If the file name is not empty, then MUSHclient will attempt to send that file. The recipient of the file must have allowed file sending, or you will get an error message. You cannot send more than one file at a time - you will get an error if you attempt to send a file whilst sending, or receiving, another one (to that user). You can use GetChatInfo to see if a file transfer is in progres. You can use SetChatOption to set the "can_send_files" flag. Each call is identified by its "chat ID" - each chat session has a unique ID, which starts at one, and is incremented by one, per world. You can use GetChatList to find a list of chat IDs that is current. You can use ChatGetID to find the chat ID corresponding to a particular chat name. Note that an "OK" response merely means that we have sent a request to the other user to accept the file. There is no guarantee that s/he will want it.` VBscript example
    ChatSendFile ChatGetID ("fred"), ""  ' send a file that you choose
Jscript example
    ChatSendFile (ChatGetID ("fred"), ""); // send a file that you choose
PerlScript example
    ChatSendFile (ChatGetID ("fred"), "");  # send a file that you choose
Python example
    world.ChatSendFile (world.ChatGetID ("fred"), "") # send a file that you choose
Lua example
    ChatSendFile (ChatGetID ("fred")) -- send a file that you choose
Lua notes
    The file name is optional. If omitted you will be prompted for one.
Return value
    eChatIDNotFound: That chat ID is not connected
    eAlreadyTransferringFile: Already transferring a file
    eFileNotFound: That file not found, or user cancelled file picker dialog box
    eOK: File transfer initiated
View list of return code meanings See Also ... Topics Chat system Getting started Functions ChatAcceptCalls (Accepts incoming chat calls) ChatCall (Calls a chat server (makes an outgoing call) using the MudMaster chat protocol) ChatCallzChat (Calls a zChat chat server (makes an outgoing call)) ChatDisconnect (Disconnects a current chat call) ChatDisconnectAll (Disconnects all current chat calls) ChatEverybody (Sends a chat message to every connected chat user) ChatGetID (Looks up what chat ID (identifier) corresponds to a particular chat name) ChatGroup (Sends a chat message to every connected chat user in the specified group) ChatID (Sends a chat message to a particular chat session) ChatMessage (Sends a message to a chat user (raw format)) ChatNameChange (Changes your chat name) ChatNote (Does a note using ANSI codes for the chat system) ChatPasteEverybody (Pastes the clipboard contents to every connected person) ChatPasteText (Pastes the clipboard contents to that person) ChatPeekConnections (Sends a "peek connections" message to the specified chat user) ChatPersonal (Sends a chat message to a particular person) ChatPing (Sends a ping message to the specified chat user) ChatRequestConnections (Sends a "request connections" message to the specified chat user) ChatStopAcceptingCalls (Stops this world from accepting chat calls) ChatStopFileTransfer (Stops a file transfer in progress to that chat user) GetChatInfo (Get information about a chat connection) GetChatList (Gets the list of chat sessions) GetChatOption (Gets the value of a chat session option) SetChatOption (Sets the value of a chat session option) (Help topic: function=ChatSendFile) Documentation contents page