ChangeUserProperty Method


		Contents Index Topic Contents
	Previous Topic: ChangeNickname Method Next Topic: Connect Method

ChangeUserProperty Method

Asynchronously modifies a user property.
Syntax
object.ChangeUserProperty UserPropertyName, NewUserProperty[, Nickname]
Parameters

object Required. An object expression that evaluates to an MsChatPr control.

UserPropertyName Required. A string that must contain one of these two valid values: "Modes" or "Nickname".

NewUserProperty Required. A variant, the type of which depends on the new user property.

Nickname Optional. A variant. Can be omitted or empty, in which case the call concerns the control user. Otherwise, the Nickname must be a current server user.

Remarks

This method can be used to change nicknames, user Modes, or ignore/stop ignoring other users. Callers can change only their own nickname or user modes.
A successful call to ChangeUserProperty results in an OnUserPropertyChanged event.
You cannot ignore a server system operator or administrator.

Examples
1. Change the nickname:
MsChatPr1.ChangeUserProperty "Nickname", "ElisabethH", "Moi"
'or
MsChatPr1.ChangeUserProperty "Nickname", "ElisabethH"
    'This is equivalent to MsChatPr1.ChangeNickname "ElisabethH"
2. Become invisible:
MsChatPr1.ChangeUserProperty "Modes", umInvisible
3. Give up the system operator privileges and become visible:
MsChatPr1.ChangeUserProperty "Modes", umNotSysop + umNotInvisible
4. Ignore a user:
MsChatPr1.ChangeUserProperty "Modes", umClientIgnored, "Maja"
5. Stop ignoring a user:
MsChatPr1.ChangeUserProperty "Modes", umNotClientIgnored, "Maja"
See Also

ChangeNickname

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

object	Required. An object expression that evaluates to an MsChatPr control.
UserPropertyName	Required. A string that must contain one of these two valid values: "Modes" or "Nickname".
NewUserProperty	Required. A variant, the type of which depends on the new user property.
Nickname	Optional. A variant. Can be omitted or empty, in which case the call concerns the control user. Otherwise, the Nickname must be a current server user.