Metodo IDirectDrawSurface7::SetClipper (ddraw.h)

Collega un oggetto clipper a o ne elimina uno da questa superficie.

Sintassi

HRESULT SetClipper(
  [in] LPDIRECTDRAWCLIPPER unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore all'interfaccia IDirectDrawClipper per l'oggetto DirectDrawClipper da associare all'oggetto DirectDrawSurface. Se si imposta questo parametro su NULL, l'oggetto DirectDrawClipper corrente viene scollegato.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_INVALIDSURFACETYPE
• DDERR_NOCLIPPERATTACHED

Commenti

Quando imposti un clipper su una superficie per la prima volta, SetClipper incrementa il conteggio dei riferimenti di clipper; le chiamate successive non influiscono sul conteggio dei riferimenti di Clipper. Se passi NULL come parametro lpDDClipper , il clipper viene rimosso dalla superficie e il conteggio dei riferimenti del clipper viene decrementato. Se non elimini il clipper, la superficie rilascia automaticamente il riferimento al clipper quando viene rilasciata la superficie stessa. In base alle regole COM, l'applicazione deve rilasciare tutti i riferimenti contenuti nel clipper quando l'oggetto non è più necessario.

SetClipper viene usato principalmente dalle superfici sovrapposte o bitbltte alla superficie primaria. Tuttavia, può essere usato in qualsiasi superficie. Dopo aver associato un oggetto DirectDrawClipper e a esso è associato un elenco di clip, l'oggetto DirectDrawClipper viene utilizzato per le operazioni IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay che coinvolgono l'oggetto DirectDrawSurface padre. SetClipper può anche scollegare l'oggetto DirectDrawClipper corrente di un oggetto DirectDrawSurface.

Requisiti

Vedi anche

IDirectDrawSurface7