PROPPAGEINFO 구조체(ocidl.h)
속성 프레임에 대한 속성 페이지를 설명하는 데 사용되는 매개 변수를 포함합니다. 속성 페이지는 IPropertyPage::GetPageInfo 메서드에서 호출자가 제공한 구조를 채웁니다.
구문
typedef struct tagPROPPAGEINFO {
ULONG cb;
LPOLESTR pszTitle;
SIZE size;
LPOLESTR pszDocString;
LPOLESTR pszHelpFile;
DWORD dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;
멤버
cb
구조체의 크기(바이트)입니다.
pszTitle
이 페이지의 탭에 표시되는 문자열을 포함하는 OLESTR 에 대한 포인터입니다. 문자열은 CoTaskMemAlloc과 함께 할당되어야 합니다. IPropertyPage::GetPageInfo의 호출자는 CoTaskMemFree를 사용하여 메모리를 해제합니다.
size
페이지 대화 상자의 필수 차원(픽셀)입니다.
pszDocString
속성 시트 대화 상자에 표시될 수 있는 페이지를 설명하는 텍스트 문자열에 대한 포인터입니다(현재 프레임 구현에서는 이 필드를 사용하지 않음). 텍스트는 CoTaskMemAlloc과 함께 할당되어야 합니다. IPropertyPage::GetPageInfo의 호출자는 CoTaskMemFree를 사용하여 메모리를 해제합니다.
pszHelpFile
IPropertyPage::Help를 구현하는 대신 사용되는 이 속성 페이지를 설명하는 도움말 파일의 간단한 이름을 포함하는 OLESTR에 대한 포인터입니다. 사용자가 도움말을 누르면 일반적으로 Help 메서드가 호출됩니다. 해당 메서드가 실패하면 프레임은 이 도움말 파일(CLSID 아래 속성 페이지의 레지스트리 항목에 있는 HelpDir 키 값 접두사)을 사용하여 도움말 시스템을 열고 dwHelpContext 필드에 설명된 컨텍스트를 표시하도록 도움말 시스템에 지시합니다. 경로는 CoTaskMemAlloc을 사용하여 할당되어야 합니다. IPropertyPage::GetPageInfo의 호출자는 CoTaskMemFree를 사용하여 메모리를 해제합니다.
dwHelpContext
이 페이지를 설명하는 pszHelpFile 내의 도움말 항목에 대한 컨텍스트 식별자입니다.
설명
이 구조 에 지정된 pszTitle, pszDocString 및 pszHelpFile 멤버에는 IPropertyPageSite::GetLocaleID를 통해 얻은 로캘에 중요한 텍스트가 포함되어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | ocidl.h |