IRealTimeStylus::RemoveStylusSyncPlugin-Methode (rtscom.h)

Artikel
03/01/2024

Entfernt ein IStylusSyncPlugin aus der Auflistung am angegebenen Index.

Syntax

HRESULT RemoveStylusSyncPlugin(
  [in]      ULONG             iIndex,
  [in, out] IStylusSyncPlugin **ppiPlugin
);

Parameter

[in] iIndex

Der Index des zu entfernenden Plug-Ins.

[in, out] ppiPlugin

Ein Zeiger auf das zu entfernende Plug-In. Wenn Sie nicht daran interessiert sind, den Zeiger auf das entfernte Plug-In zu erhalten, übergeben Sie NULL für diesen Parameter.

Rückgabewert

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

Hinweise

Verwenden Sie, um ein bestimmtes Plug-In dynamisch aus der synchronen Plug-In-Sammlung zu entfernen.

Die synchronen und asynchronen Plug-In-Auflistungen in der RealTimeStylus-Klasse können geändert werden, ohne die RealTimeStylus-Klasse zu deaktivieren und dann erneut zu aktivieren.

Beispiele

Im folgenden C++-Codebeispiel wird ein Ereignishandler für ein CheckBox-Steuerelement (Windows Forms) implementiert. Abhängig vom überprüften Zustand des Steuerelements, das durch die m_btnPacketFilter Membervariable dargestellt wird, fügt die Funktion das Plug-In hinzu oder entfernt es, das von der globalen g_pPacketModifier Variablen dargestellt wird.

void CCOMRTSDlg::OnBnClickedCheckPacketFilter()
{
	HRESULT hr;
	IStylusSyncPlugin* pSyncPlugin;

	hr = g_pPacketModifier->QueryInterface(IID_IStylusSyncPlugin, reinterpret_cast<void**>(&pSyncPlugin));

	if (SUCCEEDED(hr))
	{
		if (m_btnPacketFilter.GetCheck())
		{
			// If the checkbox is checked, add the 
			// Packet Modifier plugin to the RealTimeStylus
			hr = g_pRealTimeStylus->AddStylusSyncPlugin(0, pSyncPlugin);
		}
		else
		{
			// If the checkbox is not checked, remove the 
			// Packet Modifier plugin from the RealTimeStylus
			hr = g_pRealTimeStylus->RemoveStylusSyncPlugin(0, &pSyncPlugin);
		}
	}
}

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