Metodo ITextInputPanel::SetInPlaceVisibility (peninputpanel.h)

[ITextInputPanel è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece IInputPanelConfiguration.

]

Mostra o nasconde il pannello di input del TABLET PC.

Sintassi

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Parametri

Visible

TRUE per visualizzare il pannello di input; FALSE per nascondere il pannello di input.

Valore restituito

Se il pannello di input può essere visualizzato, il metodo restituisce S_OK, in caso contrario E_FAIL. Vedere la sezione Osservazioni per altre informazioni su quando il pannello di input può e non può essere interessato dal metodo ITextInputPanel::SetInPlaceVisibility.

Commenti

Il pannello di input viene visualizzato come specificato dalla proprietà ITextInputPanel::CurrentInPlaceState.

La chiamata al metodo ITextInputPanel::SetInPlaceVisibility con il parametro Visible impostata su TRUE avrà esito negativo se il pannello di input è già visibile.

Se l'utente ha disabilitato la modalità sul posto dalla finestra di dialogo Opzioni pannello di input, la chiamata al metodo ITextInputPanel::SetInPlaceVisibility avrà esito negativo.

Qualsiasi input penna già nel pannello di input, quando viene modificata la visibilità, viene inserita automaticamente.

Questo metodo non modifica il valore della proprietà ITextInputPanel::InPlaceVisibleOnFocus e sulla modifica dello stato attivo successivo, il comportamento viene ripristinato al comportamento specificato dalla proprietà ITextInputPanel::InPlaceVisibleOnFocus.

Il metodo ITextInputPanel::SetInPlaceVisibility è una chiamata sincrona. La visibilità del pannello di input verrà modificata prima che venga restituita la chiamata.

Esempio

Questo esempio di C++ implementa un EN_SETFOCUS gestore eventi per un controllo Modifica, IDC_EDIT1. Verifica prima di tutto se è stato creato un oggetto g_pTipITextInputPanel. Se esiste, impedisce al pannello di input di visualizzare chiamando il metodo ITextInputPanel::SetInPlaceVisibility con un valore false per il parametro Visible .

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\n");
		}
	}
}

Requisiti

Vedi anche

Interfaccia ITextInputPanel

ITextInputPanel::D efaultInPlaceState, proprietà

Metodo ITextInputPanel::SetInPlaceHoverTargetPosition

Metodo ITextInputPanel::SetInPlacePosition

Enumerazione InPlaceState