CTreeCtrl::SetItem

아티클
06/10/2015

지정 된 트리 뷰 항목의 특성을 설정 하려면이 함수를 호출 합니다.

BOOL SetItem( 
   TVITEM* pItem  
); 
BOOL SetItem( 
   HTREEITEM hItem, 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   int nSelectedImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam  
);

매개 변수

pItem
에 대 한 포인터는 TVITEM 의 설명에 따라 새 항목을 포함 하는 구조 특성은 Windows SDK.
hItem
속성 설정 하는 항목의 핸들입니다. 참조는 hItem 소속은 TVITEM 의 구조는 Windows SDK.
nMask
특성 집합을 지정 하는 정수입니다. 참조는 마스크 의 멤버는 TVITEM 구조.
lpszItem
주소 항목의 텍스트를 포함 하는 문자열입니다.
nImage
항목의 이미지를 이미지 목록 tree view 컨트롤의 인덱스입니다. 참조는 iImage 의 구성원의 TVITEM 구조.
nSelectedImage
트리 뷰 컨트롤의 이미지 목록에서 이미지를 선택 하는 항목의 인덱스입니다. 참조는 iSelectedImage 의 멤버는 TVITEM 구조.
nState
항목의 상태에 대 한 값을 지정합니다. 참조는 상태 의 멤버는 TVITEM 구조.
nStateMask
상태를 설정할 수를 지정 합니다. 참조는 stateMask 의 멤버는 TVITEM 구조.
lParam
32 비트 응용 프로그램 특정 항목과 연결 된 값입니다.

반환 값

성공 하면 0이 아닌. 그렇지 않으면 0입니다.

설명

에 TVITEM 구조체는 hItem 멤버 항목을 식별 및 마스크 멤버 특성 집합을 지정 합니다.

경우는 마스크 멤버 또는 nMask 매개 변수를 지정는 TVIF_TEXT 값은 pszText 멤버 또는 lpszItem null로 끝나는 문자열의 주소입니다 및 cchTextMax 멤버가 무시 됩니다. 경우 마스크 (또는 nMask) 지정는 TVIF_STATE 값은 stateMask 구성원 또는 nStateMask 매개 변수를 지정 하는 항목 상태를 변경 및 상태 멤버 또는 nState 매개 변수는 해당 상태에 대 한 값이 들어.

예제

// Show the item at the point myPoint in bold.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SetItem(hItem, TVIF_STATE, NULL, 0, 0, TVIS_BOLD, 
      TVIS_BOLD, 0);
}