Sophie

Sophie

distrib > Fedora > 17 > i386 > by-pkgid > f47ddb753435c655fc691eb594d59ce5 > files > 122

libgadu-doc-1.11.2-1.fc17.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>libgadu: Wiadomości</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">libgadu
   &#160;<span id="projectnumber">1.11.2</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Wygenerowano przez Doxygen 1.8.1.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Szukaj');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Strona&#160;główna</span></a></li>
      <li><a href="pages.html"><span>Dodatkowe&#160;strony</span></a></li>
      <li><a href="modules.html"><span>Moduły</span></a></li>
      <li><a href="annotated.html"><span>Struktury&#160;Danych</span></a></li>
      <li><a href="files.html"><span>Pliki</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Szukaj" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Struktury Danych</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Pliki</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Funkcje</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Zmienne</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Definicje typów</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Wyliczenia</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Wartości wyliczeń</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Definicje</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark">&#160;</span>Grupay</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark">&#160;</span>Strony</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="summary">
<a href="#nested-classes">Struktury danych</a> &#124;
<a href="#define-members">Definicje</a> &#124;
<a href="#enum-members">Wyliczenia</a> &#124;
<a href="#func-members">Funkcje</a>  </div>
  <div class="headertitle">
<div class="title">Wiadomości</div>  </div>
<div class="ingroups"><a class="el" href="group__session.html">Połączenie z serwerem</a></div></div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="nested-classes"></a>
Struktury danych</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structgg__msg__richtext__format.html">gg_msg_richtext_format</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Struktura opisująca formatowanie tekstu.  <a href="structgg__msg__richtext__format.html#details">Więcej...</a><br/></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structgg__msg__richtext__color.html">gg_msg_richtext_color</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Struktura opisującą kolor tekstu dla atrybutu <code>GG_FONT_COLOR</code>.  <a href="structgg__msg__richtext__color.html#details">Więcej...</a><br/></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structgg__msg__richtext__image.html">gg_msg_richtext_image</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Strukturya opisująca obrazek wstawiony do wiadomości dla atrubutu <code>GG_FONT_IMAGE</code>.  <a href="structgg__msg__richtext__image.html#details">Więcej...</a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="define-members"></a>
Definicje</h2></td></tr>
<tr class="memitem:ga702ddbf340747a609a56241526b19b8e"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga702ddbf340747a609a56241526b19b8e">GG_MSG_MAXSIZE</a>&#160;&#160;&#160;1989</td></tr>
<tr class="memdesc:ga702ddbf340747a609a56241526b19b8e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Maksymalna długość wiadomości.  <a href="#ga702ddbf340747a609a56241526b19b8e"></a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="enum-members"></a>
Wyliczenia</h2></td></tr>
<tr class="memitem:gab04a0655cd1e3bcac5e8f48c18df1a57"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom">{ <br/>
&#160;&#160;<a class="el" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57a8163c1c845c6cc766ba4d1b0d8a60c36">GG_CLASS_MSG</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57afcc792ce83299a41ea087b5595af0a29">GG_CLASS_CHAT</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57a5ef165db4874c852e49aeca51a7128e9">GG_CLASS_CTCP</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57ad31aaba07e24c54eb136739fdf0f35ce">GG_CLASS_ACK</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57a29acd1b8de6f0ff5e72a25ff083a3d47">GG_CLASS_QUEUED</a>
<br/>
 }</td></tr>
<tr class="memdesc:gab04a0655cd1e3bcac5e8f48c18df1a57"><td class="mdescLeft">&#160;</td><td class="mdescRight">Klasy wiadomości.  <a href="group__messages.html#gab04a0655cd1e3bcac5e8f48c18df1a57">Więcej...</a><br/></td></tr>
<tr class="memitem:ga385c44f6fb256e5716a2302a5b940388"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom">{ <br/>
&#160;&#160;<a class="el" href="group__messages.html#gga385c44f6fb256e5716a2302a5b940388a94c148486240df0354a8123ee5dd06c5">GG_FONT_BOLD</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#gga385c44f6fb256e5716a2302a5b940388a8a000abdc55fed561d4871ac9f976305">GG_FONT_ITALIC</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#gga385c44f6fb256e5716a2302a5b940388a1f3a57de68f8b37cfe5cc6fc6c59248e">GG_FONT_UNDERLINE</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#gga385c44f6fb256e5716a2302a5b940388a802285a52382aa39fdc1fc0fc0b5849c">GG_FONT_COLOR</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#gga385c44f6fb256e5716a2302a5b940388a756b07e02fb68e90274cf6471616400d">GG_FONT_IMAGE</a>
<br/>
 }</td></tr>
<tr class="memdesc:ga385c44f6fb256e5716a2302a5b940388"><td class="mdescLeft">&#160;</td><td class="mdescRight">Atrybuty formatowania wiadomości.  <a href="group__messages.html#ga385c44f6fb256e5716a2302a5b940388">Więcej...</a><br/></td></tr>
<tr class="memitem:gabc5c98fcc1211af2b80116dd6e0a035d"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom">{ <br/>
&#160;&#160;<a class="el" href="group__messages.html#ggabc5c98fcc1211af2b80116dd6e0a035dae3901917057a6657a756e5668d20a5ce">GG_ACK_DELIVERED</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggabc5c98fcc1211af2b80116dd6e0a035da76575d0bafcb1e0e8a45d08788dc5b08">GG_ACK_QUEUED</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggabc5c98fcc1211af2b80116dd6e0a035da22cd918071954d3b6d39333ee85ddac7">GG_ACK_BLOCKED</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggabc5c98fcc1211af2b80116dd6e0a035da8cf3fd01604ed358e04bcfc4c7ffc732">GG_ACK_MBOXFULL</a>, 
<br/>
&#160;&#160;<a class="el" href="group__messages.html#ggabc5c98fcc1211af2b80116dd6e0a035da34c0aa23f1f67c05dc0034318339d486">GG_ACK_NOT_DELIVERED</a>
<br/>
 }</td></tr>
<tr class="memdesc:gabc5c98fcc1211af2b80116dd6e0a035d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Status doręczenia wiadomości.  <a href="group__messages.html#gabc5c98fcc1211af2b80116dd6e0a035d">Więcej...</a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
Funkcje</h2></td></tr>
<tr class="memitem:gabcc076e57528b91518f573f59fadde08"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#gabcc076e57528b91518f573f59fadde08">gg_send_message</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, int msgclass, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, const unsigned char *message)</td></tr>
<tr class="memdesc:gabcc076e57528b91518f573f59fadde08"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła wiadomość do użytkownika.  <a href="#gabcc076e57528b91518f573f59fadde08"></a><br/></td></tr>
<tr class="memitem:ga2a30ed0ecd9691b7af77406619087a67"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga2a30ed0ecd9691b7af77406619087a67">gg_send_message_richtext</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, int msgclass, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, const unsigned char *message, const unsigned char *format, int formatlen)</td></tr>
<tr class="memdesc:ga2a30ed0ecd9691b7af77406619087a67"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła wiadomość formatowaną.  <a href="#ga2a30ed0ecd9691b7af77406619087a67"></a><br/></td></tr>
<tr class="memitem:ga48f3197c621872c670f49fe0d1ac25eb"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga48f3197c621872c670f49fe0d1ac25eb">gg_send_message_confer</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, int msgclass, int recipients_count, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> *recipients, const unsigned char *message)</td></tr>
<tr class="memdesc:ga48f3197c621872c670f49fe0d1ac25eb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła wiadomość w ramach konferencji.  <a href="#ga48f3197c621872c670f49fe0d1ac25eb"></a><br/></td></tr>
<tr class="memitem:ga0e5df383eeac438710656704fa4bdd30"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga0e5df383eeac438710656704fa4bdd30">gg_send_message_confer_richtext</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, int msgclass, int recipients_count, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> *recipients, const unsigned char *message, const unsigned char *format, int formatlen)</td></tr>
<tr class="memdesc:ga0e5df383eeac438710656704fa4bdd30"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła wiadomość formatowaną w ramach konferencji.  <a href="#ga0e5df383eeac438710656704fa4bdd30"></a><br/></td></tr>
<tr class="memitem:ga2c03e907a237f1de9a0e22b252e333c5"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga2c03e907a237f1de9a0e22b252e333c5">gg_send_message_ctcp</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, int msgclass, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, const unsigned char *message, int message_len)</td></tr>
<tr class="memdesc:ga2c03e907a237f1de9a0e22b252e333c5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła wiadomość binarną przeznaczoną dla klienta.  <a href="#ga2c03e907a237f1de9a0e22b252e333c5"></a><br/></td></tr>
<tr class="memitem:gad8f4addf7ac77bb992e42eb6e2de5b60"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#gad8f4addf7ac77bb992e42eb6e2de5b60">gg_image_request</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, int size, uint32_t crc32)</td></tr>
<tr class="memdesc:gad8f4addf7ac77bb992e42eb6e2de5b60"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła żądanie obrazka o podanych parametrach.  <a href="#gad8f4addf7ac77bb992e42eb6e2de5b60"></a><br/></td></tr>
<tr class="memitem:ga8d1a50a10b076d0006c8b1b301394bd2"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga8d1a50a10b076d0006c8b1b301394bd2">gg_image_reply</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, const char *filename, const char *image, int size)</td></tr>
<tr class="memdesc:ga8d1a50a10b076d0006c8b1b301394bd2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wysyła żądany obrazek.  <a href="#ga8d1a50a10b076d0006c8b1b301394bd2"></a><br/></td></tr>
<tr class="memitem:ga27a5bb1766cbb99dae4e862eec635899"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__messages.html#ga27a5bb1766cbb99dae4e862eec635899">gg_typing_notification</a> (struct <a class="el" href="structgg__session.html">gg_session</a> *sess, <a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> recipient, int length)</td></tr>
<tr class="memdesc:ga27a5bb1766cbb99dae4e862eec635899"><td class="mdescLeft">&#160;</td><td class="mdescRight">Informuje rozmówcę o pisaniu wiadomości.  <a href="#ga27a5bb1766cbb99dae4e862eec635899"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Opis szczegółowy</h2>
<p>Wysyłanie zwykłych wiadomości jest prostą operacją i większości przypadków wystarczy użycie funkcji <code>gg_send_message:</code> </p>
<div class="fragment"><div class="line"><a class="code" href="group__messages.html#gabcc076e57528b91518f573f59fadde08" title="Wysyła wiadomość do użytkownika.">gg_send_message</a>(sesja, <a class="code" href="group__messages.html#ggab04a0655cd1e3bcac5e8f48c18df1a57afcc792ce83299a41ea087b5595af0a29" title="Wiadomość ma pojawić się w oknie rozmowy.">GG_CLASS_CHAT</a>, odbiorca, treść);</div>
</div><!-- fragment --><p>Funkcja zwraca numer sekwencyjny wiadomości, który może zostać użyty do potwierdzenia dostarczenia wiadomości za pomocą zdarzenia <a class="el" href="group__events.html#events-list"><code>GG_EVENT_ACK</code> </a>. Wiadomości przeznaczone do wyświetlania w osobny oknie były wykorzystywane w starszych wersjach Gadu-Gadu, gdzie istniały osobne opcje &mdash; wiadomości i rozmowa. Obecnie wykorzystuje się wiadomość typu <code>GG_CLASS_CHAT</code>.</p>
<p>Wiadomość, która ma zawierać formatowanie tekstu, musi zostać wysłana za pomocą funkcji <code><a class="el" href="group__messages.html#ga2a30ed0ecd9691b7af77406619087a67" title="Wysyła wiadomość formatowaną.">gg_send_message_richtext()</a></code>. Wiadomości konferencyjne wysyła się funkcjami <code><a class="el" href="group__messages.html#ga48f3197c621872c670f49fe0d1ac25eb" title="Wysyła wiadomość w ramach konferencji.">gg_send_message_confer()</a></code> lub <code><a class="el" href="group__messages.html#ga0e5df383eeac438710656704fa4bdd30" title="Wysyła wiadomość formatowaną w ramach konferencji.">gg_send_message_confer_richtext()</a></code>.</p>
<h1><a class="anchor" id="messages-conference"></a>
Wiadomości konferencyjne</h1>
<p>Rozmowy konferencyjne w Gadu-Gadu polegają na wysyłaniu tej samej wiadomości do wszystkich uczestników wraz z metainformacją zawierającą listę uczestników. Osoba, która pierwsza wyśle wiadomość, dołącza listę rozmówców do wiadomości, z której korzysta się przy wysyłaniu odpowiedzi. Z tego powodu nie ma możliwości dołączania się lub opuszczania "pokojów" &mdash; po zamknięciu rozmowy konferencyjnej należy ignorować kolejne wiadomości, ponieważ inni uczestnicy nie są o tym fakcie informowani.</p>
<p>Funkcje <code><a class="el" href="group__messages.html#ga48f3197c621872c670f49fe0d1ac25eb" title="Wysyła wiadomość w ramach konferencji.">gg_send_message_confer()</a></code> i <code><a class="el" href="group__messages.html#ga0e5df383eeac438710656704fa4bdd30" title="Wysyła wiadomość formatowaną w ramach konferencji.">gg_send_message_confer_richtext()</a></code> zajmują się wysłaniem wiadomości do wszystkich uczestników oraz dołączaniem odpowiednich metainformowacji. Aplikacja musi jedynie dołączyć listę rozmówców w postaci listy ich identyfikatorów.</p>
<p>Po odebraniu wiadomości konferencyjnej za pomocą zdarzenia <a class="el" href="group__events.html#events-list"><code>GG_EVENT_MSG</code> ,</a>pola <a class="el" href="structgg__event__msg.html#ae3808a5fcb7a3f364bc8787a3e2153a4">recipients_count</a> oraz <a class="el" href="structgg__event__msg.html#afa2b7b0fbff40978a6a229de528cb736">recipients</a> struktury zdarzenia określają listę rozmówców.</p>
<h1><a class="anchor" id="messages-richtext"></a>
Wiadomości formatowane</h1>
<p>Wiadomości formatowane zawierają metainformacje opisujące formatowanie poszczególnych fragmentów tekstu. Blok metainformacji zawiera dowolną liczbę struktur <code><a class="el" href="structgg__msg__richtext__format.html" title="Struktura opisująca formatowanie tekstu.">gg_msg_richtext_format</a></code>. Pole <code>position</code> określa pierwszy znak, którego dotyczy formatowanie. Pole <code>font</code> jest sumą logiczną atrybutów:</p>
<ul>
<li>
<code>GG_FONT_BOLD</code> &mdash; pogrubienie, </li>
<li>
<code>GG_FONT_ITALIC</code> &mdash; kursywa, </li>
<li>
<code>GG_FONT_UNDERLINE</code> &mdash; podkreślenie, </li>
<li>
<code>GG_FONT_COLOR</code> &mdash; kolor, </li>
<li>
<code>GG_FONT_IMAGE</code> &mdash; obrazek. </li>
</ul>
<p>Jeśli występuje atrybut <code>GG_FONT_COLOR</code>, zaraz za strukturą <code><a class="el" href="structgg__msg__richtext__format.html" title="Struktura opisująca formatowanie tekstu.">gg_msg_richtext_format</a></code> znajduje się struktura <code><a class="el" href="structgg__msg__richtext__color.html" title="Struktura opisującą kolor tekstu dla atrybutu GG_FONT_COLOR.">gg_msg_richtext_color</a></code> opisująca kolor za pomocą składowych RGB.</p>
<p>Jeśli występuje atrybut <code>GG_FONT_IMAGE</code>, za strukturą znajduje się struktura <code><a class="el" href="structgg__msg__richtext__image.html" title="Strukturya opisująca obrazek wstawiony do wiadomości dla atrubutu GG_FONT_IMAGE.">gg_msg_richtext_image</a></code>. Pole <code>unknown1</code> zawiera rozmiar (0x09) oraz rodzaj struktury (0x01), ale ze względów historycznych jest liczbą 16-bitową i należy przypisać mu wartość <code>0x0109</code>. Pola <code>size</code> i <code>crc32</code> identyfikują obrazek, który można pobrać od nadawcy lub z dysku lokalnego, jeśli był już wcześniej pobierany (np. często używana ikonka). Opis pobierania obrazków od nadawcy znajduje się <a class="el" href="group__messages.html#messages-images">poniżej</a>.</p>
<dl class="section note"><dt>Nota:</dt><dd>Biblioteka nie ingeruje w zawartość bloku formatowania, więc kolejność bajtów może się różnić od używanej na danej architekturze. By pobrać lub określić poszczególne wartości, należy użyć funkcji <code><a class="el" href="group__helper.html#gae2bb699fed19a582feebe83b724aeda4">gg_fix16()</a></code> i <code><a class="el" href="group__helper.html#gae8c6817d2c15b5db3bfc4f8e39a50a4c">gg_fix32()</a></code>, które w razie konieczności dokonają konwersji.</dd>
<dd>
Należy pamiętać, że rozmiar bloku formatowania jest określany w bajtach, nie liczbie struktur.</dd>
<dd>
Rozmiary struktur i położenie ich pól nie są wyrównywane do rozmiaru słowa. Jeśli dana architektura wymaga dostępu do pamięci z wyrównaniem, należy o to zadbać w aplikacji.</dd></dl>
<h1><a class="anchor" id="messages-receive"></a>
Otrzymywanie wiadomości</h1>
<p>Wiadomości odebrane od serwera są przekazywane za pomocą zdarzenia <a class="el" href="group__events.html#events-list"><code>GG_EVENT_MSG</code> </a> </p>
<dl class="section note"><dt>Nota:</dt><dd>Serwer nie prześle zakolejkowanych wiadomości przed wysłaniem <a class="el" href="group__contacts.html">listy kontaktów</a>.</dd></dl>
<h1><a class="anchor" id="messages-ack"></a>
Potwierdzenie doręczenia</h1>
<p>Każda przesyłana wiadomość zawiera numer sekwencyjny, który może zostać użyty do potwierdzenia doręczenia. Zdarzenie <a class="el" href="group__events.html#events-list"><code>GG_EVENT_ACK</code>  zawiera informację o doręczeniu</a>lub powód niedoręczenia, chyba że wiadomość została wysłania z klasą <code>GG_CLASS_ACK</code>. Lista kodów jest opisana poniżej.</p>
<h1><a class="anchor" id="messages-images"></a>
Pobieranie i wysyłanie obrazków</h1>
<p>Po odebraniu wiadomości zawierającej strukturę <code><a class="el" href="structgg__msg__richtext__image.html" title="Strukturya opisująca obrazek wstawiony do wiadomości dla atrubutu GG_FONT_IMAGE.">gg_msg_richtext_image</a></code>, mając informację o rozmiarze i sumie kontrolnej obrazka, należy użyć funkcji:</p>
<div class="fragment"><div class="line"><a class="code" href="group__messages.html#gad8f4addf7ac77bb992e42eb6e2de5b60" title="Wysyła żądanie obrazka o podanych parametrach.">gg_image_request</a>(sesja, nadawca, rozmiar, crc);</div>
</div><!-- fragment --><p>Następnie należy oczekiwać na zdarzenie <a class="el" href="group__events.html#events-list"><code>GG_EVENT_IMAGE_REPLY</code> </a>, które będzie zawierać rozmiar pliku (<code>size</code>) i sumę kontrolą (<code>crc32</code>) do identifikacji zdarzenia, oraz nazwę obrazka (<code>filename</code>) i jego treść (<code>image</code>). Rodzaj pliku graficznego nie jest określony przy transmisji, więc należy go rozpoznać po rozszerzeniu lub treści.</p>
<dl class="section note"><dt>Nota:</dt><dd>Biblioteka ignoruje wszystkie obrazki, które nie były zamówione, żeby uniknąć zajęcia całej dostępnej pamięci, na wypadek gdyby ktoś nieustannie próbował wysyłać niekompletne obrazki.</dd></dl>
<p>Jeśli została wysłana wiadomość graficzną, należy obsługiwać zdarzenie <a class="el" href="group__events.html#events-list"><code>GG_EVENT_IMAGE_REQUEST</code> , które w polach</a><code>size</code> i <code>crc32</code> zawiera informacje o obrazku, którego potrzebuje nasz rozmówca. Obrazek wysyła się funkcją:</p>
<div class="fragment"><div class="line"><a class="code" href="group__messages.html#ga8d1a50a10b076d0006c8b1b301394bd2" title="Wysyła żądany obrazek.">gg_image_reply</a>(sesja, odbiorca, nazwa_pliku, obrazek, długość_obrazka);</div>
</div><!-- fragment --><h1><a class="anchor" id="messages-typing"></a>
Powiadomienie o pisaniu</h1>
<p>Począwszy od Gadu-Gadu 10 rozmówca jest informowany o tym, że jesteśmy w trakcie pisania wiadomości:</p>
<div class="fragment"><div class="line"><a class="code" href="group__messages.html#ga27a5bb1766cbb99dae4e862eec635899" title="Informuje rozmówcę o pisaniu wiadomości.">gg_typing_notification</a>(sesja, odbiorca, długość_wiadomości);</div>
</div><!-- fragment --><p>Informacje o pisaniu przesyłane są do aplikacji za pomocą zdarzenia <a class="el" href="group__events.html#events-list"><code>GG_EVENT_TYPING_NOTIFICATION</code> .</a></p>
<hr/><h2>Dokumentacja definicji</h2>
<a class="anchor" id="ga702ddbf340747a609a56241526b19b8e"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define GG_MSG_MAXSIZE&#160;&#160;&#160;1989</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Maksymalna długość wiadomości. </p>

</div>
</div>
<hr/><h2>Dokumentacja typów wyliczanych</h2>
<a class="anchor" id="gab04a0655cd1e3bcac5e8f48c18df1a57"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">anonymous enum</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Klasy wiadomości. </p>
<p>Wartości są maskami bitowymi, które w większości przypadków można łączyć (połączenie <code>GG_CLASS_MSG</code> i <code>GG_CLASS_CHAT</code> nie ma sensu). </p>
<dl><dt><b>Wartości wyliczeń: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggab04a0655cd1e3bcac5e8f48c18df1a57a8163c1c845c6cc766ba4d1b0d8a60c36"></a>GG_CLASS_MSG</em>&nbsp;</td><td>
<p>Wiadomość ma pojawić się w osobnym oknie. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggab04a0655cd1e3bcac5e8f48c18df1a57afcc792ce83299a41ea087b5595af0a29"></a>GG_CLASS_CHAT</em>&nbsp;</td><td>
<p>Wiadomość ma pojawić się w oknie rozmowy. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggab04a0655cd1e3bcac5e8f48c18df1a57a5ef165db4874c852e49aeca51a7128e9"></a>GG_CLASS_CTCP</em>&nbsp;</td><td>
<p>Wiadomość przeznaczona dla klienta Gadu-Gadu. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggab04a0655cd1e3bcac5e8f48c18df1a57ad31aaba07e24c54eb136739fdf0f35ce"></a>GG_CLASS_ACK</em>&nbsp;</td><td>
<p>Klient nie życzy sobie potwierdzenia. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggab04a0655cd1e3bcac5e8f48c18df1a57a29acd1b8de6f0ff5e72a25ff083a3d47"></a>GG_CLASS_QUEUED</em>&nbsp;</td><td>
<p>Wiadomość zakolejkowana na serwerze (tylko przy odbieraniu) </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga385c44f6fb256e5716a2302a5b940388"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">anonymous enum</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Atrybuty formatowania wiadomości. </p>
<dl><dt><b>Wartości wyliczeń: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a94c148486240df0354a8123ee5dd06c5"></a>GG_FONT_BOLD</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a8a000abdc55fed561d4871ac9f976305"></a>GG_FONT_ITALIC</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a1f3a57de68f8b37cfe5cc6fc6c59248e"></a>GG_FONT_UNDERLINE</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a802285a52382aa39fdc1fc0fc0b5849c"></a>GG_FONT_COLOR</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a756b07e02fb68e90274cf6471616400d"></a>GG_FONT_IMAGE</em>&nbsp;</td><td>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="gabc5c98fcc1211af2b80116dd6e0a035d"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">anonymous enum</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Status doręczenia wiadomości. </p>
<dl><dt><b>Wartości wyliczeń: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035dae3901917057a6657a756e5668d20a5ce"></a>GG_ACK_DELIVERED</em>&nbsp;</td><td>
<p>Wiadomość dostarczono. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da76575d0bafcb1e0e8a45d08788dc5b08"></a>GG_ACK_QUEUED</em>&nbsp;</td><td>
<p>Wiadomość zakolejkowano z powodu niedostępności odbiorcy. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da22cd918071954d3b6d39333ee85ddac7"></a>GG_ACK_BLOCKED</em>&nbsp;</td><td>
<p>Wiadomość zablokowana przez serwer (spam, świąteczne ograniczenia itd.) </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da8cf3fd01604ed358e04bcfc4c7ffc732"></a>GG_ACK_MBOXFULL</em>&nbsp;</td><td>
<p>Wiadomości nie dostarczono z powodu zapełnionej kolejki wiadomości odbiorcy. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da34c0aa23f1f67c05dc0034318339d486"></a>GG_ACK_NOT_DELIVERED</em>&nbsp;</td><td>
<p>Wiadomości nie dostarczono (tylko dla <code>GG_CLASS_CTCP</code>). </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Dokumentacja funkcji</h2>
<a class="anchor" id="gabcc076e57528b91518f573f59fadde08"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_send_message </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>msgclass</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>message</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła wiadomość do użytkownika. </p>
<p>Zwraca losowy numer sekwencyjny, który można zignorować albo wykorzystać do potwierdzenia.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">msgclass</td><td>Klasa wiadomości </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">message</td><td>Treść wiadomości</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>Numer sekwencyjny wiadomości lub -1 w przypadku błędu. </dd></dl>

</div>
</div>
<a class="anchor" id="ga2a30ed0ecd9691b7af77406619087a67"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_send_message_richtext </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>msgclass</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>message</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>format</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>formatlen</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła wiadomość formatowaną. </p>
<p>Zwraca losowy numer sekwencyjny, który można zignorować albo wykorzystać do potwierdzenia.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">msgclass</td><td>Klasa wiadomości </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">message</td><td>Treść wiadomości </td></tr>
    <tr><td class="paramname">format</td><td>Informacje o formatowaniu </td></tr>
    <tr><td class="paramname">formatlen</td><td>Długość informacji o formatowaniu</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>Numer sekwencyjny wiadomości lub -1 w przypadku błędu. </dd></dl>

</div>
</div>
<a class="anchor" id="ga48f3197c621872c670f49fe0d1ac25eb"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_send_message_confer </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>msgclass</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>recipients_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> *&#160;</td>
          <td class="paramname"><em>recipients</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>message</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła wiadomość w ramach konferencji. </p>
<p>Zwraca losowy numer sekwencyjny, który można zignorować albo wykorzystać do potwierdzenia.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">msgclass</td><td>Klasa wiadomości </td></tr>
    <tr><td class="paramname">recipients_count</td><td>Liczba adresatów </td></tr>
    <tr><td class="paramname">recipients</td><td>Wskaźnik do tablicy z numerami adresatów </td></tr>
    <tr><td class="paramname">message</td><td>Treść wiadomości</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>Numer sekwencyjny wiadomości lub -1 w przypadku błędu. </dd></dl>

</div>
</div>
<a class="anchor" id="ga0e5df383eeac438710656704fa4bdd30"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_send_message_confer_richtext </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>msgclass</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>recipients_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a> *&#160;</td>
          <td class="paramname"><em>recipients</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>message</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>format</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>formatlen</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła wiadomość formatowaną w ramach konferencji. </p>
<p>Zwraca losowy numer sekwencyjny, który można zignorować albo wykorzystać do potwierdzenia.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">msgclass</td><td>Klasa wiadomości </td></tr>
    <tr><td class="paramname">recipients_count</td><td>Liczba adresatów </td></tr>
    <tr><td class="paramname">recipients</td><td>Wskaźnik do tablicy z numerami adresatów </td></tr>
    <tr><td class="paramname">message</td><td>Treść wiadomości </td></tr>
    <tr><td class="paramname">format</td><td>Informacje o formatowaniu </td></tr>
    <tr><td class="paramname">formatlen</td><td>Długość informacji o formatowaniu</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>Numer sekwencyjny wiadomości lub -1 w przypadku błędu. </dd></dl>

</div>
</div>
<a class="anchor" id="ga2c03e907a237f1de9a0e22b252e333c5"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_send_message_ctcp </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>msgclass</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const unsigned char *&#160;</td>
          <td class="paramname"><em>message</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>message_len</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła wiadomość binarną przeznaczoną dla klienta. </p>
<p>Wiadomości między klientami przesyła się np. w celu wywołania zwrotnego połączenia bezpośredniego. Funkcja zwraca losowy numer sekwencyjny, który można zignorować albo wykorzystać do potwierdzenia.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">msgclass</td><td>Klasa wiadomości </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">message</td><td>Treść wiadomości </td></tr>
    <tr><td class="paramname">message_len</td><td>Długość wiadomości</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>Numer sekwencyjny wiadomości lub -1 w przypadku błędu. </dd></dl>

</div>
</div>
<a class="anchor" id="gad8f4addf7ac77bb992e42eb6e2de5b60"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_image_request </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>size</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint32_t&#160;</td>
          <td class="paramname"><em>crc32</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła żądanie obrazka o podanych parametrach. </p>
<p>Wiadomości obrazkowe nie zawierają samych obrazków, a tylko ich rozmiary i sumy kontrolne. Odbiorca najpierw szuka obrazków w swojej pamięci podręcznej i dopiero gdy ich nie znajdzie, wysyła żądanie do nadawcy. Wynik zostanie przekazany zdarzeniem <code>GG_EVENT_IMAGE_REPLY</code>.</p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">size</td><td>Rozmiar obrazka w bajtach </td></tr>
    <tr><td class="paramname">crc32</td><td>Suma kontrola obrazka</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>0 jeśli się powiodło, -1 w przypadku błędu </dd></dl>

</div>
</div>
<a class="anchor" id="ga8d1a50a10b076d0006c8b1b301394bd2"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int gg_image_reply </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>filename</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>image</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>size</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Wysyła żądany obrazek. </p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">filename</td><td>Nazwa pliku </td></tr>
    <tr><td class="paramname">image</td><td>Bufor z obrazkiem </td></tr>
    <tr><td class="paramname">size</td><td>Rozmiar obrazka</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>0 jeśli się powiodło, -1 w przypadku błędu </dd></dl>

</div>
</div>
<a class="anchor" id="ga27a5bb1766cbb99dae4e862eec635899"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structgg__typing__notification.html">gg_typing_notification</a> </td>
          <td>(</td>
          <td class="paramtype">struct <a class="el" href="structgg__session.html">gg_session</a> *&#160;</td>
          <td class="paramname"><em>sess</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="libgadu_8h.html#a33f630ba74294027f9bcda26ed49cdc8">uin_t</a>&#160;</td>
          <td class="paramname"><em>recipient</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>length</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Informuje rozmówcę o pisaniu wiadomości. </p>
<dl class="params"><dt>Parametry:</dt><dd>
  <table class="params">
    <tr><td class="paramname">sess</td><td>Struktura sesji </td></tr>
    <tr><td class="paramname">recipient</td><td>Numer adresata </td></tr>
    <tr><td class="paramname">length</td><td>Długość wiadomości lub 0 jeśli jest pusta</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Zwraca:</dt><dd>0 jeśli się powiodło, -1 w przypadku błędu </dd></dl>

</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Wygenerowano przez &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.1.1
</small></address>
</body>
</html>