AnnSetUser method (Annotation Control)

C++ Builder example

Delphi example

 

Builder Syntax

int AnnSetUser(LEADTyp::L_HANDLE hObject, char * pOldUser, char * pNewUser, bool bSelected);

Delphi Syntax

Function AnnSetUser(hObject: L_HANDLE; pOldUser: PChar; pNewUser: PChar; bSelected: Boolean): Integer;

Overview

Refer to Implementing Annotation Security.

Remarks

(Document/Medical only) Sets the user string for the specified object.

If the specified object does not have a specified user, set pOldUser to Nil and set pNewUser to the new user string.

To change an object’s user, set pOldUser to the old user string and set pNewUser to the new user string. For any object having a specified user, you must know the old user string in order to change the user.

You can change an object from having a specified user to having no user by setting pOldUser to the old user string and setting pNewUser to Nil.

Please note that when using bSelected to change the user on more than one object, only those objects with a user set to pOldUser will be changed. For example, if pOldUser is set to "YourObject" and pNewUser is set to "MyObject", and bSelected is True, only those objects having user "YourObject" will be changed. Objects with other users, or with Nil users will not be modified.

See Also

Elements:

AnnLock method, OnAnnLocked event, OnAnnUnlocked event, AnnUnlock method

Topics:

Annotations (Document/Medical only): Annotation Security