IRealTimeStylus::AddStylusAsyncPlugin-Methode (rtscom.h)

Artikel
03/04/2024

Fügt der asynchronen Plug-In-Auflistung am angegebenen Index ein IStylusAsyncPlugin hinzu.

Syntax

HRESULT AddStylusAsyncPlugin(
  [in] ULONG              iIndex,
  [in] IStylusAsyncPlugin *piPlugin
);

Parameter

[in] iIndex

Gibt den Index des Plug-Ins in der asynchronen Plug-In-Auflistung an.

[in] piPlugin

Das Plug-In, dem sie hinzugefügt werden soll.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Sie können keine asynchronen Plug-Ins hinzufügen, wenn das RealTimeStylus Class-Objekt über ein untergeordnetes RealTimeStylus-Klassenobjekt verfügt.

Beispiele

Im folgenden C++-Codebeispiel wird ein instance eines IStylusAsyncPlugins zu einem RealTimeStylus-Objekt hinzugefügt. Der Beispielcode verwendet die QueryInterface-Methode für ein GestureRecognizer-Plug-In , g_pGestureHandlerum die IStylusAsyncPlugin-Schnittstelle abzurufen, und ruft dann die IRealTimeStylus::AddStylusAsyncPlugin-Methode auf.

HRESULT CCOMRTSDlg::InitGestureHandler()
{
	// Create an IGestureHandler object
	HRESULT hr = CoCreateInstance(CLSID_GestureHandler, NULL, CLSCTX_INPROC, IID_IGestureHandler, (VOID **)&g_pGestureHandler);

	if (SUCCEEDED(hr))
	{
		// Get a pointer to the IStylusAsyncPlugin interface
		IStylusAsyncPlugin* pAsyncPlugin;
		hr = g_pGestureHandler->QueryInterface(IID_IStylusAsyncPlugin, reinterpret_cast<void**>(&pAsyncPlugin));
		
		if (SUCCEEDED(hr))
		{
			// Get the current count of plugins so we can
			// add this one to the end of the collection
			ULONG nAsyncPluginCount;
			hr = g_pRealTimeStylus->GetStylusAsyncPluginCount(&nAsyncPluginCount);

			if (SUCCEEDED(hr))
			{
				// Add the plugin to the StylusAsyncPlugin collection
				hr = g_pRealTimeStylus->AddStylusAsyncPlugin(nAsyncPluginCount, pAsyncPlugin);

				if (SUCCEEDED(hr))
				{
					// Pass the Gesture Handler a pointer to the 
					// status window so it can update the status
					hr = g_pGestureHandler->SetStatusWindow(&m_staticGestureStatus);
				}
			}
		}
	}
	return hr;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	rtscom.h
DLL	RTSCom.dll