PA_GetExportFilter

version 2003

PA_GetExportFilter → char *

The routine PA_GetExportFilter returns pointer to the export ASCII map for the current process.

This pointer is valid until the process is terminated. There is one export ASCII map per process and, by default, when a new process is started, the export ASCII map is set to the default map (each character is exported as is).

The pointer returned is a pointer to a private data structure maintained for each process; therefore, do not attempt any Memory Manager calls using this pointer.

The export ASCII map for a process is used by 4th Dimension to:

• Export a selection of records using EXPORT TEXT , EXPORT DIF or EXPORT SYLK ,

• Print a Quick Report using a direct ASCII printer driver,

• Write or send characters to a document or a serial port using SEND PACKET .

This routine has two purposes:

• The 4D Plug-in has text export capabilities and the export ASCII map is required inside those routines. To obtain the filtered ASCII code of a character, get the value of the corresponding element from the array. If, for example, the filtered ASCII code of the character whose ASCII code is 225 is needed, read the value of the 225th element from the table whose pointer is returned.

• The 4D Plug-in provides export ASCII map editing capabilities. To map a character to another, simply change the value of the corresponding element.

For example, to change the filtered ASCII code of the character whose ASCII code is 225, change the value of the 225th element from the table whose pointer is returned.

PA_GetImportFilter , USE ASCII MAP .