D2D1_HWND_RENDER_TARGET_PROPERTIES 구조체(d2d1.h)

ID2D1HwndRenderTarget에 대한 HWND, 픽셀 크기 및 프레젠테이션 옵션을 포함합니다.

구문

typedef struct D2D1_HWND_RENDER_TARGET_PROPERTIES {
  HWND                 hwnd;
  D2D1_SIZE_U          pixelSize;
  D2D1_PRESENT_OPTIONS presentOptions;
} D2D1_HWND_RENDER_TARGET_PROPERTIES;

멤버

hwnd

형식: HWND

렌더링 대상이 그리기 명령의 출력을 발급하는 HWND입니다.

pixelSize

형식: D2D1_SIZE_U

렌더링 대상의 크기(픽셀)입니다.

presentOptions

형식: D2D1_PRESENT_OPTIONS

렌더링 대상이 표시된 후 프레임을 유지할지 여부와 렌더링 대상이 표시하기 전에 디바이스가 새로 고쳐지도록 대기하는지 여부를 지정하는 값입니다.

설명

CreateHwndRenderTarget 메서드를 호출하여 새 ID2D1HwndRenderTarget을 만들 때 이 구조를 사용합니다.

편의를 위해 Direct2D는 새 D2D1_HWND_RENDER_TARGET_PROPERTIES 구조를 만들기 위한 D2D1::HwndRenderTargetProperties 함수를 제공합니다.

예제

다음 예제에서는 CreateHwndRenderTarget 메서드를 사용하여 ID2D1HwndRenderTarget을 만듭니다. D2D1::HwndRenderTargetProperties 도우미 함수를 사용하여 창에 대한 핸들과 그리기 영역의 크기를 포함하는 D2D1_HWND_RENDER_TARGET_PROPERTIES 구조를 만듭니다. D2D1_PRESENT_OPTIONS 값이 지정되지 않았으므로 함수는 기본값인 D2D1_PRESENT_OPTIONS_NONE 사용합니다.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

이 예제에서는 코드를 생략합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
머리글	d2d1.h

추가 정보

ID2D1HwndRenderTarget