GetPatternData Method

Navigation:  Reference Guide > Methods >

GetPatternData Method

Previous pageReturn to chapter overviewNext page

Gets the PDF417 barcode pattern matrix data.

BOOL GetPatternData(short *Buffer,

                                  long *Size,

                                  short *Rows,

                                  short *Columns,

                                  VARIANT_BOOL *Result);

 

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 method fails and the variable pointed to by Size returns the required buffer size, in 16-bit integers.

Size

[in/out] On input, specifies the size, in 16-bit integers, of the Buffer. On output, receives the size, in 16-bit integers, of the PDF417 barcode pattern matrix data ('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..

Result

If the method succeeds, the value of the variable pointed to by Result is VARIANT_TRUE, otherwise the value is VARIANT_FALSE.

 

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.