RESULTDATAITEM 구조체(mmc.h)

아티클
08/24/2023

RESULTDATAITEM 구조체는 스냅인의 결과 창에서 결과 항목의 특성을 지정하거나 받습니다.

구문

typedef struct _RESULTDATAITEM {
  DWORD       mask;
  BOOL        bScopeItem;
  HRESULTITEM itemID;
  int         nIndex;
  int         nCol;
  LPOLESTR    str;
  int         nImage;
  UINT        nState;
  LPARAM      lParam;
  int         iIndent;
} RESULTDATAITEM;

멤버

mask

이 데이터 구조의 특성을 지정하는 플래그 집합 또는 이 구조를 사용하는 작업입니다.

다음 플래그는 유효한 데이터를 포함하거나 데이터로 채워야 하는 RESULTDATAITEM 구조체의 멤버를 지정합니다. 하나 이상의 플래그를 설정할 수 있습니다.

RDI_STR(0x0002)

str 멤버가 유효하거나 채워져야 합니다.

RDI_IMAGE(0x0004)

nImage 멤버가 유효하거나 채워야 합니다.

RDI_STATE(0x0008)

nState 멤버가 유효하거나 채워야 합니다.

RDI_PARAM(0x0010)

lParam 멤버가 유효하거나 채워야 합니다.

RDI_INDEX(0x0020)

nIndex 멤버가 유효하거나 채워져야 합니다.

RDI_INDENT(0x0040)

iIndent 멤버가 유효하거나 채워져야 합니다.

bScopeItem

lParam 멤버가 scope 항목을 참조하는 경우 TRUE입니다. lParam 멤버가 결과 항목을 참조하는 경우 FALSE입니다.

itemID

결과 항목에 대해 콘솔에서 제공하는 고유 항목 식별자를 지정하는 값입니다. 이 값은 일부 호출의 결과 창에서 항목을 식별하는 데 사용됩니다.
IResultData 인터페이스 메서드.

스냅인에서 IResultData::InsertItem을 사용하여 scope 창에 항목을 삽입한 후 RESULTDATAITEM 구조체의 itemID 멤버에는 새로 삽입된 항목의 HRESULTITEM 핸들이 포함됩니다. 이 핸들은 결과 항목의 고유 식별자입니다.

스냅인은 IResultData::GetItem과 같은 메서드를 호출하여 삽입된 항목을 조작(나중에)하기 위해 이 값을 저장해야 합니다. 이 값이 저장되지 않은 경우 IResultData::FindItemByLParam을 사용하여 조회할 수 있습니다.

nIndex

이 구조체가 참조하는 항목의 인덱스(0부터 시작)를 지정하는 값입니다.

nCol

작업을 수행할 열을 지정하는 값입니다. 작업이 열이 아닌 항목에서 수행되는 경우 값은 0입니다.

str

구조체가 RDI_STR 항목 특성을 지정하는 경우 항목 텍스트가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버가 MMC_CALLBACK 값인 경우 항목은 콜백 항목입니다.

스냅인은 MMC_CALLBACK 대신 MMC_TEXTCALLBACK 사용할 수 있습니다. MMC_TEXTCALLBACK 값은 올바른 형식(캐스팅 필요 없음) 버전의 MMC_CALLBACK.

MMC_TEXTCALLBACK MMC 버전 1.2에 도입되었습니다.

nImage

크고 작은 아이콘 이미지 목록에 있는 목록 보기 항목 아이콘의 가상 이미지 인덱스입니다. 가상 이미지 인덱스는 내부적으로 실제 인덱스로 매핑됩니다. 이 멤버는 콜백 항목( MMC_CALLBACK 또는 MMC_IMAGECALLBACK)으로 지정할 수도 있습니다. MMC_IMAGECALLBACK 값은 올바른 형식(캐스팅 필요 없음) 버전의 MMC_CALLBACK.

MMC_IMAGECALLBACK MMC 버전 1.2에 도입되었습니다.

nState

항목의 상태 마스크를 지정하는 값입니다. 다음 값 중 하나일 수 있습니다.

LVIS_CUT

항목이 잘라내기 및 붙여넣기 작업으로 표시됩니다.

LVIS_DROPHILITED

항목이 끌어서 놓기 대상으로 강조 표시됩니다.

LVIS_FOCUSED

항목에 포커스가 있으므로 표준 포커스 사각형으로 둘러싸여 있습니다. 둘 이상의 항목을 선택할 수 있지만 하나의 항목만 포커스를 가질 수 있습니다.

LVIS_SELECTED

항목이 선택되어 있습니다. 선택한 항목의 모양은 포커스가 있는지 여부와 선택 영역에 사용되는 시스템 색에 따라 달라집니다.

참고LVIS_* 상수를 사용하려면 원본 파일에 CommCtrl.h를 포함합니다.

lParam

항목과 연결할 사용자가 제공한 32비트 값을 지정하는 값입니다. 쿠키라고도 하는 이 항목은 IComponent::QueryDataObject에 첫 번째 매개 변수로 전달되는 값입니다.

iIndent

예약되어 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	mmc.h

추가 정보

IResultData