IDirectDrawClipper::GetClipList
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método recupera um copiar da lista de juntar associado com um DirectDrawClipper WScript.Shell. Um subconjunto da lista de juntar pode ser selecionado por passar um retângulo que clipes a lista juntar.
Syntax
HRESULT GetClipList(
LPRECT lpRect,
LPRGNDATA lpClipList,
LPDWORD lpdwSize
);
Parameters
- lpRect
Endereço de um retângulo que serão usado para juntar a lista juntar. Este parâmetro pode ser NULL para recuperar a lista inteira juntar.
- lpClipList
Endereço de um RGNDATA estrutura que conterá a copiar resultante da lista de juntar. Se este parâmetro é NULL, o método preenche a variável no lpdwSize Para o número de bytes necessários manter a lista inteira juntar.
- lpdwSize
Tamanho da lista juntar resultante. Ao recuperar a lista juntar, este parâmetro é o tamanho da reserva em lpClipList. Quando lpClipList é NULL, a variável no lpdwSize Recebe o exigido tamanho da reserva, em bytes.
Return Value
Se o método for bem-sucedido, o valor de retorno é DD_OK.
Se o método falhar, o valor de retorno pode ser uma do seguinte valores de erro:
DDERR_GENERIC |
DDERR_INVALIDCLIPLIST |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_NOCLIPLIST |
DDERR_REGIONTOOSMALL |
Para obter mais informações sobre esses erros códigos Consulte DirectDraw Return Values.
Remarks
O RGNDATA estrutura usada com este método tem a seguinte sintaxe.
typedef struct _RGNDATA {
RGNDATAHEADER rdh;
char Buffer[1];
} RGNDATA;
O rdh membro das RGNDATA estrutura é um RGNDATAHEADER estrutura que possui a seguinte sintaxe.
typedef struct _RGNDATAHEADER {
DWORD dwSize;
DWORD iType;
DWORD nCount;
DWORD nRgnSize;
RECT rcBound;
} RGNDATAHEADER;
Para obter mais informações sobre essas estruturas, consulte a documentação na Windows SDK.
Requirements
| Header | ddraw.h |
| Library | ddraw.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |