ITextInputPanel::SetInPlaceVisibility-Methode (peninputpanel.h)

Artikel
08/25/2023

[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.

]

Zeigt den Tablet-PC-Eingabebereich an oder blendet sie aus.

Syntax

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Parameter

Visible

TRUE , um den Eingabebereich anzuzeigen; FALSE , um den Eingabebereich auszublenden.

Rückgabewert

Wenn der Eingabebereich angezeigt werden kann, gibt die Methode S_OK zurück, andernfalls E_FAIL. Weitere Informationen dazu, wann der Eingabebereich von der ITextInputPanel::SetInPlaceVisibility-Methode beeinflusst werden kann und nicht, finden Sie im Abschnitt Hinweise.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Der Eingabebereich wird wie von der Eigenschaft ITextInputPanel::CurrentInPlaceState-Eigenschaft angegeben angezeigt.

Das Aufrufen von ITextInputPanel::SetInPlaceVisibility-Methode mit dem auf TRUE festgelegten Visible-Parameter schlägt fehl, wenn der Eingabebereich bereits sichtbar ist.

Wenn der Benutzer den direkten Modus über das Dialogfeld Eingabebereichoptionen deaktiviert hat, tritt beim Aufrufen der ITextInputPanel::SetInPlaceVisibility-Methode ein Fehler auf.

Alle Freihandeingaben, die sich bereits im Eingabebereich befindet, werden automatisch eingefügt, wenn sich die Sichtbarkeit ändert.

Diese Methode ändert den Wert von ITextInputPanel::InPlaceVisibleOnFocus-Eigenschaft nicht, und bei der nachfolgenden Fokusänderung wird das Verhalten auf das verhalten zurückgesetzt, das von der ITextInputPanel::InPlaceVisibleOnFocus-Eigenschaft angegeben wird.

Die ITextInputPanel::SetInPlaceVisibility-Methode ist ein synchroner Aufruf. Die Sichtbarkeit des Eingabebereichs ändert sich, bevor der Aufruf zurückgegeben wird.

Beispiele

In diesem C++-Beispiel wird ein EN_SETFOCUS Ereignishandler für ein Edit-Steuerelement implementiert. IDC_EDIT1 Zuerst wird überprüft, ob ein ITextInputPanel-Objekt erstellt g_pTipwurde. Falls vorhanden, wird verhindert, dass der Eingabebereich angezeigt wird, indem die ITextInputPanel::SetInPlaceVisibility-Methode mit dem Wert false für den Visible-Parameter aufgerufen wird.

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\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