Compartilhar via

Referência de controle geral

  • Artigo

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. Há funções, macros, mensagens, notificações e estruturas compatíveis com a maioria dos controles. Por exemplo, a maioria dos controles usa as notificações de NM_HOVER para processar cliques do mouse.

  • Visão geral do
  • Funções
  • macros
  • mensagens
  • Notificações
  • estruturas
  • constantes

Súmulas

Tópico Conteúdo
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 no sistema operacional Windows.
perguntas frequentes sobre controles comuns Essas perguntas frequentes fornecem respostas para algumas perguntas comuns sobre os controles comuns.

Funções

Tópico Conteúdo
DoReaderMode Habilita o modo de leitor em uma janela.
DPA_Clone Duplica uma DPA (matriz de ponteiro dinâmico).
DPA_Create Cria um DPA.
DPA_CreateEx Cria um DPA usando um determinado tamanho especificado e um local de heap.
DPA_DeleteAllPtrs Remove todos os itens de um DPA e reduz o DPA adequadamente.
DPA_DeletePtr Remove um item de um DPA. O DPA é reduzido se necessário para acomodar o item removido.
DPA_Destroy Libera uma DPA (Matriz de Ponteiro Dinâmico).
DPA_DestroyCallback Chama pfnCB em cada elemento do DPA e libera o DPA.
DPA_EnumCallback Itera por meio da DPA (Matriz de Ponteiro Dinâmico) 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, a 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 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 DPA (Matriz de Ponteiro Dinâmico).
DrawShadowText Desenha o texto que tem uma sombra.
DrawTextExPrivWrap Desenha texto formatado no retângulo especificado. Essa 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 (guias de expansão, justificando caracteres, linhas de quebra e assim por diante). Essa função encapsula uma chamada para DrawText.
DSA_Clone Duplica uma DSA (matriz de estrutura dinâmica).
DSA_Create Cria um DSA.
DSA_DeleteAllItems Exclui todos os itens de uma DSA.
DSA_DeleteItem Exclui um item de uma DSA.
DSA_Destroy Libera um DSA.
DSA_DestroyCallback Itera por meio de uma DSA, chamando uma função de retorno de chamada especificada em cada item. Ao chegar ao final da matriz, a DSA é liberada.
DSA_EnumCallback Itera por meio da 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 da DSA.
DSA_InsertItem Insere um novo item em um DSA. Se necessário, a 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, a cor da tela de fundo e a cor do texto selecionadas no momento. Opcionalmente, você pode fornecer dimensões a serem usadas para recorte, opacidade ou ambos. Essa 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 de texto especificada. Essa função encapsula uma chamada para GetTextExtentPoint.
InitCommonControls Registra e inicializa determinadas classes de janela de controle comuns. Essa função é 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 diferentes 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 for um tamanho padrão, essa função reduzirá verticalmente uma imagem maior em vez de dimensionar uma imagem menor.
MirrorIcon Inverte os ícones (espelhos) para que eles sejam exibidos corretamente em um contexto de dispositivo espelhado.
PFNDACOMPARE Define o protótipo da função compare usada por DSA_Sort.
PFNDACOMPARECONST Define o protótipo da 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 da função de retorno de chamada usada pelas funções DSA e DPA.
PFNDAENUMCALLBACKCONST Define o protótipo da 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 da 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 da função de retorno de chamada usada por DPA_EnumCallback.
PFNDPAMERGE Define o protótipo da função de mesclagem usada por DPA_Merge.
PFNDPAMERGECONST Define o protótipo da função de mesclagem usada por DPA_Merge, usando valores constantes.
PFNDPASTREAM Define o protótipo da função de retorno de chamada usada por DPA_LoadStream e DPA_SaveStream.
PFNDSAENUMCALLBACK Define o protótipo da 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 leitor 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 adicionará uma marca de seleção ao item de menu especificado se ele não tiver um e, em seguida, exibirá 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 para uma cópia de pszNew e libera o valor anterior, se necessário.
TranslateDispatch Usado pelo cliente da função DoReaderMode para interceptar e manipular explicitamente as mensagens do Windows direcionadas para a área de rolagem da janela do modo leitor. Essa é uma função de retorno de chamada definida pelo aplicativo.

Macros

Tópico Conteúdo
DPA_AppendPtr Insere um novo item no final de uma 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 interno 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 uma DSA.
DSA_GetItemCount Obtém o número de itens em um DSA.
FORWARD_WM_NOTIFY Envia ou posta 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 Conteúdo
CCM_DPISCALE Habilita o dimensionamento automático de pontos altos por polegada (dpi) em controles Tree-View, controles de List-View, controles ComboBoxEx, controles de cabeçalho , botões de , controles da barra de ferramentas, controles de animação e listas de imagens.
CCM_GETUNICODEFORMAT Obtém o sinalizador de formato de caractere Unicode para o controle.
CCM_GETVERSION Obtém o número de versão de um controle definido pela mensagem de 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 precisar recriar o controle.
CCM_SETVERSION Esta 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 Conteúdo
NM_CHAR O código de notificação NM_CHAR é enviado por um controle quando uma chave de caractere é processada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_CUSTOMDRAW Notifica a janela pai de um controle sobre operações de desenho personalizadas. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_CUSTOMTEXT Notifica a janela pai de um controle sobre operações de texto personalizadas. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_FONTCHANGED Enviado por um controle de exibição de lista quando o controle tiver alterado uma fonte. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_HOVER Enviado por um controle quando o mouse passa o mouse sobre um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_KEYDOWN Enviado por um controle quando o controle tem o foco do teclado e o usuário pressiona uma tecla. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_KILLFOCUS Notifica a janela pai de um controle de que o controle perdeu o foco de entrada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_LDOWN Notifica a janela pai de um controle de que o botão esquerdo do mouse foi pressionado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_NCHITTEST Enviado por um controle de barra de barras quando o controle recebe uma mensagem WM_NCHITTEST. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_OUTOFMEMORY Notifica a janela pai de um controle de que o controle não pôde concluir uma operação porque não havia memória suficiente disponível. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_RDOWN Não há suporte no momento.
NM_RELEASEDCAPTURE Notifica a janela pai de um controle de que o controle está liberando a captura do mouse. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_SETCURSOR Notifica a janela pai de um controle de que o controle está definindo o cursor em resposta a uma mensagem de NM_SETCURSOR. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_SETFOCUS Notifica a janela pai de um controle de que o controle recebeu o foco de entrada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_THEMECHANGED Notifica a janela pai de um controle de que o tema foi alterado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_TOOLTIPSCREATED Notifica a janela pai de um controle de que o controle criou um controle de dica de ferramenta. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_TVSTATEIMAGECHANGING Enviado por um controle de exibição de árvore para sua janela pai que a imagem de estado está mudando. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico Conteúdo
COLORSCHEME Contém informações para o desenho de botões em uma barra de ferramentas ou barra de ferramentas.
DPASTREAMINFO Contém um item de fluxo usado pela função de retorno de chamadaPFNDPASTREAM.
INITCOMMONCONTROLSEX Carrega informações usadas para carregar classes de controle comuns da DLL (biblioteca de vínculo dinâmico). Essa estrutura é usada com a funçãoInitCommonControlsEx.
NMCHAR Contém informações usadas com mensagens de notificação de caractere.
NMCUSTOMSPLITRECTINFO Contém informações sobre os dois retângulos de um botão de divisão. Enviado com a notificação de NM_GETCUSTOMSPLITRECT.
NMCUSTOMTEXT Contém informações usadas com a 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.
NMTOOLTIPSCREATED Contém informações usadas com NM_TOOLTIPSCREATED código de notificação.
READERMODEINFO Contém informações necessárias para inicializar a função DoReaderMode.

Constantes

Tópico Conteúdo
de constantes CDRF Essas constantes são usadas como valores retornados por um controle em resposta a um código de notificação NM_CUSTOMDRAW.
estilos Esta seção lista estilos de controle comuns. Exceto quando observado, 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.