CComControlBase Sınıfı
Bu sınıf, ATL denetimlerini oluşturmak ve yönetmek için yöntemler sağlar.
Önemli
Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.
Sözdizimi
class ATL_NO_VTABLE CComControlBase
Üyeler
Genel Tür Tanımları
Veri Akışı Adı | Açıklama |
---|---|
CComControlBase::AppearanceType | Hisse senedi özelliğiniz m_nAppearance türünde short değilse geçersiz kılın. |
Ortak Oluşturucular
Veri Akışı Adı | Açıklama |
---|---|
CComControlBase::CComControlBase | Oluşturucu. |
CComControlBase::~CComControlBase | Yok edici. |
Genel Yöntemler
Veri Akışı Adı | Açıklama |
---|---|
CComControlBase::ControlQueryInterface | İstenen arabirim için bir işaretçi alır. |
CComControlBase::D oesVerbActivate | tarafından kullanılan iVerb parametresinin denetimin kullanıcı arabirimini etkinleştirdiğini (iVerb OLEIVERB_UIACTIVATE eşittir), kullanıcı denetime çift tıkladığında (iVerb OLEIVERB_PRIMARY eşittir), denetimi görüntülediğinde (iVerb OLEIVERB_SHOW eşittir) veya denetimi etkinleştirdiğinde (iVerb eşittir OLEIVERB_INPLACEACTIVATE) gerçekleştirilen eylemi tanımlar.IOleObjectImpl::DoVerb |
CComControlBase::D oesVerbUIActivate | tarafından IOleObjectImpl::DoVerb kullanılan iVerb parametresinin denetimin kullanıcı arabiriminin etkinleştirilmesine neden olup olmadığını denetler ve TRUE döndürür. |
CComControlBase::D oVerbProperties | Denetimin özellik sayfalarını görüntüler. |
CComControlBase::FireViewChange | Kapsayıcıya denetimi yeniden çizmesini bildirmek veya kayıtlı öneri havuzlarına denetimin görünümünün değiştiğini bildirmek için bu yöntemi çağırın. |
CComControlBase::GetAmbientAppearance | Denetimin geçerli görünüm ayarı olan DISPID_AMBIENT_APPEARANCE alır: düz için 0 ve 3B için 1. |
CComControlBase::GetAmbientAutoClip | Kapsayıcının denetim görüntüleme alanının otomatik kırpmasını destekleyip desteklemediğini belirten bir bayrak olan DISPID_AMBIENT_AUTOCLIP alır. |
CComControlBase::GetAmbientBackColor | Kapsayıcı tarafından tanımlanan tüm denetimlerin ortam arka plan rengi olan DISPID_AMBIENT_BACKCOLOR alır. |
CComControlBase::GetAmbientCharSet | Kapsayıcı tarafından tanımlanan tüm denetimler için ortam karakteri kümesi olan DISPID_AMBIENT_CHARSET alır. |
CComControlBase::GetAmbientCodePage | Kapsayıcı tarafından tanımlanan tüm denetimler için ortam karakter kümesi olan DISPID_AMBIENT_CODEPAGE alır. |
CComControlBase::GetAmbientDisplayAsDefault | Kapsayıcı bu sitedeki denetimi varsayılan düğme olarak işaretlediyse true olan ve bu nedenle düğme denetiminin kendisini daha kalın bir çerçeveyle çizmesi gereken bir bayrak olan DISPID_AMBIENT_DISPLAYASDEFAULT alır. |
CComControlBase::GetAmbientDisplayName | Kapsayıcının denetime sağladığı ad olan DISPID_AMBIENT_DISPLAYNAME alır. |
CComControlBase::GetAmbientFont | Kapsayıcının ortam IFont arabirimine yönelik bir işaretçi alır. |
CComControlBase::GetAmbientFontDisp | Kapsayıcının ortam IFontDisp dağıtım arabirimine yönelik bir işaretçi alır. |
CComControlBase::GetAmbientForeColor | Kapsayıcı tarafından tanımlanan tüm denetimler için ortam ön plan rengi olan DISPID_AMBIENT_FORECOLOR alır. |
CComControlBase::GetAmbientLocaleID | Kapsayıcı tarafından kullanılan dilin tanımlayıcısı olan DISPID_AMBIENT_LOCALEID alır. |
CComControlBase::GetAmbientMessageReflect | Kapsayıcının olay olarak pencere iletilerini (WM_DRAWITEM gibi) alıp almadığını belirten bir bayrak olan DISPID_AMBIENT_MESSAGEREFLECT alır. |
CComControlBase::GetAmbientPalette | Kapsayıcının HPALETTE'sine erişmek için kullanılan DISPID_AMBIENT_PALETTE alır. |
CComControlBase::GetAmbientProperty | Kimlik tarafından belirtilen kapsayıcı özelliğini alır. |
CComControlBase::GetAmbientRightToLeft | kapsayıcı tarafından içeriğin görüntülendiği yön olan DISPID_AMBIENT_RIGHTTOLEFT alır. |
CComControlBase::GetAmbientScaleUnits | Etiketleme için kapsayıcının ortam birimleri olan (inç veya santimetre gibi) DISPID_AMBIENT_SCALEUNITS alır. |
CComControlBase::GetAmbientShowGrabHandles | kapsayıcının etkin olduğunda denetimin kendisi için tutma tutamaçlarını görüntülemesine izin verip vermediğini belirten bir bayrak olan DISPID_AMBIENT_SHOWGRABHANDLES alır. |
CComControlBase::GetAmbientShowHatching | Kapsayıcının, kullanıcı arabirimi etkinken denetimin kendisini taranmış bir desenle görüntülemesine izin verip vermediğini belirten bir bayrak olan DISPID_AMBIENT_SHOWHATCHING alır. |
CComControlBase::GetAmbientSupportsMnemonics | Kapsayıcının klavye anımsatıcılarını destekleyip desteklemediğini belirten bir bayrak olan DISPID_AMBIENT_SUPPORTSMNEMONICS alır. |
CComControlBase::GetAmbientTextAlign | kapsayıcı tarafından tercih edilen metin hizalaması olan DISPID_AMBIENT_TEXTALIGN alır: genel hizalama için 0 (sağ, metin sol), sol hizalama için 1, orta hizalama için 2 ve sağ hizalama için 3. |
CComControlBase::GetAmbientTopToBottom | kapsayıcı tarafından içeriğin görüntülendiği yön olan DISPID_AMBIENT_TOPTOBOTTOM alır. |
CComControlBase::GetAmbientUIDead | Kapsayıcının denetimin kullanıcı arabirimi eylemlerine yanıt vermesini isteyip istemediğini belirten bir bayrak olan DISPID_AMBIENT_UIDEAD alır. |
CComControlBase::GetAmbientUserMode | kapsayıcının çalışma modunda mı (TRUE) yoksa tasarım modunda mı (FALSE) olduğunu gösteren bir bayrak olan DISPID_AMBIENT_USERMODE alır. |
CComControlBase::GetDirty | Veri üyesinin m_bRequiresSave değerini döndürür. |
CComControlBase::GetZoomInfo | Yerinde düzenleme için etkinleştirilmiş bir denetim için yakınlaştırma faktörünün paydasının ve paydasının x ve y değerlerini alır. |
CComControlBase::InPlaceActivate | Denetimin etkin olmayan durumdan iVerb'deki fiilin belirttiği duruma geçmesine neden olur. |
CComControlBase::InternalGetSite | Tanımlanan arabirime yönelik bir işaretçi için denetim sitesini sorgulamak için bu yöntemi çağırın. |
CComControlBase::OnDraw | Denetiminizi çizmek için bu yöntemi geçersiz kılın. |
CComControlBase::OnDrawAdvanced | Varsayılan ayar OnDrawAdvanced , çizim için normalleştirilmiş bir cihaz bağlamı hazırlar ve ardından denetim sınıfınızın OnDraw yöntemini çağırır. |
CComControlBase::OnKillFocus | Denetimin yerinde etkin olduğunu ve geçerli bir denetim sitesine sahip olduğunu denetler, ardından kapsayıcıya denetimin odağı kaybettiğini bildirir. |
CComControlBase::OnMouseActivate | Kullanıcı arabiriminin kullanıcı modunda olduğunu denetler, ardından denetimi etkinleştirir. |
CComControlBase::OnPaint | Kapsayıcıyı boyama için hazırlar, denetimin istemci alanını alır ve ardından denetim sınıfının OnDraw yöntemini çağırır. |
CComControlBase::OnSetFocus | Denetimin yerinde etkin olduğunu ve geçerli bir denetim sitesine sahip olduğunu denetler, ardından kapsayıcıya denetimin odaklandığını bildirir. |
CComControlBase::P reTranslateAccelerator | Kendi klavye hızlandırıcısı işleyicilerinizi sağlamak için bu yöntemi geçersiz kılın. |
CComControlBase::SendOnClose | Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin kapatıldığını bildirir. |
CComControlBase::SendOnDataChange | Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetim verilerinin değiştiğini bildirir. |
CComControlBase::SendOnRename | Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin yeni bir adı olduğunu bildirir. |
CComControlBase::SendOnSave | Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin kaydedildiğini bildirir. |
CComControlBase::SendOnViewChange | Tüm kayıtlı danışmanlık havuzlarına denetimin görünümünün değiştiğini bildirir. |
CComControlBase::SetControlFocus | Klavye odağını denetime veya denetimden ayarlar veya kaldırır. |
CComControlBase::SetDirty | Veri üyesini m_bRequiresSave bDirty'deki değere ayarlar. |
Ortak Veri Üyeleri
Veri Akışı Adı | Açıklama |
---|---|
CComControlBase::m_bAutoSize | Denetimi gösteren bayrak başka bir boyut olamaz. |
CComControlBase::m_bDrawFromNatural | bunu belirten ve CComControlBase::GetZoomInfo öğesinin IDataObjectImpl::GetData denetim boyutunu yerine 'den m_sizeNatural m_sizeExtent ayarlaması gerektiğini belirten bayrak. |
CComControlBase::m_bDrawGetDataInHimetric | Çizim yaparken pikselleri değil, HIMETRIC birimlerini kullanması gerektiğini belirten IDataObjectImpl::GetData bayrak. |
CComControlBase::m_bInPlaceActive | Denetimin yerinde etkin olduğunu gösteren bayrak. |
CComControlBase::m_bInPlaceSiteEx | Kapsayıcıyı gösteren bayrak, penceresiz ve titreşimsiz denetimler gibi arabirimi ve OCX96 denetim özelliklerini destekler IOleInPlaceSiteEx . |
CComControlBase::m_bNegotiatedWnd | Denetimin kapsayıcıyla OCX96 denetim özellikleri (titreşimsiz ve penceresiz denetimler gibi) desteği ve denetimin pencereli mi yoksa penceresiz mi olduğunu belirten bayrak. |
CComControlBase::m_bRecomposeOnResize | Kapsayıcı denetimin görüntü boyutunu değiştirdiğinde denetimin sunusunu yeniden derlemek istediğini belirten bayrak. |
CComControlBase::m_bRequiresSave | Denetimin son kaydedildiğinden beri değiştiğini gösteren bayrak. |
CComControlBase::m_bResizeNatural | Kapsayıcı denetimin görüntü boyutunu değiştirdiğinde denetimin doğal kapsamını (ölçeklendirilmemiş fiziksel boyutu) yeniden boyutlandırmak istediğini belirten bayrak. |
CComControlBase::m_bUIActive | Denetimin menüler ve araç çubukları gibi kullanıcı arabirimini gösteren bayrak etkindir. |
CComControlBase::m_bUsingWindowRgn | Denetimin kapsayıcı tarafından sağlanan pencere bölgesini kullandığını gösteren bayrak. |
CComControlBase::m_bWasOnceWindowless | Denetimin penceresiz olduğunu belirten bayrak, ancak şu anda penceresiz olabilir veya olmayabilir. |
CComControlBase::m_bWindowOnly | Kapsayıcı penceresiz denetimleri desteklese bile denetimi gösteren bayrak pencerelenmelidir. |
CComControlBase::m_bWndLess | Denetimin penceresiz olduğunu gösteren bayrak. |
CComControlBase::m_hWndCD | Denetimle ilişkilendirilmiş pencere tutamacına bir başvuru içerir. |
CComControlBase::m_nFreezeEvents | Kapsayıcının olayların çözülmesi (olayların kabulü) olmadan olayların dondurulma sayısı (olayları kabul etmeyi reddetti). |
CComControlBase::m_rcPos | Denetimin piksel cinsinden konumu, kapsayıcının koordinatlarıyla ifade edilir. |
CComControlBase::m_sizeExtent | Belirli bir ekran için HIMETRIC birimlerindeki denetimin kapsamı (her birim 0,01 milimetredir). |
CComControlBase::m_sizeNatural | HIMETRIC birimlerindeki denetimin fiziksel boyutu (her birim 0,01 milimetredir). |
CComControlBase::m_spAdviseSink | Kapsayıcıdaki (kapsayıcının IAdviseSink'i) danışmanlık bağlantısının doğrudan işaretçisi. |
CComControlBase::m_spAmbientDispatch | Kapsayıcının CComDispatchDriver özelliklerini bir işaretçi aracılığıyla almanıza ve ayarlamanıza olanak tanıyan bir IDispatch nesne. |
CComControlBase::m_spClientSite | Kapsayıcı içindeki denetimin istemci sitesine ilişkin bir işaretçi. |
CComControlBase::m_spDataAdviseHolder | Veri nesneleri arasında danışmanlık bağlantılarını tutmak ve havuzları önermek için standart bir araç sağlar. |
CComControlBase::m_spInPlaceSite | Kapsayıcının IOleInPlaceSite, IOleInPlaceSiteEx veya IOleInPlaceSiteWindowless arabirim işaretçisinin işaretçisi. |
CComControlBase::m_spOleAdviseHolder | Danışmanlık bağlantılarını tutmanın standart bir uygulamasını sağlar. |
Açıklamalar
Bu sınıf, ATL denetimlerini oluşturmak ve yönetmek için yöntemler sağlar. CComControl Sınıfı öğesinden CComControlBase
türetilir. ATL Denetim Sihirbazı'nı kullanarak Standart Denetim veya DHTML denetimi oluşturduğunuzda, sihirbaz sınıfınızı öğesinden CComControlBase
otomatik olarak türetecektir.
Denetim oluşturma hakkında daha fazla bilgi için bkz. ATL Öğreticisi. ATL Proje Sihirbazı hakkında daha fazla bilgi için ATL Projesi Oluşturma makalesine bakın.
Gereksinimler
Üst bilgi: atlctl.h
CComControlBase::AppearanceType
Hisse senedi özelliğiniz m_nAppearance
türünde short
değilse geçersiz kılın.
typedef short AppearanceType;
Açıklamalar
ATL Denetim Sihirbazı, kısa türündeki hisse senedi özelliğini ekler m_nAppearance
. Farklı bir veri türü kullanıyorsanız geçersiz kılın AppearanceType
.
CComControlBase::CComControlBase
Oluşturucu.
CComControlBase(HWND& h);
Parametreler
h
Denetimle ilişkili pencerenin tutamacı.
Açıklamalar
Denetim boyutunu 5080X5080 HIMETRIC birimine (2"X2") başlatır ve veri üyesi değerlerini NULL veya YANLIŞ olarak başlatır CComControlBase
.
CComControlBase::~CComControlBase
Yok edici.
~CComControlBase();
Açıklamalar
Denetim penceresi açılırsa DestroyWindow ~CComControlBase
çağrısı yaparak onu yok eder.
CComControlBase::ControlQueryInterface
İstenen arabirim için bir işaretçi alır.
virtual HRESULT ControlQueryInterface(const IID& iid,
void** ppv);
Parametreler
iid
İstenen arabirimin GUID'i.
ppv
iid tarafından tanımlanan arabirim işaretçisi işaretçisi veya arabirim bulunamazsa NULL.
Açıklamalar
Yalnızca COM eşleme tablosundaki arabirimleri işler.
Örnek
// Retrieve the control's IOleObject interface. Note interface
// is automatically released when pOleObject goes out of scope
CComPtr<IOleObject> pOleObject;
ControlQueryInterface(IID_IOleObject, (void**)&pOleObject);
CComControlBase::D oesVerbActivate
tarafından kullanılan iVerb parametresinin denetimin kullanıcı arabirimini etkinleştirdiğini (iVerb OLEIVERB_UIACTIVATE eşittir), kullanıcı denetime çift tıkladığında (iVerb OLEIVERB_PRIMARY eşittir), denetimi görüntülediğinde (iVerb OLEIVERB_SHOW eşittir) veya denetimi etkinleştirdiğinde (iVerb eşittir OLEIVERB_INPLACEACTIVATE) gerçekleştirilen eylemi tanımlar.IOleObjectImpl::DoVerb
BOOL DoesVerbActivate(LONG iVerb);
Parametreler
iVerb
tarafından DoVerb
gerçekleştirilecek eylemi gösteren değer.
Dönüş Değeri
iVerb OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW veya OLEIVERB_INPLACEACTIVATE eşitse DOĞRU döndürür; aksi takdirde YANLIŞ döndürür.
Açıklamalar
Kendi etkinleştirme fiilinizi tanımlamak için bu yöntemi geçersiz kılabilirsiniz.
CComControlBase::D oesVerbUIActivate
tarafından IOleObjectImpl::DoVerb
kullanılan iVerb parametresinin denetimin kullanıcı arabiriminin etkinleştirilmesine neden olup olmadığını denetler ve TRUE döndürür.
BOOL DoesVerbUIActivate(LONG iVerb);
Parametreler
iVerb
tarafından DoVerb
gerçekleştirilecek eylemi gösteren değer.
Dönüş Değeri
iVerb OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW veya OLEIVERB_INPLACEACTIVATE eşitse DOĞRU döndürür. Aksi takdirde, yöntemi FALSE döndürür.
CComControlBase::D oVerbProperties
Denetimin özellik sayfalarını görüntüler.
HRESULT DoVerbProperties(LPCRECT /* prcPosRect */, HWND hwndParent);
Parametreler
prcPosRec
Ayrılmış.
hwndParent
Denetimi içeren pencerenin tutamacı.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Örnek
// The following implementation of the WM_RBUTTONDOWN message handler
// will pop up the ActiveX Control's PropertyPages
LRESULT CMyComposite::OnRButtonDown(UINT /*uMsg*/, WPARAM /*wParam*/,
LPARAM /*lParam*/, BOOL& /*bHandled*/)
{
DoVerbProperties(NULL, ::GetActiveWindow());
return 0L;
}
MESSAGE_HANDLER(WM_RBUTTONDOWN, OnRButtonDown)
CComControlBase::FireViewChange
Kapsayıcıya denetimi yeniden çizmesini bildirmek veya kayıtlı öneri havuzlarına denetimin görünümünün değiştiğini bildirmek için bu yöntemi çağırın.
HRESULT FireViewChange();
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
Denetim etkinse (denetim sınıfı veri üyesi CComControlBase::m_bInPlaceActive TRUE ise), denetimin tamamını yeniden çizmek istediğinizi kapsayıcıya bildirir. Denetim etkin değilse, denetimin kayıtlı öneri havuzlarına (denetim sınıfı veri üyesi CComControlBase::m_spAdviseSink aracılığıyla) denetimin görünümünün değiştiğini bildirir.
Örnek
STDMETHODIMP CMyControl::put_Shape(int newVal)
{
// store newVal in m_nShape user-defined member
m_nShape = newVal;
// notify container to redraw control
FireViewChange();
return S_OK;
}
CComControlBase::GetAmbientAppearance
Denetimin geçerli görünüm ayarı olan DISPID_AMBIENT_APPEARANCE alır: düz için 0 ve 3B için 1.
HRESULT GetAmbientAppearance(short& nAppearance);
Parametreler
nAppearance
özelliği DISPID_AMBIENT_APPEARANCE.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Örnek
HRESULT OnDraw(ATL_DRAWINFO& di)
{
short nAppearance;
RECT& rc = *(RECT*)di.prcBounds;
// draw 3D border if AmbientAppearance is not supported or is set to 1
HRESULT hr = GetAmbientAppearance(nAppearance);
if (hr != S_OK || nAppearance==1)
{
DrawEdge(di.hdcDraw, &rc, EDGE_SUNKEN, BF_RECT);
}
else
{
Rectangle(di.hdcDraw, rc.left, rc.top, rc.right, rc.bottom);
}
SetTextAlign(di.hdcDraw, TA_CENTER|TA_BASELINE);
LPCTSTR pszText = _T("ATL 8.0 : MyControl");
// For security reasons, we recommend that you use the lstrlen function
// with caution. Here, we can guarantee that pszText is NULL terminated,
// and therefore it is safe to use this function.
TextOut(di.hdcDraw,
(rc.left + rc.right) / 2,
(rc.top + rc.bottom) / 2,
pszText,
lstrlen(pszText));
return S_OK;
}
CComControlBase::GetAmbientAutoClip
Kapsayıcının denetim görüntüleme alanının otomatik kırpmasını destekleyip desteklemediğini belirten bir bayrak olan DISPID_AMBIENT_AUTOCLIP alır.
HRESULT GetAmbientAutoClip(BOOL& bAutoClip);
Parametreler
bAutoClip
özelliği DISPID_AMBIENT_AUTOCLIP.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientBackColor
Kapsayıcı tarafından tanımlanan tüm denetimlerin ortam arka plan rengi olan DISPID_AMBIENT_BACKCOLOR alır.
HRESULT GetAmbientBackColor(OLE_COLOR& BackColor);
Parametreler
BackColor
özelliği DISPID_AMBIENT_BACKCOLOR.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientCharSet
Kapsayıcı tarafından tanımlanan tüm denetimler için ortam karakteri kümesi olan DISPID_AMBIENT_CHARSET alır.
HRESULT GetAmbientCharSet(BSTR& bstrCharSet);
Parametreler
bstrCharSet
özelliği DISPID_AMBIENT_CHARSET.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CComControlBase::GetAmbientCodePage
Kapsayıcı tarafından tanımlanan tüm denetimlerin ortam kodu sayfası olan DISPID_AMBIENT_CODEPAGE alır.
HRESULT GetAmbientCodePage(ULONG& ulCodePage);
Parametreler
ulCodePage
özelliği DISPID_AMBIENT_CODEPAGE.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CComControlBase::GetAmbientDisplayAsDefault
Kapsayıcı bu sitedeki denetimi varsayılan düğme olarak işaretlediyse true olan ve bu nedenle düğme denetiminin kendisini daha kalın bir çerçeveyle çizmesi gereken bir bayrak olan DISPID_AMBIENT_DISPLAYASDEFAULT alır.
HRESULT GetAmbientDisplayAsDefault(BOOL& bDisplayAsDefault);
Parametreler
bDisplayAsDefault
özelliği DISPID_AMBIENT_DISPLAYASDEFAULT.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientDisplayName
Kapsayıcının denetime sağladığı ad olan DISPID_AMBIENT_DISPLAYNAME alır.
HRESULT GetAmbientDisplayName(BSTR& bstrDisplayName);
Parametreler
bstrDisplayName
özelliği DISPID_AMBIENT_DISPLAYNAME.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientFont
Kapsayıcının ortam IFont
arabirimine yönelik bir işaretçi alır.
HRESULT GetAmbientFont(IFont** ppFont);
Parametreler
ppFont
Kapsayıcının ortam IFont arabirimine bir işaretçi.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
Özellik NULL ise, işaretçi NULL olur. İşaretçi NULL değilse, çağıranın işaretçiyi serbest bırakması gerekir.
CComControlBase::GetAmbientFontDisp
Kapsayıcının ortam IFontDisp
dağıtım arabirimine yönelik bir işaretçi alır.
HRESULT GetAmbientFontDisp(IFontDisp** ppFont);
Parametreler
ppFont
Kapsayıcının ortam IFontDisp dağıtım arabiriminin işaretçisi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Özellik NULL ise, işaretçi NULL olur. İşaretçi NULL değilse, çağıranın işaretçiyi serbest bırakması gerekir.
CComControlBase::GetAmbientForeColor
Kapsayıcı tarafından tanımlanan tüm denetimler için ortam ön plan rengi olan DISPID_AMBIENT_FORECOLOR alır.
HRESULT GetAmbientForeColor(OLE_COLOR& ForeColor);
Parametreler
ForeColor
özelliği DISPID_AMBIENT_FORECOLOR.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientLocaleID
Kapsayıcı tarafından kullanılan dilin tanımlayıcısı olan DISPID_AMBIENT_LOCALEID alır.
HRESULT GetAmbientLocaleID(LCID& lcid);
Parametreler
lcid
özelliği DISPID_AMBIENT_LOCALEID.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
Denetim, kullanıcı arabirimini farklı dillere uyarlamak için bu tanımlayıcıyı kullanabilir.
CComControlBase::GetAmbientMessageReflect
Kapsayıcının olay olarak pencere iletilerini (örneğin WM_DRAWITEM
) almak isteyip istemediğini belirten bir bayrak olan DISPID_AMBIENT_MESSAGEREFLECT alır.
HRESULT GetAmbientMessageReflect(BOOL& bMessageReflect);
Parametreler
bMessageReflect
özelliği DISPID_AMBIENT_MESSAGEREFLECT.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientPalette
Kapsayıcının HPALETTE'sine erişmek için kullanılan DISPID_AMBIENT_PALETTE alır.
HRESULT GetAmbientPalette(HPALETTE& hPalette);
Parametreler
hPalette
özelliği DISPID_AMBIENT_PALETTE.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientProperty
dispid tarafından belirtilen kapsayıcı özelliğini alır.
HRESULT GetAmbientProperty(DISPID dispid, VARIANT& var);
Parametreler
dispid
Alınacak kapsayıcı özelliğinin tanımlayıcısı.
var
Özelliğini almak için değişken.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
ATL, CComControlBase::GetAmbientBackColor gibi belirli özellikleri almak için bir dizi yardımcı işlev sağlamıştır. Kullanılabilir uygun bir yöntem yoksa kullanın GetAmbientProperty
.
CComControlBase::GetAmbientRightToLeft
kapsayıcı tarafından içeriğin görüntülendiği yön olan DISPID_AMBIENT_RIGHTTOLEFT alır.
HRESULT GetAmbientRightToLeft(BOOL& bRightToLeft);
Parametreler
bRightToLeft
özelliği DISPID_AMBIENT_RIGHTTOLEFT. İçerik sağdan sola görüntüleniyorsa TRUE, soldan sağa görüntüleniyorsa YANLIŞ olarak ayarlayın.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CComControlBase::GetAmbientScaleUnits
Etiketleme için kapsayıcının ortam birimleri olan (inç veya santimetre gibi) DISPID_AMBIENT_SCALEUNITS alır.
HRESULT GetAmbientScaleUnits(BSTR& bstrScaleUnits);
Parametreler
bstrScaleUnits
özelliği DISPID_AMBIENT_SCALEUNITS.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientShowGrabHandles
kapsayıcının etkin olduğunda denetimin kendisi için tutma tutamaçlarını görüntülemesine izin verip vermediğini belirten bir bayrak olan DISPID_AMBIENT_SHOWGRABHANDLES alır.
HRESULT GetAmbientShowGrabHandles(BOOL& bShowGrabHandles);
Parametreler
bShowGrabHandles
özelliği DISPID_AMBIENT_SHOWGRABHANDLES.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientShowHatching
Kapsayıcının, denetimin kullanıcı arabirimi etkin olduğunda, denetimin kendisini taranmış bir desenle görüntülemesine izin verip vermediğini belirten bir bayrak olan DISPID_AMBIENT_SHOWHATCHING alır.
HRESULT GetAmbientShowHatching(BOOL& bShowHatching);
Parametreler
bShowHatching
özelliği DISPID_AMBIENT_SHOWHATCHING.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientSupportsMnemonics
Kapsayıcının klavye anımsatıcılarını destekleyip desteklemediğini belirten bir bayrak olan DISPID_AMBIENT_SUPPORTSMNEMONICS alır.
HRESULT GetAmbientSupportsMnemonics(BOOL& bSupportsMnemonics);
Parametreler
bSupportsMnemonics
özelliği DISPID_AMBIENT_SUPPORTSMNEMONICS.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientTextAlign
kapsayıcı tarafından tercih edilen metin hizalaması olan DISPID_AMBIENT_TEXTALIGN alır: genel hizalama için 0 (sağ, metin sol), sol hizalama için 1, orta hizalama için 2 ve sağ hizalama için 3.
HRESULT GetAmbientTextAlign(short& nTextAlign);
Parametreler
nTextAlign
özelliği DISPID_AMBIENT_TEXTALIGN.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetAmbientTopToBottom
kapsayıcı tarafından içeriğin görüntülendiği yön olan DISPID_AMBIENT_TOPTOBOTTOM alır.
HRESULT GetAmbientTopToBottom(BOOL& bTopToBottom);
Parametreler
bTopToBottom
özelliği DISPID_AMBIENT_TOPTOBOTTOM. Metin yukarıdan aşağıya görüntülenirse DOĞRU, alttan üste doğru görüntülenirse YANLIŞ olarak ayarlayın.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CComControlBase::GetAmbientUIDead
Kapsayıcının denetimin kullanıcı arabirimi eylemlerine yanıt vermesini isteyip istemediğini belirten bir bayrak olan DISPID_AMBIENT_UIDEAD alır.
HRESULT GetAmbientUIDead(BOOL& bUIDead);
Parametreler
bUIDead
özelliği DISPID_AMBIENT_UIDEAD.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
TRUE ise, denetim yanıt vermemelidir. Bu bayrak, DISPID_AMBIENT_USERMODE bayrağından bağımsız olarak uygulanır. Bkz. CComControlBase::GetAmbientUserMode.
CComControlBase::GetAmbientUserMode
kapsayıcının çalışma modunda mı (TRUE) yoksa tasarım modunda mı (FALSE) olduğunu gösteren bir bayrak olan DISPID_AMBIENT_USERMODE alır.
HRESULT GetAmbientUserMode(BOOL& bUserMode);
Parametreler
bUserMode
özelliği DISPID_AMBIENT_USERMODE.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
CComControlBase::GetDirty
Veri üyesinin m_bRequiresSave
değerini döndürür.
BOOL GetDirty();
Dönüş Değeri
Veri üyesi m_bRequiresSave değerini döndürür.
Açıklamalar
Bu değer CComControlBase::SetDirty kullanılarak ayarlanır.
CComControlBase::GetZoomInfo
Yerinde düzenleme için etkinleştirilmiş bir denetim için yakınlaştırma faktörünün paydasının ve paydasının x ve y değerlerini alır.
void GetZoomInfo(ATL_DRAWINFO& di);
Parametreler
Di
Yakınlaştırma faktörünün payını ve paydasını tutacak yapı. Daha fazla bilgi için bkz . ATL_DRAWINFO.
Açıklamalar
Yakınlaştırma faktörü, denetimin doğal boyutunun geçerli boyutuna oranıdır.
CComControlBase::InPlaceActivate
Denetimin etkin olmayan durumdan iVerb'deki fiilin belirttiği duruma geçmesine neden olur.
HRESULT InPlaceActivate(LONG iVerb, const RECT* prcPosRect = NULL);
Parametreler
iVerb
IOleObjectImpl::D oVerb tarafından gerçekleştirilecek eylemi gösteren değer.
prcPosRect
Yerinde denetimin konumuna işaret eden işaretçi.
Dönüş Değeri
Standart HRESULT değerlerinden biri.
Açıklamalar
Etkinleştirmeden önce, bu yöntem denetimin bir istemci sitesine sahip olup olmadığını denetler, denetimin ne kadarının görünür olduğunu denetler ve denetimin konumunu üst pencerede alır. Denetim etkinleştirildikten sonra, bu yöntem denetimin kullanıcı arabirimini etkinleştirir ve kapsayıcıya denetimi görünür hale getirmesini söyler.
Bu yöntem ayrıca denetim için bir IOleInPlaceSite
, IOleInPlaceSiteEx
veya IOleInPlaceSiteWindowless
arabirim işaretçisi alır ve bunu denetim sınıfının veri üyesi CComControlBase::m_spInPlaceSite içinde depolar. Denetim sınıfı veri üyeleri CComControlBase::m_bInPlaceSiteEx, CComControlBase::m_bWndLess, CComControlBase::m_bWasOnceWindowless ve CComControlBase::m_bNegotiatedWnd uygun şekilde true olarak ayarlanır.
CComControlBase::InternalGetSite
Tanımlanan arabirime yönelik bir işaretçi için denetim sitesini sorgulamak için bu yöntemi çağırın.
HRESULT InternalGetSite(REFIID riid, void** ppUnkSite);
Parametreler
riid
ppUnkSite içinde döndürülmesi gereken arabirim işaretçisinin IID değeri.
ppUnkSite
riid içinde istenen arabirim işaretçisini alan işaretçi değişkeninin adresi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Site riid içinde istenen arabirimi destekliyorsa, işaretçi ppUnkSite aracılığıyla döndürülür. Aksi takdirde, ppUnkSite NULL olarak ayarlanır.
CComControlBase::m_bAutoSize
Denetimi gösteren bayrak başka bir boyut olamaz.
unsigned m_bAutoSize:1;
Açıklamalar
Bu bayrak tarafından IOleObjectImpl::SetExtent
denetlendi ve TRUE ise işlevin E_FAIL döndürmesine neden olur.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
ATL Denetim Sihirbazı'nın Stok Özellikleri sekmesine Otomatik Boyut seçeneğini eklerseniz, sihirbaz bu veri üyesini otomatik olarak denetim sınıfınızda oluşturur, özellik için put ve get yöntemleri oluşturur ve özellik değiştiğinde kapsayıcıyı otomatik olarak bilgilendirmek için IPropertyNotifySink'i destekler.
CComControlBase::m_bDrawFromNatural
bunu belirten ve CComControlBase::GetZoomInfo
öğesinin IDataObjectImpl::GetData
denetim boyutunu yerine 'den m_sizeNatural
m_sizeExtent
ayarlaması gerektiğini belirten bayrak.
unsigned m_bDrawFromNatural:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bDrawGetDataInHimetric
Çizim yaparken pikselleri değil, HIMETRIC birimlerini kullanması gerektiğini belirten IDataObjectImpl::GetData
bayrak.
unsigned m_bDrawGetDataInHimetric:1;
Açıklamalar
Her mantıksal HIMETRIC birimi 0,01 milimetredir.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bInPlaceActive
Denetimin yerinde etkin olduğunu gösteren bayrak.
unsigned m_bInPlaceActive:1;
Açıklamalar
Bu, denetimin görünür olduğu ve varsa penceresinin görünür olduğu, ancak menüleri ve araç çubuklarının etkin olmayabileceği anlamına gelir. m_bUIActive
bayrağı, denetimin menüler gibi kullanıcı arabiriminin de etkin olduğunu gösterir.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bInPlaceSiteEx
Kapsayıcıyı gösteren bayrak, penceresiz ve titreşimsiz denetimler gibi arabirimi ve OCX96 denetim özelliklerini destekler IOleInPlaceSiteEx
.
unsigned m_bInPlaceSiteEx:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Veri üyesim_spInPlaceSite
, ve m_bInPlaceSiteEx
bayraklarının değerine bağlı olarak bir IOleInPlaceSite, IOleInPlaceSiteEx veya IOleInPlaceSiteWindowless arabirimine m_bWndLess
işaret eder. (İşaretçinin m_spInPlaceSite
geçerli olması için veri üyesi m_bNegotiatedWnd
TRUE olmalıdır.)
m_bWndLess
FALSE ve m_bInPlaceSiteEx
TRUE ise, m_spInPlaceSite
bir IOleInPlaceSiteEx
arabirim işaretçisidir. Bu üç veri üyesi arasındaki ilişkiyi gösteren tablo için bkz . m_spInPlaceSite .
CComControlBase::m_bNegotiatedWnd
Denetimin kapsayıcıyla OCX96 denetim özellikleri (titreşimsiz ve penceresiz denetimler gibi) desteği ve denetimin pencereli mi yoksa penceresiz mi olduğunu belirten bayrak.
unsigned m_bNegotiatedWnd:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
İşaretçinin m_bNegotiatedWnd
geçerli olması için bayrağı TRUE m_spInPlaceSite
olmalıdır.
CComControlBase::m_bRecomposeOnResize
Kapsayıcı denetimin görüntü boyutunu değiştirdiğinde denetimin sunusunu yeniden derlemek istediğini belirten bayrak.
unsigned m_bRecomposeOnResize:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Bu bayrak IOleObjectImpl::SetExtent tarafından denetlendi ve TRUE ise görünüm SetExtent
değişiklikleri kapsayıcısını bilgilendirdi. bu bayrak ayarlanırsa, OLEMISC numaralandırmasında OLEMISC_RECOMPOSEONRESIZE bit de ayarlanmalıdır.
CComControlBase::m_bRequiresSave
Denetimin son kaydedildiğinden beri değiştiğini gösteren bayrak.
unsigned m_bRequiresSave:1;
Açıklamalar
değeri m_bRequiresSave
CComControlBase::SetDirty ile ayarlanabilir ve CComControlBase::GetDirty ile alınabilir.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bResizeNatural
Kapsayıcı denetimin görüntü boyutunu değiştirdiğinde denetimin doğal kapsamını (ölçeklendirilmemiş fiziksel boyutu) yeniden boyutlandırmak istediğini belirten bayrak.
unsigned m_bResizeNatural:1;
Açıklamalar
Bu bayrak tarafından IOleObjectImpl::SetExtent
denetlendi ve TRUE ise içine geçirilen SetExtent
boyut öğesine m_sizeNatural
atanır.
'a SetExtent
geçirilen boyut, değerine m_bResizeNatural
bakılmaksızın her zaman öğesine m_sizeExtent
atanır.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bUIActive
Denetimin menüler ve araç çubukları gibi kullanıcı arabirimini gösteren bayrak etkindir.
unsigned m_bUIActive:1;
Açıklamalar
m_bInPlaceActive
bayrağı denetimin etkin olduğunu gösterir, ancak kullanıcı arabiriminin etkin olmadığını gösterir.
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bUsingWindowRgn
Denetimin kapsayıcı tarafından sağlanan pencere bölgesini kullandığını gösteren bayrak.
unsigned m_bUsingWindowRgn:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bWasOnceWindowless
Denetimin penceresiz olduğunu belirten bayrak, ancak şu anda penceresiz olabilir veya olmayabilir.
unsigned m_bWasOnceWindowless:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bWindowOnly
Kapsayıcı penceresiz denetimleri desteklese bile denetimi gösteren bayrak pencerelenmelidir.
unsigned m_bWindowOnly:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_bWndLess
Denetimin penceresiz olduğunu gösteren bayrak.
unsigned m_bWndLess:1;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Veri üyesim_spInPlaceSite
, ve CComControlBase::m_bInPlaceSiteEx bayraklarının m_bWndLess
değerine bağlı olarak bir IOleInPlaceSite, IOleInPlaceSiteEx veya IOleInPlaceSiteWindowless arabirimine işaret eder. (Veri üyesi CComControlBase::m_bNegotiatedWnd işaretçisinin geçerli olması için CComControlBase::m_spInPlaceSite TRUE olmalıdır.)
m_bWndLess
TRUE ise, m_spInPlaceSite
bir IOleInPlaceSiteWindowless
arabirim işaretçisidir. Bu veri üyeleri arasındaki tüm ilişkiyi gösteren bir tablo için bkz . CComControlBase::m_spInPlaceSite .
CComControlBase::m_hWndCD
Denetimle ilişkilendirilmiş pencere tutamacına bir başvuru içerir.
HWND& m_hWndCD;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_nFreezeEvents
Kapsayıcının olayların çözülmesi (olayların kabulü) olmadan olayların dondurulma sayısı (olayları kabul etmeyi reddetti).
short m_nFreezeEvents;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_rcPos
Denetimin piksel cinsinden konumu, kapsayıcının koordinatlarıyla ifade edilir.
RECT m_rcPos;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_sizeExtent
Belirli bir ekran için HIMETRIC birimlerindeki denetimin kapsamı (her birim 0,01 milimetredir).
SIZE m_sizeExtent;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Bu boyut ekrana göre ölçeklendirilir. Denetimin fiziksel boyutu veri üyesinde m_sizeNatural
belirtilir ve sabittir.
AtlHiMetricToPixel genel işleviyle boyutu piksele dönüştürebilirsiniz.
CComControlBase::m_sizeNatural
HIMETRIC birimlerindeki denetimin fiziksel boyutu (her birim 0,01 milimetredir).
SIZE m_sizeNatural;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Boyutu ekrana göre ölçeklendirilirken bu boyut m_sizeExtent
sabittir.
AtlHiMetricToPixel genel işleviyle boyutu piksele dönüştürebilirsiniz.
CComControlBase::m_spAdviseSink
Kapsayıcıdaki (kapsayıcının IAdviseSink'i) danışmanlık bağlantısının doğrudan işaretçisi.
CComPtr<IAdviseSink>
m_spAdviseSink;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_spAmbientDispatch
Bir CComDispatchDriver
işaretçi aracılığıyla nesnenin özelliklerini almanıza ve ayarlamanıza olanak tanıyan nesne IDispatch
.
CComDispatchDriver m_spAmbientDispatch;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_spClientSite
Kapsayıcı içindeki denetimin istemci sitesine ilişkin bir işaretçi.
CComPtr<IOleClientSite>
m_spClientSite;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
CComControlBase::m_spDataAdviseHolder
Veri nesneleri arasında danışmanlık bağlantılarını tutmak ve havuzları önermek için standart bir araç sağlar.
CComPtr<IDataAdviseHolder>
m_spDataAdviseHolder;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Veri nesnesi, veri aktarabilen ve yöntemleri verilerin biçimini ve aktarım medyasını belirten IDataObject uygulayan bir denetimdir.
Arabirim m_spDataAdviseHolder
, kapsayıcıya danışmanlık bağlantıları kurmak ve silmek için IDataObject::D Advise ve IDataObject::D Unadvise yöntemlerini uygular. Denetimin kapsayıcısı, IAdviseSink arabirimini destekleyerek bir öneri havuzu uygulamalıdır.
CComControlBase::m_spInPlaceSite
Kapsayıcının IOleInPlaceSite, IOleInPlaceSiteEx veya IOleInPlaceSiteWindowless arabirim işaretçisinin işaretçisi.
CComPtr<IOleInPlaceSiteWindowless>
m_spInPlaceSite;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
İşaretçi m_spInPlaceSite
yalnızca m_bNegotiatedWnd bayrağı TRUE olduğunda geçerlidir.
Aşağıdaki tabloda işaretçi türünün m_bWndLess ve m_bInPlaceSiteEx veri üyesi bayraklarına nasıl m_spInPlaceSite
bağlı olduğu gösterilmektedir:
m_spInPlaceSite Türü | m_bWndLess Değeri | m_bInPlaceSiteEx Değeri |
---|---|---|
IOleInPlaceSiteWindowless |
TRUE | TRUE veya FALSE |
IOleInPlaceSiteEx |
FALSE | TRUE |
IOleInPlaceSite |
FALSE | FALSE |
CComControlBase::m_spOleAdviseHolder
Danışmanlık bağlantılarını tutmanın standart bir uygulamasını sağlar.
CComPtr<IOleAdviseHolder>
m_spOleAdviseHolder;
Açıklamalar
Not
Bu veri üyesini denetim sınıfınızda kullanmak için, denetim sınıfınızda veri üyesi olarak bildirmeniz gerekir. Denetim sınıfınız, temel sınıftaki bir birleşim içinde bildirildiği için bu veri üyesini temel sınıftan devralmayacak.
Arabirim m_spOleAdviseHolder
, kapsayıcıya danışmanlık bağlantıları kurmak ve silmek için IOleObject::Advise ve IOleObject::Unadvise yöntemlerini uygular. Denetimin kapsayıcısı, IAdviseSink arabirimini destekleyerek bir öneri havuzu uygulamalıdır.
CComControlBase::OnDraw
Denetiminizi çizmek için bu yöntemi geçersiz kılın.
virtual HRESULT OnDraw(ATL_DRAWINFO& di);
Parametreler
Di
Çizim yönü, denetim sınırları ve çizimin iyileştirilip iyileştirilmediği gibi çizim bilgilerini içeren ATL_DRAWINFO yapısına başvuru.
Dönüş Değeri
Standart bir HRESULT değeri.
Açıklamalar
Varsayılan değerOnDraw
, CComControlBase::OnDrawAdvanced içinde ayarlanan bayraklara bağlı olarak cihaz bağlamını siler veya geri yükler veya hiçbir şey yapmaz.
ATL Denetim Sihirbazı ile denetiminizi oluşturduğunuzda denetim sınıfınıza otomatik olarak bir OnDraw
yöntem eklenir. Sihirbazın varsayılan ayarı OnDraw
"ATL 8.0" etiketine sahip bir dikdörtgen çizer.
Örnek
CComControlBase::GetAmbientAppearance örneğine bakın.
CComControlBase::OnDrawAdvanced
Varsayılan ayar OnDrawAdvanced
, çizim için normalleştirilmiş bir cihaz bağlamı hazırlar ve ardından denetim sınıfınızın OnDraw
yöntemini çağırır.
virtual HRESULT OnDrawAdvanced(ATL_DRAWINFO& di);
Parametreler
Di
Çizim yönü, denetim sınırları ve çizimin iyileştirilip iyileştirilmediği gibi çizim bilgilerini içeren ATL_DRAWINFO yapısına başvuru.
Dönüş Değeri
Standart bir HRESULT değeri.
Açıklamalar
Kapsayıcı tarafından geçirilen cihaz bağlamını normalleştirmeden kabul etmek istiyorsanız bu yöntemi geçersiz kılın.
Diğer ayrıntılar için bkz . CComControlBase::OnDraw .
CComControlBase::OnKillFocus
Denetimin yerinde etkin olduğunu ve geçerli bir denetim sitesine sahip olduğunu denetler, ardından kapsayıcıya denetimin odağı kaybettiğini bildirir.
LRESULT OnKillFocus(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parametreler
nMsg
Ayrılmış.
wParam
Ayrılmış.
lParam
Ayrılmış.
bHandled
Pencere iletisinin başarıyla işlenip işlenmediğini gösteren bayrak. Varsayılan değer YANLIŞ'tır.
Dönüş Değeri
Her zaman 1 döndürür.
CComControlBase::OnMouseActivate
Kullanıcı arabiriminin kullanıcı modunda olduğunu denetler, ardından denetimi etkinleştirir.
LRESULT OnMouseActivate(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parametreler
nMsg
Ayrılmış.
wParam
Ayrılmış.
lParam
Ayrılmış.
bHandled
Pencere iletisinin başarıyla işlenip işlenmediğini gösteren bayrak. Varsayılan değer YANLIŞ'tır.
Dönüş Değeri
Her zaman 1 döndürür.
CComControlBase::OnPaint
Kapsayıcıyı boyama için hazırlar, denetimin istemci alanını alır ve ardından denetim sınıfının OnDrawAdvanced
yöntemini çağırır.
LRESULT OnPaint(UINT /* nMsg */,
WPARAM wParam,
LPARAM /* lParam */,
BOOL& /* lResult */);
Parametreler
nMsg
Ayrılmış.
wParam
Mevcut bir HDC.
lParam
Ayrılmış.
lResult
Ayrılmış.
Dönüş Değeri
Her zaman sıfır döndürür.
Açıklamalar
wParam NULL değilse, OnPaint
geçerli bir HDC içerdiğini varsayar ve CComControlBase::m_hWndCD yerine bunu kullanır.
CComControlBase::OnSetFocus
Denetimin yerinde etkin olduğunu ve geçerli bir denetim sitesine sahip olduğunu denetler, ardından kapsayıcıya denetimin odaklandığını bildirir.
LRESULT OnSetFocus(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parametreler
nMsg
Ayrılmış.
wParam
Ayrılmış.
lParam
Ayrılmış.
bHandled
Pencere iletisinin başarıyla işlenip işlenmediğini gösteren bayrak. Varsayılan değer YANLIŞ'tır.
Dönüş Değeri
Her zaman 1 döndürür.
Açıklamalar
Kapsayıcıya denetimin odağı aldığına ilişkin bir bildirim gönderir.
CComControlBase::P reTranslateAccelerator
Kendi klavye hızlandırıcısı işleyicilerinizi sağlamak için bu yöntemi geçersiz kılın.
BOOL PreTranslateAccelerator(LPMSG /* pMsg */,
HRESULT& /* hRet */);
Parametreler
pMsg
Ayrılmış.
hRet
Ayrılmış.
Dönüş Değeri
Varsayılan olarak YANLIŞ döndürür.
CComControlBase::SendOnClose
Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin kapatıldığını bildirir.
HRESULT SendOnClose();
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Denetimin danışmanlık havuzlarını kapattığını belirten bir bildirim gönderir.
CComControlBase::SendOnDataChange
Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetim verilerinin değiştiğini bildirir.
HRESULT SendOnDataChange(DWORD advf = 0);
Parametreler
advf
IAdviseSink::OnDataChange çağrısının nasıl yapıldığını belirten öneriler bayrakları. Değerler ADVF sabit listesidir.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CComControlBase::SendOnRename
Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin yeni bir adı olduğunu bildirir.
HRESULT SendOnRename(IMoniker* pmk);
Parametreler
Pmk
Denetimin yeni adını işaret eden işaretçi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Denetim için bilinen adın değiştiğini belirten bir bildirim gönderir.
CComControlBase::SendOnSave
Öneri sahibine kayıtlı tüm danışmanlık havuzlarına denetimin kaydedildiğini bildirir.
HRESULT SendOnSave();
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Denetimin verilerini yeni kaydettiğini belirten bir bildirim gönderir.
CComControlBase::SendOnViewChange
Tüm kayıtlı danışmanlık havuzlarına denetimin görünümünün değiştiğini bildirir.
HRESULT SendOnViewChange(DWORD dwAspect, LONG lindex = -1);
Parametreler
dwAspect
Denetimin yönü veya görünümü.
lindex
Görünümün değişen bölümü. Yalnızca -1 geçerlidir.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
SendOnViewChange
IAdviseSink::OnViewChange'i çağırır. Şu anda desteklenen tek lindex değeri -1'dir ve bu da görünümün tamamının ilgi çekici olduğunu gösterir.
CComControlBase::SetControlFocus
Klavye odağını denetime veya denetimden ayarlar veya kaldırır.
BOOL SetControlFocus(BOOL bGrab);
Parametreler
bGrab
TRUE ise, klavye odağını arama denetimine ayarlar. YANLIŞ ise, odağın o olması koşuluyla klavye odağını arama denetiminden kaldırır.
Dönüş Değeri
Denetim odağı başarıyla alırsa TRUE döndürür; aksi takdirde YANLIŞ.
Açıklamalar
Pencereli denetim için SetFocus Windows API işlevi çağrılır . Penceresiz denetim için IOleInPlaceSiteWindowless ::SetFocus çağrılır . Bu çağrı aracılığıyla, penceresiz bir denetim klavye odağını alır ve pencere iletilerine yanıt verebilir.
CComControlBase::SetDirty
Veri üyesini m_bRequiresSave
bDirty'deki değere ayarlar.
void SetDirty(BOOL bDirty);
Parametreler
bDirty
CComControlBase::m_bRequiresSave veri üyesinin değeri.
Açıklamalar
SetDirty(TRUE)
denetimin son kaydedildiğinden bu yana değiştiğini işaretlemek için çağrılmalıdır. değeri m_bRequiresSave
CComControlBase::GetDirty ile alınır.