DC_CHAT_VISIBILITY

Macros
#define	DC_CHAT_VISIBILITY_ARCHIVED   1
	Archived chats are not included in the default chatlist returned by dc_get_chatlist().
#define	DC_CHAT_VISIBILITY_NORMAL   0
	Chats with normal visibility are not archived and are shown below all pinned chats.
#define	DC_CHAT_VISIBILITY_PINNED   2
	Pinned chats are included in the default chatlist.

Detailed Description

These constants describe the visibility of a chat. The chat visibility can be get using dc_chat_get_visibility() and set using dc_set_chat_visibility().

Macro Definition Documentation

DC_CHAT_VISIBILITY_ARCHIVED

#define DC_CHAT_VISIBILITY_ARCHIVED   1

Archived chats are not included in the default chatlist returned by dc_get_chatlist().

Instead, if there are any archived chats, the pseudo-chat with the chat ID DC_CHAT_ID_ARCHIVED_LINK will be added at the end of the chatlist.

The UI typically shows a little icon or chats beside archived chats in the chatlist, this is needed as e.g. the search will also return archived chats.

If archived chats receive new messages, they become normal chats again.

To get a list of archived chats, use dc_get_chatlist() with the flag DC_GCL_ARCHIVED_ONLY.

DC_CHAT_VISIBILITY_NORMAL

#define DC_CHAT_VISIBILITY_NORMAL   0

Chats with normal visibility are not archived and are shown below all pinned chats.

Archived chats, that receive new messages automatically become normal chats.

DC_CHAT_VISIBILITY_PINNED

#define DC_CHAT_VISIBILITY_PINNED   2

Pinned chats are included in the default chatlist.

moreover, they are always the first items, whether they have fresh messages or not.