CLIPOBJ_cEnumStart
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.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
Essa função Configura parâmetros para enumerar retângulos em uma região juntar especificado.
Syntax
ULONG CLIPOBJ_cEnumStart(
IN CLIPOBJ* pco,
BOOL bAll,
ULONG iType,
ULONG iDirection,
ULONG cLimit
);
Parameters
- pco
[no] Ponteiro para o CLIPOBJ estrutura que define a região juntar a ser enumerado.
bAll
[no] Sinalizador que especifica se a toda a região deve ser enumerada. Para enumerar toda a região, defina este parâmetro como TRUE. Para enumerar as partes da região relevante para a operação de desenho presente, defina este parâmetro como FALSE.Um driver que caches juntar regiões devem enumerar toda a região.
- iType
[no] Estruturas de dados a serem gravados pela CLIPOBJ_bEnum função. Defina este parâmetro como CT_RECTANGLES, que indica que a região é para ser enumerados como uma lista dos retângulos.
iDirection
[no] Ordem na qual enumerar retângulos. Especificar uma ordem se um DrvBitBlt operação executa simultaneamente na superfície do mesma. Se a ordem de enumeração não for relevante para o driver de dispositivo, CD_ANY, que instrui GDI especificar para otimizar a enumeração.A seguinte tabela mostra valores possíveis para esse parâmetro.
Valor Descrição CD_ANY
GDI determina a ordem de enumeração.
CD_LEFTDOWN
Da direita para esquerda e parte superior para inferior.
CD_LEFTUP
Da direita para esquerda e inferior para parte superior.
CD_RIGHTDOWN
À esquerda para direito e parte superior para inferior.
CD_RIGHTUP
À esquerda para direito e inferior para parte superior.
- cLimit
[no] Número máximo de retângulos para enumerar. Se o valor deste parâmetro for zero, contagem não será executada.
Return Value
Essa função retorna uma contagem de retângulos enumerados. Se a contagem excede o valor especificado na cLimit parâmetro, essa função retorna 0xFFFFFFFF.
Remarks
Chamar esta função não afeta se você pode enumerar uma região. Por padrão, o driver enumera retângulos relevantes do esquerda para a direita e parte superior para inferior.
O driver pode reiniciar enumeração por chamado essa função.
Requirements
| Header | winddi.h |
| Library | Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib |
| Windows Embedded CE | Windows CE 1.0 and later |