WinMsdInsert

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

Selektion erweitern

Details

• obj: Deskriptor des Objekts, in dem selektiert wird
• bigint1: Element, das in die Selektion aufgenommen werden soll
• int2:
  • Optionen (optional):
  • _WinMsdNoTreeSync
  • _WinMsdRecId
• alpha3: Custom -Eigenschaft
• Resultat: int Fehlerwert _ErrOk Element aufgenommen. _ErrMsdExists Das Element ist bereits selektiert.
• Siehe: Verwandte Befehle , WinMsdDelete () , WinMsdRead () , WinMsdInsertName ()

Mit diesem Befehl wird das Element (bigint1) in die Menge der selektierten Elemente hinzugefügt.

Das Objekt, in dem die Selektion stattfindet wird als (obj) der Anweisung übergeben. In (bigint1) wird das Element übergeben, das in die Selektion aufgenommen 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 -Objektes ( Canvas ) oder der Deskriptor eines Cte-Items ( 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.

In (alpha3) kann eine Zeichenkette angegeben werden, die in der Custom-Eigenschaft des Cte-Items gespeichert wird.

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 muss das neu hinzugefügte Selektions-Element explizit übertragen werden, damit es im TreeView -Objekt sichtbar wird. Bei Verwendung von WinMsdInsert 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 für die Erzeugung eines neuen Selektions-Elements auch der Befehl CteInsert () verwendet werden, jedoch müssen dann die Eigenschaften Name und ID konform mit den Bedingungen der Mehrfachselektion gesetzt werden. Beim TreeView -Objekt wird zudem eine Übertragung der Elemente in der Selektionsmenge in das TreeView -Objekt notwendig. Hierzu kann der Befehl WinMsdUpdate () verwendet werden.

Beispiele:

// Einfügen eines Datensatzes
$RecList->WinMsdInsert(tblCstCustomer, _WinMsdRecId);

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

// Einfügen eines Knotens
$TreeView->WinMsdInsert(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.