matrix-glib-sdk/Matrix-0.0-MatrixEventRoomMessageFeedback.html

291 lines
16 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>MatrixEventRoomMessageFeedback: Matrix-0.0 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Matrix-0.0 Reference Manual">
<link rel="up" href="ch01.html" title="Matrix-0.0 API Reference">
<link rel="prev" href="Matrix-0.0-MatrixEventReceipt.html" title="MatrixEventReceipt">
<link rel="next" href="Matrix-0.0-MatrixHTTPClient.html" title="MatrixHTTPClient">
<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#Matrix-0.0-MatrixEventRoomMessageFeedback.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="Matrix-0.0-MatrixEventReceipt.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="Matrix-0.0-MatrixHTTPClient.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="Matrix-0.0-MatrixEventRoomMessageFeedback.top_of_page"></a>MatrixEventRoomMessageFeedback</span></h2>
<p>MatrixEventRoomMessageFeedback — Class to hold a m.room.message.feedback event.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback.functions"></a><h2>Functions</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MATRIX-EVENT-TYPE-ROOM-MESSAGE-FEEDBACK:CAPS" title="MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK">MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK</a></td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="returnvalue">MatrixEventRoomMessageFeedback</span></a> *
</td>
<td class="function_name">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#matrix-event-room-message-feedback-new" title="matrix_event_room_message_feedback_new ()">matrix_event_room_message_feedback_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#matrix-event-room-message-feedback-get-feedback-type" title="matrix_event_room_message_feedback_get_feedback_type ()">matrix_event_room_message_feedback_get_feedback_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#matrix-event-room-message-feedback-set-feedback-type" title="matrix_event_room_message_feedback_set_feedback_type ()">matrix_event_room_message_feedback_set_feedback_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#matrix-event-room-message-feedback-get-target-event-id" title="matrix_event_room_message_feedback_get_target_event_id ()">matrix_event_room_message_feedback_get_target_event_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#matrix-event-room-message-feedback-set-target-event-id" title="matrix_event_room_message_feedback_set_target_event_id ()">matrix_event_room_message_feedback_set_target_event_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback">MatrixEventRoomMessageFeedback</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedbackClass" title="struct MatrixEventRoomMessageFeedbackClass">MatrixEventRoomMessageFeedbackClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback.description"></a><h2>Description</h2>
<p>Usage of this event is discouraged in favour of the receipts module. Most clients will not recognise this event.</p>
<p>Feedback events are events sent to acknowledge a message in some way. There are two supported acknowledgements: `delivered` (sent when the event has been received) and `read` (sent when the event has been observed by the end-user). The `target_event_id` should reference the `m.room.message` event being acknowledged.</p>
</div>
<div class="refsect1">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="MATRIX-EVENT-TYPE-ROOM-MESSAGE-FEEDBACK:CAPS"></a><h3>MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK</h3>
<pre class="programlisting">#define MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK (matrix_event_room_message_feedback_get_type ())
</pre>
<p>The type for <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a>.</p>
</div>
<hr>
<div class="refsect2">
<a name="matrix-event-room-message-feedback-new"></a><h3>matrix_event_room_message_feedback_new ()</h3>
<pre class="programlisting"><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="returnvalue">MatrixEventRoomMessageFeedback</span></a> *
matrix_event_room_message_feedback_new
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="matrix-event-room-message-feedback-get-feedback-type"></a><h3>matrix_event_room_message_feedback_get_feedback_type ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
matrix_event_room_message_feedback_get_feedback_type
(<em class="parameter"><code><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> *self</code></em>);</pre>
<p>Get and return the current value of the <span class="type">"feedback-type"</span> property.</p>
<p>The type of the feedback. As the use of this event type is discouraged, Matrix GLib SDK doesnt implement this as an actual enum.</p>
<div class="refsect3">
<a name="id-1.2.20.6.4.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> instance to query</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.2.20.6.4.7"></a><h4>Returns</h4>
<p> the value of the <span class="type">"feedback-type"</span> property</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="matrix-event-room-message-feedback-set-feedback-type"></a><h3>matrix_event_room_message_feedback_set_feedback_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
matrix_event_room_message_feedback_set_feedback_type
(<em class="parameter"><code><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
<p>Set the value of the <span class="type">"feedback-type"</span> property to <em class="parameter"><code>value</code></em>
.</p>
<p>The type of the feedback. As the use of this event type is discouraged, Matrix GLib SDK doesnt implement this as an actual enum.</p>
<div class="refsect3">
<a name="id-1.2.20.6.5.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> instance to modify</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the new value of the <span class="type">"feedback-type"</span> property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="matrix-event-room-message-feedback-get-target-event-id"></a><h3>matrix_event_room_message_feedback_get_target_event_id ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
matrix_event_room_message_feedback_get_target_event_id
(<em class="parameter"><code><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> *self</code></em>);</pre>
<p>Get and return the current value of the <span class="type">"target-event-id"</span> property.</p>
<p>The event that this feedback is related to.</p>
<div class="refsect3">
<a name="id-1.2.20.6.6.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> instance to query</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.2.20.6.6.7"></a><h4>Returns</h4>
<p> the value of the <span class="type">"target-event-id"</span> property</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="matrix-event-room-message-feedback-set-target-event-id"></a><h3>matrix_event_room_message_feedback_set_target_event_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
matrix_event_room_message_feedback_set_target_event_id
(<em class="parameter"><code><a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
<p>Set the value of the <span class="type">"target-event-id"</span> property to <em class="parameter"><code>value</code></em>
.</p>
<p>The event that this feedback is related to.</p>
<div class="refsect3">
<a name="id-1.2.20.6.7.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MatrixEventRoomMessageFeedback" title="struct MatrixEventRoomMessageFeedback"><span class="type">MatrixEventRoomMessageFeedback</span></a> instance to modify</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the new value of the <span class="type">"target-event-id"</span> property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="Matrix-0.0-MatrixEventRoomMessageFeedback.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="MatrixEventRoomMessageFeedback"></a><h3>struct MatrixEventRoomMessageFeedback</h3>
<pre class="programlisting">struct MatrixEventRoomMessageFeedback {
MatrixEventRoom parent_instance;
MatrixEventRoomMessageFeedbackPrivate * priv;
};
</pre>
<p>Class to hold a m.room.message.feedback event.</p>
<p>Usage of this event is discouraged in favour of the receipts module. Most clients will not recognise this event.</p>
<p>Feedback events are events sent to acknowledge a message in some way. There are two supported acknowledgements: `delivered` (sent when the event has been received) and `read` (sent when the event has been observed by the end-user). The `target_event_id` should reference the `m.room.message` event being acknowledged.</p>
</div>
<hr>
<div class="refsect2">
<a name="MatrixEventRoomMessageFeedbackClass"></a><h3>struct MatrixEventRoomMessageFeedbackClass</h3>
<pre class="programlisting">struct MatrixEventRoomMessageFeedbackClass {
MatrixEventRoomClass parent_class;
};
</pre>
<p>The class structure for <a class="link" href="Matrix-0.0-MatrixEventRoomMessageFeedback.html#MATRIX-EVENT-TYPE-ROOM-MESSAGE-FEEDBACK:CAPS" title="MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK"><code class="literal">MATRIX_EVENT_TYPE_ROOM_MESSAGE_FEEDBACK</code></a>. All the fields in this structure are private and should never be accessed directly.</p>
<div class="refsect3">
<a name="id-1.2.20.7.3.5"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody><tr>
<td class="struct_member_name"><p><a class="link" href="Matrix-0.0-MatrixEventRoom.html#MatrixEventRoomClass" title="struct MatrixEventRoomClass"><span class="type">MatrixEventRoomClass</span></a> <em class="structfield"><code><a name="MatrixEventRoomMessageFeedbackClass.parent-class"></a>parent_class</code></em>;</p></td>
<td class="struct_member_description"><p>the parent class structure</p></td>
<td class="struct_member_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.24</div>
</body>
</html>