Método IRealTimeStylus::AddStylusAsyncPlugin (rtscom.h)

Artigo
03/13/2024

Adiciona um IStylusAsyncPlugin à coleção de plug-ins assíncrona no índice especificado.

Sintaxe

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

Parâmetros

[in] iIndex

Especifica o índice do plug-in na coleção de plug-ins assíncrona.

[in] piPlugin

O plug-in ao qual adicionar.

Retornar valor

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

Você não poderá adicionar plug-ins assíncronos se o objeto Classe RealTimeStylus tiver um objeto de classe RealTimeStylus filho.

Exemplos

O exemplo de código C++ a seguir adiciona uma instância de um IStylusAsyncPlugin a um objeto RealTimeStylus . O código de exemplo usa o método QueryInterface em um plug-in GestureRecognizer , g_pGestureHandler, para obter a interface IStylusAsyncPlugin e, em seguida, chama o Método IRealTimeStylus::AddStylusAsyncPlugin.

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;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	rtscom.h
DLL	RTSCom.dll