Acad::ErrorStatus getAt(
const char* NomRecord ,
AcDbObjectId& IdRecord ,
bool RecordSupprime = false )const;
| NomRecord | Entrée : Nom de l’enregistrement à rechercher. |
| IdRecord | Sortie : Ll'identificateur (objectId) de l’enregistrement nommé NomRecord. |
| RecordSupprime | Entrée : Booléen indiquant si oui ou non la recherche inclue les enregistrements effacés. |
Cette fonction parcours la table des blocs afin de trouver un enregistrement nommé NomRecord et, si un résultat est trouvé, retourne le AcDbObjectId de cet enregistrement dans IdRecord. Si RecordSupprime == true, alors la recherche portera aussi sur les enregistrements effacés.
Les codes possibles du retour ErrorStatus sont : Acad::eOk , Acad::eKeyNotFound , ou Acad::ePermanentlyErased.
Acad::ErrorStatus getAt(
const char* NomRecord ,
AcDbBlockTableRecord*& pRecord ,
AcDb::OpenMode ModeOuverture ,
bool RecordSupprime = false )const;
| NomRecord | Entrée : Nom de l’enregistrement à rechercher. |
| pRecord | Sortie : Pointeur vers l’enregistrement ouvert. |
| ModeOuverture | Entrée : Mode d’ouverture de l’enregistrement. les valeurs possibles sont : AcDb::kForRead AcDb::kForWrite AcDb::kForNotify |
| RecordSupprime | Entrée : Booléen indiquant si oui ou non la recherche inclue les enregistrements effacés. |
Cette fonction parcours la table des blocs à la recherche d’un enregistrement nommé NomRecord et, si un résultat est trouvé, ouvre cet enregistrement selon mode spécifié par ModeOuverture, et si l’opération réussi, retourne pRecord pointant sur l’enregistrement ouvert. Si RecordSupprime == true, alors la recherche portera aussi sur les enregistrements effacés.
Les codes ErrorStatus pouvant être retournés sont : Acad::eOk, Acad::eKeyNotFound, Acad::ePermanentlyErased, Acad::eAtMaxReaders, Acad::eWasOpenForNotify, Acad::eWasNotifying, Acad::eWasOpenForUndo, Acad::eWasOpenForWrite, Acad::eWasOpenForRead
bool has(
const char* NomRecord) const;
| NomRecord | Entrée : Nom de l’enregistrement à rechercher. |
Cette fonction retourne true si la table contient un enregistrement dont le nom est NomRecord, sinon elle retourne false.
bool has(
AcDbObjectId IdRecord) const;
| IdRecord | Entrée : L'identificateur (objectiId) de l’enregistrement à rechercher. |
Cette fonction retourne true si la table contient un enregistrement avec un AcDbObjectId qui correspond à IdRecord ; autrement, elle retourne false.
Acad::ErrorStatus newIterator(
AcDbBlockTableIterator*& pIterateur ,
bool Depart = true ,
bool RecordSupprime = true )const;
| pIterateur | Sortie : Pointeur vers l’itérateur nouvellement créé . |
| Depart | Entrée : Booléen indiquant s'il faut commencer au début ou à la fin de la table . |
| RecordSupprime | Entrée : Booléen indiquant si les enregistrements effacés doivent être pris en compte. |
Cette fonction crée un objet itérateur qui peut être utilisé pour parcourir le contenu de la table des blocs. pIterateur est défini pour pointer vers l’objet itérateur nouvellement créé. Si Depart == true, alors l’itérateur commence son parcours au début de la table des blocs, sinon il commence à la fin de celle-ci. Si RecordSupprime == true, alors l’itérateur sera initialement positionné au dernier/premier enregistrement non effacé, sinon il sera positionné au premier/dernier enregistrement, qu’il ait été effacé ou non.
L’appelant de cette fonction à la responsabilité de détruire l’objet itérateur quand il n’est plus nécessaire. Les codes ErrorStatus pouvant être retournés sont : Acad::eOk, Acad::eOutOfMemory
| www.cadfr.com |