Compartilhar via


Método ID2D1CommandSink::Clear (d2d1_1.h)

Limpa a área de desenho para a cor especificada.

Sintaxe

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

Parâmetros

[in, optional] color

Tipo: const D2D1_COLOR_F*

A cor para a qual o coletor de comando deve ser limpo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se falhar, retornará um código de erro HRESULT .

Comentários

A cor clara é restrita pelos limites de clipe e camada selecionados no momento.

Se nenhuma cor for especificada, a cor deverá ser interpretada pelo contexto. Os exemplos incluem, mas não se limitam a:

  • Preto transparente para um destino de bitmap pré-multiplicado.
  • Preto opaco para um destino de bitmap de ignorar.
  • Não contém nenhum conteúdo (ou branco) para uma página de impressora.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
DLL D2d1.dll

Confira também

ID2D1CommandList::Stream

ID2D1CommandSink

ID2D1RenderTarget::Clear