WinRvwEdit
obj -> WinRvwEdit(int1[, int2[, int3[, int4]]]) : int
(Sub-)Item eines RecView-Objektes bearbeiten
Details
- obj: Objekt
- int1: Nummer des Items
- int2: Nummer des Subitems
- int3: Nummer des Views
- int4: Optionen
- Resultat:
intFehlerwert - Siehe: Verwandte Befehle , Blog
Dieser Befehl startet die Bearbeitung eines Items (int1) oder SubItems (int2) in dem View (int3) des RecView -Objektes (obj) durch. Wird kein SubItem (int2) angegeben, oder 0 übergeben, wird das übergeordnete Item bearbeitet.
Die Gruppe des zu bearbeitenden Items muss selektiert und sichtbar sein. Daher empfiehlt sich vorher die Verwendung von WinRvwUpdate () mit den Update-Modi _WinRvwUpdateFromSelected und _WinRvwUpdateDoKeepSelect .
Durch den Befehl wird der Ablauf, wie in Ereignisabläufe des RecViews beschrieben, durchgeführt. Wird daher im Ereignis EvtLstEditStartItem das Resultat _WinRvwGroupEditSkipItem gesetzt, wird das nächste zu bearbeitende Item gesucht.
Die Nummer des Views (int3) gibt an, in welchem View die Gruppe bearbeitet werden soll. Mögliche Werte sind 0 bis 4. Wird 0 angegeben, oder das Argument weggelassen, wird im aktiven View, welches den Eingabe-Fokus besitzt, bearbeitet. Eine Angabe von 0 und 1 ist immer möglich. Die Views 2 bis 4 existieren nur, wenn eine entsprechende Splittung des RecView durch den Anwender vorgenommen wurde. Existiert das angegebene View nicht wird der Fehlerwert _ErrUnknown zurückgegeben.
Als Option (int4) kann _WinRvwEditAbortEditing angegeben werden, um eine aktuell aktive Bearbeitung abzubrechen. Diese Option ist standardmäßig aktiv. Soll die Bearbeitung nicht abgebrochen werden, muss 0 übergeben werden. Ist in diesem Fall bereits ein Datensatz in Bearbeitung, wird der Fehlerwert _ErrInUse zurückgegeben.
Als Rückgabewert wird der Fehlerwert _ErrUnknown zurückgegeben, wenn das angegebene View (int3) nicht existiert oder noch nicht initialisiert (siehe EvtLstViewInit) wurde. Wurde als Option (int4) 0 übergeben und es ist bereits ein Datensatz in Bearbeitung wird _ErrInUse zurückgegeben. Ist das Item (int1) oder das SubItem (int2) nicht vorhanden, kein Datensatz markiert, oder der aktive Datensatz nicht im sichtbaren Bereich, gibt der Befehl den Fehlerwert _ErrUnavailable zurück. Ist keines der EvtLstEdit...-Ereignisse bei dem RecView (obj) eingetragen, kommt der Fehlerwert _ErrIllegalOp. Sonst wird _ErrOk zurückgegeben.
Mögliche Laufzeitfehler
_ErrHdlInvalid: In (obj) wurde kein gültiger Deskriptor angegeben._ErrValueInvalid: In den Optionen (int4) wurde weder0noch_WinRvwEditAbortEditingangegeben.