Syntax:
INT LlProjectOpen(HLLJOB hJob, UINT nObjType, LPCTSTR pszObjName, UINT nOpenMode);
Aufgabe:
Diese Funktion steht erst ab der Professional Edition zur Verfügung! Öffnet die angegebene Projektdatei. Um das DOM-Handle für das Projektobjekt zu erhalten rufen Sie anschließend LlDomGetProject() auf. Dieses Objekt ist die Basis für alle weiteren DOM-Funktionen. Ausführliche Anwendungsbeispiele finden Sie im Kapitel DOM-Funktionen.
Parameter:
hJob: List & Label-Job-Handle
nObjType:
|
Wert |
Bedeutung |
|
LL_PROJECT_LABEL |
für Etiketten |
|
LL_PROJECT_CARD |
für Karteikarten |
|
LL_PROJECT_LIST |
für Listen |
pszObjName: Projektdateiname mit Pfadangabe und Dateiendung
nOpenMode: Kombination (ODER-Verknüpfung) jeweils eines Flags aus den folgenden drei Gruppen:
|
Wert |
Bedeutung |
|
LL_PRJOPEN_CD_OPEN_EXISTING |
Datei muss bereits existieren, sonst wird Fehlercode zurückgeliefert. |
|
LL_PRJOPEN_CD_CREATE_ALWAYS |
Datei wird immer neu erzeugt. Wenn schon vorhanden wird der Inhalt gelöscht. |
|
LL_PRJOPEN_CD_CREATE_NEW |
Datei wird neu erzeugt, wenn nicht vorhanden. Wenn Datei bereits existiert wird Fehlercode zurückgeliefert. |
|
LL_PRJOPEN_CD_OPEN_ALWAYS |
Wenn Datei vorhanden, wird der Inhalt verwendet, sonst wird Datei neu erzeugt. |
|
Wert |
Bedeutung |
|
LL_PRJOPEN_AM_READWRITE |
Datei wird für Lese/Schreibzugriff geöffnet. |
|
LL_PRJOPEN_AM_READONLY |
Datei wird nur für Lesezugriff geöffnet. |
|
Wert |
Bedeutung |
|
LL_PRJOPEN_EM_IGNORE_ |
Syntaxfehler werden ignoriert. Siehe Hinweise. |
Rückgabewert:
Fehlercode
Hinweise:
Wenn das Flag LL_PRJOPEN_EM_IGNORE_FORMULAERRORS verwendet wird, werden Syntaxfehler im Projekt ignoriert. Dies hat den Vorteil, dass Projekte auch dann erfolgreich geöffnet und bearbeitet werden können, wenn die Datenstruktur nicht bekannt bzw. angemeldet ist. Da die Formeln im Projekt dann wie Platzhalter behandelt werden, kann die Sektion mit den verwendeten Variablen (siehe LlGetUsedIdentifiers()) nicht korrekt geschrieben werden, wenn Sie z. B. in einer Tabelle weitere Spalten anhängen. Der Inhalt dieser Sektion wird beim Speichern unverändert gelassen. Das gleiche gilt für den Fall, dass in einem Berichtscontainer eine neue Tabelle eingefügt wird, die bisher nicht verwendet wurde. Für solche Fälle darf daher LL_PRJOPEN_EM_IGNORE_FORMULAERRORS nicht gesetzt werden. Wenn das Flag nicht gesetzt wird, kann LL_NTFY_EXPRERROR verwendet werden um die Fehlermeldungen für die Anzeige zu sammeln.
Beispiel:
Siehe Kapitel DOM-Funktionen.
Siehe auch:
LlProjectSave, LlProjectClose, LlDomGetProject