Metodo ITextInputPanel::get_CurrentInputArea (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.

]

Ottiene l'area di input corrente come specificato dall'enumerazione PanelInputArea.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

Parametri

Area

Valore restituito

nessuno

Osservazioni

L'area di input corrente è diversa dall'area di input predefinita quando l'utente ha aree di input cambiate in modo esplicito. È anche diverso se l'area di input predefinita non è disponibile perché il riconoscimento corrente non supporta tale modalità o perché non è disponibile alcun riconoscimento per la lingua di input corrente. Quando il pannello di input tablet PC è chiuso o nascosto, le aree di input correnti vengono reimpostate in modo che corrispondano all'area di input predefinita, a meno che lo stato predefinito non sia Auto, nel qual caso l'area di input corrente non viene reimpostata e rappresenta l'ultima area di input visibile.

Esempio

Questo esempio di C++ implementa un EN_SETFOCUS gestore eventi per un controllo Modifica, IDC_EDIT3. Verifica innanzitutto se è stato creato un oggetto ITextInputPanel. g_pTip Se esiste, segnala i valori di diverse proprietà dell'interfaccia ITextInputPanel per eseguire il debug dell'output usando la macro TRACE .

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

Requisiti

Vedi anche

Interfaccia ITextInputPanel