Share via


ID2D1CommandSink::Clear 方法 (d2d1_1.h)

將繪圖區域清除為指定的色彩。

語法

HRESULT Clear(
  [in, optional] const D2D1_COLOR_F *color
);

參數

[in, optional] color

類型: const D2D1_COLOR_F*

應該清除命令接收的色彩。

傳回值

類型: HRESULT

如果方法成功,它會 傳回S_OK。 如果失敗,則會傳回 HRESULT 錯誤碼。

備註

純色受限於目前選取的剪輯和圖層界限。

如果未指定任何色彩,則應該依內容解譯色彩。 範例包括但不限於:

  • 預乘點圖目標的透明黑色。
  • 忽略點圖目標的不透明黑色。
  • 不包含印表機頁面的內容 (或白色) 。

規格需求

需求
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
Dll D2d1.dll

另請參閱

ID2D1CommandList::Stream

ID2D1CommandSink

ID2D1RenderTarget::Clear