共用方式為


CRenderTarget::CreateCompatibleRenderTarget

建立新的點陣圖轉譯目標,以供在相容於目前轉譯目標的中繼幕後繪圖期間使用。

BOOL CreateCompatibleRenderTarget(
   CBitmapRenderTarget& bitmapTarget,
   CD2DSizeF sizeDesired = CD2DSizeF(0.,
   0.),
   CD2DSizeU sizePixelDesired = CD2DSizeU(0,
   0),
   D2D1_PIXEL_FORMAT* desiredFormat = NULL,
   D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE
);

參數

  • bitmapTarget
    這個方法傳回時,會包含新點陣圖轉譯目標指標的位址。 這個參數會以未初始化的狀態傳遞。

  • sizeDesired
    如果不同於原始轉譯目標,則為新轉譯目標所需的大小 (以裝置獨立畫素為單位),否則為 NULL。 如需詳細資訊,請參閱<備註>一節。

  • sizePixelDesired
    如果不同於原始轉譯目標,則為新轉譯目標所需的大小 (以像素為單位),否則為 NULL。 如需詳細資訊,請參閱<備註>一節。

  • desiredFormat
    新轉譯目標所需的像素格式和 Alpha 模式,或者為 NULL。 如果將像素格式設定為 DXGI_FORMAT_UNKNOWN,或此參數為 Null,則新的轉譯目標會使用與原始轉譯目標相同的像素格式。 如果 Alpha 模式是 D2D1_ALPHA_MODE_UNKNOWN,或者此參數是 NULL,則新轉譯目標的 Alpha 模式會預設為 D2D1_ALPHA_MODE_PREMULTIPLIED。 如需支援的像素格式的詳細資訊,請參閱<支援的像素格式>和<Alpha 模式>。

  • options
    指定新轉譯目標是否必須與 GDI 相容的值。

傳回值

如果方法成功,它會傳回 TRUE。 否則,它會傳回 FALSE。

需求

**標頭檔:**afxrendertarget.h

請參閱

參考

CRenderTarget 類別