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_Neig의 selNeig
핸들에 의해 정의됩니다.
만약 selNeig
파라미터를 NULL
로 세트하면, 이 함수는 "Deselect All"처럼 작동합니다.
그 외에는 neigID
와 guid
필드가 필요합니다. (inIndex 그리고/또는 holeSel
은 적용 가능한 경우에만 필요함)
API_NeigID
는 API_ElemTypeID
와 다릅니다. 왜냐하면 이것은 요소 자체가 아닌 요소들의 선택 가능한 부분들을 참고하기 때문입니다.
당신은 전체 요소들뿐만 아니라 요소 일부도 선택할 수 있습니다.
가령 API_Neig의
elemPartType
과 elemPartIndex
필드에서 지정한 정점(vertex), 모서리(edge), 면(face)들을 선택할 수 있습니다.
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h