IInkTablet::GetPropertyMetrics 메서드(msinkaut.h)

  • 아티클

지정된 속성에 대한 메트릭 데이터를 검색합니다.

구문

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

매개 변수

[in] propertyName

메트릭을 확인할 속성입니다.

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

[out] Minimum

태블릿이 이 속성에 대해 보고하는 최소값(논리 단위)입니다. 예를 들어 0에서 9000까지의 x-값을 보고하는 태블릿의 논리적 최소값은 0입니다.

[out] Maximum

태블릿이 이 속성에 대해 보고하는 최대값(논리 단위)입니다. 예를 들어 0에서 9000까지 x-값을 보고하는 태블릿의 논리적 최대값은 9000입니다.

[out] Units

인치 또는 도와 같은 속성의 물리적 단위입니다. 속성 단위 목록은 TabletPropertyMetricUnit 열거형 형식을 참조하세요.

[out] Resolution

단위 멤버의 해상도 또는 증분 값을 지정합니다. 예를 들어 dpi(인치당 400개 점)를 보고하는 태블릿의 해상도 값은 400입니다.

반환 값

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

반환 코드 설명
S_OK
 성공.
TPC_E_UNKNOWN_PROPERTY
 태블릿은 지정된 속성을 지원하지 않습니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
CO_E_CLASSSTRING
 GUID 형식이 잘못되었습니다.
E_INVALIDARG
 알 수 없는 속성 문자열입니다.
E_INK_EXCEPTION
 처리하는 동안 예외가 발생했습니다.

설명

메트릭을 검색하는 속성에는 패킷이 생성된 시간 또는 태블릿 표면의 펜 팁의 하향 압력이 포함될 수 있습니다.

메트릭을 검색할 수 있는 속성의 전체 목록은 PacketProperty 상수를 참조하세요.

참고 특정 메시지 처리기 내에서 이 속성에 액세스하면 기본 함수가 다시 입력되어 예기치 않은 결과가 발생할 수 있습니다. WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT 메시지를 처리할 때 재진입 호출을 방지합니다. wParam 이 SC_HOTKEY 또는 SC_TASKLIST 설정되었는지 WM_SYSCOMMAND. 및 WM_SYSKEYDOWN(Alt-Tab 또는 Alt-Esc 키 조합을 처리하는 경우). 이것은 단일 스레드 아파트 모델 애플리케이션의 문제입니다.
 

요구 사항

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

추가 정보

GetPacketDescriptionPropertyMetrics 메서드

GetPacketValuesByProperty 메서드

IInkTablet 인터페이스

SetPacketValuesByProperty 메서드

TabletPropertyMetricUnit 열거형