CTooltipManager Sınıfı

Araç ipuçları hakkındaki çalışma zamanı bilgilerini korur. Sınıfın CTooltipManager örneği uygulama başına bir kez oluşturulur.

Sözdizimi

class CTooltipManager : public CObject

Üyeler

Genel Yöntemler

Veri Akışı Adı	Açıklama
CTooltipManager::CreateToolTip	Belirtilen Windows denetim türleri için bir araç ipucu denetimi oluşturur.
CTooltipManager::D eleteToolTip	Araç ipucu denetimini siler.
CTooltipManager::SetTooltipParams	Belirtilen Windows denetim türleri için araç ipucu denetiminin görsel görünümünü özelleştirir.
CTooltipManager::SetTooltipText	Araç ipucu denetimi için metin ve açıklamayı ayarlar.
CTooltipManager::UpdateTooltips

Açıklamalar

Uygulamanızda özelleştirilmiş araç ipuçlarını uygulamak için CMFCToolTipCtrl SınıfıCMFCToolTipInfo ve CTooltipManager öğelerini birlikte kullanın. Bu araç ipucu sınıflarının nasıl kullanılacağına ilişkin bir örnek için CMFCToolTipCtrl Sınıfı konusuna bakın.

Devralma Hiyerarşisi

CObject

CTooltipManager

Gereksinimler

Üst bilgi: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Bir araç ipucu denetimi oluşturur.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

Parametreler

pToolTip
[out] Araç ipucu işaretçisine başvuru. İşlev döndürdüğünde yeni oluşturulan araç ipucuna işaret etmek için ayarlanır.

pWndParent
[in] Araç ipucunun üst öğesi.

nType
[in] Araç ipucunun türü.

Dönüş Değeri

Bir araç ipucu başarıyla oluşturulduysa sıfır olmayan.

Açıklamalar

pToolTip'e geri geçirilen araç ipucu denetimini silmek için CTooltipManager::D eleteToolTip'i çağırmalısınız.

CTooltipManager, oluşturduğu her araç ipucunun görsel görüntüleme parametrelerini nType'ın belirttiği araç ipucu türüne göre ayarlar. Bir veya daha fazla araç ipucu türünün parametrelerini değiştirmek için CTooltipManager::SetTooltipParams çağrısı yapın.

Geçerli araç ipucu türleri aşağıdaki tabloda listelenmiştir:

Araç ipucu türü	Denetim kategorisi	Örnek türler
AFX_TOOLTIP_TYPE_BUTTON	Bir düğme.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Resim yazısı çubuğu.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Başka bir kategoriye sığmayan herhangi bir denetim.	Yok.
AFX_TOOLTIP_TYPE_DOCKBAR	Yerleştirilebilir bir bölme.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Metin kutusu.	Yok.
AFX_TOOLTIP_TYPE_MINIFRAME	Mini çerçeve.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Planlayıcı.	Yok.
AFX_TOOLTIP_TYPE_RIBBON	Şerit çubuğu.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Sekme denetimi.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Araç çubuğu.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Araç kutusu.	Yok.

CTooltipManager::D eleteToolTip

Araç ipucu denetimini siler.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parametreler

pToolTip
[in, out] Yok edilecek bir araç ipucu işaretçisine başvuru.

Açıklamalar

CTooltipManager::CreateToolTip tarafından oluşturulan her CToolTipCtrl Sınıfı için bu yöntemi çağırabilirsiniz. Üst denetim, işleyicisinden OnDestroy bu yöntemi çağırmalıdır. Araç ipucunun çerçeveden doğru şekilde kaldırılması için bu gereklidir. Bu yöntem, pToolTip'i döndürmeden önce NULL olarak ayarlar.

CTooltipManager::SetTooltipParams

Belirtilen Windows denetim türleri için araç ipucu denetiminin görünümünü özelleştirir.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

Parametreler

nTypes
[in] Denetim türlerini belirtir.

pRTC
[in] Özel araç ipucunun çalışma zamanı sınıfı.

pParams
[in] Araç ipucu parametreleri.

Açıklamalar

Bu yöntem, CToolTipManager'ın araç ipuçları oluştururken kullandığı çalışma zamanı sınıfını ve başlangıç parametrelerini ayarlar. Denetim CTooltipManager::CreateToolTip'i çağırdığında ve nTypes tarafından belirtilen türlerden biri olan bir araç ipucu türüne geçtiğinde, araç ipucu yöneticisi pRTC tarafından belirtilen çalışma zamanı sınıfının bir örneği olan bir araç ipucu denetimi oluşturur ve pParams tarafından belirtilen parametreleri yeni araç ipucuna geçirir.

Bu yöntemi çağırdığınızda, var olan tüm araç ipucu sahipleri AFX_WM_UPDATETOOLTIPS iletisini alır ve CTooltipManager::CreateToolTip kullanarak araç ipuçlarını yeniden oluşturmaları gerekir.

nType'lar, CTooltipManager::CreateToolTip tarafından kullanılan geçerli araç ipucu türlerinin herhangi bir bileşimi veya AFX_TOOLTIP_TYPE_ALL olabilir. AFX_TOOLTIP_TYPE_ALL geçirirseniz, tüm araç ipucu türleri etkilenir.

Örnek

Aşağıdaki örnekte sınıfının yönteminin SetTooltipParams nasıl kullanılacağı gösterilmektedir CTooltipManager . Bu kod parçacığı, draw client örneğinin bir parçasıdır.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

CTooltipManager::SetTooltipText

Araç ipucunun metnini ve açıklamasını ayarlar.

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

Parametreler

Ptı
[in] TOOLINFO nesnesinin işaretçisi.

pToolTip
[in, out] Metin ve açıklamanın ayarlanacağı araç ipucu denetiminin işaretçisi.

nType
[in] Bu araç ipucunun ilişkilendirildiği denetim türünü belirtir.

strText
[in] Araç ipucu metni olarak ayarlanacağı metin.

lpszDescr
[in] Araç ipucu açıklamasının işaretçisi. NULL olabilir.

Açıklamalar

Araç ipucunu oluştururken nType değeri CTooltipManager::CreateToolTip'in nType parametresiyle aynı değer olmalıdır.

CTooltipManager::UpdateTooltips

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

void UpdateTooltips();

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCToolTipCtrl Sınıfı
CMFCToolTipInfo Sınıfı