CMFCTabDropTarget Sınıfı

Sekme denetimi ile OLE kitaplıkları arasındaki iletişim mekanizmasını sağlar.

Sözdizimi

class CMFCTabDropTarget : public COleDropTarget

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

Bu sınıf, sınıfına CMFCBaseTabCtrl sürükle ve bırak desteği sağlar. Uygulamanız AfxOleInit işlevini kullanarak OLE kitaplıklarını başlatırsa, CMFCBaseTabCtrl nesneler kendilerini sürükle ve bırak işlemleri için kaydeder.

sınıfı, CMFCTabDropTarget bir sürükleme işlemi gerçekleştiğinde imlecin altındaki sekmeyi etkin hale getirerek temel sınıfını genişletir. Sürükle ve bırak işlemleri hakkında daha fazla bilgi için bkz . OLE sürükle ve bırak.

Örnek

Aşağıdaki örnekte bir CMFCTabDropTarget nesnenin nasıl oluşturup yönteminin nasıl kullanılacağı gösterilmektedir Register .

HWND hWndTab = NULL;
CBasePane *basePane = new CBasePane();
CMFCBaseTabCtrl *pTabParent = basePane->GetParentTabWnd(hWndTab);
CMFCTabDropTarget *dropTarget = new CMFCTabDropTarget();
dropTarget->Register(pTabParent);

Devralma Hiyerarşisi

CObject

CCmdTarget

COleDropTarget

CMFCTabDropTarget

Gereksinimler

Üst bilgi: afxbasetabctrl.h

CMFCTabDropTarget::OnDragEnter

Kullanıcı bir nesneyi sekme penceresine sürüklediğinde çerçeve tarafından çağrılır.

virtual DROPEFFECT OnDragEnter(
    CWnd* pWnd,
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parametreler

pWnd
[in] Kullanılma -yan.

pDataObject
[in] Kullanıcının sürüklediğini nesnenin işaretçisi.

dwKeyState
[in] Değiştirici anahtarların durumunu içerir. Bu, aşağıdaki sayılardan herhangi birinin birleşimidir: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON ve MK_RBUTTON.

nokta
[in] İmlecin istemci koordinatlarındaki konumu.

Dönüş Değeri

Bırakmanın noktayla belirtilen konumda gerçekleşmesi durumunda ortaya çıkan etki. Aşağıdakilerden biri veya daha fazlası olabilir:

• DROPEFFECT_NONE

• DROPEFFECT_COPY

• DROPEFFECT_MOVE

• DROPEFFECT_LINK

• DROPEFFECT_SCROLL

Açıklamalar

Araç çubuğu çerçevesi özelleştirme modunda değilse veya Pano veri biçimi kullanılamıyorsa bu yöntem DROPEFFECT_NONE döndürür. Aksi takdirde, sağlanan parametrelerle çağrının CMFCBaseTabCtrl::OnDragEnter sonucunu döndürür.

Özelleştirme modu hakkında daha fazla bilgi için bkz . CMFCToolBar::IsCustomizeMode. Pano veri biçimleri hakkında daha fazla bilgi için bkz . COleDataObject::IsDataAvailable.

CMFCTabDropTarget::OnDragLeave

Kullanıcı odağı olan bir nesneyi sekme penceresinin dışına sürüklediğinde çerçeve tarafından çağrılır.

virtual void OnDragLeave(CWnd* pWnd);

Parametreler

pWnd
[in] Kullanılma -yan.

Açıklamalar

Bu yöntem, sürükleme işlemini gerçekleştirmek için yöntemini çağırır CMFCBaseTabCtrl::OnDragLeave .

CMFCTabDropTarget::OnDragOver

Kullanıcı odağı olan sekme penceresine bir nesne sürüklediğinde çerçeve tarafından çağrılır.

virtual DROPEFFECT OnDragOver(
    CWnd* pWnd,
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parametreler

pWnd
[in] Kullanılma -yan.

pDataObject
[in] Kullanıcının sürüklediğini nesnenin işaretçisi.

dwKeyState
[in] Değiştirici anahtarların durumunu içerir. Bu, aşağıdaki sayılardan herhangi birinin birleşimidir: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON ve MK_RBUTTON.

nokta
[in] fare işaretçisinin istemci koordinatlarındaki konumu.

Dönüş Değeri

Bırakmanın noktayla belirtilen konumda gerçekleşmesi durumunda ortaya çıkan etki. Aşağıdakilerden biri veya daha fazlası olabilir:

• DROPEFFECT_NONE

• DROPEFFECT_COPY

• DROPEFFECT_MOVE

• DROPEFFECT_LINK

• DROPEFFECT_SCROLL

Açıklamalar

Bu yöntem, bir sürükleme işlemi gerçekleştiğinde imlecin altındaki sekmeyi etkin hale getirir. Araç çubuğu çerçevesi özelleştirme modunda değilse veya Pano veri biçimi kullanılamıyorsa DROPEFFECT_NONE döndürür. Aksi takdirde, sağlanan parametrelerle çağrının CMFCBaseTabCtrl::OnDragOver sonucunu döndürür.

Özelleştirme modu hakkında daha fazla bilgi için bkz . CMFCToolBar::IsCustomizeMode. Pano veri biçimleri hakkında daha fazla bilgi için bkz . COleDataObject::IsDataAvailable.

CMFCTabDropTarget::OnDropEx

Kullanıcı sürükleme işleminin sonunda fare düğmesini serbest bıraktığında çerçeve tarafından çağrılır.

virtual DROPEFFECT OnDropEx(
    CWnd* pWnd,
    COleDataObject* pDataObject,
    DROPEFFECT dropEffect,
    DROPEFFECT dropList,
    CPoint point);

Parametreler

pWnd
[in] Kullanılma -yan.

pDataObject
[in] Kullanıcının sürüklediğini nesnenin işaretçisi.

dropEffect
[in] Varsayılan bırakma işlemi.

dropList
[in] Kullanılma -yan.

nokta
[in] fare işaretçisinin istemci koordinatlarındaki konumu.

Dönüş Değeri

Sonuçta elde edilen bırakma efekti. Aşağıdakilerden biri veya daha fazlası olabilir:

• DROPEFFECT_NONE

• DROPEFFECT_COPY

• DROPEFFECT_MOVE

• DROPEFFECT_LINK

• DROPEFFECT_SCROLL

Açıklamalar

Bu yöntem, araç çubuğu çerçevesi özelleştirme modundaysa ve Pano veri biçimi kullanılabiliyorsa çağırır CMFCBaseTabCtrl::OnDrop . çağrısı CMFCBaseTabCtrl::OnDrop sıfır olmayan bir değer döndürürse, bu yöntem dropEffect tarafından belirtilen varsayılan bırakma efektini döndürür. Aksi takdirde, bu yöntem DROPEFFECT_NONE döndürür. Bırakma efektleri hakkında daha fazla bilgi için bkz . COleDropTarget::OnDropEx.

Özelleştirme modu hakkında daha fazla bilgi için bkz . CMFCToolBar::IsCustomizeMode. Pano veri biçimleri hakkında daha fazla bilgi için bkz . COleDataObject::IsDataAvailable.

CMFCTabDropTarget::Register

Denetimi ole sürükle ve bırak işleminin hedefi olabilecek bir denetim olarak kaydeder.

BOOL Register(CMFCBaseTabCtrl *pOwner);

Parametreler

pOwner
[in] Bırakma hedefi olarak kaydetmek için sekme denetimi.

Dönüş Değeri

Kayıt başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu yöntem, denetimi sürükleyip bırakma işlemlerine kaydetmek için COleDropTarget::Register öğesini çağırır.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
OLE sürükle ve bırak