MMC_LISTPAD_INFO 구조체(mmc.h)
MMC_LISTPAD_INFO 구조체는 MMC 1.1에서 도입되었습니다.
MMC_LISTPAD_INFO 구조체는 IExtendTaskPad::GetListPadInfo 메서드로 채워져 목록 보기 작업 패드에 대해 다음 정보를 지정합니다.
- 목록 컨트롤의 제목 텍스트
- 선택적 단추에 대한 텍스트
- 해당 단추를 클릭할 때 IExtendTaskPad::TaskNotify 에 전달된 명령 ID입니다.
구문
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
멤버
szTitle
목록 컨트롤 바로 위에 배치된 텍스트를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 텍스트는 목록 컨트롤 내의 개체에 대한 레이블(예: 목록에 프린터가 포함된 경우 "프린터") 또는 지침(예: "프린터 선택 및 수행할 작업 클릭")일 수 있습니다.
szTitle이 NULL이거나 비어 있으면 목록 컨트롤에 대한 제목이 표시되지 않습니다.
szTitle 멤버가 IExtendTaskPad::GetTitle에 대한 pszTitle 매개 변수와 동일하지 않습니다. IExtendTaskPad::GetTitle 메서드는 작업 패드의 맨 위에 표시되고 모든 표준 MMC 작업 패드에 표시되는 전체 작업 패드의 제목을 반환합니다. MMC_LISTPAD_INFOszTitle 멤버는 목록 컨트롤의 레이블이며 MMC 목록 보기 작업 패드에만 표시됩니다.
szButtonText
목록 컨트롤 바로 위와 szTitle 텍스트 오른쪽에 있는 단추에 배치된 텍스트가 포함된 null로 끝나는 문자열에 대한 포인터입니다.
사용자가 작업 패드에서 이 단추를 클릭하면 MMC는 스냅인의 IExtendTaskPad::TaskNotify 메서드를 호출하고 nCommandID 에 지정된 값을 arg 매개 변수의 VARIANT 구조체로 전달합니다. TaskNotify에 전달된 VARIANT에는 VT_I4 설정된vt 멤버와 명령 ID가 포함된 lVal 멤버가 있습니다.
텍스트 없이 단추를 표시하려면 szButtonText 를 빈 문자열로 설정합니다.
작업 패드에 표시되도록 이 단추를 숨기려면 szButtonText 를 NULL로 설정합니다.
nCommandID
szButtonText로 지정된 단추의 식별자로 사용되는 값입니다. 단추 클릭 알림을 보낸 작업 패드를 식별하려면 이 값을 각 작업 패드에 고유하게 지정하는 것이 좋습니다.
사용자가 이 단추를 클릭하면 MMC는 스냅인의 IExtendTaskPad::TaskNotify 메서드를 호출하고 이 값을 arg 매개 변수의 VARIANT 로 전달합니다.
szButtonText가 NULL인 경우 이 값은 무시됩니다.
설명
COM API 함수 CoTaskMemAlloc(또는 이에 상응하는)을 사용하여 szTitle 및 szButtonText 문자열을 할당하면 MMC에서 릴리스됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | mmc.h |