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를 통해 얻은 로캘에 중요한 텍스트가 포함되어야 합니다.

요구 사항

추가 정보

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR