6.8.22 DMcob_GetValue

Mit Hilfe dieser Funktion werden Sie in die Lage versetzt, Attribute von DM-Objekten zu erfragen.

Die zulässigen Attribute für den jeweiligen Objekttyp entnehmen Sie bitte dem Kapitel „Attribute und Definitionen“.

call "DMcob_GetValue" using
            DM-StdArgs
            DM-Value.

Parameter

-> DM-Object of DM-Value

Dieser Parameter beschreibt das Objekt, dessen Attribut Sie erfragen möchten. Diesen Identifikator haben Sie als Rückgabewert der Funktion DMcob_PathToID erhalten.

-> DM-Attribute of DM-Value

Dieser Parameter beschreibt das Attribut, das Sie von dem Objekt erfragen möchten. Alle zugelassenen Attribute sind in der Datei IDMcobws.cob definiert.

-> DM-Index of DM-Value

Dieser Parameter wird nur bei Vektorattributen von Objekten ausgewertet und beschreibt den Index des gesuchten Unterobjektes (z.B. Text in Listbox).

<- DM-Datatype of DM-Value

In diesem Parameter erhalten Sie den Datentyp des gesuchten Attributs. Dabei müssen Sie beachten, dass Sie das unbedingt lesen, bevor Sie auf die Daten zugreifen. Den Datentyp eines jeden Attributes entnehmen Sie bitte dem Kapitel „Attribute und Definitionen“.For the data type of each attribute please refer to the chapter „Attributes and Definitions“.

-> DM-Indexcount of DM-Value

Hier wird angegeben, wie viele Indexwerte beim Aufruf der Funktion beachtet werden sollen:

  • 2-dimensionale Attribute -> Wert muss auf 2 gesetzt werden
  • 1-dimensionale Attribute -> Wert muss auf 1 gesetzt werden
  • nicht-indizierte Attribute -> Wert muss auf 0 gesetzt werden

-> DM-value-string-putlen of DM-Value

Hier wird angegeben, wie lang der zu erfragende String sein darf.

<- DM-value-object of DM-Value
<- DM-value-boolean of DM-Value
<- DM-value-classid of DM-Value
<- DM-value-integer of DM-Value
<- DM-value-string of DM-Value

In einem dieser Parameter erhalten Sie den Wert des gefragten Attributs. Der Wert, der gesetzt wird, ist abhängig vom Datentyp des Attributs. Den Datentyp eines jeden Attributes entnehmen Sie bitte dem Kapitel „Attribute und Definitionen“.For the data type of each attribute please refer to the chapter „Attributes and Definitions“.

-> DM-Options

Mit Hilfe dieses Parameters wird gesteuert, in welcher Form Texte vom Dialog Manager aus zurückgeliefert werden, falls das entsprechende Attribut vom Typ Text ist.

  • DMF-GetMasterString

    Wird hier DMF-GetMasterString angegeben, wird der Originalstring zurückgeliefert.

  • DMF-GetLocalString

    Ist hier DMF-GetLocalString angegeben, wird der String in der aktuell eingestellten Sprache zurückgeliefert.

  • DMF-GetTextID

    Wird hier DMF-GetTextID angegeben, liefert der Dialog Manager nur den Identifikator des Textes. Dieser kann dann direkt zum Setzen über die Funktion DMcob_SetValue verwendet werden.

COBOL-Schnittstelle für Micro Focus Visual COBOL

An Stelle von DM-value-string kann auch DM-value-string-u verwendet werden, wenn mit Unicode-Texten (UTF-16) gearbeitet wird.

DM-value-string-getlen und DM-value-string-putlen geben weiterhin die Anzahl der Zeichen und nicht der Bytes an.

Rückgabewert

DM-status of DM-StdArgs

DM-error

Das Attribut ist für das Objekt nicht zulässig.

DM-success

Das Attribut konnte erfolgreich erfragt werden.

Beispiel

Um auf den Titel des Fensters "TestWindow" zuzugreifen muss das COBOL Programm etwa wie folgt aussehen:

    move 0 to DM-indexcount.

    move AT-title to DM-Attribute.

    move DMF-GetMasterString to DM-Options.

    Call "DMcob_GetValue" using DM-StdArgs DM-Value.

    if DM-Datatype is equal to DT-string

        display DM-value-string.