OleCreatePropertyFrame 함수(olectl.h)

새 속성 프레임, 즉 부모가 hwndOwner인 속성 시트 대화 상자를 호출합니다. 여기서 대화 상자는 부모 창의 지점(x,y)에 배치되고 캡션 lpszCaption이 있습니다.

구문

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

매개 변수

[in] hwndOwner

결과 속성 시트 대화 상자의 부모 창에 대한 핸들입니다.

[in] x

예약되어 있습니다. hwndOwner를 기준으로 대화 상자의 가로 위치입니다.

[in] y

예약되어 있습니다. hwndOwner를 기준으로 대화 상자의 세로 위치입니다.

[in] lpszCaption

대화 상자의 캡션 사용되는 문자열에 대한 포인터입니다.

[in] cObjects

ppUnk에 전달된 개체 포인터의 수입니다.

[in] ppUnk

이 속성 시트가 호출되는 개체에 대한 IUnknown 포인터의 배열입니다. 배열의 요소 수는 cObjects로 지정됩니다. 이러한 포인터는 IPropertyPage::SetObjects를 통해 각 속성 페이지에 전달됩니다.

[in] cPages

pPageCIsID에 지정된 속성 페이지 수입니다.

[in] pPageClsID

속성 시트에 표시할 각 속성 페이지의 CLSID를 포함하는 cPage 크기의 배열입니다.

[in] lcid

속성 시트에 사용할 로캘 식별자입니다. 속성 페이지는 IPropertyPageSite::GetLocaleID를 통해 이 식별자를 검색할 수 있습니다.

[in] dwReserved

나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.

[in] pvReserved

나중에 사용하도록 예약됨; 은 NULL이어야 합니다.

반환 값

이 함수는 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값과 다음을 지원합니다.

반환 코드	Description
S_OK	대화 상자가 호출되고 성공적으로 작동했습니다.
E_POINTER	lpszCaption, ppUnk 또는 pPageCIsID의 주소가 잘못되었습니다. 예를 들어 그 중 하나가 NULL일 수 있습니다.

설명

표시할 속성 페이지는 cPagesCLSID 값의 배열인 pPageClsID로 식별됩니다. 이 속성 시트의 영향을 받는 개체는 IUnknown 포인터를 포함하는 cObjects 크기의 배열인 ppUnk에서 식별됩니다.

이 함수는 항상 모달 대화 상자를 만들고 대화 상자가 닫을 때까지 반환되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	olectl.h
라이브러리	OleAut32.lib
DLL	OleAut32.dll

추가 정보

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID