Compartilhar via


Método IDWriteLocalizedStrings::GetStringLength (dwrite.h)

Obtém o comprimento em caracteres (sem incluir o terminador nulo) da cadeia de caracteres com o índice especificado.

Sintaxe

HRESULT GetStringLength(
        UINT32 index,
  [out] UINT32 *length
);

Parâmetros

index

Tipo: UINT32

Um índice baseado em zero do par de linguagem/cadeia de caracteres.

[out] length

Tipo: UINT32*

O comprimento em caracteres da cadeia de caracteres, não incluindo o terminador nulo, do par de linguagem/cadeia de caracteres.

Valor retornado

Tipo: HRESULT

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

Comentários

Use GetStringLength para obter o comprimento da cadeia de caracteres antes de chamar o método IDWriteLocalizedStrings::GetString , conforme mostrado no código a seguir.

UINT32 length = 0;

// Get the string length.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetStringLength(index, &length);
}

// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
    hr = E_OUTOFMEMORY;
}

// Get the family name.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetString(index, name, length+1);
}

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteLocalizedStrings