IExtendPropertySheet2::GetWatermarks 메서드(mmc.h)
IExtendPropertySheet2::GetWatermarks 메서드는 마법사 97 스타일 마법사로 구현된 마법사 시트에 대한 워터마크 비트맵 및 헤더 비트맵을 가져옵니다.
구문
HRESULT GetWatermarks(
[in] LPDATAOBJECT lpIDataObject,
[out] HBITMAP *lphWatermark,
[out] HBITMAP *lphHeader,
[out] HPALETTE *lphPalette,
[out] BOOL *bStretch
);
매개 변수
[in] lpIDataObject
scope 또는 결과 항목에 대한 컨텍스트 정보를 포함하는 개체의 IDataObject 인터페이스에 대한 포인터입니다.
[out] lphWatermark
마법사 97 페이지의 워터마크 역할을 하는 비트맵에 대한 핸들에 대한 포인터입니다. 비트맵에 대한 핸들이 NULL이면 마법사에 대한 워터마크가 표시되지 않습니다. 이 값이 NULL이 아닌 경우 호환성을 위해 스냅인은 워터마크 리소스의 수명을 관리해야 합니다. 스냅인은 워터마크 리소스를 해제하는 역할을 담당합니다.
[out] lphHeader
마법사 97 페이지의 헤더 역할을 하는 비트맵에 대한 핸들에 대한 포인터입니다. 비트맵에 대한 핸들이 NULL이면 마법사 페이지의 헤더에 비트맵이 표시되지 않습니다. 이 값이 NULL이 아닌 경우 호환성을 위해 스냅인은 헤더 리소스의 수명을 관리해야 합니다. 스냅인은 헤더 리소스를 해제하는 역할을 담당합니다.
[out] lphPalette
lphWatermark 및 lphHeader로 지정된 비트맵에 사용해야 하는 팔레트에 대한 핸들에 대한 포인터입니다. 색상표는 기본적으로 NULL 입니다. 색상표가 반환되지 않으면 색상표는 NULL입니다. 이 값이 NULL이 아닌 경우 호환성을 위해 스냅인은 색상표 리소스의 수명을 관리해야 합니다. 스냅인은 색상표 리소스를 해제하는 역할을 담당합니다.
[out] bStretch
속성 시트의 배경 또는 머리글 영역에 맞게 워터마크 및 헤더 비트맵을 타일식이 아닌 확장해야 하는지 여부를 지정하는 값입니다. TRUE 는 워터마크 및 헤더 비트맵을 확장해야 하며, FALSE 는 워터마크 및 헤더 비트맵의 크기를 유지하고 타일로 표시되도록 지정합니다. 이 매개 변수는 기본적으로 FALSE 입니다. bStretch 값이 반환되지 않으면 bStretch는 FALSE입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
MMC는 다음 경우에만 이 메서드를 호출합니다.
- IPropertySheetProvider::CreatePropertySheet의 형식 매개 변수는 FALSE(마법사 시트의 경우)로 설정되고 dwOptions 매개 변수가 MMC_PSO_NEWWIZARDTYPE(마법사 97 스타일)로 설정됩니다.
- 스냅인은 IComponentData 또는 IComponent 인터페이스에 대한 포인터를 IPropertySheetProvider::AddPrimaryPages 메서드 호출의 첫 번째 매개 변수로 전달합니다.
이미지의 왜곡을 방지하려면 워터마크 및 헤더 비트맵에 bStretch 가 FALSE로 설정된 다음 차원(픽셀 단위)이 있는 것이 좋습니다.
| Bitmap | 차원 |
|---|---|
| lphWatermark | 164w x 628h |
| lphHeader | 49w x 49h |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |