IRealTimeStylus::AddStylusSyncPlugin-Methode (rtscom.h)

Fügt der synchronen Plug-In-Auflistung am angegebenen Index ein IStylusSyncPlugin hinzu.

Syntax

HRESULT AddStylusSyncPlugin(
  [in] ULONG             iIndex,
  [in] IStylusSyncPlugin *piPlugin
);

Parameter

[in] iIndex

Der Index der synchronen Plug-In-Auflistung, in der das Plug-In hinzugefügt wird.

[in] piPlugin

Das hinzugefügte Plug-In.

Rückgabewert

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

Hinweise

Verwenden Sie dies, um der synchronen Plug-In-Sammlung dynamisch ein Plug-In hinzuzufügen.

Die synchronen und asynchronen Plug-In-Auflistungen für das RealTimeStylus Class-Objekt können geändert werden, ohne das RealTimeStylus-Klassenobjekt zu deaktivieren und dann erneut zu aktivieren.

Plug-Ins müssen den kostenlosen Threaded Marshaler aggregieren und dürfen keine Einzelthread-Apartmentobjekte sein.

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

Weitere Informationen

IRealTimeStylus

IRealTimeStylus::AddStylusAsyncPlugin-Methode

RealTimeStylus-Klasse