다음을 통해 공유

TVINSERTSTRUCTW 구조체(commctrl.h)

  • 아티클

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

통사론

typedef struct tagTVINSERTSTRUCTW {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXW itemex;
    TV_ITEMW  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTW, *LPTVINSERTSTRUCTW;

회원

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