X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/5ba5f32918f1e94246d62258b52b87dbabaeea54..554b7d9f8da9ee75b7922060ca063b058d8b3b5b:/interface/wx/protocol/http.h diff --git a/interface/wx/protocol/http.h b/interface/wx/protocol/http.h index 314b1571a8..fd72c127a5 100644 --- a/interface/wx/protocol/http.h +++ b/interface/wx/protocol/http.h @@ -3,7 +3,7 @@ // Purpose: interface of wxHTTP // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -107,7 +107,54 @@ public: /** Returns @true if there were cookies. */ - bool HasCookies() const; + + /** + Set the binary data to be posted to the server. + + If a non-empty buffer is passed to this method, the next request will + be an HTTP @c POST instead of the default HTTP @c GET and the given @a + data will be posted as the body of this request. + + For textual data a more convenient SetPostText() can be used instead. + + @param contentType + The value of HTTP "Content-Type" header, e.g. "image/png". + @param data + The data to post. + @return + @true if any data was passed in or @false if the buffer was empty. + + @since 2.9.4 + */ + bool SetPostBuffer(const wxString& contentType, const wxMemoryBuffer& data); + + /** + Set the text to be posted to the server. + + After a successful call to this method, the request will use HTTP @c + POST instead of the default @c GET when it's executed. + + Use SetPostBuffer() if you need to post non-textual data. + + @param contentType + The value of HTTP "Content-Type" header, e.g. "text/html; + charset=UTF-8". + @param data + The data to post. + @param conv + The conversion to use to convert @a data contents to a byte stream. + Its value should be consistent with the charset parameter specified + in @a contentType. + @return + @true if string was non-empty and was successfully converted using + the given @a conv or @false otherwise (in this case this request + won't be @c POST'ed correctly). + + @since 2.9.4 + */ + bool SetPostText(const wxString& contentType, + const wxString& data, + const wxMBConv& conv = wxConvUTF8); };