CDHtmlDialog Sınıf

Kullanıcı arabirimini uygulamak için iletişim kutusu kaynakları yerine HTML kullanan iletişim kutuları oluşturmak için kullanılır.

Sözdizimi

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CDHtmlDialog::CDHtmlDialog	CDHtmlDialog nesnesi oluşturur.
CDHtmlDialog::~CDHtmlDialog	CDHtmlDialog nesnesini yok eder.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CDHtmlDialog::CanAccessExternal	Yüklenen sayfadaki betik oluşturma nesnelerinin denetim sitesinin dış gönderimine erişip erişemeyeceğini görmek için erişim denetimi olarak çağrılan geçersiz kılınabilir. Gönderme işleminin betik için güvenli olduğundan veya geçerli bölgenin betik oluşturma için güvenli olmayan nesnelere izin verdiğinden emin olmak için denetler.
CDHtmlDialog::CreateControlSite	İletişim kutusunda WebBrowser denetimini barındırmak üzere bir denetim sitesi örneği oluşturmak için geçersiz kılınabilir.
CDHtmlDialog::DDX_DHtml_AxControl	Bir üye değişkeni ile HTML sayfasındaki ActiveX denetiminin özellik değeri arasında veri alışverişi sağlar.
CDHtmlDialog::DDX_DHtml_CheckBox	Html sayfasındaki bir üye değişkeniyle onay kutusu arasında veri alışverişi sağlar.
CDHtmlDialog::DDX_DHtml_ElementText	Verileri bir üye değişkeniyle HTML sayfasındaki herhangi bir HTML öğesi özelliği arasında değiştirir.
CDHtmlDialog::DDX_DHtml_Radio	Html sayfasındaki bir üye değişkeniyle radyo düğmesi arasında veri alışverişi sağlar.
CDHtmlDialog::DDX_DHtml_SelectIndex	BIR HTML sayfasındaki liste kutusunun dizinini alır veya ayarlar.
CDHtmlDialog::DDX_DHtml_SelectString	BIR HTML sayfasındaki liste kutusu girdisinin görünen metnini (geçerli dizine göre) alır veya ayarlar.
CDHtmlDialog::DDX_DHtml_SelectValue	BIR HTML sayfasındaki liste kutusu girdisinin değerini (geçerli dizine göre) alır veya ayarlar.
CDHtmlDialog::DestroyModeless	Modsuz bir iletişim kutusunu yok eder.
CDHtmlDialog::EnableModeless	Modeless iletişim kutularını etkinleştirir.
CDHtmlDialog::FilterDataObject	İletişim kutusunun barındırılan tarayıcı tarafından oluşturulan pano veri nesnelerini filtrelemesine izin verir.
CDHtmlDialog::GetControlDispatch	HTML belgesine IDispatch eklenmiş bir ActiveX denetimindeki arabirimi alır.
CDHtmlDialog::GetControlProperty	Belirtilen ActiveX denetiminin istenen özelliğini alır.
CDHtmlDialog::GetCurrentUrl	Geçerli belgeyle ilişkili Tekdüzen Kaynak Konum Belirleyicisi'ni (URL) alır.
CDHtmlDialog::GetDHtmlDocument	IHTMLDocument2 Şu anda yüklü olan HTML belgesinde arabirimi alır.
CDHtmlDialog::GetDropTarget	İletişim kutusunun alternatif IDropTargetbir sağlamasını sağlamak için bırakma hedefi olarak kullanıldığında, kapsanan WebBrowser denetimi tarafından çağrılır.
CDHtmlDialog::GetElement	HTML öğesinde bir arabirim alır.
CDHtmlDialog::GetElementHtml	innerHTML BIR HTML öğesinin özelliğini alır.
CDHtmlDialog::GetElementInterface	İstenen arabirim işaretçisini bir HTML öğesinden alır.
CDHtmlDialog::GetElementProperty	Html öğesinin özelliğinin değerini alır.
CDHtmlDialog::GetElementText	innerText BIR HTML öğesinin özelliğini alır.
CDHtmlDialog::GetEvent	İşaretçiyi IHTMLEventObj geçerli olay nesnesine alır.
CDHtmlDialog::GetExternal	Konağın arabirimini IDispatch alır.
CDHtmlDialog::GetHostInfo	Konağın kullanıcı arabirimi özelliklerini alır.
CDHtmlDialog::GetOptionKeyPath	Kullanıcı tercihlerinin depolandığı kayıt defteri anahtarını alır.
CDHtmlDialog::HideUI	Konağın kullanıcı arabirimini gizler.
CDHtmlDialog::IsExternalDispatchSafe	Konağın IDispatch arabiriminin betik oluşturma için güvenli olup olmadığını gösterir.
CDHtmlDialog::LoadFromResource	Belirtilen kaynağı WebBrowser denetimine yükler.
CDHtmlDialog::Navigate	Belirtilen URL'ye gider.
CDHtmlDialog::OnBeforeNavigate	Bir gezinti olayı tetiklenmeden önce çerçeve tarafından çağrılır.
CDHtmlDialog::OnDocumentComplete	Bir belgenin durumuna ulaşıldığında bir uygulamayı bilgilendirmek için çerçeve tarafından çağrılır READYSTATE_COMPLETE .
CDHtmlDialog::OnDocWindowActivate	Belge penceresi etkinleştirildiğinde veya devre dışı bırakıldığında çerçeve tarafından çağrılır.
CDHtmlDialog::OnFrameWindowActivate	Çerçeve penceresi etkinleştirildiğinde veya devre dışı bırakıldığında çerçeve tarafından çağrılır.
CDHtmlDialog::OnInitDialog	İletiye yanıt olarak WM_INITDIALOG çağrıldı.
CDHtmlDialog::OnNavigateComplete	Bir gezinti olayı tamamlandıktan sonra çerçeve tarafından çağrılır.
CDHtmlDialog::ResizeBorder	Nesneyi, kenarlık alanını yeniden boyutlandırmak için gerekli olduğu konusunda uyarır.
CDHtmlDialog::SetControlProperty	ActiveX denetiminin özelliğini yeni bir değere ayarlar.
CDHtmlDialog::SetElementHtml	HTML öğesinin innerHTML özelliğini ayarlar.
CDHtmlDialog::SetElementProperty	BIR HTML öğesinin özelliğini ayarlar.
CDHtmlDialog::SetElementText	HTML öğesinin innerText özelliğini ayarlar.
CDHtmlDialog::SetExternalDispatch	Konağın arabirimini IDispatch ayarlar.
CDHtmlDialog::SetHostFlags	Konağın kullanıcı arabirimi bayraklarını ayarlar.
CDHtmlDialog::ShowContextMenu	Bağlam menüsü görüntülenmek üzereyken çağrılır.
CDHtmlDialog::ShowUI	Konağın kullanıcı arabirimini gösterir.
CDHtmlDialog::TranslateAccelerator	Menü hızlandırıcısı-anahtar iletilerini işlemek için çağrılır.
CDHtmlDialog::TranslateUrl	Yüklenecek URL'yi değiştirmek için çağrıldı.
CDHtmlDialog::UpdateUI	Komut durumunun değiştiğini konağa bildirmek için çağrıldı.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
CDHtmlDialog::m_bUseHtmlTitle	html belgesinin başlığının iletişim kutusu başlığı olarak kullanılıp kullanılmayacağını gösterir.
CDHtmlDialog::m_nHtmlResID	Görüntülenecek HTML kaynağının kaynak kimliği.
CDHtmlDialog::m_pBrowserApp	Web tarayıcısı uygulamasının işaretçisi.
CDHtmlDialog::m_spHtmlDoc	HTML belgesinin işaretçisi.
CDHtmlDialog::m_strCurrentUrl	Geçerli URL.
CDHtmlDialog::m_szHtmlResID	HTML kaynak kimliğinin dize sürümü.

Açıklamalar

CDHtmlDialog bir HTML kaynağından veya URL'den görüntülenecek HTML'yi yükleyebilir.

CDHtmlDialog ayrıca HTML denetimleriyle veri alışverişi yapabilir ve düğme tıklamaları gibi HTML denetimlerinden gelen olayları işleyebilir.

Devralma Hiyerarşisi

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Gereksinimler

Üstbilgi: afxdhtml.h

DDX_DHtml Yardımcı Makrolar

DDX_DHtml Yardımcı makrolar, HTML sayfasındaki denetimlerin yaygın olarak kullanılan özelliklerine kolay erişim sağlar.

Veri Değişimi Makroları

Veri Akışı Adı	Açıklama
DDX_DHtml_ElementValue	Seçili denetimden Value özelliğini ayarlar veya alır.
DDX_DHtml_ElementInnerText	Geçerli öğenin başlangıç ve bitiş etiketleri arasındaki metni ayarlar veya alır.
DDX_DHtml_ElementInnerHtml	Geçerli öğenin başlangıç ve bitiş etiketleri arasındaki HTML'yi ayarlar veya alır.
DDX_DHtml_Anchor_Href	Hedef URL'yi veya bağlantı noktasını ayarlar veya alır.
DDX_DHtml_Anchor_Target	Hedef pencereyi veya çerçeveyi ayarlar veya alır.
DDX_DHtml_Img_Src	Belgedeki bir resmin veya video klibin adını ayarlar veya alır.
DDX_DHtml_Frame_Src	İlişkili çerçevenin URL'sini ayarlar veya alır.
DDX_DHtml_IFrame_Src	İlişkili çerçevenin URL'sini ayarlar veya alır.

CDHtmlDialog::CanAccessExternal

Yüklenen sayfadaki betik oluşturma nesnelerinin denetim sitesinin dış gönderimine erişip erişemeyeceğini görmek için erişim denetimi olarak çağrılan geçersiz kılınabilir. Gönderme işleminin betik için güvenli olduğundan veya geçerli bölgenin betik oluşturma için güvenli olmayan nesnelere izin verdiğinden emin olmak için denetler.

virtual BOOL CanAccessExternal();

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CDHtmlDialog::CDHtmlDialog

Kaynak tabanlı dinamik HTML iletişim kutusu oluşturur.

CDHtmlDialog();

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

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

Parametreler

lpszTemplateName
bir iletişim kutusu şablon kaynağının adı olan null ile sonlandırılan dize.

szHtmlResID
BIR HTML kaynağının adı olan null ile sonlandırılan dize.

pParentWnd
İletişim kutusu nesnesinin ait olduğu üst veya sahip pencere nesnesine (türünde CWnd) yönelik bir işaretçi. ise NULL, iletişim kutusu nesnesinin üst penceresi ana uygulama penceresine ayarlanır.

nIDTemplate
İletişim kutusu şablonu kaynağının kimlik numarasını içerir.

nHtmlResID
BIR HTML kaynağının kimlik numarasını içerir.

Açıklamalar

Oluşturucunun ikinci biçimi, şablon adı aracılığıyla iletişim kutusu kaynağına erişim sağlar. Oluşturucunun üçüncü biçimi, kaynak şablonunun kimliği aracılığıyla iletişim kutusu kaynağına erişim sağlar. Genellikle kimlik ön ekiyle IDD_ başlar.

CDHtmlDialog::~CDHtmlDialog

Bir CDHtmlDialog nesneyi yok eder.

virtual ~CDHtmlDialog();

Açıklamalar

CWnd::DestroyWindow üye işlevi tarafından CDialog::Createoluşturulan modsuz iletişim kutularını yok etmek için kullanılmalıdır.

CDHtmlDialog::CreateControlSite

İletişim kutusunda WebBrowser denetimini barındırmak üzere bir denetim sitesi örneği oluşturmak için geçersiz kılınabilir.

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

Parametreler

pContainer
Nesnenin işaretçisi COleControlContainer .

ppSite
işaretçisine işaret eden bir COleControlSiteişaretçi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Kendi denetim site sınıfınızın bir örneğini döndürmek için bu üye işlevini geçersiz kılabilirsiniz.

CDHtmlDialog::DDX_DHtml_AxControl

Bir üye değişkeni ile HTML sayfasındaki ActiveX denetiminin özellik değeri arasında veri alışverişi sağlar.

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

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
ActiveX denetiminin HTML kaynağındaki nesne etiketinin ID parametresinin değeri.

dispId
Veri alışverişi yapmak istediğiniz özelliğin dağıtım kimliği.

szPropName
Özelliğin adı.

var
ActiveX denetim özelliğiyle değiştirilen değeri tutan , COleVariantveya CComVarianttüründe VARIANTveri üyesi.

Örnek

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

CDHtmlDialog::DDX_DHtml_CheckBox

Html sayfasındaki bir üye değişkeniyle onay kutusu arasında veri alışverişi sağlar.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin ID parametresi için belirttiğiniz değer.

value
Değiş tokuş edilen değer.

Örnek

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

CDHtmlDialog::DDX_DHtml_ElementText

Verileri bir üye değişkeniyle HTML sayfasındaki herhangi bir HTML öğesi özelliği arasında değiştirir.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin ID parametresi için belirttiğiniz değer.

dispId
Veri alışverişi yapmak istediğiniz HTML öğesinin dağıtım kimliği.

value
Değiş tokuş edilen değer.

CDHtmlDialog::DDX_DHtml_Radio

Html sayfasındaki bir üye değişkeniyle radyo düğmesi arasında veri alışverişi sağlar.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin ID parametresi için belirttiğiniz değer.

value
Değiş tokuş edilen değer.

CDHtmlDialog::DDX_DHtml_SelectIndex

BIR HTML sayfasındaki liste kutusunun dizinini alır veya ayarlar.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin id parametresi için belirttiğiniz değer.

value
Değiş tokuş edilen değer.

CDHtmlDialog::DDX_DHtml_SelectString

BIR HTML sayfasındaki liste kutusu girdisinin görünen metnini (geçerli dizine göre) alır veya ayarlar.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin ID parametresi için belirttiğiniz değer.

value
Değiş tokuş edilen değer.

CDHtmlDialog::DDX_DHtml_SelectValue

BIR HTML sayfasındaki liste kutusu girdisinin değerini (geçerli dizine göre) alır veya ayarlar.

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

Parametreler

pDX
Nesne işaretçisi CDataExchange .

szId
HTML denetiminin ID parametresi için belirttiğiniz değer.

value
Değiş tokuş edilen değer.

Örnek

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

CDHtmlDialog::DestroyModeless

Nesneden CDHtmlDialog modsuz bir iletişim kutusunu ayırır ve nesneyi yok eder.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Modeless iletişim kutularını etkinleştirir.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parametreler

fEnable
Windows SDK'sında IDocHostUIHandler::EnableModeless bölümüne bakınfEnable.

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::EnableModeless.

CDHtmlDialog::FilterDataObject

İletişim kutusunun barındırılan tarayıcı tarafından oluşturulan pano veri nesnelerini filtrelemesine izin verir.

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

Parametreler

pDO
Windows SDK'sında IDocHostUIHandler::FilterDataObject bölümüne bakınpDO.

ppDORet
Windows SDK'sında IDocHostUIHandler::FilterDataObject bölümüne bakınppDORet.

Dönüş Değeri

S_FALSE döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::FilterDataObject.

CDHtmlDialog::GetControlDispatch

tarafından GetDHtmlDocumentdöndürülen HTML belgesine IDispatch katıştırılmış bir ActiveX denetimindeki arabirimi alır.

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

Parametreler

szId
ActiveX denetiminin HTML Kimliği.

ppdisp
IDispatch Web sayfasında bulunursa denetimin arabirimi.

Dönüş Değeri

Standart HRESULT bir değer.

CDHtmlDialog::GetControlProperty

Belirtilen ActiveX denetiminin istenen özelliğini alır.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parametreler

szId
ActiveX denetiminin HTML Kimliği.

szPropName
Geçerli kullanıcının varsayılan yerel ayarındaki bir özelliğin adı.

pdispControl
IDispatch ActiveX denetiminin işaretçisi.

dispId
Bir özelliğin dağıtım kimliği.

Dönüş Değeri

denetim veya özellik bulunamadığında istenen özelliği içeren bir değişken veya boş bir değişken.

Açıklamalar

Aşırı yüklemeler en üstteki en verimliden en alttaki en verimliye doğru listelenir.

CDHtmlDialog::GetCurrentUrl

Geçerli belgeyle ilişkili Tekdüzen Kaynak Konum Belirleyicisi'ni (URL) alır.

void GetCurrentUrl(CString& szUrl);

Parametreler

szUrl
CString Alınacak URL'yi içeren bir nesne.

CDHtmlDialog::GetDHtmlDocument

IHTMLDocument2 Şu anda yüklü olan HTML belgesinde arabirimi alır.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parametreler

**pphtmlDoc HTML belgesi işaretçisi işaretçisi.

Dönüş Değeri

Standart HRESULTbir . Başarılı olursa döndürür S_OK .

CDHtmlDialog::GetDropTarget

İletişim kutusunun alternatif IDropTargetbir sağlamasını sağlamak için bırakma hedefi olarak kullanıldığında, kapsanan WebBrowser denetimi tarafından çağrılır.

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

Parametreler

pDropTarget
Windows SDK'sında IDocHostUIHandler::GetDropTarget bölümüne bakınpDropTarget.

ppDropTarget
Windows SDK'sında IDocHostUIHandler::GetDropTarget bölümüne bakınppDropTarget.

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::GetDropTarget.

CDHtmlDialog::GetElement

tarafından szElementIdbelirtilen HTML öğesinde bir arabirim döndürür.

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

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

Parametreler

szElementId
HTML öğesinin kimliği.

ppdisp
IDispatch İstenen öğeye veya öğe koleksiyonuna yönelik bir işaretçi.

pbCollection
BOOL ile ppdisp temsil edilen nesnenin tek bir öğe mi yoksa öğe koleksiyonu mu olduğunu belirten bir.

pphtmlElement
IHTMLElement İstenen öğeye yönelik bir işaretçi.

Dönüş Değeri

Standart HRESULT bir değer.

Açıklamalar

Belirtilen kimlikle birden fazla öğenin bulunabileceği koşulları işlemeniz gerekiyorsa ilk aşırı yüklemeyi kullanın. Döndürülen arabirim işaretçisinin bir koleksiyona mı yoksa tek bir öğeye mi ait olduğunu öğrenmek için son parametreyi kullanabilirsiniz. Arabirim işaretçisi bir koleksiyondaysa öğesini sorgulayabilir ve öğelerini sıralı konuma göre başvurmak için IHTMLElementCollection özelliğini kullanabilirsiniz item .

Sayfada aynı kimliğe sahip birden fazla öğe varsa ikinci aşırı yükleme başarısız olur.

CDHtmlDialog::GetElementHtml

innerHTML tarafından szElementIdtanımlanan HTML öğesinin özelliğini alır.

BSTR GetElementHtml(LPCTSTR szElementId);

Parametreler

szElementId
HTML öğesinin kimliği.

Dönüş Değeri

innerHTML veya öğesinin bulunup bulunmadığı tarafından szElementId NULL tanımlanan HTML öğesinin özelliği.

CDHtmlDialog::GetElementInterface

tarafından szElementIdtanımlanan HTML öğesinden istenen arabirim işaretçisini alır.

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

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

Parametreler

szElementId
HTML öğesinin kimliği.

ppvObj
Öğe bulunursa ve sorgu başarılı olursa istenen arabirim işaretçisiyle doldurulacak bir işaretçinin adresi.

refiid
İstenen arabirimin arabirim kimliği (IID).

Dönüş Değeri

Standart HRESULT bir değer.

Örnek

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

tarafından dispId tanımlanan özelliğin değerini tarafından szElementIdtanımlanan HTML öğesinden alır.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parametreler

szElementId
HTML öğesinin kimliği.

dispId
Bir özelliğin dağıtım kimliği.

Dönüş Değeri

Özellik veya öğe bulunamadığında özelliğin veya boş bir değişkenin değeri.

CDHtmlDialog::GetElementText

innerText tarafından szElementIdtanımlanan HTML öğesinin özelliğini alır.

BSTR GetElementText(LPCTSTR szElementId);

Parametreler

szElementId
HTML öğesinin kimliği.

Dönüş Değeri

innerText özelliği veya öğesi bulunamadığında veya NULL tarafından szElementId tanımlanan HTML öğesinin özelliği.

CDHtmlDialog::GetEvent

İşaretçiyi IHTMLEventObj geçerli olay nesnesine döndürür.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parametreler

ppEventObj
Arabirim işaretçisiyle doldurulacak bir işaretçinin IHTMLEventObj adresi.

Dönüş Değeri

Standart HRESULT bir değer.

Açıklamalar

Bu işlev yalnızca DHTML olay işleyicisi içinden çağrılmalıdır.

CDHtmlDialog::GetExternal

Konağın arabirimini IDispatch alır.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parametreler

ppDispatch
Windows SDK'sında IDocHostUIHandler::GetExternal bölümüne bakınppDispatch.

Dönüş Değeri

Başarılı veya E_NOTIMPL başarısız olduğunda döndürürS_OK.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::GetExternal.

CDHtmlDialog::GetHostInfo

Konağın kullanıcı arabirimi özelliklerini alır.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parametreler

pInfo
Windows SDK'sında IDocHostUIHandler::GetHostInfo bölümüne bakınpInfo.

Dönüş Değeri

S_OK döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::GetHostInfo.

CDHtmlDialog::GetOptionKeyPath

Kullanıcı tercihlerinin depolandığı kayıt defteri anahtarını alır.

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

Parametreler

pchKey
Windows SDK'sında IDocHostUIHandler::GetOptionKeyPath bölümüne bakınpchKey.

dw
Windows SDK'sında IDocHostUIHandler::GetOptionKeyPath bölümüne bakındw.

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::GetOptionKeyPath.

CDHtmlDialog::HideUI

Konağın kullanıcı arabirimini gizler.

STDMETHOD(HideUI)(void);

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::HideUI.

CDHtmlDialog::IsExternalDispatchSafe

Konağın IDispatch arabiriminin betik oluşturma için güvenli olup olmadığını gösterir.

virtual BOOL IsExternalDispatchSafe();

Dönüş Değeri

FALSE döndürür.

CDHtmlDialog::LoadFromResource

Belirtilen kaynağı DHTML iletişim kutusundaki WebBrowser denetimine yükler.

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

Parametreler

lpszResource
Yüklenecek kaynağın adını içeren bir dize işaretçisi.

nRes
Yüklenecek kaynağın kimliği.

Dönüş Değeri

TRUE başarılı olursa; aksi takdirde FALSE.

CDHtmlDialog::m_bUseHtmlTitle

html belgesinin başlığının iletişim kutusu başlığı olarak kullanılıp kullanılmayacağını gösterir.

BOOL m_bUseHtmlTitle;

Açıklamalar

ise m_bUseHtmlTitle TRUE, iletişim kutusu resim yazısı HTML belgesinin başlığına eşit olarak ayarlanır; aksi takdirde, iletişim kutusu kaynağındaki resim yazısı kullanılır.

CDHtmlDialog::m_nHtmlResID

Görüntülenecek HTML kaynağının kaynak kimliği.

UINT m_nHtmlResID;

Örnek

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

CDHtmlDialog::m_pBrowserApp

Web tarayıcısı uygulamasının işaretçisi.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

HTML belgesinin işaretçisi.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Geçerli URL.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

HTML kaynak kimliğinin dize sürümü.

LPTSTR m_szHtmlResID;

Örnek

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

CDHtmlDialog::Navigate

tarafından lpszURLbelirtilen URL ile tanımlanan kaynağa gider.

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

Parametreler

lpszURL
Hedeflenecek URL'yi içeren bir dize işaretçisi.

dwFlags
Kaynağın geçmiş listesine eklenip eklenmeyeceğini, önbelleğe okunup okunmayacağını veya önbellekten yazılıp yazılmayacağını ve kaynağın yeni bir pencerede görüntülenip görüntülenmeyeceğini belirten bir değişkenin bayrakları. değişken, numaralandırma tarafından tanımlanan değerlerin BrowserNavConstants bir bileşimi olabilir.

lpszTargetFrameName
Kaynağın görüntüleneceği çerçevenin adını içeren bir dize işaretçisi.

lpszHeaders
Sunucuya gönderilecek HTTP üst bilgilerini belirten bir değer işaretçisi. Bu üst bilgiler varsayılan Internet Explorer üst bilgilerine eklenir. Üst bilgiler, sunucunun gerektirdiği eylem, sunucuya iletilen veri türü veya durum kodu gibi bilgileri belirtebilir. URL bir HTTP URL'si değilse bu parametre yoksayılır.

lpvPostData
HTTP POST işlemiyle gönderilecek verilere ilişkin bir işaretçi. Örneğin, POST işlemi bir HTML formu tarafından toplanan verileri göndermek için kullanılır. Bu parametre herhangi bir post veri belirtmezse bir Navigate HTTP GET işlemi yayınlar. URL bir HTTP URL'si değilse bu parametre yoksayılır.

dwPostDataLen
HTTP POST işlemiyle gönderilecek veriler. Örneğin, POST işlemi bir HTML formu tarafından toplanan verileri göndermek için kullanılır. Bu parametre herhangi bir post veri belirtmezse bir Navigate HTTP GET işlemi yayınlar. URL bir HTTP URL'si değilse bu parametre yoksayılır.

CDHtmlDialog::OnBeforeNavigate

Bir gezinti gerçekleşmeden önce bir olayın tetiklenmelerine neden olmak için çerçeve tarafından çağrılır.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametreler

pDisp
Nesne işaretçisi IDispatch .

szUrl
Gidilmesi gereken URL'yi içeren bir dize işaretçisi.

CDHtmlDialog::OnDocumentComplete

Bir belgenin durumuna ulaştığı zaman bir uygulamayı bilgilendirmek için çerçeve tarafından çağrılır READYSTATE_COMPLETE .

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametreler

pDisp
Nesne işaretçisi IDispatch .

szUrl
Gidilen URL'yi içeren bir dize işaretçisi.

CDHtmlDialog::OnDocWindowActivate

Belge penceresi etkinleştirildiğinde veya devre dışı bırakıldığında çerçeve tarafından çağrılır.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parametreler

fActivate
Windows SDK'sında IDocHostUIHandler::OnDocWindowActivate bölümüne bakınfActivate.

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::OnDocWindowActivate.

CDHtmlDialog::OnFrameWindowActivate

Çerçeve penceresi etkinleştirildiğinde veya devre dışı bırakıldığında çerçeve tarafından çağrılır.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parametreler

fActivate
Windows SDK'sında IDocHostUIHandler::OnFrameWindowActivate bölümüne bakınfActivate.

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::OnFrameWindowActivate.

CDHtmlDialog::OnInitDialog

İletiye yanıt olarak WM_INITDIALOG çağrıldı.

virtual BOOL OnInitDialog();

Dönüş Değeri

Varsayılan uygulama döndürür TRUE.

Açıklamalar

Bu ileti, iletişim kutusu görüntülenmeden hemen önce gerçekleşen , CreateIndirectveya DoModal çağrıları sırasında Createiletişim kutusuna gönderilir.

İletişim kutusu başlatıldığında özel işlem yapmanız gerekiyorsa bu üye işlevini geçersiz kılın. Geçersiz kılınan sürümde, önce temel sınıfı OnInitDialog çağırın, ancak dönüş değerini göz ardı edin. Normalde geçersiz kılınan üye işlevinizden geri dönersiniz TRUE .

Windows, işlevi ileti eşlemeniz yerine tüm Microsoft Foundation Sınıf Kitaplığı iletişim kutuları için ortak olan standart genel iletişim kutusu yordamı aracılığıyla çağırır OnInitDialog , bu nedenle bu üye işlevi için bir ileti eşlemesi girdisine ihtiyacınız yoktur.

CDHtmlDialog::OnNavigateComplete

Belirtilen URL'ye gezinti tamamlandıktan sonra çerçeve tarafından çağrılır.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametreler

pDisp
Nesne işaretçisi IDispatch .

szUrl
Gidilen URL'yi içeren bir dize işaretçisi.

CDHtmlDialog::ResizeBorder

Nesneyi, kenarlık alanını yeniden boyutlandırmak için gerekli olduğu konusunda uyarır.

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

Parametreler

prcBorder
Windows SDK'sında IDocHostUIHandler::ResizeBorder bölümüne bakınprcBorder.

pUIWindow
Windows SDK'sında IDocHostUIHandler::ResizeBorder bölümüne bakınpUIWindow.

fFrameWindow
Windows SDK'sında IDocHostUIHandler::ResizeBorder bölümüne bakınfFrameWindow.

Dönüş Değeri

E_NOTIMPL döndürür.

CDHtmlDialog::SetControlProperty

ActiveX denetiminin özelliğini yeni bir değere ayarlar.

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

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

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

Parametreler

szElementId
ActiveX denetiminin HTML Kimliği.

dispId
Ayarlanacağı özelliğin dağıtım kimliği.

pVar
Yeni özellik değerini içeren bir VARIANT işaretçi.

pdispControl
ActiveX denetiminin arabirimine yönelik IDispatch işaretçi.

szPropName
Ayarlanacağı özelliğin adını içeren dize.

CDHtmlDialog::SetElementHtml

HTML öğesinin innerHTML özelliğini ayarlar.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parametreler

szElementId
HTML öğesinin kimliği.

bstrText
özelliğinin innerHTML yeni değeri.

punkElem
IUnknown HTML öğesinin işaretçisi.

CDHtmlDialog::SetElementProperty

BIR HTML öğesinin özelliğini ayarlar.

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

Parametreler

szElementId
HTML öğesinin kimliği.

dispId
Ayarlanacağı özelliğin dağıtım kimliği.

pVar
Özelliğin yeni değeri.

CDHtmlDialog::SetElementText

HTML öğesinin innerText özelliğini ayarlar.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parametreler

szElementId
HTML öğesinin kimliği.

bstrText
özelliğinin innerText yeni değeri.

punkElem
IUnknown HTML öğesinin işaretçisi.

CDHtmlDialog::SetExternalDispatch

Konağın arabirimini IDispatch ayarlar.

void SetExternalDispatch(IDispatch* pdispExternal);

Parametreler

pdispExternal
Yeni IDispatch arabirim.

CDHtmlDialog::SetHostFlags

Konak kullanıcı arabirimi bayraklarını ayarlar.

void SetHostFlags(DWORD dwFlags);

Parametreler

dwFlags
Olası değerler için Bkz DOCHOSTUIFLAG . Windows SDK'sı.

CDHtmlDialog::ShowContextMenu

Bağlam menüsü görüntülenmek üzereyken çağrılır.

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

Parametreler

dwID
Windows SDK'sında IDocHostUIHandler::ShowContextMenu bölümüne bakındwID.

ppt
Windows SDK'sında IDocHostUIHandler::ShowContextMenu bölümüne bakınppt.

pcmdtReserved
Windows SDK'sında IDocHostUIHandler::ShowContextMenu bölümüne bakınpcmdtReserved.

pdispReserved
Windows SDK'sında IDocHostUIHandler::ShowContextMenu bölümüne bakınpdispReserved.

Dönüş Değeri

S_FALSE döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::ShowContextMenu.

CDHtmlDialog::ShowUI

Konağın kullanıcı arabirimini gösterir.

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

Parametreler

dwID
Windows SDK'sında IDocHostUIHandler::ShowUI bölümüne bakındwID.

pActiveObject
Windows SDK'sında IDocHostUIHandler::ShowUI bölümüne bakınpActiveObject.

pCommandTarget
Windows SDK'sında IDocHostUIHandler::ShowUI bölümüne bakınpCommandTarget.

pFrame
Windows SDK'sında IDocHostUIHandler::ShowUI bölümüne bakınpFrame.

pDoc
Windows SDK'sında IDocHostUIHandler::ShowUI bölümüne bakınpDoc.

Dönüş Değeri

S_FALSE döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::ShowUI.

CDHtmlDialog::TranslateAccelerator

Menü hızlandırıcısı-anahtar iletilerini işlemek için çağrılır.

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

Parametreler

lpMsg
Windows SDK'sında IDocHostUIHandler::TranslateAccelerator bölümüne bakınlpMsg.

pguidCmdGroup
Windows SDK'sında IDocHostUIHandler::TranslateAccelerator bölümüne bakınpguidCmdGroup.

nCmdID
Windows SDK'sında IDocHostUIHandler::TranslateAccelerator bölümüne bakınnCmdID.

Dönüş Değeri

S_FALSE döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::TranslateAccelerator.

CDHtmlDialog::TranslateUrl

Yüklenecek URL'yi değiştirmek için çağrıldı.

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

Parametreler

dwTranslate
Windows SDK'sında IDocHostUIHandler::TranslateUrl bölümüne bakındwTranslate.

pchURLIn
Windows SDK'sında IDocHostUIHandler::TranslateUrl bölümüne bakınpchURLIn.

ppchURLOut
Windows SDK'sında IDocHostUIHandler::TranslateUrl bölümüne bakınppchURLOut.

Dönüş Değeri

S_FALSE döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::TranslateUrl.

CDHtmlDialog::UpdateUI

Komut durumunun değiştiğini konağa bildirmek için çağrıldı.

STDMETHOD(UpdateUI)(void);

Dönüş Değeri

E_NOTIMPL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi uygulamasıdır CDHtmlDialog IDocHostUIHandler::UpdateUI.

Ayrıca bkz.

MFC Örneği DHtmlExplore
DDX_DHtml Yardımcı Makrolar
Hiyerarşi Grafiği