APIEnv_NewNavigatorViewID
###_short_desc_###
GSErrCode ACAPI_Environment (
APIEnv_NewNavigatorViewID,
API_NavigatorItem* navigatorItem,
API_NavigatorView* navigatorView,
const GS::Guid* parentAndChildGuids
);
파라미터
- navigatorItem
- ___
- navigatorView
- ___
- parentAndChildGuids
- 이 파라미터는 뷰 맵에 새로운 폴더 항목을 생성하고 싶을 때 사용합니다. 그리고 이 경우 navigatorView 파라미터는 NULL이 될 수 있습니다. 만약 다른 타입의 요소를 생성하면, 이 파라미터(parentAndChild)는 NULL이 될 수 있습니다. 이것은 2개의 GS::Guid들로 구성된 배열입니다. 1번째 guid는 새로운 navitem이 배치될 노드의 guid입니다. ("parent") 2번째("child")는 새 항목이 배치된 후입니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS- 만약 파라미터들에서 뭔가가 잘못되면 이 리턴 값을 보게 될 것입니다. 예. parentAndChild 배열에서 1번째 guid가 2번째의 father의 guid가 아닙니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
예제
이것은 Navigator_Test 테스트 애드온을 기반으로 한 폴더 항목 생성을 위한 예제입니다.
API_NavigatorItem navItem;
navItem.mapId = API_PublicViewMap;
navItem.itemType = API_FolderNavItem;
CHCopyC ("This test folder is created through API.", navItem.name);
GS::Guid parentAndChild[2];
Int32 selected = DGTreeViewGetSelected (dialogID, NavTreeView, DG_TVI_ROOT);
Int32 selParent = DGTreeViewGetItem (dialogID, NavTreeView, selected, DG_TVG_PARENT);
parentAndChild[0] = APIGuid2GSGuid (NavigatorTestGlobals::Instance ().GetNavigatorItem (TruncateTo32Bit (DGTreeViewGetItemUserData (dialogID, NavTreeView, selParent))));
parentAndChild[1] = APIGuid2GSGuid (NavigatorTestGlobals::Instance ().GetNavigatorItem (TruncateTo32Bit (DGTreeViewGetItemUserData (dialogID, NavTreeView, selected))));
ACAPI_Environment (APIEnv_NewNavigatorViewID, &navItem, NULL, &parentAndChild);
설명
###_remarks_###
요구사항
- 버전: API 13 또는 이후
- 헤더: APIdefs_Environment.h
