API Reference 
271 
Task 
Meaning 
LL_DRILLDOWN_START 
Start 
LL_DRILLDOWN_FINALIZE 
Finalize 
_nUserParameter: Value passed with LL_OPTION_DRILLDOWNPARAMETER 
_pszTableID: Points to a string containing the name of the child table 
_pszRelationID:  Points  to  a  string  containing  the  name  of  the  relation 
between child and parent table 
_pszSubreportTableID:  Points  to a  string  containing the  name of  the child 
table. 
_pszKeyField: Points to a string containing the name of the key field of the 
parent  table.  If  the  relation  contains  different  key  fields,  the  result  is  tab 
delimited. 
Please 
note 
the 
description 
of 
the 
function 
LlDbAddTableRelationEx(). 
_pszSubreportKeyField:  Points  to  a  string  containing  the name of  the  key 
field of the child table. If the relation contains different key fields, the result is 
tab  delimited.  Please  note  the  description  of  the  function 
LlDbAddTableRelationEx(). 
_pszKeyValue: Points to a string containing the contents of the key field of 
the parent table. If the relation contains different key fields, the result is tab 
delimited. 
Please 
note 
the 
description 
of 
the 
function 
LlDbAddTableRelationEx(). 
_pszProjectFileName: Name of the project file to be processed. 
_pszPreviewFileName: Name of the preview file that has to be created. 
_pszTooltipText: Points to a string containing the tool tip text when hovering 
over a table entry, that can trigger a drilldown report. 
_pszTabText:  Points to a  string containing the tab text, if the user wants a 
drilldown report shown in a separate tab. 
_hWnd: Window handle to show own dialogs (window handle of the preview 
control). 
_nID: Unique drilldown job ID, should not be mistaken with the List & Label 
print job. To make a unique assignement, in the FINALIZE task this ID contains 
the value that has been assigned in the START task.  
.Pdf to .txt converter - SDK Library service:C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
www.rasteredge.com
.Pdf to .txt converter - SDK Library service:VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
www.rasteredge.com
API Reference 
272 
_hAttachInfo:  This  parameter  is  needed  for  LlAssociatePreviewControl()  to 
attach  the  viewer.  Additionally  the  flags  LL_ASSOCIATEPREVIEW-
CONTROLFLAG_DELETE_ON_CLOSE 
and 
LL_ASSOCIATEPREVIEW-
CONTROLFLAG_HANDLE_IS_ATTACHINFO  must  be  used.  Further  infor-
mation can be found in chapter "4.5. Printing Relational Data". 
Hints: 
This  callback  will  always  be  called  in  the  context  of  the  preview  thread, 
regardless if initiated from designer or preview print. 
Example: 
See chapter "4.5. Printing Relational Data". 
LL_QUERY_DESIGNERACTIONSTATE 
Task: 
Via this callback List & Label checks the state of the user defined Actions (see 
LlDesignerAddAction()). You can then, depending on requirements, enable or 
disable the actions. 
Activate: 
Always active  
Parameter: 
HIWORD(lParam): the (user defined) ID for the action 
LOWORD(lParam): Status setting as set by Designer 
Return value (_lResult): 
Value 
Meaning 
Action is active 
Action is not active 
Example: 
case LL_QUERY_DESIGNERACTIONSTATE: 
_lResult = (bEnabled? 1 : 2); 
break; 
SDK Library service:Online Convert PDF to Text file. Best free online PDF txt
Online PDF to Text Converter. Download Free Trial. Convert a PDF to Text. Just upload your file by clicking on the blue button or drag
www.rasteredge.com
SDK Library service:VB.NET Create PDF from Text to convert txt files to PDF in vb.net
Sample code for text to PDF converting in VB.NET programming . ' txt convert to pdf Dim txt As BaseDocument = New RasterEdge.XDoc.Converter.Inner.TXTDocument("C
www.rasteredge.com
API Reference 
273 
5.3. Managing Preview Files 
5.3.1. Overview  
The preview print contained in List & Label writes the preview data into a file. This file 
can  be  archived  for  later  use,  sent  to  another user  who  can  look  at  it  or  print  it 
without any loss of quality. 
All data is stored in one file. Using the optional compression that you can switch on 
using  
LlSetOption(hJob, LL_OPTION_COMPRESSSTORAGE, 1) 
the file size can be reduced by up to 2/3. Compression slows down the print process 
but  is  convenient,  for  example,  if  you  wish  to  present  data  on  the  Internet  for 
download or preview using our OCX. 
The file has the extension ".LL". We do not provide any information about its inner 
structure, and we recommend that you do no rely on any details you may find out! 
This is intentional, as we have our own API to access the data contained in it, so that 
there is no advantage for you in seeing inside the file. We wish to be free to change 
the format whenever necessary, without having conflicts with existing software. 
5.3.2. The Preview API 
You do not need to worry about the details of the preview files - the API functions 
LlStgsysxxx() do that for you. 
All  of  these  functions  are exported  by  the  C?LS16.DLL.  This  DLL,  which  you  will 
usually distribute with external viewers, is as small as possible. If you wish to use 
this  DLL  via  an  import  library,  you  need  to  link  to  the  C?LS16.LIB  file.  In  some 
programming languages, it is sufficient to include the respective declaration file. 
LlStgsysAppend 
Syntax: 
INT LlStgsysAppend (HLLSTG hStg, HLLSTG hStgToAppend); 
Task: 
Append another preview job to the current storage file. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
hStgToAppend: Handle of the preview file to append. 
SDK Library service:C# Create PDF from Text to convert txt files to PDF in C#.net, ASP
XDoc.PDF Library for .NET in C#. Best C# text to PDF converter SDK for converting adobe PDF from TXT in Visual Studio .NET project.
www.rasteredge.com
SDK Library service:VB.NET PDF - Convert PDF with VB.NET WPF PDF Viewer
An advanced PDF converter tool, which supports to be integrated in .NET project, and compatible with all Export PDF text content to TXT file with
www.rasteredge.com
API Reference 
274 
Return value: 
<0: Error code 
= 0: okay 
Hints: 
This  function  needs  both  (!)  preview  files  to  be  in  the  LL_STG_STORAGE 
format. 
Of course, the current storage format may not be opened with bReadOnly = 
TRUE! 
Example: 
HLLSTG hStgOrg; 
HLLSTG hStgAppend; 
hStgOrg = LlStgsysStorageOpen("c:\\test\\label1.ll", FALSE, FALSE); 
hStgAppend = LlStgsysStorageOpen("c:\\test\\label2.ll", FALSE, TRUE); 
LlStgsysAppend(hStgOrg, hStgAppend); 
LlStgsysClose(hStgsysOrg); 
LlStgsysClose(hStgsysAppend); 
LlStgsysConvert 
Syntax: 
INT LlStgsysConvert (HLLSTG hStg, LPCTSTR pszDstFilename,  
 LPCTSTR pszFormat); 
Task: 
Converts a preview file to another format. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
pszDstFilename: Name of the target file. It is also possible to use the place 
marker  %d  (e.g.  "page  %d").  This  is  important  e.g.  for  converting  JPEGs, 
because without the place marker only one page will result. 
pszFormat: Target format. Valid values are: 
"TIFF" (also "PICTURE_MULTITIFF") 
"JPEG" (also "PICTURE_JPEG") 
"PNG" (also "PICTURE_PNG") 
"EMF" 
"TTY" 
"PDF" 
"PRN" 
"XPS" 
SDK Library service:VB.NET TIFF: TIFF to Text (TXT) Converter SDK; Convert TIFF to
can not only convert TIFF to .txt file, but this VB.NET TIFF to text converter library only provide powerful & profession imaging controls, PDF document, tiff
www.rasteredge.com
SDK Library service:C# PDF Converter Library SDK to convert PDF to other file formats
A best C# PDF converter control for adobe PDF document conversion in Visual Studio .NET applications. Allow users to convert PDF to Text (TXT) file.
www.rasteredge.com
API Reference 
275 
This parameter allows you to declare a semicolon-separated list with further 
export options. You will find the accepted values in the chapter "The Export 
Modules". An example is the parameters "PDF;PDF.EncryptionFile=1".  
Additional to the mentioned parameters above the following parameters can 
be used: 
Value 
Meaning 
PageIndexRange 
Analog  to  the  print  options  dialog  a 
range for pages can be set. 
JobIndexRange 
Analog  to  the  print  options  dialog  a 
range for the job can be set. 
IssueIndexRange 
Analog  to  the  print  options  dialog  a 
range for the issues can be set. 
An example of this is the use of " PDF;Export.PageIndexRange=2-3".  
With this, only pages 2 and 3 are converted to PDF. 
Return value: 
<0: Errorcode 
= 0: okay 
Hints: 
Example: 
HLLSTG hStgOrg; 
hStgOrg = LlStgsysStorageOpen("c:\\test\\label1.ll", "",  
FALSE, TRUE); 
LlStgsysStorageConvert(hStgOrg, "c:\\test\\label2.pdf", "PDF"); 
LlStgsysStorageClose(hStgOrg); 
See also: 
LlStgsysStorageOpen, LlStgsysStorageConvert 
LlStgsysDeleteFiles 
Syntax: 
void LlStgsysDeleteFiles (HLLSTG hStg); 
Task: 
Erases the preview file(s). 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
SDK Library service:C# WPF PDF Viewer SDK to convert and export PDF document to other
An advanced .NET WPF PDF converter library for converting PDF in C#.NET WPF program. Export PDF text content to TXT file with original layout.
www.rasteredge.com
SDK Library service:VB.NET PDF - WPF PDF Viewer for VB.NET Program
XDoc.HTML5 Viewer. XDoc.Windows Viewer. XDoc.Converter. View & Process. Users can export and convert PDF to Word, Tiff, TXT and various of image file formats.
www.rasteredge.com
API Reference 
276 
Return value: 
<0: Error code 
= 0: okay 
Hints: 
This function erases the preview file(s). The only call that makes sense after 
this call is LlStgsysStorageClose(). 
See also: 
LlStgsysStorageOpen, LlStgsysStorageClose 
LlStgsysDestroyMetafile 
Syntax: 
INT LlStgsysDestroyMetafile (HANDLE hMF); 
Task: 
Releases the metafile handle. 
Parameter: 
hMF: (enhanced) metafile handle 
Return value: 
<0: Error code 
= 0: okay 
Example: 
See LlStgsysGetPageMetafile 
See also: 
LlStgsysGetPageMetafile 
LlStgsysDrawPage 
Syntax: 
void LlStgsysDrawPage (HLLSTG hStg, HDC hDC, HDC hPrnDC,  
 BOOL bAskPrinter, _PCRECT pRC, INT nPageIndex, BOOL bFit,  
 LPVOID pReserved); 
Task: 
Paints a preview page to a screen or printer device. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
hDC: DC for printing (usually a printer or screen device). Can be NULL (see 
below). 
API Reference 
277 
hPrnDC: Reference DC which can be used to get the unprintable area etc. For 
a screen DC, this is the (default) printer DC, for a printer DC it is the same as 
hDC above. Can be NULL (See below). 
bAskPrinter: If hPrnDC is NULL, this flag defines whether the user is asked 
about the printer for the reference DC. If it is TRUE, he will be asked, if it is 
FALSE, the default printer will be used. 
pRC:  Points  to  a  RECT  structure  containing  the  device  coordinates  for 
printing. If this is NULL, the printer's values will be used. Must not be NULL 
when printing to a non-printer DC! 
nPageIndex: Page index (1..LlStgsysGetPageCount()) 
bFit: Defines whether the print should fit into the area (TRUE) or whether the 
original size should be kept (FALSE), although the latter might result in clipped 
output due to differences in paper size, unprintable area etc.. 
pReserved: NULL 
Return value: 
Error code 
Hints: 
If  hDC  is  NULL,  it  will  be  set  to hPrnDC after  the  reference  DC  has  been 
created. 
See Also: 
LlStgsysPrint, LlStgsysStoragePrint 
LlStgsysGetAPIVersion 
Syntax: 
int LlStgsysGetAPIVersion (HLLSTG hStg); 
Task: 
Returns the version of the Stgsys API. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
Return value: 
The  version  number  of  the  Stgsys  API  in  List  &  Label  C?LL16.DLL  and 
C?LS16.DLL 
Hints: 
The current version is 16 (as of 10/2010) 
API Reference 
278 
This function should be used to test the API version. Newer APIs might have a 
larger set of functions available, older ones less. 
See also: 
LlStgsysGetFileVersion 
LlStgsysGetFilename 
Syntax: 
int LlStgsysGetFilename (HLLSTG hStg, INT nJob, INT nFile,  
 LPTSTR pszBuffer, UINT nBufSize); 
Task: 
Can be used to get the "real" name(s) of the preview file(s). If a path has been 
provided to LlStgsysStorageOpen() this path will also be included. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
nJob: Job Index: 1: first Job,... (1..LlStgsysGetJobCount()) 
nFile: Page number 
Value 
Meaning 
-1 
Management file 
Printer configuration file 
>0 
Page Metafile for this page (1.. LlStgsysGet-
PageCount()) 
lpszBuffer: Initialized buffer for the file name 
nBufSize: Size of the buffer 
Return value: 
Error code 
Hints: 
The nFile Parameter distinguishes the type of file for which the name is to be 
returned. 
In the case of LL_STG_STORAGE, its name is returned regardless of the nFile 
parameter, as this is the one and only file that contains all information. 
Example: 
CString  sFilename, sOutput; 
LlStgsysGetFilename(hStg, 1, -1, sFilename.GetBuffer(_MAX_PATH),  
_MAX_PATH); 
sFilename.ReleaseBuffer(); 
sOutput = CString(_T("View of file ")) + sFilename; 
API Reference 
279 
See also: 
LlStgsysGetJobCount 
LlStgsysGetFileVersion 
Syntax: 
int LlStgsysGetFileVersion (HLLSTG hStg); 
Task: 
Returns the version of the preview file. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
Return value: 
The version number of the preview file and the type: 
Value 
Meaning 
Bits 0..7 
Version number (currently 16, current as of 
10/2010) 
Hints: 
This call is also very important for finding out about properties of the storage 
file and for dealing with possible differences. 
See also: 
LlStgsysGetAPIVersion 
LlStgsysGetJobCount 
Syntax: 
INT LlStgsysGetJobCount (HLLSTG hStg); 
Task: 
Returns the number of jobs stored in the preview. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
Return value: 
>0: Number of jobs 
<0: Error code 
Example: 
see LlStgsysSetJob 
API Reference 
280 
See also: 
LlStgsysStorageOpen 
LlStgsysGetJobOptionStringEx  
Syntax: 
INT LlStgsysGetJobOptionStringEx (HLLSTG hStg, LPCTSTR pszKey,  
 LPTSTR pszBuffer, UINT nBufSize); 
Task: 
Returns project parameter values. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
pszKey: Option name 
pszBuffer: Address of buffer for the value 
nBufSize: Size of buffer (incl. string termination) 
Return value: 
<0: Error code 
= 0: okay 
Hints: 
The  available  option  names  depend  on  the  parameters  which  the  creating 
application  has  made  available  via  LlPrintSetProjectParameter()  or 
LlSetDefaultProjectParameter() as PUBLIC. Note that you need to prefix these 
parameters with "ProjectParameter" in order to query the values. See also the 
Project Parameters chapter. 
See also: 
LlStgsysSetJobOptionStringEx 
LlStgsysGetJobOptionValue 
Syntax: 
INT LlStgsysGetJobOptionValue (HLLSTG hStg, INT nOption); 
Task: 
Returns certain numerical parameters for the current job. 
Parameter: 
hStg: The handle returned by LlStgsysStorageOpen() 
nOption: Chooses the meaning of the return value 
Documents you may be interested
Documents you may be interested