다음을 통해 공유


RealTimeStylus.AddCustomStylusDataToQueue 메서드

업데이트: 2007년 11월

RealTimeStylus 개체의 큐에 사용자 지정 데이터를 추가합니다.

네임스페이스:  Microsoft.StylusInput
어셈블리:  Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Sub AddCustomStylusDataToQueue ( _
    queue As StylusQueues, _
    guid As Guid, _
    data As Object _
)
‘사용 방법
Dim instance As RealTimeStylus
Dim queue As StylusQueues
Dim guid As Guid
Dim data As Object

instance.AddCustomStylusDataToQueue(queue, _
    guid, data)
public void AddCustomStylusDataToQueue(
    StylusQueues queue,
    Guid guid,
    Object data
)
public:
void AddCustomStylusDataToQueue(
    StylusQueues queue, 
    Guid guid, 
    Object^ data
)
public void AddCustomStylusDataToQueue(
    StylusQueues queue,
    Guid guid,
    Object data
)
public function AddCustomStylusDataToQueue(
    queue : StylusQueues, 
    guid : Guid, 
    data : Object
)

매개 변수

  • guid
    형식: System.Guid
    추가할 사용자 지정 데이터의 형식을 식별하는 GUID(Globally Unique Identifier)입니다.
  • data
    형식: System.Object
    큐에 추가할 사용자 지정 데이터입니다.

설명

이 메서드를 사용하면 RealTimeStylus 개체의 큐에 사용자 지정 정보를 추가하여 RealTimeStylus 개체의 기능을 확장할 수 있습니다. 이러한 정보는 CustomStylusData 개체로 추가됩니다. 이 메서드를 통해 선택 및 지우기 모드를 시작하고 종료하는 사용자 지정 데이터를 만들면 RealTimeStylus 개체에서 선택 및 지우기를 구현할 수 있습니다.

RealTimeStylus 개체의 큐인 StylusQueues에서 세 위치 중 하나에 사용자 지정 스타일러스 데이터를 추가할 수 있습니다.

queue 매개 변수를 Input으로 설정하면 사용자 지정 데이터가 RealTimeStylus 개체의 입력 큐에 추가되고 동기적 플러그 인 컬렉션에 태블릿 펜 데이터 스트림의 새 데이터보다 먼저 전송됩니다.

  • queue 매개 변수를 Output으로 설정하면 사용자 지정 데이터가 RealTimeStylus 개체의 출력 큐에서 동기적 플러그 인 컬렉션이 현재 처리하고 있는 데이터보다 뒤에 추가됩니다.

queue 매개 변수를 OutputImmediate로 설정하면 사용자 지정 데이터가 RealTimeStylus 개체의 출력 큐에서 동기적 플러그 인 컬렉션이 현재 처리하고 있는 데이터보다 앞에 추가됩니다.

위에 나와 있는 모든 경우에서 동기적 플러그 인 컬렉션의 후속 플러그 인이 추가하는 데이터는 이전 플러그 인이 추가하는 데이터보다 뒤에 추가됩니다.

사용자 지정 스타일러스 데이터는 큐에 CustomStylusData 개체로 추가되고, 플러그 인은 해당 IStylusSyncPlugin.CustomStylusDataAdded 또는 IStylusAsyncPlugin.CustomStylusDataAdded 메서드를 통해 이 데이터를 받습니다.

RealTimeStylus 개체의 스레드에 있지 않은 개체에서 AddCustomStylusDataToQueue 메서드를 호출하면 큐에서 사용자 지정 데이터와 RealTimeStylus 개체가 처리하는 패킷 간의 관계가 명확하지 않습니다.

경고

IStylusSyncPlugin 인터페이스를 구현하는 개체에서 사용자 지정 데이터를 받을 때의 응답으로 사용자 지정 데이터를 입력 큐에 추가하면 RealTimeStylus 개체의 스레드에 무한 루프가 만들어질 수 있습니다.

데이터가 큐에 추가되는 순서에 대한 자세한 내용 및 그림은 Accessing and Manipulating Stylus Input에 들어 있는 개념 항목을 참조하십시오.

다음 목록은 이 메서드에서 예외가 throw되는 조건을 보여 줍니다.

  • RealTimeStylus 개체가 삭제된 경우

  • data 매개 변수가 null(Visual Basic .NET의 경우 Nothing)인 경우

  • RealTimeStylus 개체가 활성화되지 않은 경우

  • 지정된 큐에서 정보를 받을 수 있는 적절한 플러그 인이 RealTimeStylus 개체에 연결되지 않은 경우

  • guid 매개 변수가 DynamicRenderer 또는 GestureRecognizer 클래스에 연결된 GUID로 설정된 경우

플랫폼

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

3.0에서 지원

참고 항목

참조

RealTimeStylus 클래스

RealTimeStylus 멤버

Microsoft.StylusInput 네임스페이스

StylusQueues

Microsoft.StylusInput.PluginData.CustomStylusData

기타 리소스

Accessing and Manipulating Stylus Input