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