TVINSERTSTRUCTA 구조체(commctrl.h)

트리 뷰 컨트롤에 새 항목을 추가하는 데 사용되는 정보를 포함합니다. 이 구조체는 TVM_INSERTITEM 메시지와 함께 사용됩니다. 구조체는 TV_INSERTSTRUCT 구조체와 동일하지만 현재 명명 규칙을 따르도록 이름이 변경되었습니다.

구문

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

멤버

hParent

형식: HTREEITEM

부모 항목에 대한 핸들입니다. 이 멤버가 TVI_ROOT 값 또는 NULL이면 트리 뷰 컨트롤의 루트에 항목이 삽입됩니다.

hInsertAfter

형식: HTREEITEM

새 항목을 삽입할 항목 또는 다음 값 중 하나에 대한 핸들입니다.

값	의미
TVI_FIRST	목록의 시작 부분에 항목을 삽입합니다.
TVI_LAST	목록의 끝에 항목을 삽입합니다.
TVI_ROOT	항목을 루트 항목으로 추가합니다.
TVI_SORT	항목을 사전순으로 목록에 삽입합니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

형식: TVITEMEX

버전 4.71. 추가할 항목에 대한 정보가 포함된 TVITEMEX 구조체입니다.

DUMMYUNIONNAME.item

형식: TVITEM

추가할 항목에 대한 정보를 포함하는 TVITEM 구조체입니다.

설명

이 구조체의 공용 구조체는 이름 없는 공용 구조체를 지원하지 않는 컴파일러에서 작동하도록 업데이트되었습니다. 컴파일러에서 이름 없는 공용 구조체를 지원하지 않는 경우 commctrl.h 헤더 파일을 포함하기 전에 NONAMELESSUNION 토큰을 정의합니다.

중요 TVI_LAST 사용하여 이미 많은 수의 항목이 포함된 트리 뷰 노드에 항목을 삽입하는 데 시간이 오래 걸릴 수 있으므로 삽입 작업이 완료될 때까지 애플리케이션이 응답을 중지할 수 있습니다.

 

참고

commctrl.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 TVINSERTSTRUCT를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	commctrl.h