Referência de Controlo Geral

Esta seção contém informações de referência sobre elementos de programação que se aplicam a vários controles, não apenas a um controle específico. Existem funções, macros, mensagens, notificações e estruturas suportadas pela maioria dos controlos. Por exemplo, a maioria dos controles usa as notificações NM_HOVER para processar cliques do mouse.

• Visão geral
• Funções
• Macros
• Mensagens
• Notificações
• Estruturas
• constantes

Visão geral

Tópico	Índice
Sobre controles comuns	Os controles comuns são um conjunto de janelas que são implementadas pela biblioteca de controle comum, que é uma DLL incluída com o sistema operacional Windows.
Perguntas frequentes sobre controles comuns	Esta FAQ fornece respostas a algumas perguntas comuns sobre os controlos comuns.

Funções

Tópico	Índice
DoReaderMode	Ativa o modo de leitura em uma janela.
DPA_Clone	Duplica uma matriz de ponteiro dinâmico (DPA).
DPA_Create	Cria um DPA.
DPA_CreateEx	Cria um DPA usando um determinado tamanho especificado e local de heap.
DPA_DeleteAllPtrs	Remove todos os itens de um DPA e reduz o DPA de acordo.
DPA_DeletePtr	Remove um item de um DPA. O DPA encolhe, se necessário, para acomodar o item removido.
DPA_Destroy	Libera uma matriz de ponteiro dinâmico (DPA).
DPA_DestroyCallback	Chama pfnCB em cada elemento do DPA e, em seguida, libera o DPA.
DPA_EnumCallback	Itera através do Dynamic Pointer Array (DPA) e chama pfnCB em cada item.
DPA_GetPtr	Obtém um item de um DPA.
DPA_GetPtrIndex	Obtém o índice de um item correspondente encontrado em um DPA.
DPA_GetSize	Obtém o tamanho de um DPA.
DPA_Grow	Altera o número de ponteiros em um DPA.
DPA_InsertPtr	Insere um novo item em uma posição especificada em um DPA. Se necessário, o DPA se expande para acomodar o novo item.
DPA_LoadStream	Carrega o DPA de um fluxo chamando a função de retorno de chamada especificada para ler cada elemento.
DPA_Merge	Combina o conteúdo de dois DPAs.
DPA_SaveStream	Salva o DPA em um fluxo escrevendo um cabeçalho e, em seguida, chamando a função de retorno de chamada especificada para gravar cada elemento.
DPA_Search	Localiza um item em um DPA.
DPA_SetPtr	Atribui um valor a um item em um DPA.
DPA_Sort	Classifica os itens em uma matriz de ponteiro dinâmico (DPA).
DrawShadowText	Desenha texto com sombra.
DrawTextExPrivWrap	Desenha texto formatado no retângulo especificado. Esta função encapsula uma chamada para DrawTextEx.
DrawTextWrap	Desenha texto formatado no retângulo especificado. Ele formata o texto de acordo com o método especificado (expandir guias, justificar caracteres, quebrar linhas e assim por diante). Esta função encapsula uma chamada para DrawText.
DSA_Clone	Duplica uma matriz de estrutura dinâmica (DSA).
DSA_Create	Cria um DSA.
DSA_DeleteAllItems	Exclui todos os itens de um DSA.
DSA_DeleteItem	Exclui um item de um DSA.
DSA_Destroy	Liberta um DSA.
DSA_DestroyCallback	Itera através de um DSA, chamando uma função de retorno de chamada especificada em cada item. Ao chegar ao final da matriz, o DSA é liberado.
DSA_EnumCallback	Itera através do DSA e chama pfnCB em cada item.
DSA_GetItem	Obtém um elemento de um DSA.
DSA_GetItemPtr	Obtém um ponteiro para um elemento de um DSA.
DSA_GetSize	Obtém o tamanho do DSA.
DSA_InsertItem	Insere um novo item em um DSA. Se necessário, o DSA se expande para acomodar o novo item.
DSA_SetItem	Define o conteúdo de um elemento em um DSA.
DSA_Sort	Classifica os itens em um DSA.
ExtTextOutWrap	Desenha texto usando a fonte selecionada, a cor do plano de fundo e a cor do texto selecionadas no momento. Opcionalmente, você pode fornecer dimensões a serem usadas para recorte, opacidade ou ambos. Esta função encapsula uma chamada para ExtTextOut.
GetEffectiveClientRect	Calcula as dimensões de um retângulo na área do cliente que contém todos os controles especificados.
GetMUILanguage	Obtém o idioma atualmente em uso pelos controles comuns para um processo específico.
GetTextExtentPoint32Wrap	Calcula a largura e a altura da cadeia de caracteres especificada do texto. Esta função encapsula uma chamada para GetTextExtentPoint.
InitCommonControls	Registra e inicializa determinadas classes de janela de controle comuns. Esta função está obsoleta. Novos aplicativos devem usar a funçãoInitCommonControlsEx.
InitCommonControlsEx	Registra classes de controle comuns específicas da DLL de controle comum.
InitMUILanguage	Permite que um aplicativo especifique um idioma a ser usado com os controles comuns que é diferente do idioma do sistema.
LoadIconMetric	Carrega um recurso de ícone especificado com uma métrica de sistema especificada pelo cliente.
LoadIconWithScaleDown	Carrega um ícone. Se o ícone não tiver um tamanho padrão, essa função reduzirá uma imagem maior em vez de aumentar a escala de uma imagem menor.
MirrorIcon	Inverte (espelhos) ícones para que eles sejam exibidos corretamente em um contexto de dispositivo espelhado.
PFNDACOMPARE	Define o protótipo para a função de comparação usada por DSA_Sort.
PFNDACOMPARECONST	Define o protótipo para a função de comparação usada por DSA_Sort quando os itens que estão sendo comparados são objetos constantes.
PFNDAENUMCALLBACK	Define o protótipo para a função de retorno de chamada usada pelas funções DSA e DPA.
PFNDAENUMCALLBACKCONST	Define o protótipo para a função de retorno de chamada usada pelas funções DSA e DPA quando os itens envolvidos são ponteiros para dados constantes.
PFNDPACOMPARE	Define o protótipo para a função de comparação usada por DPA_Sort e DPA_Search.
PFNDPACOMPARECONST	Define o protótipo para a função de comparação usada por DPA_Sort ou DPA_Search quando os itens que estão sendo comparados são objetos constantes.
PFNDPAENUMCALLBACK	Define o protótipo para a função de retorno de chamada usada por DPA_EnumCallback.
PFNDPAMERGE	Define o protótipo para a função de mesclagem usada por DPA_Merge.
PFNDPAMERGECONST	Define o protótipo para a função de mesclagem usada por DPA_Merge, usando valores constantes.
PFNDPASTREAM	Define o protótipo para a função de retorno de chamada usada por DPA_LoadStream e DPA_SaveStream.
PFNDSAENUMCALLBACK	Define o protótipo para a função de retorno de chamada usada por DSA_DestroyCallback.
ReaderScroll	Uma função de retorno de chamada definida pelo aplicativo usada quando o ponteiro do mouse é movido dentro da parte da janela do modo de leitura que foi declarada como a área de rolagem ativa.
ShowHideMenuCtl	Define ou remove o atributo de marca de seleção do item de menu especificado e mostra ou oculta o controle correspondente. A função adiciona uma marca de seleção ao item de menu especificado se não tiver uma e, em seguida, exibe o controle correspondente. Se o item de menu já tiver uma marca de seleção, a função removerá a marca de seleção e ocultará o controle correspondente.
Str_GetPtr	Copia uma cadeia de caracteres de um buffer para outro.
Str_SetPtrW	Define ppszCurrent como uma cópia de pszNew e libera o valor anterior, se necessário.
TranslateDispatch	Usado pelo cliente do DoReaderMode função para intercetar e manipular explicitamente quaisquer mensagens do Windows direcionadas para a área de rolagem da janela do modo leitor. Esta é uma função de retorno de chamada definida pelo aplicativo.

Macros

Tópico	Índice
DPA_AppendPtr	Insere um novo item no final de um DPA.
DPA_FastDeleteLastPtr	Exclui o último ponteiro de um DPA.
DPA_FastGetPtr	Obtém o valor do ponteiro especificado no DPA.
DPA_GetPtrCount	Obtém o número de ponteiros em um DPA.
DPA_GetPtrPtr	Obtém o ponteiro para a matriz de ponteiro interna de um DPA.
DPA_SetPtrCount	Define o número de ponteiros em um DPA.
DPA_SortedInsertPtr	Insere um novo item antes ou depois de um item existente especificado.
DSA_AppendItem	Acrescenta um novo item ao final de um DSA.
DSA_GetItemCount	Obtém o número de itens em um DSA.
FORWARD_WM_NOTIFY	Envia ou publica a mensagem WM_NOTIFY.
HANDLE_WM_NOTIFY	Chama uma função que processa a mensagem WM_NOTIFY.
INDEXTOSTATEIMAGEMASK	Prepara o índice de uma imagem de estado para que um controle de exibição de árvore ou controle de exibição de lista possa usar o índice para recuperar a imagem de estado de um item.

Mensagens

Tópico	Índice
CCM_DPISCALE	Permite o dimensionamento automático de pontos altos por polegada (dpi) em controles de Tree-View, controles List-View, controles ComboBoxEx, controles de cabeçalho, de botões , controles da barra de ferramentas, controles de animaçãoe Listas de imagens.
CCM_GETUNICODEFORMAT	Obtém o sinalizador de formato de caractere Unicode para o controle.
CCM_GETVERSION	Obtém o número da versão de um controle definido pela mensagem CCM_SETVERSION mais recente.
CCM_SETUNICODEFORMAT	Define o sinalizador de formato de caractere Unicode para o controle. Essa mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle.
CCM_SETVERSION	Essa mensagem é usada para informar ao controle que você está esperando um comportamento associado a uma versão específica.
CCM_SETWINDOWTHEME	Define o estilo visual de um controle.
WM_NOTIFY	Enviado por um controle comum para sua janela pai quando um evento ocorreu ou o controle requer algumas informações.
WM_NOTIFYFORMAT	Determina se uma janela aceita estruturas ANSI ou Unicode na mensagem de notificação WM_NOTIFY. WM_NOTIFYFORMAT mensagens são enviadas de um controle comum para sua janela pai e da janela pai para o controle comum.

Notificações

Tópico	Índice
NM_CHAR	O código de notificação NM_CHAR é enviado por um controle quando uma chave de caractere é processada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_CUSTOMDRAW	Notifica a janela pai de um controle sobre operações de desenho personalizadas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_CUSTOMTEXT	Notifica a janela pai de um controle sobre operações de texto personalizadas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_FONTCHANGED	Enviado por um controle de exibição de lista quando o controle alterou uma fonte. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_GETCUSTOMSPLITRECT	Enviado por um controle de botão para seu pai para obter medidas para os dois retângulos que compõem o botão de divisão. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_HOVER	Enviado por um controle quando o mouse passa sobre um item. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_KEYDOWN	Enviado por um controle quando o controle tem o foco do teclado e o usuário pressiona uma tecla. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_KILLFOCUS	Notifica a janela pai de um controle de que o controle perdeu o foco de entrada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_LDOWN	Notifica a janela pai de um controle de que o botão esquerdo do mouse foi pressionado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_NCHITTEST	Enviado por um controle de vergalhão quando o controle recebe uma mensagem WM_NCHITTEST. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_OUTOFMEMORY	Notifica a janela pai de um controle que o controle não pôde concluir uma operação porque não havia memória suficiente disponível. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_RDOWN	Não suportado atualmente.
NM_RELEASEDCAPTURE	Notifica a janela pai de um controle de que o controle está liberando a captura do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_RETURN	Notifica a janela pai de um controle de que o controle tem o foco de entrada e que o usuário pressionou a tecla ENTER. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_SETCURSOR	Notifica a janela pai de um controle de que o controle está definindo o cursor em resposta a uma mensagem NM_SETCURSOR. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_SETFOCUS	Notifica a janela pai de um controle de que o controle recebeu o foco de entrada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_THEMECHANGED	Notifica a janela pai de um controle de que o tema foi alterado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_TOOLTIPSCREATED	Notifica a janela pai de um controle de que o controle criou um controle de dica de ferramenta. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.
NM_TVSTATEIMAGECHANGING	Enviado por um controle de exibição de árvore para sua janela pai que a imagem de estado está mudando. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY.

Estruturas

Tópico	Índice
COLORSCHEME	Contém informações para o desenho de botões em uma barra de ferramentas ou vergalhão.
DPASTREAMINFO	Contém um item de fluxo usado pela função de retorno de chamada PFNDPASTREAM.
INITCOMMONCONTROLSEX	Carrega informações usadas para carregar classes de controle comuns da biblioteca de vínculo dinâmico (DLL). Essa estrutura é usada com a funçãoInitCommonControlsEx.
NMCHAR	Contém informações usadas com mensagens de notificação de caracteres.
NMCUSTOMSPLITRECTINFO	Contém informações sobre os dois retângulos de um botão de divisão. Enviado com a notificação NM_GETCUSTOMSPLITRECT.
NMCUSTOMTEXT	Contém informações usadas com notificação de texto personalizada.
NMHDR	Contém informações sobre uma mensagem de notificação.
NMKEY	Contém informações usadas com mensagens de notificação de chave.
NMMOUSE	Contém informações usadas com mensagens de notificação do mouse.
NMOBJECTNOTIFY	Contém informações usadas com os códigos de notificação TBN_GETOBJECT, TCN_GETOBJECTe PSN_GETOBJECT.
NMTOOLTIPScriado	Contém informações usadas com NM_TOOLTIPSCREATED código de notificação.
READERMODEINFO	Contém informações necessárias para inicializar a funçãoDoReaderMode.

Constantes

Tópico	Índice
Constantes CDRF	Essas constantes são usadas como valores de retorno por um controle em resposta a um código de notificação NM_CUSTOMDRAW.
Estilos	Esta seção lista estilos de controle comuns. Exceto onde indicado, esses estilos se aplicam a controles de cabeçalho, controles de barra de ferramentas e janelas de status.
Classes de janela	Esta seção lista os nomes de classe de janela fornecidos pela biblioteca de controle comum.