Graphisoft®

API Development KitVersion: 18

ACAPI_Element_Select

현재 선택에서 여러 개의 요소들을 추가/제거합니다.

    GSErrCode  ACAPI_Element_Select (
        API_Neig**     selNeig,
        Int32          nItem,
        bool           add
    );

 

파라미터

selNeig
[in] 선택에 추가/제거될 요소들입니다. (API_Neig 리스트에 대한 핸들입니다); NULL이 될 수 있습니다.
nItem
[in] 처리될 항목들의 수입니다.
add
[in] 만약 true이면 현재 선택에 요소들을 추가합니다. 그렇지 않으면 헌재 선택에서 그것들을 제거합니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADDATABASE
현재 데이터베이스가 동작에 적절하지 않습니다.
APIERR_BADID
요소 유일 ID가 유효하지 않습니다. 요소 타입이 유효하지 않습니다. 또는
요소 타입을 서버 애플리케이션에서 지원하지 않습니다.
APIERR_BADPARS
전달된 파라미터가 유효하지 않은 데이터를 포함하고 있습니다; selNeig, nItem

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

 

설명

당신은 현재 선택에 여러 개의 (nItem) 요소들을 추가/제거(add flag)하기 위해 이 함수를 사용할 수 있습니다. 요소들은 타입 API_NeigselNeig 핸들에 의해 정의됩니다.

만약 selNeig 파라미터를 NULL로 세트하면, 이 함수는 "Deselect All"처럼 작동합니다. 그 외에는 neigIDguid 필드가 필요합니다. (inIndex 그리고/또는 holeSel은 적용 가능한 경우에만 필요함)

API_NeigIDAPI_ElemTypeID와 다릅니다. 왜냐하면 이것은 요소 자체가 아닌 요소들의 선택 가능한 부분들을 참고하기 때문입니다.

API 18 당신은 전체 요소들뿐만 아니라 요소 일부도 선택할 수 있습니다. 가령 API_NeigelemPartTypeelemPartIndex 필드에서 지정한 정점(vertex), 모서리(edge), 면(face)들을 선택할 수 있습니다.

 

요구사항

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

 

참고사항

API_Neig,
선택 관리자, 요소 관리자, API 함수