LlDefineLayout

Syntax:

INT LlDefineLayout (HLLJOB hJob, HWND hWnd, LPCTSTR lpszTitle, UINT nObjType, LPCTSTR lpszObjName);

Task:

Calls the interactive Designer that will be displayed as a modal pop-up window overlapping your application window.

Parameter:

hJob: List & Label job handle

hWnd: Handle of the application window which will be disabled while the Designer is being displayed.

lpszTitle: Window title

nObjType: Project type

Value

Meaning

LL_­PROJECT_­LABEL

for labels

LL_­PROJECT_­CARD

for cards

LL_­PROJECT_­LIST

for lists

         

if necessary combined with 'or' with:         

Value

Meaning

LL_­FIXEDNAME

Deletes the menu items 'new' and 'load' (preferred: LlDesignerProhibitAction())

LL_­NOSAVEAS

Deletes the menu item 'save as' (preferred: LlDesignerProhibitAction())

LL_­NONAMEINTITLE

No file name of the current project in List & Label's main window title

 

lpszObjName: File name of the desired object with file extension

Return Value:

Error code

Hints:

The window handle is used to deactivate the calling program.

If this is not desired or possible, NULL can also be passed. In this case the calling program is responsible for closing the layout editor, should the user abort the main program. This is not recommended.

When the List & Label layout Designer is minimized, the calling program is also automatically minimized; when the Designer is subsequently restored, List & Label is also restored.

Example:

HLLJOB hJob;
hJob = LlJobOpen(0);

LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Name", "Smith");
LlDefineVariable(hJob, "forename", "George");
LlDefineVariable(hJob, "PIN", "40|08150|77500",
         LL_BARCODE_EAN13, NULL);
LlDefineLayout(hJob, hWndMain, "Test", LL_PROJECT_LABEL,        "test.lbl")
LlJobClose(hJob);

See also:

LlDesignerProhibitAction, LlSetOption, LlSetFileExtensions