Access Method

Provides exclusive access to the image data contained in this RasterImage.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public void Access()

'Declaration
 
Public Sub Access()

'Usage
 
Dim instance As RasterImage
 
instance.Access()

public void Access()

 function Leadtools.RasterImage.Access()

public:
void Access();

Remarks

If the image data of this RasterImage object is stored in a global Windows handle, then use the Access method to lock the memory. If you do not call this method before accessing the data with a low-level method like GetRow(Int32,Byte[],Int32,Int32) or SetRow(Int32,Byte[],Int32,Int32)the application might fail.

To make the most of available system resources, you should only keep a RasterImage object locked when you need to access the image data. Call Release to unlock the image data for more efficient use of system memory resources.

If the image data of this RasterImage is not stored in a global Windows handle, then this method will do nothing and calling it will not have any effect on the RasterImage.

Use IsGlobalMemory to determine whether the image data of this RasterImage is stored in a global Windows handle.

For WinRT, use AccessData and ReleaseData.

Example

For an example, refer to GetRow(Int32,Byte[],Int32,Int32)

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RasterImage Class
RasterImage Members