Compartilhar via

Função ScriptStringOut (usp10.h)

  • Artigo

Exibe uma cadeia de caracteres gerada por uma chamada anterior a ScriptStringAnalyse e, opcionalmente, adiciona realce.

Sintaxe

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

Parâmetros

[in] ssa

Uma estrutura SCRIPT_STRING_ANALYSIS para a cadeia de caracteres.

[in] iX

A coordenada x do ponto de referência usado para posicionar a cadeia de caracteres.

[in] iY

A coordenada y do ponto de referência usado para posicionar a cadeia de caracteres.

[in] uOptions

Opções que especificam o uso do retângulo definido pelo aplicativo. Esse parâmetro pode ser definido como 0 ou para qualquer um dos valores a seguir. Os valores podem ser combinados com OR binário.

Valor Significado
ETO_CLIPPED
 Recortar texto para o retângulo.
ETO_OPAQUE
 Use a cor da tela de fundo atual para preencher o retângulo.

[in, optional] prc

Ponteiro para uma estrutura RECT que define o retângulo a ser usado. Se uOptions estiver definido como ETO_OPAQUE e NULL for fornecido para prc, a função terá êxito e retornará S_OK. No entanto, se o aplicativo definir uOptions como ETO_CLIPPING e fornecer NULL para prc, a função retornará E_INVALIDARG. O aplicativo pode definir esse parâmetro como NULL para indicar que nenhuma opção é necessária.

[in] iMinSel

Índice baseado em zero que especifica a posição inicial na cadeia de caracteres. Para nenhuma seleção, o aplicativo deve definir iMinSel>= iMaxSel.

[in] iMaxSel

Índice baseado em zero que especifica a posição final na cadeia de caracteres.

[in] fDisabled

TRUE se o sistema operacional aplicar o realce de texto desabilitado definindo a cor da tela de fundo como COLOR_HIGHLIGHT por trás de todos os caracteres selecionados. O aplicativo poderá definir esse parâmetro como FALSE se o sistema operacional aplicar o realce de texto habilitado definindo a cor da tela de fundo como COLOR_HIGHLIGHT e a cor do texto como COLOR_HIGHLIGHTTEXT para cada caractere selecionado.

Retornar valor

Retorna S_OK se tiver êxito. A função retornará um valor HRESULT diferente de zero se não for bem-sucedida. O aplicativo não pode testar o valor retornado com as macros SUCCEEDED e FAILED .

Comentários

Para usar essa função, o aplicativo precisa especificar SSA_GLYPHS em sua chamada original para ScriptStringAnalyse.

O aplicativo não deve usar SetTextAlign com TA_UPDATECP ao usar ScriptStringOut porque o texto selecionado não pode ser renderizado corretamente. Se o aplicativo precisar usar esse sinalizador, ele poderá desmarcar e redefinir o sinalizador conforme necessário para evitar o problema.

Importante Começando com Windows 8: para manter a capacidade de execução no Windows 7, um módulo que usa Uniscribe deve especificar Usp10.lib antes de gdi32.lib em sua lista de bibliotecas.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho usp10.h
Biblioteca Usp10.lib
DLL Usp10.dll

Confira também

SCRIPT_STRING_ANALYSIS

Scriptstringanalyse

Uniscribe

Funções Uniscribe