Estilos de controle estático

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

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 um quadro desenhado na mesma cor que os quadros de janela. Essa cor é preta no esquema de cores padrão.
SS_BLACKRECT	Um retângulo preenchido com a cor do quadro da janela atual. Essa 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 até o final de uma linha são encapsuladas automaticamente para o início da próxima linha centralizada. Palavras mais longas 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 seja recortado. Se o controle estático contiver uma única linha de texto, o texto será centralizado verticalmente na área de cliente do controle.
SS_EDITCONTROL	O controle estático duplica as características de exibição de texto de um controle de edição multilinha. Especificamente, a largura média do caractere é 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 o final de uma cadeia de caracteres não se ajustar ao retângulo, ele será truncado e as reticências serão adicionadas. Se uma palavra que não estiver no final da cadeia de caracteres ultrapassar os limites do retângulo, ela será truncada sem reticências. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra de palavra. Compare com SS_PATHELLIPSIS e SS_WORDELLIPSIS.
SS_ENHMETAFILE	Um meta-arquivo aprimorado deve ser exibido no controle estático. O texto é o nome de um metarquivo. Um controle estático de metarquivo avançado tem um tamanho fixo e o metarquivo é dimensionado para se ajustar à área de 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 um quadro desenhado com a mesma cor que a tela de fundo (área de trabalho). Essa cor é cinza no esquema de cores padrão.
SS_GRAYRECT	Um retângulo preenchido com a cor da tela de fundo 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 por meio de 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 ignorada usando o estilo SS_REALSIZEIMAGE além de SS_ICON. Se um ícone não puder ser carregado por meio do LoadIcon, será feita uma tentativa de carregar o recurso especificado como um cursor usando LoadCursor. Se isso também falhar, será feita uma tentativa de carregar do driver de dispositivo usando LoadImage.
SS_LEFT	Um retângulo simples e a esquerda alinham o texto no retângulo. O texto é formatado antes de ser exibido. As palavras que se estendem até o final de uma linha são automaticamente encapsuladas para o início da próxima linha alinhada à esquerda. Palavras mais longas do que a largura do controle são truncadas.
SS_LEFTNOWORDWRAP	Um retângulo simples e a esquerda alinham o texto no retângulo. As guias são expandidas, mas as palavras não são encapsuladas. O texto que se estende até o final de uma linha é recortado.
SS_NOPREFIX	Impede a interpretação de qualquer caractere de e comercial (&) no texto do controle como caracteres de prefixo de acelerador. Eles são exibidos com o e comercial removido e o próximo caractere na cadeia de caracteres sublinhado. Esse estilo de controle estático pode ser incluído em qualquer um dos controles estáticos definidos. Você pode combinar SS_NOPREFIX com outros estilos. Isso pode ser útil quando nomes de arquivo 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 códigos de notificação STN_ENABLE 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 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 reticências para que o resultado se encaixe 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 de palavra. Compare com SS_ENDELLIPSIS e SS_WORDELLIPSIS.
SS_REALSIZECONTROL	Ajusta o bitmap para se ajustar ao 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 determina a redimensionação automática de bitmaps para ajustar seus controles. Se SS_CENTERIMAGE for especificado, o bitmap ou ícone será centralizado (e recortado, se necessário). Se SS_CENTERIMAGE não for especificado, o bitmap ou ícone será estendido ou reduzido. Observe que a redimensionação nos dois eixos é independente e o resultado pode ter uma taxa de 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. Ele 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 adequadamente, mas o ícone permanece alinhado às bordas esquerda e superior especificadas originalmente do controle. 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. Comparar com SS_REALSIZECONTROL.
SS_RIGHT	Um retângulo simples e o alinhamento direito do texto no retângulo. O texto é formatado antes de ser exibido. As palavras que se estendem até o final de uma linha são encapsuladas automaticamente para o início da próxima linha alinhada à direita. Palavras mais longas 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. Somente 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 esmaeça seu texto.
SS_SUNKEN	Desenha uma borda submersa ao redor 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 válidos SS_* de uma determinada máscara de bits. Observe que isso está desatualizado e não inclui corretamente todos os estilos válidos. Portanto, você não deve usar esse estilo.
SS_WHITEFRAME	Uma caixa com um quadro desenhado com a mesma cor que a tela de fundo da janela. Essa cor é branca no esquema de cores padrão.
SS_WHITERECT	Um retângulo preenchido com a cor da tela de fundo da janela atual. Essa cor é branca no esquema de cores padrão.
SS_WORDELLIPSIS	Trunca qualquer palavra que não se encaixe no retângulo e adicione reticências. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra de palavra. Compare com SS_ENDELLIPSIS e SS_PATHELLIPSIS.

Comentários

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Winuser.h (inclua Windows.h)