New to Telerik UI for WinForms? Download free 30-day trial

Getting Started

This article will give you getting started experience with RadChat.

1. To start using RadChat just drag it from the toolbox and drop it onto the form:

winforms/chat-items-getting-started 001

2. Set the RadChat.Author property:

Setting default author

this.radChat1.Author = new Author(Properties.Resources.architect, "Ben");

Me.radChat1.Author = New Author(My.Resources.architect, "Ben")

Now, you are ready to start sending messages:

winforms/chat-items-getting-started 002

By default, when you enter some input in the text box and press the Enter key to confirm the message, it is automatically added to RadChat. This is controlled by the RadChat.AutoAddUserMessages property which default value is true. Once a message is confirmed either by pressing the Enter key or by clicking the arrow sign, the RadChat.SendMessage event is fired.

If the RadChat.AutoAddUserMessages property is set to false the message from the text box won't be automatically added to the messages' view. In the SendMessage event you can add the message programmatically.

Adding message programmatically

private void AddMessageProgrammatically()
    this.radChat1.AutoAddUserMessages = false;
    this.radChat1.SendMessage += radChat1_SendMessage;

private void radChat1_SendMessage(object sender, SendMessageEventArgs e)
    ChatTextMessage textMessage = e.Message as ChatTextMessage;
    textMessage.Message = "[Slightly changed message] " + textMessage.Message;

Private Sub AddMessageProgrammatically()
    Me.radChat1.AutoAddUserMessages = False
    AddHandler Me.radChat1.SendMessage, AddressOf radChat1_SendMessage
End Sub
Private Sub radChat1_SendMessage(ByVal sender As Object, ByVal e As SendMessageEventArgs)
    Dim textMessage As ChatTextMessage = TryCast(e.Message, ChatTextMessage)
    textMessage.Message = "[Slightly changed message] " & textMessage.Message
End Sub

winforms/chat-items-getting-started 003

See Also

In this article
Not finding the help you need? Improve this article