Partilhar via

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

Divide o traço no local especificado no traço.

Sintaxe

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

Parâmetros

[in] SplitAt

O valor do índice de ponto flutuante que representa onde dividir o traço.

Nota Um índice de ponto flutuante é um valor flutuante que representa um local entre dois pontos no traço. Como exemplos, se 0.0 for o primeiro ponto no traço e 1,0 for o segundo ponto no traço, 0,5 estará na metade entre o primeiro e o segundo pontos. Da mesma forma, um valor de índice de ponto flutuante de 37,25 representa um local que é de 25% ao longo da linha entre os pontos 37 e 38 do traço.
 

[out, retval] NewStroke

Quando esse método é retornado, contém um ponteiro para o novo objeto IInkStrokeDisp que é criado a partir da operação de divisão.

Valor de retorno

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.
E_OUTOFMEMORY
 Não é possível alocar o objeto auxiliar do manipulador de traços.
E_INVALIDARG
 O parâmetro é inválido.
E_UNEXPECTED
 Parâmetro inesperado ou tipo de propriedade.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método.

Observações

Esse método insere o novo traço imediatamente após o traço original no conjunto de traços e renumera os índices de traço restantes.

Quando um IInkStrokeDisp é dividido, a parte inicial do traço permanece a ID do IInkStrokeDisp original. A parte final do IInkStrokeDisp torna-se um novo IInkStrokeDisp com uma ID maior que a ID IInkStrokeDisp mais alta. Se o IInkStrokeDisp original estava em uma coleção InkStrokes (diferente do Ink.Strokes), apenas a parte inicial permanece nessa coleção.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header msinkaut.h

Consulte também

IInkStrokeDisp Interface

  • Last updated on