View Issue Details
ID | Project | Category | View Status | Date Submitted | Last Update |
---|---|---|---|---|---|
0013605 | Open CASCADE | OCCT:Application Framework | public | 2006-10-10 20:13 | 2012-01-13 14:05 |
Reporter | Assigned To | ||||
Priority | normal | Severity | feature | ||
Status | closed | Resolution | fixed | ||
OS | All | ||||
Fixed in Version | 6.2.0 | ||||
Summary | 0013605: Transaction signal API in TDocStd_Document | ||||
Description | There is a need that TDocStd_Document generates a signal to application that a transaction event has happened (Open, Abort, Commit). This signal can be passed by either of two ways: 1. Using the virtual API of TDocStd_Document, so that the derived document class could provide the treatment of an event or fire it to GUI or other clients. 2. Using the virtual API of TDocStd_Application: new methods OnOpenTransaction, etc. can be called upon a transaction event in the document. This way is more suitable if the application does not use a specialized Document class. | ||||
Additional information and documentation updates | Documentation remark, added by AGV 2007-02-15 13:00:02: New features: Virtual API for transaction events. This improvement allows the application to receive signals from OCAF document about each of the events: Open Transaction Commit Transaction Abort Transaction Improvements: Every time a document transaction event occurs, the application (class TDocStd_Application) that owns the OCAF document calls the corresponding virtual method: OnOpenTransaction (aDocument) OnCommitTransaction (aDocument) OnAbortTransaction (aDocument) where "aDocument" is a reference to the instance of concerned OCAF document. By default these methods do nothing, but the developer can redefine them in his/her Application subclass, attaching the relevant GUI actions or other events. If this API is inconvenient (e.g., for OCAF documents that are not owned by Application), the developer can redefine the protected methods: OpenTransaction() CommitTransaction() AbortTransaction() for the similar purposes. By the described improvement, these three methods were defined as virtual. In case of redefinition, it is mandatory to call TColStd_Document::OpenTransaction() from the method in derived class (i.e., MyDocument::OpenTransaction()). The same for CommitTransaction() and AbortTransaction(). Modified entities: Application from TDocStd Document from TDocStd | ||||
Tags | No tags attached. | ||||
Test case number | |||||
Date Modified | Username | Field | Change |
---|---|---|---|
2006-10-12 12:38 |
|
CC | => abv |
2006-10-12 12:54 | bugmaster | Assigned To | bugmaster => agv |
2006-10-12 12:54 | bugmaster | Status | new => assigned |
2006-10-31 16:51 | bugmaster | Status | assigned => verified |
2007-06-01 12:06 | bugmaster | Status | verified => closed |
2007-06-01 12:06 | bugmaster | Resolution | @0@ => fixed |
2011-08-02 10:32 | bugmaster | Category | OCCT:OCAF => OCCT:Application Framework |
2012-01-13 14:05 |
|
Description Updated | |
2012-01-13 14:05 |
|
Additional Information Updated |