CMFCToolTipCtrl Sınıfı

Makale
08/04/2024

CToolTipCtrl Sınıfını temel alan genişletilmiş bir araç ipucu uygulaması. sınıfını CMFCToolTipCtrl temel alan araç ipucu bir simge, etiket ve açıklama görüntüleyebilir. Gradyan dolgu, özel metin ve kenarlık renkleri, kalın metin, yuvarlak köşeler veya balon stili kullanarak görsel görünümünü özelleştirebilirsiniz.

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

Sözdizimi

class CMFCToolTipCtrl : public CToolTipCtrl

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
`CMFCToolTipCtrl::CMFCToolTipCtrl`	Varsayılan oluşturucu.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCToolTipCtrl::GetIconSize	Araç ipucundaki bir simgenin boyutunu döndürür.
CMFCToolTipCtrl::GetParams	Araç ipucunun görüntü ayarlarını döndürür.
CMFCToolTipCtrl::OnDrawBorder	Araç ipucunun kenarlığı çizer.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Araç ipucunda bir simge görüntüler.
CMFCToolTipCtrl::OnDrawLabel	Araç ipucunun etiketini çizer veya etiketin boyutunu hesaplar.
CMFCToolTipCtrl::OnDrawSeparator	Ayırıcıyı bir araç ipucundaki etiket ve açıklama arasına çizer.
CMFCToolTipCtrl::OnFillBackground	Araç ipucu arka planını doldurur.
CMFCToolTipCtrl::SetDescription	Açıklamayı araç ipucu tarafından görüntülenecek şekilde ayarlar.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Nesne kullanarak `CMFCToolTipInfo` bir araç ipucunun görsel görünümünü belirtir.

Açıklamalar

Uygulamanızda özelleştirilmiş araç ipuçlarını uygulamak için , CMFCToolTipInfove CTooltipManager Sınıfı nesnelerini birlikte kullanınCMFCToolTipCtrl.

Örneğin, balon stili araç ipuçlarını kullanmak için şu adımları izleyin:

Uygulamanızda araç ipucu yöneticisini başlatmak için CWinAppEx Sınıfı yöntemini kullanın.

İstediğiniz görsel stilini belirtmek için bir CMFCToolTipInfo yapı oluşturun:

CMFCToolTipInfo params;
params.m_bBoldLabel = FALSE;
params.m_bDrawDescription = FALSE;
params.m_bDrawIcon = FALSE;
params.m_bRoundedCorners = TRUE;
params.m_bDrawSeparator = FALSE;
if (m_bCustomColors)
{
    params.m_clrFill = RGB (255, 255, 255);
    params.m_clrFillGradient = RGB (228, 228, 240);
    params.m_clrText = RGB (61, 83, 80);
    params.m_clrBorder = RGB (144, 149, 168);

}

Nesnede tanımlanan CMFCToolTipInfo stilleri kullanarak uygulamadaki tüm araç ipuçlarının görsel stilini ayarlamak için CTooltipManager::SetTooltipParams yöntemini kullanın:
```
theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMFCToolTipCtrl), &params);
```

Araç ipucu davranışını ve işlemeyi denetlemek için öğesinden CMFCToolTipCtrl yeni bir sınıf da türetebilirsiniz. Yeni bir araç ipucu denetim sınıfı belirtmek için yöntemini kullanın CTooltipManager::SetTooltipParams :

myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMyToolTipCtrl))

Varsayılan araç ipucu denetim sınıfını geri yüklemek ve araç ipucu görünümünü varsayılan durumuna sıfırlamak için, çalışma zamanı sınıfında NULL değerini ve araç ipucu bilgi parametrelerini SetTooltipParamsbelirtin:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    NULL,
    NULL);

Örnek

Aşağıdaki örnekte bir CMFCToolTipCtrl nesnenin nasıl oluşturlanacağı, araç ipucunun görüntülediği açıklamanın nasıl ayarlanacağı ve araç ipucu denetiminin genişliğinin nasıl ayarlanacağı gösterilmektedir.

CMFCToolTipInfo *params = new CMFCToolTipInfo();

params->m_bBoldLabel = FALSE;
params->m_bDrawDescription = FALSE;
params->m_bDrawIcon = FALSE;
params->m_bRoundedCorners = TRUE;
params->m_bDrawSeparator = FALSE;
params->m_clrFill = RGB(255, 255, 255);
params->m_clrFillGradient = RGB(228, 228, 240);
params->m_clrText = RGB(61, 83, 80);
params->m_clrBorder = RGB(144, 149, 168);

CMFCToolTipCtrl *tipCtrl = new CMFCToolTipCtrl(params);
tipCtrl->SetDescription(_T("tool tip control"));
tipCtrl->SetFixedWidth(100, 150);

Devralma Hiyerarşisi

Gereksinimler

Üst bilgi: afxtooltipctrl.h

CMFCToolTipCtrl::CMFCToolTipCtrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Parametreler

[in] pParams

Açıklamalar

CMFCToolTipCtrl::GetIconSize

Araç ipucundaki bir simgenin boyutunu döndürür.

virtual CSize GetIconSize();

Dönüş Değeri

Simgenin piksel cinsinden boyutu.

CMFCToolTipCtrl::GetParams

Araç ipucunun görüntü ayarlarını döndürür.

const CMFCToolTipInfo& GetParams() const;

Dönüş Değeri

CmFCToolTipInfo Sınıfı nesnesinde depolanan geçerli araç ipucu görüntüleme ayarları.

CMFCToolTipCtrl::OnDrawBorder

Araç ipucunun kenarlığı çizer.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rect,
    COLORREF clrLine);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Rect
[in] Araç ipucunun sınırlayıcı dikdörtgeni.

clrLine
[in] Kenarlık rengi.

Açıklamalar

Araç ipucu kenarlığı görünümünü özelleştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolTipCtrl::OnDrawDescription

virtual CSize OnDrawDescription(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parametreler

[in] pDC
[in] Rect
[in] bCalcOnly

Dönüş Değeri

Açıklamalar

CMFCToolTipCtrl::OnDrawIcon

Araç ipucunda bir simge görüntüler.

virtual BOOL OnDrawIcon(
    CDC* pDC,
    CRect rectImage);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

rectImage
[in] Simgenin koordinatları.

Dönüş Değeri

Simge çizildiyse TRUE. Aksi takdirde FALSE.

Açıklamalar

Özel bir simge görüntülemek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın. Araç ipucunun metin ve açıklama düzenini doğru hesaplamasını sağlamak için CMFCToolTipCtrl::GetIconSize'ı da geçersiz kılmalısınız.

CMFCToolTipCtrl::OnDrawLabel

Araç ipucunun etiketini çizer veya etiketin boyutunu hesaplar.

virtual CSize OnDrawLabel(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Rect
[in] Etiket alanının sınırlayıcı dikdörtgeni.

bCalcOnly
[in] TRUE ise etiket çizilmeyecektir.

Dönüş Değeri

Etiketin piksel cinsinden boyutu.

Açıklamalar

Araç ipucu etiketinin görünümünü özelleştirmek istiyorsanız, türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolTipCtrl::OnDrawSeparator

Ayırıcıyı bir araç ipucundaki etiket ve açıklama arasına çizer.

virtual void OnDrawSeparator(
    CDC* pDC,
    int x1,
    int x2,
    int y);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

x1
[in] Ayırıcının sol ucunun yatay koordinatı.

x2
[in] Ayırıcının sağ ucunun yatay koordinatı.

Y
[in] Ayırıcının dikey koordinatı.

Açıklamalar

Varsayılan uygulama noktadan (x1, y) noktaya (x2, y) bir çizgi çizer.

Ayırıcının görünümünü özelleştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolTipCtrl::OnFillBackground

Araç ipucu arka planını doldurur.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect,
    COLORREF& clrText,
    COLORREF& clrLine);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Rect
[in] Doldurulacak alanın sınırlayıcı dikdörtgenini belirtir.

clrText
[in] Araç ipucu ön plan rengi.

clrLine
[in] Etiket ve açıklama arasındaki kenarlıkların rengi ve sınırlayıcı çizgisi.

Açıklamalar

Varsayılan uygulama, rect tarafından belirtilen dikdörtgeni CMFCToolTipCtrl::SetParams'a yapılan en son çağrı tarafından belirtilen renk veya desenle doldurur.

Araç ipucunun görünümünü özelleştirmek istiyorsanız, türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolTipCtrl::SetDescription

Açıklamayı araç ipucu tarafından görüntülenecek şekilde ayarlar.

virtual void SetDescription(const CString strDesrciption);

Parametreler

strDesrciption
[in] Açıklama metni.

Açıklamalar

Açıklama metni araç ipucunda ayırıcının altında görüntülenir.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametreler

[in] nWidthRegular
[in] nWidthLargeImage

Açıklamalar

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Parametreler

[in] pRibbonButton

Açıklamalar

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Parametreler

[in] Pt

Açıklamalar

CMFCToolTipCtrl::SetParams

CMFCToolTipInfo Sınıf nesnesi kullanarak bir araç ipucunun görsel görünümünü belirtir.

void SetParams(CMFCToolTipInfo* pParams);

Parametreler

pParams
[in] Görüntüleme parametrelerini içeren bir CMFCToolTipInfo Sınıfı nesnesinin işaretçisi.

Açıklamalar

Araç ipucu her görüntülendiğinde, pParams'ın belirttiği renkler ve görsel stiller kullanılarak çizilir. pParams değeri, belirtilen görünümü korumak için CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon , CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipCtrl::OnDrawSeparator veya CMFCToolTipCtrl::OnFillBackground'ı geçersiz kılan türetilmiş bir sınıf tarafından erişilebilen korumalı üyede m_Params depolanır.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CToolTipCtrl Sınıfı
CTooltipManager Sınıfı
CMFCToolTipInfo Sınıfı
CWinAppEx Sınıfı

Aracılığıyla paylaş

CMFCToolTipCtrl Sınıfı

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

Örnek

Devralma Hiyerarşisi

Gereksinimler

CMFCToolTipCtrl::CMFCToolTipCtrl

Parametreler

Açıklamalar

CMFCToolTipCtrl::GetIconSize

Dönüş Değeri

CMFCToolTipCtrl::GetParams

Dönüş Değeri

CMFCToolTipCtrl::OnDrawBorder

Parametreler

Açıklamalar

CMFCToolTipCtrl::OnDrawDescription

Parametreler

Dönüş Değeri

Açıklamalar

CMFCToolTipCtrl::OnDrawIcon

Parametreler

Dönüş Değeri

Açıklamalar

CMFCToolTipCtrl::OnDrawLabel

Parametreler

Dönüş Değeri

Açıklamalar

CMFCToolTipCtrl::OnDrawSeparator

Parametreler

Açıklamalar

CMFCToolTipCtrl::OnFillBackground

Parametreler

Açıklamalar

CMFCToolTipCtrl::SetDescription

Parametreler

Açıklamalar

CMFCToolTipCtrl::SetFixedWidth

Parametreler

Açıklamalar

CMFCToolTipCtrl::SetHotRibbonButton

Parametreler

Açıklamalar

CMFCToolTipCtrl::SetLocation

Parametreler

Açıklamalar

CMFCToolTipCtrl::SetParams

Parametreler

Açıklamalar

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar