Udostępnij za pośrednictwem


CDHtmlDialog Klasa

Służy do tworzenia okien dialogowych, które używają kodu HTML, a nie zasobów dialogowych do implementowania interfejsu użytkownika.

Składnia

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CDHtmlDialog::CDHtmlDialog Tworzy obiekt CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog Niszczy obiekt CDHtmlDialog.

Metody publiczne

Nazwa/nazwisko opis
CDHtmlDialog::CanAccessExternal Można zastąpić, który jest wywoływany jako kontrola dostępu, aby sprawdzić, czy obiekty skryptowe na załadowanej stronie mogą uzyskiwać dostęp do zewnętrznego wysyłania lokacji sterowania. Sprawdza, czy wysyłanie jest bezpieczne dla skryptów, lub bieżąca strefa zezwala na obiekty, które nie są bezpieczne dla skryptów.
CDHtmlDialog::CreateControlSite Można zastąpić używane do tworzenia wystąpienia witryny sterowania do hostowania kontrolki WebBrowser w oknie dialogowym.
CDHtmlDialog::DDX_DHtml_AxControl Wymienia dane między zmienną składową a wartością właściwości kontrolki ActiveX na stronie HTML.
CDHtmlDialog::DDX_DHtml_CheckBox Wymienia dane między zmienną składową a polem wyboru na stronie HTML.
CDHtmlDialog::DDX_DHtml_ElementText Wymienia dane między zmienną składową a dowolną właściwością elementu HTML na stronie HTML.
CDHtmlDialog::DDX_DHtml_Radio Wymienia dane między zmienną składową a przyciskiem radiowym na stronie HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex Pobiera lub ustawia indeks pola listy na stronie HTML.
CDHtmlDialog::DDX_DHtml_SelectString Pobiera lub ustawia tekst wyświetlany wpisu pola listy (na podstawie bieżącego indeksu) na stronie HTML.
CDHtmlDialog::DDX_DHtml_SelectValue Pobiera lub ustawia wartość wpisu pola listy (na podstawie bieżącego indeksu) na stronie HTML.
CDHtmlDialog::DestroyModeless Niszczy bez moderowe okno dialogowe.
CDHtmlDialog::EnableModeless Włącza moderowe okna dialogowe.
CDHtmlDialog::FilterDataObject Umożliwia okno dialogowe filtrowania obiektów danych schowka utworzonych przez hostowaną przeglądarkę.
CDHtmlDialog::GetControlDispatch IDispatch Pobiera interfejs w kontrolce ActiveX osadzonej w dokumencie HTML.
CDHtmlDialog::GetControlProperty Pobiera żądaną właściwość określonego formantu ActiveX.
CDHtmlDialog::GetCurrentUrl Pobiera ujednolicony lokalizator zasobów (URL) skojarzony z bieżącym dokumentem.
CDHtmlDialog::GetDHtmlDocument IHTMLDocument2 Pobiera interfejs aktualnie załadowanego dokumentu HTML.
CDHtmlDialog::GetDropTarget Wywoływana przez zawartą kontrolkę WebBrowser, gdy jest używana jako element docelowy upuszczania, aby umożliwić okno dialogowe podawania alternatywnego IDropTargetelementu .
CDHtmlDialog::GetElement Pobiera interfejs w elemecie HTML.
CDHtmlDialog::GetElementHtml innerHTML Pobiera właściwość elementu HTML.
CDHtmlDialog::GetElementInterface Pobiera żądany wskaźnik interfejsu z elementu HTML.
CDHtmlDialog::GetElementProperty Pobiera wartość właściwości elementu HTML.
CDHtmlDialog::GetElementText innerText Pobiera właściwość elementu HTML.
CDHtmlDialog::GetEvent IHTMLEventObj Pobiera wskaźnik do bieżącego obiektu zdarzenia.
CDHtmlDialog::GetExternal Pobiera interfejs hosta IDispatch .
CDHtmlDialog::GetHostInfo Pobiera możliwości interfejsu użytkownika hosta.
CDHtmlDialog::GetOptionKeyPath Pobiera klucz rejestru, w którym są przechowywane preferencje użytkownika.
CDHtmlDialog::HideUI Ukrywa interfejs użytkownika hosta.
CDHtmlDialog::IsExternalDispatchSafe Wskazuje, czy interfejs hosta IDispatch jest bezpieczny do obsługi skryptów.
CDHtmlDialog::LoadFromResource Ładuje określony zasób do kontrolki WebBrowser.
CDHtmlDialog::Navigate Przechodzi do określonego adresu URL.
CDHtmlDialog::OnBeforeNavigate Wywoływana przez strukturę przed wyzwoleniem zdarzenia nawigacji.
CDHtmlDialog::OnDocumentComplete Wywoływana przez platformę w celu powiadamiania aplikacji o osiągnięciu READYSTATE_COMPLETE stanu dokumentu.
CDHtmlDialog::OnDocWindowActivate Wywoływana przez platformę po aktywowaniu lub dezaktywowaniu okna dokumentu.
CDHtmlDialog::OnFrameWindowActivate Wywoływana przez platformę, gdy okno ramki jest aktywowane lub dezaktywowane.
CDHtmlDialog::OnInitDialog Wywołana w odpowiedzi na WM_INITDIALOG komunikat.
CDHtmlDialog::OnNavigateComplete Wywoływana przez platformę po zakończeniu zdarzenia nawigacji.
CDHtmlDialog::ResizeBorder Ostrzega obiekt, którego potrzebuje, aby zmienić rozmiar jego przestrzeni obramowania.
CDHtmlDialog::SetControlProperty Ustawia właściwość kontrolki ActiveX na nową wartość.
CDHtmlDialog::SetElementHtml innerHTML Ustawia właściwość elementu HTML.
CDHtmlDialog::SetElementProperty Ustawia właściwość elementu HTML.
CDHtmlDialog::SetElementText innerText Ustawia właściwość elementu HTML.
CDHtmlDialog::SetExternalDispatch Ustawia interfejs hosta IDispatch .
CDHtmlDialog::SetHostFlags Ustawia flagi interfejsu użytkownika hosta.
CDHtmlDialog::ShowContextMenu Wywoływana, gdy ma być wyświetlane menu kontekstowe.
CDHtmlDialog::ShowUI Pokazuje interfejs użytkownika hosta.
CDHtmlDialog::TranslateAccelerator Wywoływane w celu przetworzenia komunikatów skrótu-menu.
CDHtmlDialog::TranslateUrl Wywołano polecenie , aby zmodyfikować adres URL do załadowania.
CDHtmlDialog::UpdateUI Wywołano polecenie w celu powiadomienia hosta o zmianie stanu polecenia.

Publiczne elementy członkowskie danych

Nazwa/nazwisko opis
CDHtmlDialog::m_bUseHtmlTitle Wskazuje, czy tytuł dokumentu HTML ma być używany jako podpis okna dialogowego.
CDHtmlDialog::m_nHtmlResID Identyfikator zasobu HTML do wyświetlenia.
CDHtmlDialog::m_pBrowserApp Wskaźnik do aplikacji przeglądarki internetowej.
CDHtmlDialog::m_spHtmlDoc Wskaźnik do dokumentu HTML.
CDHtmlDialog::m_strCurrentUrl Bieżący adres URL.
CDHtmlDialog::m_szHtmlResID Wersja ciągu identyfikatora zasobu HTML.

Uwagi

CDHtmlDialog może załadować kod HTML, który ma być wyświetlany z zasobu HTML lub adresu URL.

CDHtmlDialog umożliwia również wymianę danych za pomocą kontrolek HTML i obsługę zdarzeń z kontrolek HTML, takich jak kliknięcia przycisków.

Hierarchia dziedziczenia

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Wymagania

Nagłówek: afxdhtml.h

DDX_DHtml Makra pomocnika

DDX_DHtml Makra pomocnicze umożliwiają łatwy dostęp do najczęściej używanych właściwości kontrolek na stronie HTML.

Makra wymiany danych

Nazwa/nazwisko opis
DDX_DHtml_ElementValue Ustawia lub pobiera właściwość Value z wybranej kontrolki.
DDX_DHtml_ElementInnerText Ustawia lub pobiera tekst między tagami początkowymi i końcowymi bieżącego elementu.
DDX_DHtml_ElementInnerHtml Ustawia lub pobiera kod HTML między tagami początkowymi i końcowymi bieżącego elementu.
DDX_DHtml_Anchor_Href Ustawia lub pobiera docelowy adres URL lub punkt zakotwiczenia.
DDX_DHtml_Anchor_Target Ustawia lub pobiera okno docelowe lub ramkę.
DDX_DHtml_Img_Src Ustawia lub pobiera nazwę obrazu lub klipu wideo w dokumencie.
DDX_DHtml_Frame_Src Ustawia lub pobiera adres URL skojarzonej ramki.
DDX_DHtml_IFrame_Src Ustawia lub pobiera adres URL skojarzonej ramki.

CDHtmlDialog::CanAccessExternal

Można zastąpić, który jest wywoływany jako kontrola dostępu, aby sprawdzić, czy obiekty skryptowe na załadowanej stronie mogą uzyskiwać dostęp do zewnętrznego wysyłania lokacji sterowania. Sprawdza, czy wysyłanie jest bezpieczne dla skryptów, lub bieżąca strefa zezwala na obiekty, które nie są bezpieczne dla skryptów.

virtual BOOL CanAccessExternal();

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

CDHtmlDialog::CDHtmlDialog

Tworzy dynamiczne okno dialogowe HTML oparte na zasobach.

CDHtmlDialog();

CDHtmlDialog(
    LPCTSTR lpszTemplateName,
    LPCTSTR szHtmlResID,
    CWnd *pParentWnd = NULL);

CDHtmlDialog(
    UINT nIDTemplate,
    UINT nHtmlResID = 0,
    CWnd *pParentWnd = NULL);

Parametry

lpszTemplateName
Ciąg o wartości null, który jest nazwą zasobu szablonu okna dialogowego.

szHtmlResID
Ciąg zakończony wartością null, który jest nazwą zasobu HTML.

pParentWnd
Wskaźnik do obiektu nadrzędnego lub obiektu okna właściciela (typu CWnd), do którego należy obiekt okna dialogowego. Jeśli jest to NULL, okno nadrzędne obiektu okna dialogowego jest ustawione na główne okno aplikacji.

nIDTemplate
Zawiera identyfikator zasobu szablonu okna dialogowego.

nHtmlResID
Zawiera identyfikator zasobu HTML.

Uwagi

Druga forma konstruktora zapewnia dostęp do zasobu okna dialogowego za pośrednictwem nazwy szablonu. Trzecia forma konstruktora zapewnia dostęp do zasobu okna dialogowego za pośrednictwem identyfikatora szablonu zasobu. Zazwyczaj identyfikator zaczyna się od prefiksu IDD_ .

CDHtmlDialog::~CDHtmlDialog

CDHtmlDialog Niszczy obiekt.

virtual ~CDHtmlDialog();

Uwagi

Funkcja CWnd::DestroyWindow składowa musi służyć do niszczenia bez moderowych okien dialogowych utworzonych przez CDialog::Createprogram .

CDHtmlDialog::CreateControlSite

Można zastąpić używane do tworzenia wystąpienia witryny sterowania do hostowania kontrolki WebBrowser w oknie dialogowym.

virtual BOOL CreateControlSite(
    COleControlContainer* pContainer,
    COleControlSite** ppSite,
    UINT /* nID */,
    REFCLSID /* clsid */);

Parametry

pContainer
Wskaźnik do COleControlContainer obiektu.

ppSite
Wskaźnik do wskaźnika na COleControlSite.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Tę funkcję składową można zastąpić, aby zwrócić wystąpienie własnej klasy lokacji sterowania.

CDHtmlDialog::DDX_DHtml_AxControl

Wymienia dane między zmienną składową a wartością właściwości kontrolki ActiveX na stronie HTML.

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość parametru identyfikatora tagu obiektu w źródle HTML dla kontrolki ActiveX.

dispId
Identyfikator wysyłania właściwości, za pomocą której chcesz wymieniać dane.

szPropName
Nazwa właściwości.

var
Element członkowski danych typu VARIANT, COleVariantlub CComVariant, który przechowuje wartość wymienianą za pomocą właściwości kontrolki ActiveX.

Przykład

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

Wymienia dane między zmienną składową a polem wyboru na stronie HTML.

void DDX_DHtml_CheckBox(
    CDataExchange* pDX,
    LPCTSTR szId,
    int& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru IDENTYFIKATORa kontrolki HTML.

value
Wymieniana wartość.

Przykład

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

Wymienia dane między zmienną składową a dowolną właściwością elementu HTML na stronie HTML.

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru IDENTYFIKATORa kontrolki HTML.

dispId
Identyfikator wysyłania elementu HTML, za pomocą którego chcesz wymieniać dane.

value
Wymieniana wartość.

CDHtmlDialog::DDX_DHtml_Radio

Wymienia dane między zmienną składową a przyciskiem radiowym na stronie HTML.

void DDX_DHtml_Radio(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru IDENTYFIKATORa kontrolki HTML.

value
Wymieniana wartość.

CDHtmlDialog::DDX_DHtml_SelectIndex

Pobiera lub ustawia indeks pola listy na stronie HTML.

void DDX_DHtml_SelectIndex(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru kontrolki id HTML.

value
Wymieniana wartość.

CDHtmlDialog::DDX_DHtml_SelectString

Pobiera lub ustawia tekst wyświetlany wpisu pola listy (na podstawie bieżącego indeksu) na stronie HTML.

void DDX_DHtml_SelectString(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru IDENTYFIKATORa kontrolki HTML.

value
Wymieniana wartość.

CDHtmlDialog::DDX_DHtml_SelectValue

Pobiera lub ustawia wartość wpisu pola listy (na podstawie bieżącego indeksu) na stronie HTML.

void DDX_DHtml_SelectValue(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parametry

pDX
Wskaźnik do CDataExchange obiektu.

szId
Wartość określona dla parametru IDENTYFIKATORa kontrolki HTML.

value
Wymieniana wartość.

Przykład

// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);

CDHtmlDialog::DestroyModeless

Odłącza moderowe okno dialogowe od CDHtmlDialog obiektu i niszczy obiekt.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Włącza moderowe okna dialogowe.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parametry

fEnable
Zobacz fEnable w IDocHostUIHandler::EnableModeless zestawie Windows SDK.

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::EnableModeless, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::FilterDataObject

Umożliwia okno dialogowe filtrowania obiektów danych schowka utworzonych przez hostowaną przeglądarkę.

STDMETHOD(FilterDataObject)(
    IDataObject* pDO,
    IDataObject** ppDORet);

Parametry

pDO
Zobacz pDO w IDocHostUIHandler::FilterDataObject zestawie Windows SDK.

ppDORet
Zobacz ppDORet w IDocHostUIHandler::FilterDataObject zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_FALSE.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::FilterDataObject, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::GetControlDispatch

IDispatch Pobiera interfejs w kontrolce ActiveX osadzonej w dokumencie HTML zwróconym przez GetDHtmlDocumentelement .

HRESULT GetControlDispatch(
    LPCTSTR szId,
    IDispatch** ppdisp);

Parametry

szId
Identyfikator HTML kontrolki ActiveX.

ppdisp
Interfejs IDispatch kontrolki, jeśli zostanie znaleziony na stronie sieci Web.

Wartość zwracana

Wartość standardowa HRESULT .

CDHtmlDialog::GetControlProperty

Pobiera żądaną właściwość określonego formantu ActiveX.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parametry

szId
Identyfikator HTML kontrolki ActiveX.

szPropName
Nazwa właściwości w domyślnych ustawieniach regionalnych bieżącego użytkownika.

pdispControl
Wskaźnik IDispatch kontrolki ActiveX.

dispId
Identyfikator wysyłania właściwości.

Wartość zwracana

Wariant zawierający żądaną właściwość lub pusty wariant, jeśli nie można odnaleźć kontrolki lub właściwości.

Uwagi

Przeciążenia są wymienione od co najmniej wydajne u góry do najbardziej wydajnych u dołu.

CDHtmlDialog::GetCurrentUrl

Pobiera ujednolicony lokalizator zasobów (URL) skojarzony z bieżącym dokumentem.

void GetCurrentUrl(CString& szUrl);

Parametry

szUrl
CString Obiekt zawierający adres URL do pobrania.

CDHtmlDialog::GetDHtmlDocument

IHTMLDocument2 Pobiera interfejs aktualnie załadowanego dokumentu HTML.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parametry

**pphtmlDoc Wskaźnik do wskaźnika do dokumentu HTML.

Wartość zwracana

HRESULTStandardowy . Zwraca wartość w przypadku powodzenia S_OK .

CDHtmlDialog::GetDropTarget

Wywoływana przez zawartą kontrolkę WebBrowser, gdy jest używana jako element docelowy upuszczania, aby umożliwić okno dialogowe podawania alternatywnego IDropTargetelementu .

STDMETHOD(GetDropTarget)(
    IDropTarget* pDropTarget,
    IDropTarget** ppDropTarget);

Parametry

pDropTarget
Zobacz pDropTarget w IDocHostUIHandler::GetDropTarget zestawie Windows SDK.

ppDropTarget
Zobacz ppDropTarget w IDocHostUIHandler::GetDropTarget zestawie Windows SDK.

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::GetDropTarget, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::GetElement

Zwraca interfejs w elemecie HTML określonym przez szElementId.

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

Parametry

szElementId
Identyfikator elementu HTML.

ppdisp
Wskaźnik IDispatch do żądanego elementu lub kolekcji elementów.

pbCollection
Element BOOL wskazujący, czy obiekt reprezentowany przez ppdisp element jest pojedynczym elementem, czy kolekcją elementów.

pphtmlElement
Wskaźnik IHTMLElement do żądanego elementu.

Wartość zwracana

Wartość standardowa HRESULT .

Uwagi

Użyj pierwszego przeciążenia, jeśli musisz obsłużyć warunki, w których może istnieć więcej niż jeden element o określonym identyfikatorze. Możesz użyć ostatniego parametru, aby dowiedzieć się, czy zwrócony wskaźnik interfejsu jest kolekcją, czy pojedynczym elementem. Jeśli wskaźnik interfejsu znajduje się w kolekcji, możesz wykonać zapytanie o IHTMLElementCollection właściwość i użyć jej item właściwości, aby odwołać się do elementów według położenia porządkowego.

Drugie przeciążenie zakończy się niepowodzeniem, jeśli na stronie znajduje się więcej niż jeden element o tym samym identyfikatorze.

CDHtmlDialog::GetElementHtml

innerHTML Pobiera właściwość elementu HTML zidentyfikowanego przez szElementIdelement .

BSTR GetElementHtml(LPCTSTR szElementId);

Parametry

szElementId
Identyfikator elementu HTML.

Wartość zwracana

Właściwość innerHTML elementu HTML zidentyfikowanego przez szElementId element lub NULL jeśli nie można odnaleźć elementu.

CDHtmlDialog::GetElementInterface

Pobiera żądany wskaźnik interfejsu z elementu HTML zidentyfikowanego przez szElementIdelement .

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

Parametry

szElementId
Identyfikator elementu HTML.

ppvObj
Adres wskaźnika, który zostanie wypełniony żądanym wskaźnikiem interfejsu, jeśli element zostanie znaleziony, a zapytanie powiedzie się.

refiid
Identyfikator interfejsu (IID) żądanego interfejsu.

Wartość zwracana

Wartość standardowa HRESULT .

Przykład

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Pobiera wartość właściwości zidentyfikowanej przez dispId element HTML zidentyfikowany przez szElementIdelement .

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parametry

szElementId
Identyfikator elementu HTML.

dispId
Identyfikator wysyłania właściwości.

Wartość zwracana

Wartość właściwości lub pusty wariant, jeśli nie można odnaleźć właściwości lub elementu.

CDHtmlDialog::GetElementText

innerText Pobiera właściwość elementu HTML zidentyfikowanego przez szElementIdelement .

BSTR GetElementText(LPCTSTR szElementId);

Parametry

szElementId
Identyfikator elementu HTML.

Wartość zwracana

Właściwość innerText elementu HTML zidentyfikowanego przez szElementId element lub NULL , jeśli nie można odnaleźć właściwości lub elementu.

CDHtmlDialog::GetEvent

IHTMLEventObj Zwraca wskaźnik do bieżącego obiektu zdarzenia.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parametry

ppEventObj
Adres wskaźnika, który zostanie wypełniony wskaźnikiem interfejsu IHTMLEventObj .

Wartość zwracana

Wartość standardowa HRESULT .

Uwagi

Ta funkcja powinna być wywoływana tylko z poziomu programu obsługi zdarzeń DHTML.

CDHtmlDialog::GetExternal

Pobiera interfejs hosta IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parametry

ppDispatch
Zobacz ppDispatch w IDocHostUIHandler::GetExternal zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_OK powodzenia lub E_NOTIMPL niepowodzenia.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::GetExternal, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::GetHostInfo

Pobiera możliwości interfejsu użytkownika hosta.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parametry

pInfo
Zobacz pInfo w IDocHostUIHandler::GetHostInfo zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_OK.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::GetHostInfo, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Pobiera klucz rejestru, w którym są przechowywane preferencje użytkownika.

STDMETHOD(GetOptionKeyPath)(
    LPOLESTR* pchKey,
    DWORD dw);

Parametry

pchKey
Zobacz pchKey w IDocHostUIHandler::GetOptionKeyPath zestawie Windows SDK.

dw
Zobacz dw w IDocHostUIHandler::GetOptionKeyPath zestawie Windows SDK.

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::GetOptionKeyPath, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::HideUI

Ukrywa interfejs użytkownika hosta.

STDMETHOD(HideUI)(void);

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::HideUI, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Wskazuje, czy interfejs hosta IDispatch jest bezpieczny do obsługi skryptów.

virtual BOOL IsExternalDispatchSafe();

Wartość zwracana

Zwraca wartość FALSE.

CDHtmlDialog::LoadFromResource

Ładuje określony zasób do kontrolki WebBrowser w oknie dialogowym DHTML.

BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);

Parametry

lpszResource
Wskaźnik do ciągu zawierającego nazwę zasobu do załadowania.

nRes
Identyfikator zasobu do załadowania.

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Wskazuje, czy tytuł dokumentu HTML ma być używany jako podpis okna dialogowego.

BOOL m_bUseHtmlTitle;

Uwagi

Jeśli m_bUseHtmlTitle parametr to TRUE, podpis okna dialogowego jest ustawiony na tytuł dokumentu HTML. W przeciwnym razie jest używany podpis w zasobie okna dialogowego.

CDHtmlDialog::m_nHtmlResID

Identyfikator zasobu HTML do wyświetlenia.

UINT m_nHtmlResID;

Przykład

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();

CDHtmlDialog::m_pBrowserApp

Wskaźnik do aplikacji przeglądarki internetowej.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Wskaźnik do dokumentu HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Bieżący adres URL.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Wersja ciągu identyfikatora zasobu HTML.

LPTSTR m_szHtmlResID;

Przykład

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
TCHAR szResID[] = _T("HTML_PAGE");
mydialog.m_szHtmlResID = szResID;
mydialog.DoModal();

Przechodzi do zasobu określonego przez adres URL określony przez lpszURLelement .

void Navigate(
    LPCTSTR lpszURL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

Parametry

lpszURL
Wskaźnik do ciągu zawierającego adres URL, który ma być docelowy.

dwFlags
Flagi zmiennej określającej, czy należy dodać zasób do listy historii, czy odczytywać do pamięci podręcznej, czy zapisywać z pamięci podręcznej oraz czy zasób ma być wyświetlany w nowym oknie. Zmienna może być kombinacją wartości zdefiniowanych przez BrowserNavConstants wyliczenie.

lpszTargetFrameName
Wskaźnik do ciągu, który zawiera nazwę ramki, w której ma być wyświetlany zasób.

lpszHeaders
Wskaźnik do wartości, która określa nagłówki HTTP do wysłania na serwer. Te nagłówki są dodawane do domyślnych nagłówków programu Internet Explorer. Nagłówki mogą określać takie informacje, jak akcja wymagana przez serwer, typ przekazywanych danych do serwera lub kod stanu. Ten parametr jest ignorowany, jeśli adres URL nie jest adresem URL PROTOKOŁU HTTP.

lpvPostData
Wskaźnik do danych do wysłania za pomocą transakcji HTTP POST. Na przykład transakcja POST służy do wysyłania danych zebranych przez formularz HTML. Jeśli ten parametr nie określi żadnych danych po wpisie, Navigate wystąpi problem z transakcją HTTP GET. Ten parametr jest ignorowany, jeśli adres URL nie jest adresem URL PROTOKOŁU HTTP.

dwPostDataLen
Dane do wysłania za pomocą transakcji HTTP POST. Na przykład transakcja POST służy do wysyłania danych zebranych przez formularz HTML. Jeśli ten parametr nie określi żadnych danych po wpisie, Navigate wystąpi problem z transakcją HTTP GET. Ten parametr jest ignorowany, jeśli adres URL nie jest adresem URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Wywoływana przez platformę w celu spowodowania wyzwolenia zdarzenia przed przejściem do nawigacji.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Wskaźnik do IDispatch obiektu.

szUrl
Wskaźnik do ciągu zawierającego adres URL do przejścia.

CDHtmlDialog::OnDocumentComplete

Wywoływana przez platformę w celu powiadamiania aplikacji o osiągnięciu READYSTATE_COMPLETE stanu dokumentu.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Wskaźnik do IDispatch obiektu.

szUrl
Wskaźnik do ciągu zawierającego adres URL, do którego został wyświetlony adres URL.

CDHtmlDialog::OnDocWindowActivate

Wywoływana przez platformę po aktywowaniu lub dezaktywowaniu okna dokumentu.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parametry

fActivate
Zobacz fActivate w IDocHostUIHandler::OnDocWindowActivate zestawie Windows SDK.

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::OnDocWindowActivate, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

Wywoływana przez platformę, gdy okno ramki jest aktywowane lub dezaktywowane.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parametry

fActivate
Zobacz fActivate w IDocHostUIHandler::OnFrameWindowActivate zestawie Windows SDK.

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::OnFrameWindowActivate, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::OnInitDialog

Wywołana w odpowiedzi na WM_INITDIALOG komunikat.

virtual BOOL OnInitDialog();

Wartość zwracana

Domyślna implementacja zwraca wartość TRUE.

Uwagi

Ten komunikat jest wysyłany do okna dialogowego podczas Createwywołań , CreateIndirectlub DoModal , które występują bezpośrednio przed wyświetleniem okna dialogowego.

Zastąpi tę funkcję składową, jeśli musisz wykonać specjalne przetwarzanie podczas inicjowania okna dialogowego. W przesłoniętej wersji najpierw wywołaj klasę OnInitDialog bazową, ale zignoruj jej wartość zwracaną. Zwykle będziesz zwracać TRUE z zastąpionej funkcji składowej.

System Windows wywołuje OnInitDialog funkcję za pomocą standardowej globalnej procedury okna dialogowego wspólnego dla wszystkich okien dialogowych biblioteki klas programu Microsoft Foundation, a nie za pośrednictwem mapy komunikatów, więc nie potrzebujesz wpisu mapy komunikatów dla tej funkcji składowej.

CDHtmlDialog::OnNavigateComplete

Wywoływana przez strukturę po zakończeniu nawigacji do określonego adresu URL.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Wskaźnik do IDispatch obiektu.

szUrl
Wskaźnik do ciągu zawierającego adres URL, do którego został wyświetlony adres URL.

CDHtmlDialog::ResizeBorder

Ostrzega obiekt, którego potrzebuje, aby zmienić rozmiar jego przestrzeni obramowania.

STDMETHOD(ResizeBorder)(
    LPCRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fRameWindow);

Parametry

prcBorder
Zobacz prcBorder w IDocHostUIHandler::ResizeBorder zestawie Windows SDK.

pUIWindow
Zobacz pUIWindow w IDocHostUIHandler::ResizeBorder zestawie Windows SDK.

fFrameWindow
Zobacz fFrameWindow w IDocHostUIHandler::ResizeBorder zestawie Windows SDK.

Wartość zwracana

Zwraca E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Ustawia właściwość kontrolki ActiveX na nową wartość.

void SetControlProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Parametry

szElementId
Identyfikator HTML kontrolki ActiveX.

dispId
Identyfikator wysyłania właściwości do ustawienia.

pVar
Wskaźnik do VARIANT wartości zawierającej nową właściwość.

pdispControl
Wskaźnik do interfejsu kontrolki IDispatch ActiveX.

szPropName
Ciąg zawierający nazwę właściwości do ustawienia.

CDHtmlDialog::SetElementHtml

innerHTML Ustawia właściwość elementu HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parametry

szElementId
Identyfikator elementu HTML.

bstrText
Nowa wartość innerHTML właściwości.

punkElem
Wskaźnik IUnknown elementu HTML.

CDHtmlDialog::SetElementProperty

Ustawia właściwość elementu HTML.

void SetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

Parametry

szElementId
Identyfikator elementu HTML.

dispId
Identyfikator wysyłania właściwości do ustawienia.

pVar
Nowa wartość właściwości.

CDHtmlDialog::SetElementText

innerText Ustawia właściwość elementu HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parametry

szElementId
Identyfikator elementu HTML.

bstrText
Nowa wartość innerText właściwości.

punkElem
Wskaźnik IUnknown elementu HTML.

CDHtmlDialog::SetExternalDispatch

Ustawia interfejs hosta IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Parametry

pdispExternal
Nowy IDispatch interfejs.

CDHtmlDialog::SetHostFlags

Ustawia flagi interfejsu użytkownika hosta.

void SetHostFlags(DWORD dwFlags);

Parametry

dwFlags
Aby uzyskać możliwe wartości, zobacz DOCHOSTUIFLAG w zestawie Windows SDK.

CDHtmlDialog::ShowContextMenu

Wywoływana, gdy ma być wyświetlane menu kontekstowe.

STDMETHOD(ShowContextMenu)(
    DWORD dwID,
    POINT* ppt,
    IUnknown* pcmdtReserved,
    IDispatch* pdispReserved);

Parametry

dwID
Zobacz dwID w IDocHostUIHandler::ShowContextMenu zestawie Windows SDK.

ppt
Zobacz ppt w IDocHostUIHandler::ShowContextMenu zestawie Windows SDK.

pcmdtReserved
Zobacz pcmdtReserved w IDocHostUIHandler::ShowContextMenu zestawie Windows SDK.

pdispReserved
Zobacz pdispReserved w IDocHostUIHandler::ShowContextMenu zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_FALSE.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::ShowContextMenu, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::ShowUI

Pokazuje interfejs użytkownika hosta.

STDMETHOD(ShowUI)(
    DWORD dwID,
    IOleInPlaceActiveObject* pActiveObject,
    IOleCommandTarget* pCommandTarget,
    IOleInPlaceFrame* pFrame,
    IOleInPlaceUIWindow* pDoc);

Parametry

dwID
Zobacz dwID w IDocHostUIHandler::ShowUI zestawie Windows SDK.

pActiveObject
Zobacz pActiveObject w IDocHostUIHandler::ShowUI zestawie Windows SDK.

pCommandTarget
Zobacz pCommandTarget w IDocHostUIHandler::ShowUI zestawie Windows SDK.

pFrame
Zobacz pFrame w IDocHostUIHandler::ShowUI zestawie Windows SDK.

pDoc
Zobacz pDoc w IDocHostUIHandler::ShowUI zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_FALSE.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::ShowUI, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::TranslateAccelerator

Wywoływane w celu przetworzenia komunikatów skrótu-menu.

STDMETHOD(TranslateAccelerator)(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Parametry

lpMsg
Zobacz lpMsg w IDocHostUIHandler::TranslateAccelerator zestawie Windows SDK.

pguidCmdGroup
Zobacz pguidCmdGroup w IDocHostUIHandler::TranslateAccelerator zestawie Windows SDK.

nCmdID
Zobacz nCmdID w IDocHostUIHandler::TranslateAccelerator zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_FALSE.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::TranslateAccelerator, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::TranslateUrl

Wywołano polecenie , aby zmodyfikować adres URL do załadowania.

STDMETHOD(TranslateUrl)(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Parametry

dwTranslate
Zobacz dwTranslate w IDocHostUIHandler::TranslateUrl zestawie Windows SDK.

pchURLIn
Zobacz pchURLIn w IDocHostUIHandler::TranslateUrl zestawie Windows SDK.

ppchURLOut
Zobacz ppchURLOut w IDocHostUIHandler::TranslateUrl zestawie Windows SDK.

Wartość zwracana

Zwraca wartość S_FALSE.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::TranslateUrl, zgodnie z opisem w zestawie Windows SDK.

CDHtmlDialog::UpdateUI

Wywołano polecenie w celu powiadomienia hosta o zmianie stanu polecenia.

STDMETHOD(UpdateUI)(void);

Wartość zwracana

Zwraca wartość E_NOTIMPL.

Uwagi

Ta funkcja składowa jest implementacją CDHtmlDialog elementu IDocHostUIHandler::UpdateUI, zgodnie z opisem w zestawie Windows SDK.

Zobacz też

Przykład MFC DHtmlExplore
DDX_DHtml Makra pomocnika
Wykres hierarchii