IInkStrokeDisp::GetPacketValuesByProperty 메서드(msinkaut.h)

아티클
08/25/2023

스트로크의 하나 이상의 패킷에서 알려진 패킷 속성에 대한 데이터를 검색합니다.

구문

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

매개 변수

[in] PropertyName

검색할 패킷 데이터를 선택하는 데 사용된 PacketProperty 상수의 식별자입니다.

BSTR 데이터 형식에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[in, optional] Index

선택 사항입니다. 스트로크 내의 패킷에 대한 0부터 시작하는 인덱스의 시작점입니다. InkSelectionConstants 열거형 형식에 정의된 기본값 ISC_FirstElement 첫 번째 패킷을 지정합니다.

[in, optional] Count

선택 사항입니다. 스트로크 데이터를 구성하는 점 수입니다. InkSelectionConstants 열거형 형식에 정의된 기본값 ISC_AllElements 스트로크 데이터를 구성하는 모든 점을 지정합니다.

[out, retval] PacketValues

이 메서드가 반환되면 스트로크에서 요청된 각 지점에 대해 요청된 PacketProperty 의 값을 지정하는 서명된 32비트 정수 배열이 포함됩니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
TPC_E_INVALID_STROKE	스트로크가 잘못되었습니다.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_OUTOFMEMORY	패킷 데이터 배열을 할당할 수 없습니다.
E_INVALIDARG	인덱스, 개수 또는 패킷 속성이 잘못되었습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
CO_E_CLASSSTRING	GUID 형식이 잘못되었습니다.

설명

특정 패킷 속성은 특정 IInkStrokeDisp 개체에서 사용할 수 없습니다. 태블릿 PC에는 사용자 입력을 위한 태블릿이 둘 이상 있을 수 있습니다. InkTablets 컬렉션에는 태블릿 PC에 연결된 모든 태블릿 목록이 포함되어 있습니다. IsPacketPropertySupported 메서드를 사용하여 특정 패킷 속성이 특정 IInkTablet 개체 또는 사용 가능한 모든 태블릿에서 지원되는지 확인합니다. 또한 잉크 수집기의 DesiredPacketDescription 속성을 사용하여 새 스트로크에서 수집되는 패킷 속성을 제어합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	msinkaut.h
라이브러리	InkObj.dll