ITextInputPanel::get_InPlaceBoundingRectangle-Methode (peninputpanel.h)

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

]

Ruft das umgebende Rechteck für den Tablet-PC-Eingabebereich ab.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_InPlaceBoundingRectangle(
  RECT *BoundingRectangle
);

Parameter

BoundingRectangle

Rückgabewert

Keine

Bemerkungen

Wenn das Schreibpad oder zeichenpad aktiv ist, ist die Höhe der Schaltfläche Einfügen im umgebenden Rechteck für den direkten Eingabebereich enthalten. Das umgebende Rechteck enthält nicht die Höhe des Korrekturkamms. Wenn das direkte Eingabebereich automatisch wächst, wird das ITextInputPanelEventSink::InPlaceSizeChanging Method/ITextInputPanelEventSink::InPlaceSizeChanged Method-Ereignispaar ausgelöst, und der Wert dieser Eigenschaft wird aktualisiert, um den zusätzlichen Schreibbereich oder die Schreibzeile einzuschließen.

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