Einen Bereich übernehmen oder verwerfen

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Datensatzmenge durch Angabe eines Bereichs begrenzen


Wenn Sie SetRangeStart oder EditRangeStart aufrufen, um den Anfang eines Bereichs festzulegen, oder SetRangeEnd oder EditRangeEnd, um das Ende eines Bereichs festzulegen, geht die Datenmenge in den Status dsSetKey über. Sie bleibt in diesem Status, bis Sie den Bereich übernehmen oder verwerfen.

Einen Bereich anwenden

Wenn Sie einen Bereich festlegen, treten die definierten Grenzvorgaben erst dann in Kraft, wenn Sie den Bereich anwenden. Hierzu muss die Methode ApplyRange aufgerufen werden. Sie schränkt die Ansicht und den Zugriff des Benutzers unmittelbar auf die festgelegte Untermenge der Datenmenge ein.

Einen Bereich verwerfen

Die Methode CancelRange beendet die Anwendung eines Bereichs und stellt den Zugriff auf die vollständige Datenmenge wieder her. Obwohl das Verwerfen eines Bereichs den Zugriff auf alle Datensätze in der Datenmenge wiederherstellt, stehen die Grenzvorgaben für den Bereich weiterhin zur Verfügung und der Bereich kann später erneut angewendet werden. Bereichsgrenzen werden beibehalten, bis Sie neue Bereichsgrenzen vorgeben oder die existierenden Bereichsgrenzen ändern. Beispielsweise ist der folgende Code zulässig:

Delphi:

MyTable.CancelRange;
// …
// Später kann derselbe Bereich wieder angewendet werden. Dazu müssen SetRangeStart usw. nicht mehr aufgerufen werden.
MyTable.ApplyRange;

C++:

MyTable->CancelRange();
// …
 // Später diesen wieder Bereich verwenden. Erübrigt erneuten Aufruf von SetRangeStart usw.
MyTable->ApplyRange();

Siehe auch