Compartir a través de

Referencia de control general

Esta sección contiene información de referencia sobre los elementos de programación que se aplican a varios controles, no solo a un control específico. Hay funciones, macros, mensajes, notificaciones y estructuras que la mayoría de los controles admiten. Por ejemplo, la mayoría de los controles usan las notificaciones de NM_HOVER para procesar los clics del mouse.

Temas de introducción

Tema Contenido
Acerca de los controles comunes Los controles comunes son un conjunto de ventanas implementadas por la biblioteca de control común, que es un archivo DLL incluido con el sistema operativo Windows.
Preguntas más frecuentes sobre controles comunes En estas preguntas más frecuentes se proporcionan respuestas a algunas preguntas comunes sobre los controles comunes.

Functions

Tema Contenido
DoReaderMode Habilita el modo lector en una ventana.
DPA_Clone Duplica una matriz de punteros dinámicos (DPA).
DPA_Create Crea un DPA.
DPA_CreateEx Crea un DPA con un tamaño y una ubicación de montón especificados especificados.
DPA_DeleteAllPtrs Quita todos los elementos de un DPA y reduce el DPA en consecuencia.
DPA_DeletePtr Quita un elemento de un DPA. El DPA se reduce si es necesario para acomodar el elemento quitado.
DPA_Destroy Libera una matriz de puntero dinámico (DPA).
DPA_DestroyCallback Llama a pfnCB en cada elemento del DPA y, a continuación, libera el DPA.
DPA_EnumCallback Recorre en iteración la matriz de puntero dinámico (DPA) y llama a pfnCB en cada elemento.
DPA_GetPtr Obtiene un elemento de un DPA.
DPA_GetPtrIndex Obtiene el índice de un elemento coincidente que se encuentra en un DPA.
DPA_GetSize Obtiene el tamaño de un DPA.
DPA_Grow Cambia el número de punteros de un DPA.
DPA_InsertPtr Inserta un nuevo elemento en una posición especificada en un DPA. Si es necesario, el DPA se expande para dar cabida al nuevo elemento.
DPA_LoadStream Carga el DPA desde una secuencia llamando a la función de devolución de llamada especificada para leer cada elemento.
DPA_Merge Combina el contenido de dos DPA.
DPA_SaveStream Guarda el DPA en una secuencia escribiendo un encabezado y llamando a la función de devolución de llamada especificada para escribir cada elemento.
DPA_Search Busca un elemento en un DPA.
DPA_SetPtr Asigna un valor a un elemento de un DPA.
DPA_Sort Ordena los elementos de una matriz de puntero dinámico (DPA).
DrawShadowText Dibuja texto que tiene una sombra.
DrawTextExPrivWrap Dibuja texto con formato en el rectángulo especificado. Esta función ajusta una llamada a DrawTextEx.
DrawTextWrap Dibuja texto con formato en el rectángulo especificado. Da formato al texto según el método especificado (expandiendo fichas, justificando caracteres, líneas de separación, etc.). Esta función ajusta una llamada a DrawText.
DSA_Clone Duplica una matriz de estructura dinámica (DSA).
DSA_Create Crea una DSA.
DSA_DeleteAllItems Elimina todos los elementos de un DSA.
DSA_DeleteItem Elimina un elemento de un DSA.
DSA_Destroy Libera un DSA.
DSA_DestroyCallback Recorre en iteración una DSA, llamando a una función de devolución de llamada especificada en cada elemento. Al llegar al final de la matriz, se libera la DSA.
DSA_EnumCallback Recorre en iteración la DSA y llama a pfnCB en cada elemento.
DSA_GetItem Obtiene un elemento de un DSA.
DSA_GetItemPtr Obtiene un puntero a un elemento de un DSA.
DSA_GetSize Obtiene el tamaño de la DSA.
DSA_InsertItem Inserta un nuevo elemento en un DSA. Si es necesario, la DSA se expande para dar cabida al nuevo elemento.
DSA_SetItem Establece el contenido de un elemento de un DSA.
DSA_Sort Ordena los elementos de un DSA.
ExtTextOutWrap Dibuja texto con la fuente seleccionada actualmente, el color de fondo y el color del texto. Opcionalmente, puede proporcionar dimensiones que se usarán para recortar, opacidad o ambas. Esta función ajusta una llamada a ExtTextOut.
GetEffectiveClientRect Calcula las dimensiones de un rectángulo en el área cliente que contiene todos los controles especificados.
GetMUILanguage Obtiene el idioma actualmente en uso de los controles comunes para un proceso determinado.
GetTextExtentPoint32Wrap Calcula el ancho y el alto de la cadena de texto especificada. Esta función ajusta una llamada a GetTextExtentPoint.
InitCommonControls Registra e inicializa determinadas clases comunes de ventana de control. Esta función está obsoleta. Las nuevas aplicaciones deben usar la función InitCommonControlsEx .
InitCommonControlsEx Registra clases de control comunes específicas desde el archivo DLL de control común.
InitMUILanguage Permite a una aplicación especificar un idioma que se usará con los controles comunes que son diferentes del idioma del sistema.
LoadIconMetric Carga un recurso de icono especificado con una métrica del sistema especificada por el cliente.
LoadIconWithScaleDown Carga un icono. Si el icono no es un tamaño estándar, esta función reduce verticalmente una imagen más grande en lugar de escalar verticalmente una imagen más pequeña.
MirrorIcon Invierte (reflejos) iconos para que se muestren correctamente en un contexto de dispositivo reflejado.
PFNDACOMPARE Define el prototipo de la función de comparación usada por DSA_Sort.
PFNDACOMPARECONST Define el prototipo de la función de comparación utilizada por DSA_Sort cuando los elementos que se comparan son objetos constantes.
PFNDAENUMCALLBACK Define el prototipo de la función de devolución de llamada usada por las funciones DSA y DPA.
PFNDAENUMCALLBACKCONST Define el prototipo de la función de devolución de llamada usada por las funciones DSA y DPA cuando los elementos implicados son punteros a datos constantes.
PFNDPACOMPARE Define el prototipo de la función de comparación usada por DPA_Sort y DPA_Search.
PFNDPACOMPARECONST Define el prototipo de la función de comparación utilizada por DPA_Sort o DPA_Search cuando los elementos que se comparan son objetos constantes.
PFNDPAENUMCALLBACK Define el prototipo de la función de devolución de llamada usada por DPA_EnumCallback.
PFNDPAMERGE Define el prototipo de la función de combinación utilizada por DPA_Merge.
PFNDPAMERGECONST Define el prototipo de la función de combinación utilizada por DPA_Merge, mediante valores constantes.
PFNDPASTREAM Define el prototipo de la función de devolución de llamada usada por DPA_LoadStream y DPA_SaveStream.
PFNDSAENUMCALLBACK Define el prototipo de la función de devolución de llamada usada por DSA_DestroyCallback.
ReaderScroll Función de devolución de llamada definida por la aplicación que se usa cuando el puntero del mouse se mueve dentro de la parte de la ventana del modo lector que se ha declarado como el área de desplazamiento activa.
ShowHideMenuCtl Establece o quita el atributo de marca de verificación del elemento de menú especificado y muestra u oculta el control correspondiente. La función agrega una marca de verificación al elemento de menú especificado si no tiene una y, a continuación, muestra el control correspondiente. Si el elemento de menú ya tiene una marca de verificación, la función quita la marca de verificación y oculta el control correspondiente.
Str_GetPtr Copia una cadena de un búfer a otro.
Str_SetPtrW Establece ppszCurrent en una copia de pszNew y libera el valor anterior, si es necesario.
TranslateDispatch Usado por el cliente de la función DoReaderMode para interceptar y controlar explícitamente los mensajes de Windows destinados al área de desplazamiento de la ventana del modo lector. Se trata de una función de devolución de llamada definida por la aplicación.

Macros

Tema Contenido
DPA_AppendPtr Inserta un nuevo elemento al final de un DPA.
DPA_FastDeleteLastPtr Elimina el último puntero de un DPA.
DPA_FastGetPtr Obtiene el valor del puntero especificado en el DPA.
DPA_GetPtrCount Obtiene el número de punteros de un DPA.
DPA_GetPtrPtr Obtiene el puntero a la matriz de punteros interna de un DPA.
DPA_SetPtrCount Establece el número de punteros de un DPA.
DPA_SortedInsertPtr Inserta un nuevo elemento antes o después de un elemento existente especificado.
DSA_AppendItem Anexa un nuevo elemento al final de un DSA.
DSA_GetItemCount Obtiene el número de elementos de un DSA.
FORWARD_WM_NOTIFY Envía o envía el mensaje de WM_NOTIFY .
HANDLE_WM_NOTIFY Llama a una función que procesa el mensaje WM_NOTIFY .
INDEXTOSTATEIMAGEMASK Prepara el índice de una imagen de estado para que un control de vista de árbol o un control de vista de lista pueda usar el índice para recuperar la imagen de estado de un elemento.

Messages

Tema Contenido
CCM_DPISCALE Habilita el escalado automático de puntos altos por pulgada (ppp) en controles deTree-View, controles deList-View, controles ComboBoxEx, Controles encabezados, Botones, Controles de barra de herramientas, Controles de animación y Listas de imágenes.
CCM_GETUNICODEFORMAT Obtiene la marca de formato de caracteres Unicode para el control .
CCM_GETVERSION Obtiene el número de versión de un control establecido por el mensaje de CCM_SETVERSION más reciente.
CCM_SETUNICODEFORMAT Establece la marca de formato de caracteres Unicode para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control.
CCM_SETVERSION Este mensaje se usa para informar al control de que espera un comportamiento asociado a una versión determinada.
CCM_SETWINDOWTHEME Establece el estilo visual de un control.
WM_NOTIFY Enviado por un control común a su ventana primaria cuando se ha producido un evento o el control requiere cierta información.
WM_NOTIFYFORMAT Determina si una ventana acepta estructuras ANSI o Unicode en el mensaje de notificación WM_NOTIFY . WM_NOTIFYFORMAT mensajes se envían desde un control común a su ventana principal y desde la ventana primaria al control común.

Notifications

Tema Contenido
NM_CHAR Un control envía el código de notificación NM_CHAR cuando se procesa una clave de caracteres. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_CUSTOMDRAW Notifica a la ventana primaria de un control sobre las operaciones de dibujo personalizadas. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_CUSTOMTEXT Notifica a la ventana primaria de un control sobre las operaciones de texto personalizadas. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_FONTCHANGED Enviado por un control de vista de lista cuando el control ha cambiado una fuente. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_GETCUSTOMSPLITRECT Enviado por un control de botón a su elemento primario para obtener medidas para los dos rectángulos que componen el botón de división. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_HOVER Enviado por un control cuando el mouse mantiene el puntero sobre un elemento. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_KEYDOWN Enviado por un control cuando el control tiene el foco del teclado y el usuario presiona una tecla. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_KILLFOCUS Notifica a la ventana primaria de un control que el control ha perdido el foco de entrada. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_LDOWN Notifica a la ventana primaria de un control que se ha presionado el botón izquierdo del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_NCHITTEST Enviado por un control de barra de rebar cuando el control recibe un mensaje de WM_NCHITTEST . Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_OUTOFMEMORY Notifica a la ventana primaria de un control que el control no pudo completar una operación porque no había suficiente memoria disponible. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_RDOWN No se admite actualmente.
NM_RELEASEDCAPTURE Notifica a la ventana primaria de un control que el control está liberando la captura del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_RETURN Notifica a la ventana primaria de un control que el control tiene el foco de entrada y que el usuario ha presionado la tecla ENTRAR. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_SETCURSOR Notifica a la ventana primaria de un control que el control establece el cursor en respuesta a un mensaje de NM_SETCURSOR . Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_SETFOCUS Notifica a la ventana primaria de un control que el control ha recibido el foco de entrada. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_THEMECHANGED Notifica a la ventana primaria de un control que el tema ha cambiado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_TOOLTIPSCREATED Notifica a la ventana primaria de un control que el control ha creado un control de información sobre herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY .
NM_TVSTATEIMAGECHANGING Enviado por un control de vista de árbol a su ventana primaria que cambia la imagen de estado. Este código de notificación se envía en forma de mensaje WM_NOTIFY .

Estructuras

Tema Contenido
COLORSCHEME Contiene información para el dibujo de botones en una barra de herramientas o una barra de rebar.
DPASTREAMINFO Contiene un elemento de secuencia utilizado por la función de devolución de llamada PFNDPASTREAM .
INITCOMMONCONTROLSEX Incluye información que se usa para cargar clases de control comunes desde la biblioteca de vínculos dinámicos (DLL). Esta estructura se usa con la función InitCommonControlsEx .
NMCHAR Contiene información usada con mensajes de notificación de caracteres.
NMCUSTOMSPLITRECTINFO Contiene información sobre los dos rectángulos de un botón de división. Se envía con la notificación NM_GETCUSTOMSPLITRECT .
NMCUSTOMTEXT Contiene información que se usa con la notificación de texto personalizada.
NMHDR Contiene información sobre un mensaje de notificación.
NMKEY Contiene información usada con mensajes de notificación de clave.
NMMOUSE Contiene información usada con mensajes de notificación del mouse.
NMOBJECTNOTIFY Contiene información usada con los códigos de notificación de TBN_GETOBJECT, TCN_GETOBJECT y PSN_GETOBJECT .
NMTOOLTIPSCREATED Contiene información usada con NM_TOOLTIPSCREATED código de notificación.
READERMODEINFO Contiene información necesaria para inicializar la función DoReaderMode .

Constants

Tema Contenido
Constantes de CDRF Estas constantes se usan como valores devueltos por un control en respuesta a un código de notificación de NM_CUSTOMDRAW .
Estilos En esta sección se enumeran los estilos de control comunes. Excepto donde se indique, estos estilos se aplican a los controles de encabezado, los controles de barra de herramientas y las ventanas de estado.
Clases de ventana En esta sección se enumeran los nombres de clase de ventana proporcionados por la biblioteca de controles común.
  • Last updated on