Reference Guide > Methods > GetPatternData Method

Gets the PDF417 barcode pattern matrix data.

[Visual Basic .NET]

Public Function GetPatternData(ByRef Buffer() As Char, _

ByRef Size As Long, _

ByRef Rows As Integer, _

ByRef Columns As Integer) As Boolean

[C#]

public bool GetPatternData(ref char[] Buffer,

ref long Size,

ref int Rows,

ref int Columns);

Parameters

Buffer

Pointer to a buffer that receives the character stream ('1's and '0's) storing the PDF417 barcode pattern matrix data row by row from the top left matrix corner, '1' indicates the narrow bar and '0' indicates the narrow space.

If the function fails and the variable pointed to by Size returns the required buffer size, in characters.

Size

[in/out] On input, specifies the size, in characters, of the Buffer. On output, receives the size, in characters, of the PDF417 barcode pattern matrix ('1's and '0's).

Rows

A pointer to the variable that receives the number of the rows for the pattern matrix.

Columns

A pointer to the variable that receives the number of the columns for the pattern matrix..

Return Value

If the function succeeds, the return value is a nonzero value, otherwise the return value is zero.

Remarks

You can use this method to obtain the PDF417 barcode pattern matrix data and render the PDF417 barcode onto any device such as the printer, only Columns, Data, ErrorCorrectionLevel, HandleTilde, Mode, Rows and TruncateSysmbol properties affect the pattern matrix data output.

Based on the Orientation property value, rotate the pattern matrix accordingly before you render the PDF417 barcode onto a device.

If the Orientation property value is 0 (no rotation) or 2 (180-degree rotation), the ratio of the height to the width for the rectangles (the narrow bar and the narrow space) must be equal to the Y2XRatio property value, the width of the rectangles is specified by the NarrowBarWidth property.

If the Orientation property value is 1 (90-degree rotation) or 3 (270-degree rotation), the ratio of the width to the height for the rectangles (the narrow bar and the narrow space) must be equal to the Y2XRatio property value, the height of the rectangles is specified by the NarrowBarWidth property.