Compartilhar via

Método IDirectDrawClipper::SetClipList (ddraw.h)

  • Artigo

Define ou exclui a lista de clipes usada pelos métodos IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay em superfícies às quais o objeto DirectDrawClipper pai está anexado.

Sintaxe

HRESULT SetClipList(
  [in] LPRGNDATA unnamedParam1,
  [in] DWORD     unnamedParam2
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura RGNDATA válida para a lista de clipes a ser definida ou NULL. Se houver uma lista de clipes existente associada ao objeto DirectDrawClipper e esse valor for NULL, a lista de clipes será excluída.

[in] unnamedParam2

Atualmente, não é usado e deve ser definido como 0.

Valor retornado

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

  • DDERR_CLIPPERISUSINGHWND
  • DDERR_INVALIDCLIPLIST
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_OUTOFMEMORY

Comentários

Você não poderá definir a lista de clipes se um identificador de janela já estiver associado ao objeto DirectDrawClipper.

O método IDirectDrawSurface7::BltFast não pode ser recortar. Se você chamar IDirectDrawSurface7::BltFast em uma superfície com um cortador anexado, ele retornará DDERR_UNSUPPORTED.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

Idirectdrawclipper