Partilhar via

Referência de Controlo 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. 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

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.