Compartilhar via

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

  • Artigo

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 float que representa um local em algum lugar 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á no meio do caminho entre o primeiro e o segundo pontos. Da mesma forma, um valor de índice de ponto flutuante de 37,25 representa um local de 25% ao longo da linha entre os pontos 37 e 38 do traço.
 

[out, retval] NewStroke

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

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.
E_OUTOFMEMORY
 Não é possível alocar o objeto auxiliar do manipulador stroke.
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 .

Comentários

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 estivesse em uma coleção InkStrokes (diferente do Ink.Strokes), somente a parte inicial permanecerá nessa coleção.

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

IInkStrokeDisp Interface