TRVChat.AddMessage

Методы добавляют новое сообщение в конец чата. Это два метода с одинаковой функциональностью, отличающиеся только способом передачи параметров: напрямую или через запись.

function AddMessage(AUser: TRVChatUser;

const AText: TRVUnicodeString;
ADateTime: TDateTime = 0;

Extra: TRVChatMessageExtra = nil;
AState: TRVChatMessageState = rvcmsDefault):

TRVChatMessage;

function AddMessage(

const Data: TRVChatMessageInsertionInfo):

TRVChatMessage;

Методы добавляют новое сообщение в конец чата. Они обновляют содержимое ChatRichView и добавляют новый элемент в конец коллекции Messages.

Перед вызовом этих методов ChatRichView должен быть отформатирован. Методы форматируют добавленное сообщение.

Если ChatRichView был прокручен до самого низа, после добавления он прокручивается до конца нового сообщения. В противном случае положение вертикальной прокрутки не изменяется.

Параметры:

AUser – ссылка на пользователя, автора сообщения. Это ссылка на один из элементов коллекции Users.

AText – текст сообщения. Если Extra = nil или Extra имеет тип TRVChatMessageExtraQuote, текст не может быть пустым. Текст может состоять из нескольких строк. Чат автоматически распознаёт URL в тексте (см. RVIsURL).

ADateTime – время сообщения. Если значение равно 0, используется текущее время.

Extra – дополнительные данные, прикреплённые к сообщению: файлы, изображение или цитата. Это может быть объект одного из следующих классов:

•TRVChatMessageExtraFiles для прикрепления файлов;

•TRVChatMessageExtraImage для прикрепления изображения;

•TRVChatMessageExtraQuote для добавления цитаты;

•nil – без дополнительных данных.

Если Extra.AutoDestroy = True, метод освобождает Extra, если сообщение было успешно добавлено.

AState – состояние сообщения.

Возвращаемое значение:

Ссылка на добавленное сообщение в случае успеха; nil в противном случае.

См. также:

InsertMessage