Método ID2D1Properties::GetPropertyName(U,PWSTR,UINT32) (d2d1_1.h)

Artigo
03/05/2025

Obtém o nome da propriedade que corresponde ao índice fornecido. Essa é uma sobrecarga de modelo. Consulte Comentários.

Sintaxe

HRESULT GetPropertyName(
        U      index,
  [out] PWSTR  name,
        UINT32 nameCount
);

Parâmetros

index

Tipo: U

O índice da propriedade para a qual o nome está sendo retornado.

[out] name

Tipo: PWSTR

Quando esse método é retornado, contém o nome que está sendo recuperado.

nameCount

Tipo: UINT32

O número de caracteres no nome buffer.

Valor de retorno

Tipo: HRESULT

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

HRESULT	Descrição
S_OK	Nenhum erro ocorreu.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O buffer fornecido era muito pequeno para acomodar os dados.
D2DERR_INVALID_PROPERTY	A propriedade especificada não existe.

Observações

Esse método retornará uma cadeia de caracteres vazia se índice for inválido. Se o método retornar RESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), nome ainda será preenchido e truncado.

template<typename U>
    HRESULT GetPropertyName(
        U index,
        _Out_writes_(nameCount) PWSTR name,
        UINT32 nameCount
        ) CONST;

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	d2d1_1.h
biblioteca	D2d1.lib
de DLL	D2d1.dll

Consulte também

D2D1_PROPERTY

D2D1_SUBPROPERTY

ID2D1DeviceContext::CreateEffect

ID2D1Properties

Compartilhar via