Header_SetHotDivider macro (commctrl.h)

Artigo
10/24/2024

Altera a cor de um divisor entre itens de cabeçalho para indicar o destino de uma operação de arrastar e soltar externa. Você pode usar essa macro ou enviar a mensagem HDM_SETHOTDIVIDER explicitamente.

Sintaxe

int Header_SetHotDivider(
   HWND  hwnd,
   BOOL  fPos,
   DWORD dw
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para um controle de cabeçalho.

fPos

Tipo: BOOL

Um valor que especifica como dw deve ser interpretado. O valor neste campo pode ser um dos seguintes:

Valor	Significado
VERDADEIRO	Indica que dw contém as coordenadas do cliente do ponteiro.
FALSE	Indica que dw contém um valor de índice divisor.

dw

Tipo: DWORD

O valor mantido aqui é interpretado dependendo do valor de fPos.

Se fPos for VERDADEIRO, dw representará as coordenadas do cliente x e y do ponteiro. A coordenada x está na palavra baixa e a coordenada y está na palavra alta. Ao receber a mensagem, o controle de cabeçalho realça o divisor apropriado com base nas coordenadas dw.

Se fPos for false, dw representará o índice inteiro do divisor que será realçado.

Valor de retorno

Tipo: int

Retorna o índice do divisor realçado pelo controle.

Observações

Um controle de cabeçalho definido para o estilo HDS_DRAGDROP produz esse efeito automaticamente. Essa mensagem destina-se a ser usada quando o proprietário do controle manipula manualmente as operações de arrastar e soltar.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via