WinMsdRead

obj -> WinMsdRead(bigint1[, int2]) : handle

Element einer Selektion lesen

Details

• obj: Deskriptor des Objekts, in dem selektiert wird
• bigint1: Element, das gelesen werden soll oder Dateinummer
• int2:
  • Optionen (optional):
  • _WinMsdRecId
• Resultat: handle Deskriptor des CteItem -Objektes
• Siehe: Verwandte Befehle , WinMsdDelete () , WinMsdInsert () , WinMsdReadName ()

Mit diesem Befehl wird das Element (bigint1) in der Menge der selektierten Elemente gelesen. Mit dem Befehl kann geprüft werden, ob ein bestimmtes Element in der Selektion enthalten ist. Zum Lesen aller selektierten Elemente sollte der Cte-Tree oder die Cte-Liste verwendet werden (siehe SelectionData ).

Das Objekt, bei dem die Selektion gelesen werden soll, wird als (obj) der Anweisung übergeben. In (bigint1) wird das Element übergeben, dass gelesen werden soll. In Abhängigkeit vom Objekt muss in (bigint1) eine Datensatz-ID ( RecList ), eine Zeilennummer ( DataList ), der Deskriptor eines TreeNode -Objekts ( TreeView ) oder der Deskriptor eines CanvasGraphic -Objekts ( Canvas ) übergeben werden.

Die Übergabe einer Datensatz-ID kann auch durch die Angabe der Dateinummer in (bigint1) erfolgen, wenn in (int2) die Konstante _WinMsdRecId übergeben wird.

Zurückgegeben wird der Deskriptor auf das CteItem -Objekt, das das selektierte Element enthält (siehe auch SelectionData ).

Beispiele:

// Überprüfen eines Datensatzes
if ($RecList->WinMsdRead(tblCstCustomer, _WinMsdRecId) > 0)
{
  // Datensatz enthalten
  ...
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der als (obj) übergebene Deskriptor ist ungültig.
• _ErrValueInvalid: Die in (int2) übergebenen Optionen sind nicht zulässig.
• _ErrFileInvalid: Die angegebene Dateinummer in (int1) existiert nicht.