Méthode ITextInputPanel ::get_PreferredInPlaceDirection (peninputpanel.h)

[ITextInputPanel est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt IInputPanelConfiguration.

]

Obtient ou définit la direction par défaut du panneau d’entrée sur place par rapport au champ d’entrée de texte.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_PreferredInPlaceDirection(
  InPlaceDirection *Direction
);

Paramètres

Direction

Valeur de retour

None

Remarques

Une application peut spécifier si le panneau d’entrée sur place apparaît par défaut au-dessus ou au-dessous d’un champ d’entrée de texte. Pour ce faire, l’application peut définir la propriété ITextInputPanel ::P referredInPlaceDirection sur InPlaceDirection_Bottom ou InPlaceDirection_Top. La propriété ITextInputPanel ::P referredInPlaceDirection est une préférence, car le panneau d’entrée sur place remplace la préférence définie par l’application si nécessaire pour conserver le panneau d’entrée à l’écran. La valeur par défaut du système consiste à positionner le panneau d’entrée sur place sous un champ de texte dans la mesure du possible et à le positionner au-dessus. La définition de PreferredInPlaceDirection sur InPlaceDirection_Auto restaure la valeur par défaut du système.

Exemples

Cet exemple C++ crée un objet ITextInputPanel , g_pTipet l’attache au handle de fenêtre d’un contrôle InkEdit , IDC_EDIT3, en définissant la propriété ITextInputPanel ::AttachedEditWindow . Il définit également, puis obtient la propriété ITextInputPanel ::P referredInPlaceDirection.

if (SUCCEEDED(CoInitialize(NULL)))
{
    if (SUCCEEDED(CoCreateInstance(CLSID_TextInputPanel, NULL, CLSCTX_INPROC, IID_ITextInputPanel, (VOID**)&g_pTip)))
    {
        if (SUCCEEDED(g_pTip->put_AttachedEditWindow(GetDlgItem(IDC_EDIT3)->m_hWnd)))
        {
            g_pTip->put_DefaultInPlaceState(InPlaceState_Expanded);
            InPlaceState ips;
            g_pTip->get_DefaultInPlaceState(&ips);
            TRACE("DefaultInplaceState: %d\n", ips);
            
            g_pTip->put_DefaultInputArea(PanelInputArea_CharacterPad);
            PanelInputArea pia;
            g_pTip->get_DefaultInputArea(&pia);
            TRACE("DefaultInputArea: %d\n", pia);

            g_pTip->put_ExpandPostInsertionCorrection(FALSE);
            BOOL epic;
            g_pTip->get_ExpandPostInsertionCorrection(&epic);
            TRACE("ExpandPostInsertionCorrection: %d\n", epic);

            g_pTip->put_InPlaceVisibleOnFocus(TRUE);
            BOOL ipvof;
            g_pTip->get_InPlaceVisibleOnFocus(&ipvof);
            TRACE("InPlaceVisibleOnFocus: %d\n", ipvof);

            g_pTip->put_PreferredInPlaceDirection(InPlaceDirection_Top);
            InPlaceDirection direction;
            g_pTip->get_PreferredInPlaceDirection(&direction);
            TRACE("PreferredInPlaceDirection: %d\n", direction);
        }
    }
    else
    {
        TRACE("Failed to create ITextInputPanel object.\n");
    }
}

Configuration requise

Voir aussi

ITextInputPanel, interface