Compartir a través de


Estilos de control estáticos

Para crear un control estático mediante la función CreateWindow o CreateWindowEx , especifique la clase STATIC, las constantes de estilo de ventana adecuadas y una combinación de los siguientes estilos de control estáticos.

Constante Descripción
SS_BITMAP
Un mapa de bits se mostrará en el control estático. El texto es el nombre de un mapa de bits (no un nombre de archivo) definido en otro lugar del archivo de recursos. El estilo omite los parámetros nWidth y nHeight ; el control se ajusta automáticamente para acomodar el mapa de bits.
SS_BLACKFRAME
Cuadro con un marco dibujado en el mismo color que los marcos de ventana. Este color es negro en la combinación de colores predeterminada.
SS_BLACKRECT
Rectángulo rellenado con el color actual del marco de ventana. Este color es negro en la combinación de colores predeterminada.
SS_CENTER
Un rectángulo simple y centra el texto en el rectángulo. Se asigna formato al texto antes de que se muestre. Las palabras que se extienden más allá del final de una línea se encapsulan automáticamente al principio de la siguiente línea centrada. Las palabras que son más largas que el ancho del control se truncan.
SS_CENTERIMAGE
Un mapa de bits se centra en el control estático que lo contiene. El control no se cambia de tamaño, por lo que se recortará un mapa de bits demasiado grande para el control. Si el control estático contiene una sola línea de texto, el texto se centra verticalmente en el área cliente del control.
SS_EDITCONTROL
El control estático duplica las características que muestran texto de un control de edición de varias líneas. En concreto, el ancho medio de caracteres se calcula de la misma manera que con un control de edición y la función no muestra una última línea parcialmente visible.
SS_ENDELLIPSIS
Si el final de una cadena no cabe en el rectángulo, se truncan y se agregan puntos suspensivos. Si una palabra que no está al final de la cadena va más allá de los límites del rectángulo, se trunca sin puntos suspensivos. El uso de este estilo obligará a que el texto del control esté en una línea sin ajuste de palabras. Compare con SS_PATHELLIPSIS y SS_WORDELLIPSIS.
SS_ENHMETAFILE
Se va a mostrar un metarchivo mejorado en el control estático. El texto es el nombre de un metarchivo. Un control estático de metarchivo mejorado tiene un tamaño fijo; el metarchivo se escala para ajustarse al área cliente del control estático.
SS_ETCHEDFRAME
Dibuja el marco del control estático mediante el estilo de borde EDGE_ETCHED . Para obtener más información, consulte la función DrawEdge .
SS_ETCHEDHORZ
Dibuja los bordes superior e inferior del control estático mediante el estilo de borde EDGE_ETCHED . Para obtener más información, consulte la función DrawEdge .
SS_ETCHEDVERT
Dibuja los bordes izquierdo y derecho del control estático mediante el estilo de borde EDGE_ETCHED . Para obtener más información, consulte la función DrawEdge .
SS_GRAYFRAME
Cuadro con un marco dibujado con el mismo color que el fondo de la pantalla (escritorio). Este color es gris en la combinación de colores predeterminada.
SS_GRAYRECT
Rectángulo rellenado con el color de fondo de pantalla actual. Este color es gris en la combinación de colores predeterminada.
SS_ICON
Icono que se va a mostrar en el cuadro de diálogo. Si el control se crea como parte de un cuadro de diálogo, el texto es el nombre de un icono (no un nombre de archivo) definido en otro lugar del archivo de recursos. Si el control se crea a través de CreateWindow o una función relacionada, el texto es el nombre de un icono (no un nombre de archivo) definido en el archivo de recursos asociado al módulo especificado por el parámetro hInstance en CreateWindow.
El icono puede ser un cursor animado.
El estilo omite los parámetros CreateWindownWidth y nHeight; el control se ajusta automáticamente para acomodar el icono. A medida que usa la función LoadIcon , el estilo SS_ICON solo puede cargar iconos de dimensiones SM_CXICON y SM_CYICON. Esta restricción se puede omitir mediante el estilo SS_REALSIZEIMAGE además de SS_ICON.
Si no se puede cargar un icono a través de LoadIcon, se intenta cargar el recurso especificado como cursor mediante LoadCursor. Si también se produce un error, se intenta cargar desde el controlador de dispositivo mediante LoadImage.
SS_LEFT
Un rectángulo simple y a la izquierda alinea el texto en el rectángulo. Se asigna formato al texto antes de que se muestre. Las palabras que se extienden más allá del final de una línea se ajustan automáticamente al principio de la siguiente línea alineada a la izquierda. Las palabras que son más largas que el ancho del control se truncan.
SS_LEFTNOWORDWRAP
Un rectángulo simple y a la izquierda alinea el texto en el rectángulo. Las tabulaciones se expanden, pero las palabras no se ajustan. El texto que se extiende más allá del final de una línea se recorta.
SS_NOPREFIX
Evita la interpretación de los caracteres de y comercial (&) en el texto del control como caracteres de prefijo de acelerador. Se muestran con el signo y el siguiente carácter de la cadena subrayada. Este estilo de control estático se puede incluir con cualquiera de los controles estáticos definidos. Puede combinar SS_NOPREFIX con otros estilos. Esto puede ser útil cuando los nombres de archivo u otras cadenas que pueden contener una y comercial (&) deben mostrarse en un control estático en un cuadro de diálogo.
SS_NOTIFY
Envía el STN_CLICKED de ventana primaria, STN_DBLCLK, STN_DISABLE y códigos de notificación STN_ENABLE cuando el usuario hace clic o hace doble clic en el control.
SS_OWNERDRAW
El propietario del control estático es responsable de dibujar el control. La ventana del propietario recibe un mensaje de WM_DRAWITEM cada vez que es necesario dibujar el control.
SS_PATHELLIPSIS
Reemplaza los caracteres en medio de la cadena por puntos suspensivos para que el resultado se ajuste al rectángulo especificado. Si la cadena contiene caracteres de barra diagonal inversa (\), SS_PATHELLIPSIS conserva tanto como sea posible el texto después de la última barra diagonal inversa. El uso de este estilo obligará a que el texto del control esté en una línea sin ajuste de palabras. Compare con SS_ENDELLIPSIS y SS_WORDELLIPSIS.
SS_REALSIZECONTROL
Ajusta el mapa de bits para ajustarse al tamaño del control estático. Por ejemplo, cambiar la configuración regional puede cambiar la fuente del sistema y, por tanto, los controles se pueden cambiar de tamaño. Si un control estático tuviera un mapa de bits, el mapa de bits ya no cabería en el control. Este bit de estilo dicta la redimensionación automática de mapas de bits para ajustarse a sus controles.
Si se especifica SS_CENTERIMAGE , el mapa de bits o el icono se centra (y se recorta si es necesario). Si no se especifica SS_CENTERIMAGE , el mapa de bits o el icono se estiran o se reducen.
Tenga en cuenta que la redimensionación de los dos ejes es independiente y el resultado puede tener una relación de aspecto modificada.
Compare con SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Especifica que se usa el ancho real del recurso y el icono se carga mediante LoadImage. SS_REALSIZEIMAGE siempre se usa junto con SS_ICON.
SS_REALSIZEIMAGE usa LoadImage, invalidando el proceso seguido normalmente en SS_ICON. No carga cursores; Si se produce un error en LoadImage , no se realizan más intentos de carga. Usa el ancho real del recurso. El control estático se cambia de tamaño en consecuencia, pero el icono permanece alineado con los bordes izquierdo y superior especificados originalmente del control.
Tenga en cuenta que si también se especifica SS_CENTERIMAGE , el icono se centra dentro del espacio del control, que se especificó mediante los parámetros CreateWindownWidth y nHeight.
Comparar con SS_REALSIZECONTROL.
SS_RIGHT
Un rectángulo simple y alinea a la derecha el texto en el rectángulo. Se asigna formato al texto antes de que se muestre. Las palabras que se extienden más allá del final de una línea se ajustan automáticamente al principio de la siguiente línea alineada a la derecha. Las palabras que son más largas que el ancho del control se truncan.
SS_RIGHTJUST
La esquina inferior derecha de un control estático con el estilo SS_BITMAP o SS_ICON es permanecer fijo cuando se cambia el tamaño del control. Solo se ajustan los lados superior e izquierdo para dar cabida a un nuevo mapa de bits o icono.
SS_SIMPLE
Un rectángulo simple y muestra una sola línea de texto alineado a la izquierda en el rectángulo. La línea de texto no se puede acortar ni modificar de ninguna manera. Además, si el control está deshabilitado, el control no atenua su texto.
SS_SUNKEN
Dibuja un borde medio hundido alrededor de un control estático.
SS_TYPEMASK
Bit de estilo compuesto que resulta del uso del operador OR en bits de estilo SS_*. Se puede usar para enmascarar bits de SS_* válidos de una máscara de bits determinada. Tenga en cuenta que esto está obsoleto y no incluye correctamente todos los estilos válidos. Por lo tanto, no debe usar este estilo.
SS_WHITEFRAME
Cuadro con un marco dibujado con el mismo color que el fondo de la ventana. Este color es blanco en la combinación de colores predeterminada.
SS_WHITERECT
Rectángulo relleno con el color de fondo de la ventana actual. Este color es blanco en la combinación de colores predeterminada.
SS_WORDELLIPSIS
Trunca cualquier palabra que no cabe en el rectángulo y agrega puntos suspensivos. El uso de este estilo forzará que el texto del control esté en una línea sin ajuste de palabras.
Comparar con SS_ENDELLIPSIS y SS_PATHELLIPSIS.

Observaciones

Para usar un estilo que trunca palabras o cadenas con puntos suspensivos para texto de varias líneas, DrawThemeText o DrawText se puede usar en un control de dibujo de propietario con marcas de formato DT_WORDBREAK y DT_ENDELLIPSIS establecer.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)