LEADTOOLS Annotations for WPF and Silverlight (Leadtools.Windows.Annotations assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.31
Lock Method
See Also 
Leadtools.Windows.Annotations Namespace > AnnObject Class : Lock Method



password
String containing the password used to lock the annotation object.
password
String containing the password used to lock the annotation object.
Locks this AnnObject with the specified password. Supported in Silverlight, Windows Phone 7

Syntax

Visual Basic (Declaration) 
Public Overridable Sub Lock( _
   ByVal password As String _
) 
Visual Basic (Usage)Copy Code
Dim instance As AnnObject
Dim password As String
 
instance.Lock(password)
C# 
public virtual void Lock( 
   string password
)
C++/CLI 
public:
virtual void Lock( 
   String^ password
) 

Parameters

password
String containing the password used to lock the annotation object.

Example

This method changes the 'lock' state of an object.

Visual BasicCopy Code
Public Sub AnnObject_Lock(ByVal obj As AnnObject, ByVal password As String)
   If obj.IsLocked Then
      MessageBox.Show("Object is locked. It will be unlocked.")
      If String.Compare(password, obj.Password, False) <> 0 Then
         MessageBox.Show("Invalid password!!")
      Else
         obj.Unlock(password)
      End If
   Else
      MessageBox.Show("Object was not locked. It will be locked now.")
      obj.Lock(password)
   End If
End Sub
C#Copy Code
public void AnnObject_Lock(AnnObject obj, string password)
{
   if(obj.IsLocked)
   {
      MessageBox.Show("Object is locked. It will be unlocked.");
      if(string.Compare(password, obj.Password, false) != 0)
         MessageBox.Show("Invalid password!!");
      else
         obj.Unlock(password);
   }
   else
   {
      MessageBox.Show("Object was not locked. It will be locked now.");
      obj.Lock(password);
   }
}
SilverlightCSharpCopy Code
public void AnnObject_Lock(AnnObject obj, string password)
{
   if(obj.IsLocked)
   {
      MessageBox.Show("Object is locked. It will be unlocked.");
      if(string.Compare(password, obj.Password, StringComparison.Ordinal) != 0)
         MessageBox.Show("Invalid password!!");
      else
         obj.Unlock(password);
   }
   else
   {
      MessageBox.Show("Object was not locked. It will be locked now.");
      obj.Lock(password);
   }
}
SilverlightVBCopy Code
Public Sub AnnObject_Lock(ByVal obj As AnnObject, ByVal password As String)
   If obj.IsLocked Then
      MessageBox.Show("Object is locked. It will be unlocked.")
      If String.Compare(password, obj.Password, StringComparison.Ordinal) <> 0 Then
         MessageBox.Show("Invalid password!!")
      Else
         obj.Unlock(password)
      End If
   Else
      MessageBox.Show("Object was not locked. It will be locked now.")
      obj.Lock(password)
   End If
End Sub

Remarks

Only unlocked objects can be locked. If an object is already locked, it will stay locked with its original password. You must pass the same password to AnnObject.Unlock to unlock this AnnObject.

If this method succeeds, password will be stored inside the object and can be retrieved with the Password property.

An object must be unlocked in order to change that object in automated mode.

For more information, refer to Implementing WPF Annotation Security.

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also

Lock requires a Document/Medical product license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features and Unlocking Special LEAD Features.