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 a 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.dll |
| 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_FALSE 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_FALSE 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 didascalie specifiche delle impostazioni locali, testo del messaggio di errore e così via da un file di risorse o da 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_FALSE 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_FALSE 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_FALSE 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_FALSE 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