ITextInputPanel::get_CurrentInPlaceState-Methode (peninputpanel.h)

[ITextInputPanel ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IInputPanelConfiguration.

]

Ruft den aktuellen direkten Zustand ab, wie durch die InPlaceState-Enumeration angegeben.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_CurrentInPlaceState(
  InPlaceState *State
);

Parameter

State

Rückgabewert

Keine

Bemerkungen

Wenn der Eingabebereich des Tablet-PCs geschlossen oder ausgeblendet ist, wird der aktuelle direkte Zustand auf den Standardzustand zurückgesetzt, es sei denn, der Standardzustand lautet Auto. In diesem Fall wird der aktuelle direkte Zustand auf Hover zurückgesetzt.

Beispiele

In diesem C++-Beispiel wird ein EN_SETFOCUS Ereignishandler für ein Edit-Steuerelement implementiert. IDC_EDIT3 Zuerst wird überprüft, ob ein ITextInputPanel-Objekt erstellt g_pTipwurde. Falls vorhanden, werden die Werte mehrerer Eigenschaften der ITextInputPanel-Schnittstelle gemeldet, um die Ausgabe mithilfe des TRACE-Makros zu debuggen.

void CCOMTIPDlg::OnEnSetFocusEdit3()
{
    if (NULL != g_pTip)
    {
		CorrectionMode mode;

		if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
        {
			TRACE("CurrentCorrectionMode: %d\n", mode);
		}

		InPlaceState state;

		if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
        {
			TRACE("CurrentInPlaceState: %d\n", state);
		}

		PanelInputArea area;

		if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
        {
			TRACE("CurrentInputArea: %d\n", area);
		}

		InteractionMode iMode;

		if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
        {
			TRACE("CurrentInteractionMode: %d\n", iMode);
		}

        RECT rect;

		if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
        {
	        TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
	        TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
	        TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
	        TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
        }

	    int nHeight;

		if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
        {
	        TRACE("PopDownCorrectionHeight: %d\n", nHeight);
        }

	    if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
        {
	        TRACE("PopUpCorrectionHeight: %d\n", nHeight);
        }

		if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
		{
			TRACE("Call to SetInPlacePosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlacePosition() failed.\n");
		}
    }
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

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	peninputpanel.h
DLL	Tiptsf.dll

Weitere Informationen

ITextInputPanel-Schnittstelle