WinMsdDelete

obj -> WinMsdDelete(bigint1[, int2]) : int

Element aus der Selektion entfernen

Details

• obj: Deskriptor des Objekts, in dem selektiert wird
• bigint1: Element, das aus der Selektion entfernt werden soll
• int2:
  • Optionen (optional):
  • _WinMsdNoTreeSync
  • _WinMsdRecId
• Resultat: int Fehlerwert _ErrOk Element entfernt. _ErrMsdNotFound Das Element wurde nicht gefunden.
• Siehe: Verwandte Befehle , WinMsdInsert () , WinMsdRead () , WinMsdDeleteName ()

Mit diesem Befehl wird das Element (bigint1) aus der Menge der selektierten Elemente entfernt.

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

Beim RecList -Objekt kann auch die Option _WinMsdRecId verwendet werden. In (bigint1) muss dann die Dateinummer angegeben werden. Dadurch wird automatisch die Datensatz-ID des aktuell geladenen Datensatzes der angegebenen Datei ermittelt.

Bei den Objekten RecList und DataList wird das neu hinzugefügte Selektions-Element sichtbar, nachdem das Objekt durch den Befehl WinUpdate () neu gezeichnet wurde. Beim Canvas -Objekt muss zusätzlich die Option _WinUpdState angegeben werden. Beim TreeView -Objekt müssen die Selektions-Elemente explizit übertragen werden, damit die Selektion im TreeView -Objekt sichtbar wird. Bei Verwendung von WinMsdDelete() ist dies standardmäßig der Fall. Durch _WinMsdNoTreeSync kann die Übertragung des neuen Elementes in den TreeView verhindert werden. Um alle Elemente einer Mehrfachselektion in das TreeView -Objekt zu übertragen kann der Befehl WinMsdUpdate () benutzt werden.

Natürlich kann zum Entfernen eines Selektions-Elementes auch der Befehl CteDelete () verwendet werden. Beim TreeView -Objekt wird anschließend eine Übertragung der Elemente in der Selektionsmenge in das TreeView -Objekt notwendig. Hierzu kann der Befehl WinMsdUpdate () verwendet werden.

Beispiele:

// Entfernen eines Datensatzes
$RecList->WinMsdDelete(tblCstCustomer, _WinMsdRecId);

// Identisch mit
$RecList->WinMsdDelete(RecInfo(tblCstCustomer, _RecID));

// Entfernen eines Knotens
$TreeView->WinMsdDelete(aEvt:Obj);

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.