Método IInkStrokeDisp::SetPacketValuesByProperty (msinkaut.h)

Modifica os valores de pacote para uma propriedade específica.

Sintaxe

HRESULT SetPacketValuesByProperty(
  [in]           BSTR    bstrPropertyName,
  [in]           VARIANT PacketValues,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPacketsSet
);

Parâmetros

[in] bstrPropertyName

O identificador GUID (identificador global exclusivo) das constantes PacketProperty usadas para selecionar quais dados de pacote estão definidos. Use PacketDescription para determinar as propriedades definidas para esse traço.

[in] PacketValues

A matriz de valores de dados de pacote. O método falhará se qualquer um dos valores na matriz estiver fora do valor mínimo ou máximo da propriedade. Para determinar o intervalo de valores na propriedade , chame o método GetPacketDescriptionPropertyMetrics .

[in, optional] Index

Opcional. O índice inicial do pacote a ser modificado. O valor padrão ISC_FirstElement, definido no tipo de enumeração ItemSelectionConstants , especifica o primeiro pacote.

[in, optional] Count

Opcional. Especifica o número de pacotes no traço a ser modificado e o número de valores em PacketValues. O valor padrão ISC_AllElements, definido no tipo de enumeração ItemSelectionConstants , especifica que todos os pacotes são modificados.

[out, retval] NumberOfPacketsSet

Quando esse método retorna, contém o número real de pacotes definidos.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Um parâmetro continha um ponteiro inválido.
CO_E_CLASSSTRING	Formato GUID inválido.
E_INVALIDARG	Variante inválida, índice (fora do intervalo) ou GUID da propriedade.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	msinkaut.h
Biblioteca	InkObj.dll

Confira também

Método GetPacketDescriptionPropertyMetrics

IInkStrokeDisp Interface

Enumeração ItemSelectionConstants

Constantes PacketPropertyGuids