Interfaccia IAxWinAmbientDispatch
Questa interfaccia fornisce metodi per specificare le caratteristiche del controllo o del contenitore ospitato.
Importante
Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.
Sintassi
interface IAxWinAmbientDispatch : IDispatch
Membri
Metodi
Nome | Descrizione |
---|---|
get_AllowContextMenu | La AllowContextMenu proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida. |
get_AllowShowUI | La AllowShowUI proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente. |
get_AllowWindowlessActivation | La AllowWindowlessActivation proprietà specifica se il contenitore consentirà l'attivazione senza finestra. |
get_BackColor | La BackColor proprietà specifica il colore di sfondo ambientale del contenitore. |
get_DisplayAsDefault | DisplayAsDefault è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito. |
get_DocHostDoubleClickFlags | La DocHostDoubleClickFlags proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic. |
get_DocHostFlags | La DocHostFlags proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host. |
get_Font | La Font proprietà specifica il tipo di carattere di ambiente del contenitore. |
get_ForeColor | La ForeColor proprietà specifica il colore di primo piano di ambiente del contenitore. |
get_LocaleID | La LocaleID proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore. |
get_MessageReflect | La MessageReflect proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato. |
get_OptionKeyPath | La OptionKeyPath proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente. |
get_ShowGrabHandles | La ShowGrabHandles proprietà di ambiente consente al controllo di scoprire se deve disegnare se stessa con handle di afferramento. |
get_ShowHatching | La ShowHatching proprietà di ambiente consente al controllo di scoprire se deve disegnare se stesso tratteggio. |
get_UserMode | La UserMode proprietà specifica la modalità utente di ambiente del contenitore. |
put_AllowContextMenu | La AllowContextMenu proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida. |
put_AllowShowUI | La AllowShowUI proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente. |
put_AllowWindowlessActivation | La AllowWindowlessActivation proprietà specifica se il contenitore consentirà l'attivazione senza finestra. |
put_BackColor | La BackColor proprietà specifica il colore di sfondo ambientale del contenitore. |
put_DisplayAsDefault | DisplayAsDefault è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito. |
put_DocHostDoubleClickFlags | La DocHostDoubleClickFlags proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic. |
put_DocHostFlags | La DocHostFlags proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host. |
put_Font | La Font proprietà specifica il tipo di carattere di ambiente del contenitore. |
put_ForeColor | La ForeColor proprietà specifica il colore di primo piano di ambiente del contenitore. |
put_LocaleID | La LocaleID proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore. |
put_MessageReflect | La MessageReflect proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato. |
put_OptionKeyPath | La OptionKeyPath proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente. |
put_UserMode | La UserMode proprietà specifica la modalità utente di ambiente del contenitore. |
Osservazioni:
Questa interfaccia viene esposta dagli oggetti host del controllo ActiveX di ATL. Chiamare i metodi in questa interfaccia per impostare le proprietà di ambiente disponibili per il controllo ospitato o per specificare altri aspetti del comportamento del contenitore. Per integrare le proprietà fornite da IAxWinAmbientDispatch
, usare IAxWinAmbientDispatchEx.
AxHost tenterà di caricare informazioni sul tipo relative IAxWinAmbientDispatch
a e IAxWinAmbientDispatchEx
da typelib che contiene il codice.
Se si esegue il collegamento ad ATL90.dll, AXHost caricherà le informazioni sul tipo dal typelib nella DLL.
Per altri dettagli, vedere Hosting di controlli ActiveX tramite ATL AXHost .
Requisiti
La definizione di questa interfaccia è disponibile in diversi formati, come illustrato nella tabella seguente.
Tipo definizione | file |
---|---|
IDL | atliface.idl |
Libreria dei tipi | Atl |
C++ | atliface.h (incluso anche in ATLBase.h) |
IAxWinAmbientDispatch::get_AllowContextMenu
La AllowContextMenu
proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida.
STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);
Parametri
pbAllowContextMenu
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_AllowShowUI
La AllowShowUI
proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente.
STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);
Parametri
pbAllowShowUI
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_AllowWindowlessActivation
La AllowWindowlessActivation
proprietà specifica se il contenitore consentirà l'attivazione senza finestra.
STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);
Parametri
pbAllowWindowless
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_BackColor
La BackColor
proprietà specifica il colore di sfondo ambientale del contenitore.
STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);
Parametri
pclrBackground
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa COLOR_BTNFACE o COLOR_WINDOW come valore predefinito di questa proprietà , a seconda che l'elemento padre della finestra host sia o meno un dialogo.
IAxWinAmbientDispatch::get_DisplayAsDefault
DisplayAsDefault
è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito.
STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);
Parametri
pbDisplayAsDefault
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_DocHostDoubleClickFlags
La DocHostDoubleClickFlags
proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic.
STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);
Parametri
pdwDocHostDoubleClickFlags
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa DOCHOSTUIDBLCLK_DEFAULT come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_DocHostFlags
La DocHostFlags
proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host.
STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);
Parametri
pdwDocHostFlags
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa DOCHOSTUIFLAG_NO3DBORDER come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_Font
La Font
proprietà specifica il tipo di carattere di ambiente del contenitore.
STDMETHOD(get_Font)(IFontDisp** pFont);
Parametri
pFont
[out] Indirizzo di un IFontDisp
puntatore di interfaccia utilizzato per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa il tipo di carattere GUI predefinito o il tipo di carattere di sistema come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_ForeColor
La ForeColor
proprietà specifica il colore di primo piano di ambiente del contenitore.
STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);
Parametri
pclrForeground
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa il colore del testo della finestra di sistema come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_LocaleID
La LocaleID
proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore.
STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);
Parametri
plcidLocaleID
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa le impostazioni locali predefinite dell'utente come valore predefinito di questa proprietà.
Con questo metodo è possibile individuare l'ID locale di ambiente, ovvero l'ID locale del programma in cui viene usato il controllo. Una volta che si conosce l'ID locale, è possibile chiamare il codice per caricare didascalia specifiche delle impostazioni locali, testo del messaggio di errore e così via da un file di risorse o una DLL satellite.
IAxWinAmbientDispatch::get_MessageReflect
La MessageReflect
proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato.
STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);
Parametri
pbMessageReflect
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::get_OptionKeyPath
La OptionKeyPath
proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente.
STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);
Parametri
pbstrOptionKeyPath
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
IAxWinAmbientDispatch::get_ShowGrabHandles
La ShowGrabHandles
proprietà di ambiente consente al controllo di scoprire se deve disegnare se stessa con handle di afferramento.
STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);
Parametri
pbShowGrabHandles
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL restituisce sempre VARIANT_FALedizione Standard come valore di questa proprietà.
IAxWinAmbientDispatch::get_ShowHatching
La ShowHatching
proprietà di ambiente consente al controllo di scoprire se deve disegnare se stesso tratteggio.
STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);
Parametri
pbShowHatching
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL restituisce sempre VARIANT_FALedizione Standard come valore di questa proprietà.
IAxWinAmbientDispatch::get_UserMode
La UserMode
proprietà specifica la modalità utente di ambiente del contenitore.
STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);
Parametri
pbUserMode
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_AllowContextMenu
La AllowContextMenu
proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida.
STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);
Parametri
bAllowContextMenu
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_AllowShowUI
La AllowShowUI
proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente.
STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);
Parametri
bAllowShowUI
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_AllowWindowlessActivation
La AllowWindowlessActivation
proprietà specifica se il contenitore consentirà l'attivazione senza finestra.
STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);
Parametri
bAllowWindowless
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_BackColor
La BackColor
proprietà specifica il colore di sfondo ambientale del contenitore.
STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);
Parametri
clrBackground
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa COLOR_BTNFACE o COLOR_WINDOW come valore predefinito di questa proprietà , a seconda che l'elemento padre della finestra host sia o meno un dialogo.
IAxWinAmbientDispatch::p ut_DisplayAsDefault
DisplayAsDefault
è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito.
STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);
Parametri
bDisplayAsDefault
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags
La DocHostDoubleClickFlags
proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic.
STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);
Parametri
dwDocHostDoubleClickFlags
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa DOCHOSTUIDBLCLK_DEFAULT come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_DocHostFlags
La DocHostFlags
proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host.
STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);
Parametri
dwDocHostFlags
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa DOCHOSTUIFLAG_NO3DBORDER come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_Font
La Font
proprietà specifica il tipo di carattere di ambiente del contenitore.
STDMETHOD(put_Font)(IFontDisp* pFont);
Parametri
pFont
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa il tipo di carattere GUI predefinito o il tipo di carattere di sistema come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_ForeColor
La ForeColor
proprietà specifica il colore di primo piano di ambiente del contenitore.
STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);
Parametri
clrForeground
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa il colore del testo della finestra di sistema come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_LocaleID
La LocaleID
proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore.
STDMETHOD(put_LocaleID)(LCID lcidLocaleID);
Parametri
lcidLocaleID
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa le impostazioni locali predefinite dell'utente come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_MessageReflect
La MessageReflect
proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato.
STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);
Parametri
bMessageReflect
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
IAxWinAmbientDispatch::p ut_OptionKeyPath
La OptionKeyPath
proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente.
STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);
Parametri
bstrOptionKeyPath
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
IAxWinAmbientDispatch::p ut_UserMode
La UserMode
proprietà specifica la modalità utente di ambiente del contenitore.
STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);
Parametri
bUserMode
[in] Nuovo valore di questa proprietà.
Valore restituito
Valore HRESULT standard.
Osservazioni:
L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.
Vedi anche
Interfaccia IAxWinAmbientDispatchEx
Interfaccia IAxWinHostWindow
CAxWindow::QueryHost
AtlAxGetHost
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per