Syntax:
HLLJOB LlJobOpen (INT nLanguage);
Task:
Initializes internal variables and resources of the DLL for a calling program. Almost all DLL commands require the return value of this function as the first parameter.
Parameter:
nLanguage: Chosen language for user interactions (dialogs)
Value |
Meaning |
CMBTLANG_DEFAULT |
Default language (use
settings in Windows) |
CMBTLANG_GERMAN |
German |
CMBTLANG_ENGLISH |
English |
Further constants can be found in your declaration file.
If this parameter is "or"ed with the constant LL_JOBOPENFLAG_NOLLXPRELOAD, no List & Label extensions will be preloaded.
Return Value:
A handle which is required as a parameter for most functions in order to have access to application-specific data.
A valid value is greater than 0. If the value is less than 0, it shows an errorcode. Please see chapters General Notes About the Return Value and Error Codes for further details.
Hints:
For ease of maintenance, we suggest putting global settings in one place, immediately after the LlJobOpen() call (dialog design, callback modes, expression mode, ...).
The C?LL29.DLL requires the language-dependent components which are stored in a separate DLL, e.g. C?LL2900.LNG or C?LL2901.LNG. They are loaded depending on the language setting.
If List & Label is no longer required, then the job should be released with the function LlJobClose() to give the DLL a chance to release the internal variables for this job.
The language IDs appended to the file name are a hex representation of the CMBTLANG_xxxx language codes found in the header (*.H, *.BAS, *.PAS, ...) file.
Example:
HLLJOB hJob;
hJob =
LlJobOpen(CMBTLANG_ENGLISH);
LlDefineVariableStart(hJob);
LlDefineVariable(hJob,
"Name", "Smith");
LlDefineVariable(hJob, "forename", "George");
<...
etc ...>
LlJobClose(hJob);
See also:
LlJobOpenLCID, LlJobClose, LlSetOption, LlDesignerProhibitAction, LlSetFileExtensions