Delta Chat Core C Interface
Macros
DC_CHAT_VISIBILITY

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

Macros

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

Detailed Description

These constants describe the visibility of a chat. The chat visibiliry 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 the the end of the chatlist.

The UI typically shows a little icon or chats beside archived chats in the chatlist, this is needed as eg. 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.