Fonctions de requête de AcDbBlockTable

 


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

 

▲haut de page

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.

 

▲haut de page

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

▲haut de page
www.cadfr.com