ACAPI_Element_ChangeParameters

여러 요소들의 파라미터들을 변경합니다.

    GSErrCode  ACAPI_Element_ChangeParameters (
        API_Elem_Head**            elemHead,
        Int32                      nItem,
        const API_Element*         defPars,
        const API_ElementMemo*     defMemo,
        const API_Element*         mask
    );

 

파라미터

elemHead

[in] 요소(들)을 식별합니다.

nItem

[in] elemHead 내 항목들의 개수입니다.

defPars

[in] 새 요소의 파라미터들입니다.

defMemo

[in] 새 요소의 메모입니다. (필요할 경우에만)

mask

[in] 새 요소의 마스크입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

defPars가 NULL입니다.

APIERR_BADDATABASE

현재 데이터베이스가 동작에 적절하지 않습니다.

APIERR_MEMFULL

동작을 완료하기에는 메모리가 부족합니다.

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

 

설명

elemHead로 식별되는 여러 개(nItem)의 요소들의 설정 파라미터들을 변경하기 위해 이 함수를 사용할 수 있습니다. 만약 elemHead가 NULL이면, 이 함수는 선택한 것들에 대하여 작동합니다. defPars 인자에 전달한 타입과 동일한 요소들만 영향을 받습니다.

몇 가지 이유로 인해 편집이 허용되지 않는 요소들은 무시합니다. 그러한 경우들은 다음과 같습니다:

• 잠겨 있음,
• 잠긴 레이어 상에 있음,
• 그룹의 일부이며 서스펜드 그룹이 OFF,
• 사용자 작업공간에 있지 않음, 등.

이 함수는 요소들의 설정 타입 파라미터들을 변경하는 데에만 사용할 수 있고 기하 파라미터들을 변경할 수는 없습니다. mask 인자에 표시된 파라미터들만 영향을 받습니다. 라이브러리 파트들을 참조하는 요소들은 memo의 params 핸들이 해석됩니다. 만약 NULL이면, 아무 일도 일어나지 않을 것입니다. 만약 전달되었으면, 실제 파라미터 리스트가 변경될 것입니다.

유사하게 작동하는 ACAPI_Element_Change와 ACAPI_Element_ChangeDefaults 함수들을 참조하십시오.

다음 참고사항들은 절대적으로 중요합니다:

• 대상 요소들의 리스트는 다른 그룹 멤버들에 의해 자동으로 확장될 것입니다; 만약 집합 안에 하나의 그룹 멤버가 있고 서스펜드 그룹이 OFF일 경우.
• 모든 편집된 요소들은 자신의 유일 ID를 보존합니다.
• 모든 요소 간 링크들은 조정될 것입니다; 치수 역시 그러합니다.

마친 후에 핸들들을 폐기하기 위해 ACAPI_DisposeElemMemoHdls를 호출하는 것을 잊지 마십시오.

 

요구사항

버전: API 2.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_Elem_Head, API_Element, API_ElementMemo,
ACAPI_Element_Change,
ACAPI_Element_ChangeDefaults,
ACAPI_DisposeElemMemoHdls,
요소 관리자, API 함수