1 // Created on: 1992-11-17
2 // Created by: Christian CAILLET
3 // Copyright (c) 1992-1999 Matra Datavision
4 // Copyright (c) 1999-2014 OPEN CASCADE SAS
6 // This file is part of Open CASCADE Technology software library.
8 // This library is free software; you can redistribute it and/or modify it under
9 // the terms of the GNU Lesser General Public License version 2.1 as published
10 // by the Free Software Foundation, with special exception defined in the file
11 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
12 // distribution for complete text of the license and disclaimer of any warranty.
14 // Alternatively, this file may be used under the terms of Open CASCADE
15 // commercial license or contractual agreement.
17 #ifndef _IFSelect_SelectExtract_HeaderFile
18 #define _IFSelect_SelectExtract_HeaderFile
20 #include <Standard.hxx>
21 #include <Standard_Type.hxx>
23 #include <Standard_Boolean.hxx>
24 #include <IFSelect_SelectDeduct.hxx>
25 #include <Standard_Integer.hxx>
26 class Interface_EntityIterator;
27 class Interface_Graph;
28 class Standard_Transient;
29 class Interface_InterfaceModel;
30 class TCollection_AsciiString;
33 class IFSelect_SelectExtract;
34 DEFINE_STANDARD_HANDLE(IFSelect_SelectExtract, IFSelect_SelectDeduct)
36 //! A SelectExtract determines a list of Entities from an Input
37 //! Selection, as a sub-list of the Input Result
38 //! It works by applying a sort criterium on each Entity of the
39 //! Input. This criterium can be applied Direct to Pick Items
40 //! (default case) or Reverse to Remove Item
42 //! Basic features (the unique Input) are inherited from SelectDeduct
43 class IFSelect_SelectExtract : public IFSelect_SelectDeduct
49 //! Returns True if Sort criterium is Direct, False if Reverse
50 Standard_EXPORT Standard_Boolean IsDirect() const;
52 //! Sets Sort criterium sense to a new value
53 //! (True : Direct , False : Reverse)
54 Standard_EXPORT void SetDirect (const Standard_Boolean direct);
56 //! Returns the list of selected entities. Works by calling the
57 //! method Sort on each input Entity : the Entity is kept as
58 //! output if Sort returns the same value as Direct status
59 Standard_EXPORT virtual Interface_EntityIterator RootResult (const Interface_Graph& G) const;
61 //! Returns True for an Entity if it satisfies the Sort criterium
63 //! - <rank>, the rank of the Entity in the Iteration,
64 //! - <ent> , the Entity itself, and
65 //! - <model>, the Starting Model
66 //! Hence, the Entity to check is "model->Value(num)" (but an
67 //! InterfaceModel allows other checks)
68 //! This method is specific to each class of SelectExtract
69 Standard_EXPORT virtual Standard_Boolean Sort (const Standard_Integer rank, const Handle(Standard_Transient)& ent, const Handle(Interface_InterfaceModel)& model) const = 0;
71 //! Works as Sort but works on the Graph
72 //! Default directly calls Sort, but it can be redefined
73 //! If SortInGraph is redefined, Sort should be defined even if
74 //! not called (to avoid deferred methods in a final class)
75 Standard_EXPORT virtual Standard_Boolean SortInGraph (const Standard_Integer rank, const Handle(Standard_Transient)& ent, const Interface_Graph& G) const;
77 //! Returns a text saying "Picked" or "Removed", plus the
78 //! specific criterium returned by ExtractLabel (see below)
79 Standard_EXPORT TCollection_AsciiString Label() const;
81 //! Returns a text defining the criterium for extraction
82 Standard_EXPORT virtual TCollection_AsciiString ExtractLabel() const = 0;
87 DEFINE_STANDARD_RTTI(IFSelect_SelectExtract,IFSelect_SelectDeduct)
92 //! Initializes a SelectExtract : enforces the sort to be Direct
93 Standard_EXPORT IFSelect_SelectExtract();
100 Standard_Boolean thesort;
111 #endif // _IFSelect_SelectExtract_HeaderFile