Graphisoft®

API Development KitVersion: 18

ACAPI_LibPart_PatternSearch

로드된 라이브러리들 중에서 등록된 라이브러리 파트들을 검색합니다.

    GSErrCode  ACAPI_LibPart_PatternSearch (
        const API_LibPart*       ancestor,
        const GS::UniString&     pattern,
        API_LibPart              result[50],
        Int32*                   numFound
    );

 

파라미터

ancestor
[in] 검색할 라이브러리 파트 타입입니다.
pattern
[in] 로드된 라이브러리들 중에서 검색할 패턴입니다.
result
[out] 처음 발견한 50개의 라이브러리 파트들이 저장된 배열입니다.
numFound
[out] 발견한 라이브러리 파트들의 개수입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다. 라이브러리 파트를 찾았습니다. (또는 createIfMissingtrue일 경우 레퍼런스가 성공적으로 생성되었습니다)
APIERR_BADPARS
ancestorNULL, numFoundNULL입니다. 또는 pattern이 비어 있습니다.
APIERR_BADID
주어진 typeID 또는 조상 ownUnID를 따라 검색한 라이브러리 파트가 없습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 로드된 라이브러리들 중에서 라이브러리 파트들을 검색하는 데 사용합니다.

검색 패턴은 1개 이상의 단어 또는 인용 부호 안의 표현식이 될 수 있습니다.

라이브러리 파트들은 이 문서의 라이브러리 파트 서브타입 챕터에서 설명한 대로 서브타입 계층을 따라 분류된다는 것을 기억하시기 바랍니다. 확장 가능한 서브타입 시스템은 라이브러리 파트의 typeID 기반 구분을 쓸모없게 만들었지만, 내부 조상 노드들에 대한 parentUnID 대신 서브타입 별로 검색하기 위해 이 필드를 사용할 수도 있습니다. (이 경우 APILib_ObjectID는 Model Element에 해당하고, API_ZombieLibID는 General Object subtype을 의미한다는 것을 참고 바랍니다)

 

요구사항

버전: API 16 또는 이후
헤더: ACAPinc.h

 

참고사항

API_LibPart
ACAPI_LibPart_Get, ACAPI_LibPart_Create
ACAPI_LibPart_Search

라이브러리 파트 관리자, 라이브러리 파트 서브타입
API 함수