Método IInkDisp::CreateStroke (msinkaut.h)
Cria um objeto IInkStrokeDisp de uma matriz de valores de entrada de dados de pacote.
Sintaxe
HRESULT CreateStroke(
[in] VARIANT PacketData,
[in] VARIANT PacketDescription,
[out, retval] IInkStrokeDisp **Stroke
);
Parâmetros
[in] PacketData
Especifica a matriz de dados de pacotes. Os dados são uma matriz de valores Int32 que, em ordem, formam a matriz de pontos (x0, y0), (x1, y1), que é passada para o método dentro de uma Variant.
Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.
[in] PacketDescription
É um parâmetro reservado que atualmente não é implementado.
[out, retval] Stroke
Quando esse método retorna, contém um ponteiro para o traço recém-criado.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Um parâmetro continha um ponteiro inválido. |
|
Tipo VARIANT inválido (apenas VT_ARRAY | VT_I4 com suporte). |
|
Ocorreu uma exceção dentro do método . |
|
Não é possível alocar memória para criar o novo traço. |
Comentários
Os valores mínimo e máximo de qualquer ponto na matriz de pontos são LONG_MIN e LONG_MAX, respectivamente. No entanto, esses pontos definem um retângulo de espaço à tinta cuja largura ou altura máxima não pode exceder LONG_MAX. Devido a isso, a diferença entre as coordenadas x mínimas e máximas ou as coordenadas mínimas e máximas de y não pode exceder LONG_MAX.
Requisitos
| 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 |