Método IDWriteFontSet::GetPropertyValues(DWRITE_FONT_PROPERTY_ID,WCHARconst*,IDWriteStringList**) (dwrite_3.h)

  • Artigo

Retorna todos os valores de propriedade exclusivos no conjunto, que podem ser usados para fins como exibir uma lista de famílias ou uma nuvem de marcas. Os valores são retornados na ordem de prioridade de acordo com a lista de idiomas, de modo que, se uma fonte contiver mais de um nome localizado, a preferencial será retornada.

Sintaxe

HRESULT GetPropertyValues(
  DWRITE_FONT_PROPERTY_ID propertyID,
  WCHAR const             *preferredLocaleNames,
  IDWriteStringList       **values
);

Parâmetros

propertyID

Tipo: DWRITE_FONT_PROPERTY_ID

Propriedade font de interesse.

preferredLocaleNames

Tipo: WCHAR const *

Os nomes de localidade preferenciais a serem consultados como uma lista de nomes delimitados por ponto e vírgula na ordem preferencial. Quando uma cadeia de caracteres específica (como família de fontes) tem mais de um nome localizado, a primeira correspondência é retornada. Se a primeira correspondência não existir, a segunda correspondência será retornada e assim por diante. Por exemplo, "ja-jp; en-us".

values

Tipo: [out] IDWriteLocalizedStrings**

Recebe um ponteiro para o objeto de cadeias de caracteres localizadas recém-criado; ou nullptr em caso de falha ou propriedade inexistente.

Retornar valor

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dwrite_3.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteFontSet