Estilos de controle estático

Para criar um controle estático usando a função CreateWindow ou CreateWindowEx , especifique a classe STIC, constantes de estilo de janela apropriadas e uma combinação dos seguintes estilos de controle estático.

Constante	Descrição
SS_BITMAP	Um bitmap deve ser exibido no controle estático. O texto é o nome de um bitmap (não um nome de arquivo) definido em outro lugar no arquivo de recurso. O estilo ignora os parâmetros nWidth e nHeight ; O controle se dimensiona automaticamente para acomodar o bitmap.
SS_BLACKFRAME	Uma caixa com uma moldura desenhada na mesma cor das molduras das janelas. Esta cor é preta no esquema de cores padrão.
SS_BLACKRECT	Um retângulo preenchido com a cor atual da moldura da janela. Esta cor é preta no esquema de cores padrão.
SS_CENTER	Um retângulo simples e centraliza o texto no retângulo. O texto é formatado antes de ser exibido. As palavras que se estendem além do final de uma linha são automaticamente encapsuladas no início da próxima linha centralizada. Palavras que são maiores do que a largura do controle são truncadas.
SS_CENTERIMAGE	Um bitmap é centralizado no controle estático que o contém. O controle não é redimensionado, de modo que um bitmap muito grande para o controle será cortado. Se o controle estático contém uma única linha de texto, o texto é centralizado verticalmente na área do cliente do controle.
SS_EDITCONTROL	O controle estático duplica as características de exibição de texto de um controle de edição de várias linhas. Especificamente, a largura média de caracteres é calculada da mesma maneira que com um controle de edição, e a função não exibe uma última linha parcialmente visível.
SS_ENDELLIPSIS	Se a extremidade de uma string não couber no retângulo, ela é truncada e elipses são adicionadas. Se uma palavra que não está no final da cadeia ultrapassa os limites do retângulo, ela é truncada sem elipses. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra automática de texto. Compare com SS_PATHELLIPSIS e SS_WORDELLIPSIS.
SS_ENHMETAFILE	Um metarquivo aprimorado deve ser exibido no controle estático. O texto é o nome de um metaarquivo. Um controle estático de metarquivo aprimorado tem um tamanho fixo; O metarquivo é dimensionado para se ajustar à área do cliente do controle estático.
SS_ETCHEDFRAME	Desenha o quadro do controle estático usando o estilo de borda EDGE_ETCHED . Para obter mais informações, consulte a função DrawEdge .
SS_ETCHEDHORZ	Desenha as bordas superior e inferior do controle estático usando o estilo de borda EDGE_ETCHED . Para obter mais informações, consulte a função DrawEdge .
SS_ETCHEDVERT	Desenha as bordas esquerda e direita do controle estático usando o estilo de borda EDGE_ETCHED . Para obter mais informações, consulte a função DrawEdge .
SS_GRAYFRAME	Uma caixa com uma moldura desenhada com a mesma cor do fundo do ecrã (ambiente de trabalho). Essa cor é cinza no esquema de cores padrão.
SS_GRAYRECT	Um retângulo preenchido com a cor de fundo da tela atual. Essa cor é cinza no esquema de cores padrão.
SS_ICON	Um ícone a ser exibido na caixa de diálogo. Se o controle for criado como parte de uma caixa de diálogo, o texto será o nome de um ícone (não um nome de arquivo) definido em outro lugar no arquivo de recurso. Se o controle for criado via CreateWindow ou uma função relacionada, o texto será o nome de um ícone (não um nome de arquivo) definido no arquivo de recurso associado ao módulo especificado pelo parâmetro hInstance para CreateWindow. O ícone pode ser um cursor animado. O estilo ignora os parâmetros CreateWindownWidth e nHeight; O controle se dimensiona automaticamente para acomodar o ícone. Como ele usa a função LoadIcon , o estilo SS_ICON pode carregar apenas ícones de dimensões SM_CXICON e SM_CYICON. Essa restrição pode ser contornada usando o estilo SS_REALSIZEIMAGE além de SS_ICON. Se um ícone não puder ser carregado através de LoadIcon, será feita uma tentativa de carregar o recurso especificado como um cursor usando LoadCursor. Se isso também falhar, é feita uma tentativa de carregar a partir do driver de dispositivo usando LoadImage.
SS_LEFT	Um retângulo simples e alinha à esquerda o texto no retângulo. O texto é formatado antes de ser exibido. As palavras que se estendem além do final de uma linha são automaticamente quebradas no início da próxima linha alinhada à esquerda. Palavras que são maiores do que a largura do controle são truncadas.
SS_LEFTNOWORDWRAP	Um retângulo simples e alinha à esquerda o texto no retângulo. As guias são expandidas, mas as palavras não são quebradas. O texto que se estende além do final de uma linha é cortado.
SS_NOPREFIX	Impede a interpretação de quaisquer caracteres e comerciais (&) no texto do controle como caracteres de prefixo acelerador. Estes são exibidos com o E comercial removido e o próximo caractere na cadeia de caracteres sublinhado. Este estilo de controle estático pode ser incluído com qualquer um dos controles estáticos definidos. Você pode combinar SS_NOPREFIX com outros estilos. Isso pode ser útil quando nomes de arquivos ou outras cadeias de caracteres que podem conter um e comercial (&) devem ser exibidos em um controle estático em uma caixa de diálogo.
SS_NOTIFY	Envia a janela pai STN_CLICKED, STN_DBLCLK, STN_DISABLE e STN_ENABLE códigos de notificação quando o usuário clica ou clica duas vezes no controle.
SS_OWNERDRAW	O proprietário do controle estático é responsável por desenhar o controle. A janela do proprietário recebe uma mensagem WM_DRAWITEM sempre que o controle precisa ser desenhado.
SS_PATHELLIPSIS	Substitui caracteres no meio da cadeia de caracteres por elipses para que o resultado caiba no retângulo especificado. Se a cadeia de caracteres contiver caracteres de barra invertida (\), SS_PATHELLIPSIS preservará o máximo possível do texto após a última barra invertida. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra automática de texto. Compare com SS_ENDELLIPSIS e SS_WORDELLIPSIS.
SS_REALSIZECONTROL	Ajusta o bitmap para ajustar o tamanho do controle estático. Por exemplo, alterar a localidade pode alterar a fonte do sistema e, portanto, os controles podem ser redimensionados. Se um controle estático tivesse um bitmap, o bitmap não caberia mais no controle. Esse bit de estilo dita o redimensionamento automático de bitmaps para ajustar seus controles. Se SS_CENTERIMAGE for especificado, o bitmap ou ícone será centralizado (e cortado, se necessário). Se SS_CENTERIMAGE não for especificado, o bitmap ou ícone será esticado ou reduzido. Observe que o redimensionamento nos dois eixos é independente, e o resultado pode ter uma proporção alterada. Compare com SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE	Especifica que a largura real do recurso é usada e o ícone é carregado usando LoadImage. SS_REALSIZEIMAGE é sempre usado em conjunto com SS_ICON. SS_REALSIZEIMAGE usa LoadImage, substituindo o processo normalmente seguido em SS_ICON. Não carrega cursores; se LoadImage falhar, nenhuma outra tentativa de carregamento será feita. Ele usa a largura real do recurso. O controle estático é redimensionado de acordo, mas o ícone permanece alinhado às bordas esquerda e superior do controle originalmente especificadas. Observe que, se SS_CENTERIMAGE também for especificado, o ícone será centralizado dentro do espaço do controle, que foi especificado usando os parâmetros CreateWindownWidth e nHeight. Compare com SS_REALSIZECONTROL.
SS_RIGHT	Um retângulo simples e alinha à direita o texto no retângulo. O texto é formatado antes de ser exibido. As palavras que se estendem além do final de uma linha são automaticamente quebradas no início da próxima linha alinhada à direita. Palavras que são maiores do que a largura do controle são truncadas.
SS_RIGHTJUST	O canto inferior direito de um controle estático com o estilo SS_BITMAP ou SS_ICON deve permanecer fixo quando o controle for redimensionado. Apenas os lados superior e esquerdo são ajustados para acomodar um novo bitmap ou ícone.
SS_SIMPLE	Um retângulo simples e exibe uma única linha de texto alinhado à esquerda no retângulo. A linha de texto não pode ser encurtada ou alterada de forma alguma. Além disso, se o controle estiver desabilitado, o controle não acinzentará seu texto.
SS_SUNKEN	Desenha uma borda semi-submersa em torno de um controle estático.
SS_TYPEMASK	Um bit de estilo composto que resulta do uso do operador OR em bits de estilo SS_*. Pode ser usado para mascarar bits SS_* válidos de uma determinada máscara de bits. Observe que isso está desatualizado e não inclui corretamente todos os estilos válidos. Assim, você não deve usar esse estilo.
SS_WHITEFRAME	Uma caixa com uma moldura desenhada com a mesma cor do fundo da janela. Essa cor é branca no esquema de cores padrão.
SS_WHITERECT	Um retângulo preenchido com a cor de fundo da janela atual. Essa cor é branca no esquema de cores padrão.
SS_WORDELLIPSIS	Trunca qualquer palavra que não caiba no retângulo e adiciona elipses. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra automática de texto. Compare com SS_ENDELLIPSIS e SS_PATHELLIPSIS.

Observações

Para usar um estilo que trunca palavras ou cadeias de caracteres com reticências para texto de várias linhas, DrawThemeText ou DrawText pode ser usado em um controle de desenho do proprietário com sinalizadores de formatação DT_WORDBREAK e DT_ENDELLIPSIS definidos.

Requerimentos

Requisito	Valor
Cliente mínimo suportado	Windows Vista [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows Server 2003 [apenas aplicações de ambiente de trabalho]
Cabeçalho	Winuser.h (inclui Windows.h)