Formatar valores
Esta seção lista os valores usados com o parâmetro dwTextFlags das funções DrawThemeText e GetThemeTextExtent. Um ou mais desses valores são usados para especificar como uma cadeia de caracteres de texto deve ser formatada. A função DrawThemeText desenhará a cadeia de texto dentro de um retângulo de exibição, especificado pelo parâmetro pRect . A função GetThemeTextExtent pode ser usada para determinar o retângulo delimitador necessário para texto de um determinado comprimento e formato.
Formatar valores
A tabela a seguir lista os valores de formato.
| Valor | Descrição |
|---|---|
| DT_BOTTOM | Renderiza a cadeia de texto na parte inferior do retângulo de exibição. Esse valor é usado somente com o valor DT_SINGLELINE. |
| DT_CALCRECT | Determina a largura e a altura do retângulo de exibição. |
| DT_CENTER | Centraliza o texto horizontalmente no retângulo de exibição. |
| DT_EDITCONTROL | 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 para um controle de edição, e a função não exibe uma última linha parcialmente visível. |
| DT_END_ELLIPSIS | Trunca uma cadeia de caracteres de texto mais larga que o retângulo de exibição e adiciona reticências para indicar o truncamento. A cadeia de caracteres não é modificada, a menos que o sinalizador DT_MODIFYSTRING seja especificado. |
| DT_EXPANDTABS | Amplia os caracteres da guia. O número padrão de caracteres por guia é oito. Os valores DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS e DT_END_ELLIPSIS não podem ser usados com o valor DT_EXPANDTABS. |
| DT_EXTERNALLEADING | Inclui a entrelinha externa de uma fonte na altura da linha. Normalmente, a entrelinha externa não é incluída na altura de uma linha de texto. |
| DT_HIDEPREFIX | Ignora o caractere de prefixo & no texto. A letra a seguir não é sublinhada, mas outros caracteres de prefixo ainda são processados. Por exemplo: string de entrada: "A&bc&&d" normal: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
| DT_LEFT | Alinha o texto à esquerda. |
| DT_MODIFYSTRING | Modifica uma cadeia de caracteres para corresponder ao texto exibido. Esse valor não tem efeito a menos que DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS seja especificado. |
| DT_NOCLIP | Desenha a cadeia de texto sem recortar o retângulo de exibição. |
| DT_NOFULLWIDTHCHARBREAK | Impede uma quebra de linha em um conjunto de caracteres de byte duplo (DBCS), para que a regra de quebra de linha seja equivalente ao conjunto de caracteres de byte único (SBCS). Isso pode ser usado, por exemplo, para tornar os rótulos de ícones escritos em texto coreano mais legíveis. Esse valor não tem efeito a menos que DT_WORDBREAK seja especificado. |
| DT_NOPREFIX | Desativa o processamento de caracteres de prefixo. Normalmente, DrawThemeText interpreta o caractere de prefixo & como uma diretiva para sublinhar o caractere a seguir, e os caracteres de prefixo && como uma diretiva para imprimir um único &. Ao especificar DT_NOPREFIX, esse processamento é desativado. Por exemplo: string de entrada: "A&bc&&d" normal: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
| DT_PATH_ELLIPSIS | Substitui caracteres no meio do texto por reticências para que o resultado caiba no retângulo de exibição. Se a cadeia de caracteres contiver caracteres de barra invertida (\), DT_PATH_ELLIPSIS preservará o máximo possível do texto após a última barra invertida. A cadeia de caracteres não é modificada, a menos que o sinalizador DT_MODIFYSTRING seja especificado. |
| DT_PREFIXONLY | Desenha apenas um sublinhado na posição do caractere após o caractere de prefixo &. Normalmente , DrawThemeText interpreta o & como uma diretiva para sublinhar o caractere que segue e os caracteres de prefixo && como uma diretiva para imprimir um único &. Ao especificar DT_PREFIXONLY, nenhum caractere é desenhado, apenas um sublinhado. Espaços em branco são colocados nas posições onde os caracteres normalmente apareceriam. Por exemplo: string de entrada: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " " |
| DT_RIGHT | Alinha o texto à direita. |
| DT_RTLREADING | Estabelece texto na ordem da direita para a esquerda para texto bidirecional, por exemplo, texto em uma fonte hebraica ou árabe. A direção padrão do texto é da esquerda para a direita. |
| DT_SINGLELINE | Exibe texto em uma única linha. Os retornos de carro e as alimentações de linha não quebram a linha. |
| DT_TABSTOP | Define paradas de tabulação. |
| DT_TOP | Renderiza o texto na parte superior do retângulo de exibição. |
| DT_VCENTER | Centraliza o texto verticalmente. Esse valor é usado somente com o valor DT_SINGLELINE. |
| DT_WORDBREAK | Quebra linhas entre palavras se uma palavra se estender além da borda do retângulo de exibição. Uma sequência de retorno de carro/alimentação de linha (CR/LF) também quebra a linha. |
| DT_WORD_ELLIPSIS | Trunca qualquer palavra que não caiba no retângulo de exibição e adiciona reticências. |