Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |
|---|---|
|
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 é dimensionado automaticamente para acomodar o bitmap. |
|
Uma caixa com um quadro desenhado na mesma cor que os quadros de janela. Essa cor é preta no esquema de cores padrão. |
|
Um retângulo preenchido com a cor do quadro da janela atual. Essa cor é preta no esquema de cores padrão. |
|
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 automaticamente encapsuladas para o início da próxima linha centralizada. Palavras mais longas que a largura do controle são truncadas. |
|
Um bitmap é centralizado no controle estático que o contém. O controle não é redimensionado, de modo que um bitmap grande demais para o controle seja recortado. Se o controle estático contiver uma única linha de texto, o texto será centralizado verticalmente na área do cliente do controle. |
|
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 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. |
|
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 automática de palavras. Compare com SS_PATHELLIPSIS e SS_WORDELLIPSIS. |
|
Um metafile aprimorado deve ser exibido no controle estático. O texto é o nome de um metafile. Um controle estático de metafilo aprimorado tem um tamanho fixo; o metafile é dimensionado para se ajustar à área do cliente do controle estático. |
|
Desenha o quadro do controle estático usando o estilo de borda EDGE_ETCHED . Para obter mais informações, consulte a função DrawEdge . |
|
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 . |
|
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 . |
|
Uma caixa com um quadro desenhado com a mesma cor que o plano de fundo da tela (área de trabalho). Essa cor é cinza no esquema de cores padrão. |
|
Um retângulo preenchido com a cor atual da tela de fundo. Essa cor é cinza no esquema de cores padrão. |
|
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 é dimensionado 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. |
|
Um retângulo simples e alinhado à esquerda alinha 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 que a largura do controle são truncadas. |
|
Um retângulo simples e alinhado à esquerda alinha 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. |
|
Impede a interpretação de qualquer caractere esporádico (&) no texto do controle como caracteres de prefixo de acelerador. Elas são exibidas 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 com 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. |
|
Envia os códigos de notificação da janela pai STN_CLICKED, STN_DBLCLK, STN_DISABLE e STN_ENABLE quando o usuário clica ou clica duas vezes no controle. |
|
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. |
|
Substitui caracteres no meio da cadeia de caracteres por reticências para que o resultado se ajuste 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 palavras. Compare com SS_ENDELLIPSIS e SS_WORDELLIPSIS. |
|
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 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. Comparar com 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 tentativa adicional 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 originalmente especificadas 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. |
|
Um retângulo simples e o lado direito 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 à direita. Palavras mais longas que a largura do controle são truncadas. |
|
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. |
|
Um retângulo simples e exibe uma única linha de texto alinhado à esquerda no retângulo. A linha de texto não pode ser abreviada ou alterada de forma alguma. Além disso, se o controle estiver desabilitado, o controle não colocará o texto em cinza. |
|
Desenha uma borda semi-afundada em torno de um controle estático. |
|
Um bit de estilo composto resultante 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. Portanto, você não deve usar esse estilo. |
|
Uma caixa com um quadro desenhado com a mesma cor que o plano de fundo da janela. Essa cor é branca no esquema de cores padrão. |
|
Um retângulo preenchido com a cor atual da tela de fundo da janela. Essa cor é branca no esquema de cores padrão. |
|
Trunca qualquer palavra que não se ajuste ao retângulo e adiciona reticências. Usar esse estilo forçará o texto do controle a estar em uma linha sem quebra automática de palavras. 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 multilinha, DrawThemeText ou DrawText pode ser usado em um controle de desenho de proprietário com sinalizadores de formatação DT_WORDBREAK e DT_ENDELLIPSIS conjunto.
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 |
|