CToolTipCtrl Sınıf

Uygulamadaki bir aracın amacını açıklayan tek satırlık bir metin görüntüleyen küçük bir açılır pencere olan "araç ipucu denetiminin" işlevselliğini kapsüller.

Sözdizimi

class CToolTipCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CToolTipCtrl::CToolTipCtrl	Bir CToolTipCtrl nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CToolTipCtrl::Activate	Araç ipucu denetimini etkinleştirir ve devre dışı bırakır.
CToolTipCtrl::AddTool	Bir aracı araç ipucu denetimiyle kaydeder.
CToolTipCtrl::AdjustRect	Araç ipucu denetiminin metin görüntüleme dikdörtgeni ile pencere dikdörtgeni arasında dönüştürür.
CToolTipCtrl::Create	Bir araç ipucu denetimi oluşturur ve bunu bir CToolTipCtrl nesneye ekler.
CToolTipCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir araç ipucu denetimi oluşturur ve bunu bir CToolTipCtrl nesneye ekler.
CToolTipCtrl::DelTool	Araç ipucu denetiminden bir aracı kaldırır.
CToolTipCtrl::GetBubbleSize	Araç ipucunun boyutunu alır.
CToolTipCtrl::GetCurrentTool	Geçerli araç ipucu denetiminin görüntülediği araç ipucu penceresinin boyutu, konumu ve metni gibi bilgileri alır.
CToolTipCtrl::GetDelayTime	Şu anda bir araç ipucu denetimi için ayarlanmış olan başlangıç, açılır pencere ve yeniden gösterme sürelerini alır.
CToolTipCtrl::GetMargin	Araç ipucu penceresi için ayarlanan üst, sol, alt ve sağ kenar boşluklarını alır.
CToolTipCtrl::GetMaxTipWidth	Araç ipucu penceresinin en büyük genişliğini alır.
CToolTipCtrl::GetText	Araç ipucu denetiminin bir araç için koruduğu metni alır.
CToolTipCtrl::GetTipBkColor	Araç ipucu penceresinde arka plan rengini alır.
CToolTipCtrl::GetTipTextColor	Araç ipucu penceresindeki metin rengini alır.
CToolTipCtrl::GetTitle	Geçerli araç ipucu denetiminin başlığını alır.
CToolTipCtrl::GetToolCount	Bir araç ipucu denetimi tarafından tutulan araçların sayısını alır.
CToolTipCtrl::GetToolInfo	Araç ipucu denetiminin bir araç hakkında koruduğu bilgileri alır.
CToolTipCtrl::HitTest	Belirli bir aracın sınırlayıcı dikdörtgeni içinde olup olmadığını belirlemek için bir noktayı test eder. Öyleyse, araç hakkındaki bilgileri alır.
CToolTipCtrl::Pop	Görüntülenen araç ipucu penceresini görünümden kaldırır.
CToolTipCtrl::Popup	Geçerli araç ipucu denetiminin son fare iletisinin koordinatlarında görüntülenmesine neden olur.
CToolTipCtrl::RelayEvent	İşlenmek üzere bir araç ipucu denetimine fare iletisi geçirir.
CToolTipCtrl::SetDelayTime	Bir araç ipucu denetimi için başlangıç, açılır pencere ve yeniden gösteri sürelerini ayarlar.
CToolTipCtrl::SetMargin	Araç ipucu penceresi için üst, sol, alt ve sağ kenar boşluklarını ayarlar.
CToolTipCtrl::SetMaxTipWidth	Araç ipucu penceresi için en yüksek genişliği ayarlar.
CToolTipCtrl::SetTipBkColor	Araç ipucu penceresinde arka plan rengini ayarlar.
CToolTipCtrl::SetTipTextColor	Araç ipucu penceresinde metin rengini ayarlar.
CToolTipCtrl::SetTitle	Araç ipucuna standart bir simge ve başlık dizesi ekler.
CToolTipCtrl::SetToolInfo	Araç ipucunun bir araç için koruduğu bilgileri ayarlar.
CToolTipCtrl::SetToolRect	Bir araç için yeni bir sınırlayıcı dikdörtgen ayarlar.
CToolTipCtrl::SetWindowTheme	Araç ipucu penceresinin görsel stilini ayarlar.
CToolTipCtrl::Update	Geçerli aracı yeniden çizilmeye zorlar.
CToolTipCtrl::UpdateTipText	Bir aracın araç ipucu metnini ayarlar.

Açıklamalar

"Araç", alt pencere veya denetim gibi bir pencere ya da pencerenin istemci alanındaki uygulama tanımlı dikdörtgen bir alandır. Araç ipucu çoğu zaman gizlenir ve yalnızca kullanıcı imleci bir araca yerleştirdiğinde ve yaklaşık yarım saniye orada bıraktığında görünür. Araç ipucu imlecin yanında görünür ve kullanıcı fare düğmesine tıkladığında veya imleci araçtan uzaklaştırdığında kaybolur.

CToolTipCtrl araç ipucunun ilk zamanını ve süresini, araç ipucu metnini çevreleyen kenar boşluğu genişliklerini, araç ipucu penceresinin genişliğini ve araç ipucunun arka planını ve metin rengini denetleme işlevi sağlar. Tek bir araç ipucu denetimi birden fazla araç için bilgi sağlayabilir.

sınıfı, CToolTipCtrl Windows ortak araç ipucu denetiminin işlevselliğini sağlar. Bu denetim (ve dolayısıyla CToolTipCtrl sınıf) yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir.

Araç ipuçlarını etkinleştirme hakkında daha fazla bilgi için bkz . Windows'ta Türetilmeyen CFrameWndAraç İpuçları.

kullanma CToolTipCtrlhakkında daha fazla bilgi için bkz. Denetimler ve Kullanma CToolTipCtrl.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CToolTipCtrl

Gereksinimler

Üstbilgi: afxcmn.h

CToolTipCtrl::Activate

Araç ipucu denetimini etkinleştirmek veya devre dışı bırakmak için bu işlevi çağırabilirsiniz.

void Activate(BOOL bActivate);

Parametreler

bActivate
Araç ipucu denetiminin etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakıldığını belirtir.

Açıklamalar

ise bActivate TRUE, denetim etkinleştirilir; ise FALSEdevre dışı bırakılır.

Araç ipucu denetimi etkin olduğunda, imleç denetime kayıtlı bir aracın üzerindeyken araç ipucu bilgileri görüntülenir; etkin olmadığında, imleç bir aracın üzerinde olsa bile araç ipucu bilgileri görünmez.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CToolTipCtrl::AddTool

Bir aracı araç ipucu denetimiyle kaydeder.

BOOL AddTool(
    CWnd* pWnd,
    UINT nIDText,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

BOOL AddTool(
    CWnd* pWnd,
    LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

Parametreler

pWnd
Aracı içeren pencerenin işaretçisi.

nIDText
Aracın metnini içeren dize kaynağının kimliği.

lpRectTool
Aracın sınırlayıcı dikdörtgeninin koordinatlarını içeren bir RECT yapıya yönelik işaretçi. Koordinatlar, tarafından pWndtanımlanan pencerenin istemci alanının sol üst köşesine göre belirlenir.

nIDTool
Aracın kimliği.

lpszText
Aracın metnine yönelik işaretçi. Bu parametre değerini LPSTR_TEXTCALLBACKiçeriyorsa, TTN_NEEDTEXT bildirim iletileri pencerenin işaret eden pWnd üst öğesine gider.

Dönüş Değeri

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

Açıklamalar

ve parametrelerinin lpRectTool her ikisi de geçerli veya ise lpRectTool NULLnIDTool 0 olmalıdır.nIDTool

Araç ipucu denetimi birden fazla araçla ilişkilendirilebilir. Araç ipucu denetimine bir araç kaydetmek için bu işlevi çağırın; böylece imleç araç üzerindeyken araç ipucunda depolanan bilgiler görüntülenir.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CToolTipCtrl::AdjustRect

Araç ipucu denetiminin metin görüntüleme dikdörtgeni ile pencere dikdörtgeni arasında dönüştürür.

BOOL AdjustRect(
    LPRECT lprc,
    BOOL bLarger = TRUE);

Parametreler

lprc
RECT Araç ipucu penceresi dikdörtgeni veya metin görüntüleme dikdörtgeni tutan bir yapıya işaret eden işaretçi.

bLarger
lprc iseTRUE, metin görüntüleme dikdörtgeni belirtmek için kullanılır ve ilgili pencere dikdörtgenini alır. lprc iseFALSE, bir pencere dikdörtgeni belirtmek için kullanılır ve ilgili metin görüntüleme dikdörtgenini alır.

Dönüş Değeri

Dikdörtgen başarıyla ayarlanırsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu üye işlevi, bir araç ipucu denetiminin metin görüntüleme dikdörtgenini pencere dikdörtgeninden veya belirtilen metin görüntüleme dikdörtgenini görüntülemek için gereken araç ipucu penceresi dikdörtgenini hesaplar.

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_ADJUSTRECTdavranışını uygular.

CToolTipCtrl::Create

Bir araç ipucu denetimi oluşturur ve bunu bir CToolTipCtrl nesneye ekler.

virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);

Parametreler

pParentWnd
Araç ipucu denetiminin üst penceresini( genellikle bir CDialog) belirtir. Bu olmamalıdır NULL.

dwStyle
Araç ipucu denetiminin stilini belirtir. Daha fazla bilgi için Açıklamalar bölümüne bakın.

Dönüş Değeri

Nesne başarıyla oluşturulduysa CToolTipCtrl sıfır olmayan; aksi takdirde 0.

Açıklamalar

İki adımda bir CToolTipCtrl oluşturursunuz. İlk olarak, nesnesini oluşturmak için oluşturucuyu çağırın CToolTipCtrl ve ardından araç ipucu denetimini oluşturup nesneye eklemek için öğesini çağırın Create CToolTipCtrl .

parametresi, dwStyle Pencere Stilleri'nin herhangi bir bileşimi olabilir. Ayrıca, bir araç ipucu denetiminin sınıfa özgü iki stili vardır: TTS_ALWAYSTIP ve TTS_NOPREFIX.

Stil	Anlamı
TTS_ALWAYSTIP	Araç ipucu denetiminin sahip penceresinin etkin veya etkin olmamasından bağımsız olarak, araç ipucunun bir aracın üzerindeyken görüneceğini belirtir. Bu stil olmadan, araç ipucu denetimi aracın sahip penceresi etkin olduğunda görünür, ancak etkin olmadığında görüntülenmez.
TTS_NOPREFIX	Bu stil, sistemin ve işareti (&) karakterini bir dizeden çıkarmasını engeller. Araç ipucu denetimi stiline TTS_NOPREFIX sahip değilse, sistem ve karakterlerini otomatik olarak ayırarak uygulamanın hem menü öğesiyle hem de araç ipucu denetimindeki metin olarak aynı dizeyi kullanmasına olanak sağlar.

Araç ipucu denetimi, denetimi oluştururken belirtip belirtmediğinize bakılmaksızın ve WS_EX_TOOLWINDOW pencere stillerine sahiptirWS_POPUP.

Genişletilmiş windows stilleriyle bir araç ipucu denetimi oluşturmak için yerine öğesini çağırın CToolTipCtrl::CreateEx Create.

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CToolTipCtrl::CreateEx

Bir denetim (alt pencere) oluşturur ve bunu nesnesiyle CToolTipCtrl ilişkilendirir.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwStyle = 0,
    DWORD dwStyleEx = 0);

Parametreler

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

dwStyle
Araç ipucu denetiminin stilini belirtir. Daha fazla bilgi için'nin Create Açıklamalar bölümüne bakın.

dwStyleEx
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında parametresine CreateWindowEx bakındwExStyle.

Dönüş Değeri

Aksi takdirde başarılı olursa sıfır olmayan 0.

Açıklamalar

Create Yerine, Windows genişletilmiş stil ön biçimi WS_EX_tarafından belirtilen genişletilmiş Windows stilleri uygulamak için kullanınCreateEx.

CToolTipCtrl::CToolTipCtrl

Bir CToolTipCtrl nesne oluşturur.

CToolTipCtrl();

Açıklamalar

Nesnesini oluşturmadan sonra çağırmalısınız Create .

Örnek

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

ve tarafından pWnd nIDTool belirtilen aracı bir araç ipucu denetimi tarafından desteklenen araçlar koleksiyonundan kaldırır.

void DelTool(
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parametreler

pWnd
Aracı içeren pencerenin işaretçisi.

nIDTool
Aracın kimliği.

CToolTipCtrl::GetBubbleSize

Araç ipucunun boyutunu alır.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parametreler

lpToolInfo
Araç ipucunun yapısının işaretçisi TOOLINFO .

Dönüş Değeri

Araç ipucunun boyutu.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETBUBBLESIZEdavranışını uygular.

CToolTipCtrl::GetCurrentTool

Geçerli araç ipucu denetimi tarafından görüntülenen araç ipucu penceresinin boyutu, konumu ve metni gibi bilgileri alır.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parametreler

lpToolInfo
[out] Geçerli araç ipucu penceresi hakkında bilgi alan bir TOOLINFO yapı işaretçisi.

Dönüş Değeri

TRUE bilgiler başarıyla alınırsa; aksi takdirde , FALSE.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TTM_GETCURRENTTOOL .

Örnek

Aşağıdaki kod örneği geçerli araç ipucu penceresi hakkındaki bilgileri alır.

{
    //Get information about the current tooltip. 
    TOOLINFO tInfo = {0};
    tInfo.cbSize = sizeof(TOOLINFO);
    CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
    CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
    BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}

CToolTipCtrl::GetDelayTime

Bir araç ipucu denetimi için ayarlanmış olan başlangıç, açılır pencere ve yeniden gösterme sürelerini alır.

int GetDelayTime(DWORD dwDuration) const;

Parametreler

dwDuration
Hangi süre değerinin alınacağını belirten bayrak. Bu parametre aşağıdaki değerlerden biri olabilir:

• TTDT_AUTOPOP İşaretçi bir aracın sınırlayıcı dikdörtgeni içinde sabitse araç ipucu penceresinin görünür kaldığı süreyi alın.

• TTDT_INITIAL Araç ipucu penceresi görüntülenmeden önce işaretçinin aracın sınırlayıcı dikdörtgeninde sabit kalması gereken süreyi alın.

• TTDT_RESHOW İşaretçi bir araçtan diğerine taşınırken sonraki araç ipucu pencerelerinin görünmesi için gereken süreyi alın.

Dönüş Değeri

Belirtilen gecikme süresi (milisaniye cinsinden)

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETDELAYTIMEdavranışını uygular.

CToolTipCtrl::GetMargin

Araç ipucu penceresi için ayarlanan üst, sol, alt ve sağ kenar boşluklarını alır.

void GetMargin(LPRECT lprc) const;

Parametreler

lprc
Kenar boşluğu bilgilerini alacak bir RECT yapının adresi. Yapının üyeleri RECT sınırlayıcı bir dikdörtgen tanımlamaz. Bu iletinin amacı doğrultusunda yapı üyeleri aşağıdaki gibi yorumlanır:

Üye	Temsil
top	Piksel cinsinden araç ipucu metninin üst kenarlığı ile üstü arasındaki uzaklık.
left	İpucu metninin sol kenarlığı ile sol ucu arasındaki uzaklık piksel cinsinden.
bottom	İpucu metninin alt kenarlığı ile alt kısmı arasındaki uzaklık piksel cinsinden.
right	İpucu metninin sağ kenarlığı ile sağ ucu arasındaki piksel cinsinden uzaklık.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETMARGINdavranışını uygular.

CToolTipCtrl::GetMaxTipWidth

Araç ipucu penceresinin en büyük genişliğini alır.

int GetMaxTipWidth() const;

Dönüş Değeri

Araç ipucu penceresinin en büyük genişliği.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETMAXTIPWIDTHdavranışını uygular.

CToolTipCtrl::GetText

Araç ipucu denetiminin bir araç için koruduğu metni alır.

void GetText(
    CString& str,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parametreler

str
Aracın metnini alan bir CString nesneye başvuru.

pWnd
Aracı içeren pencerenin işaretçisi.

nIDTool
Aracın kimliği.

Açıklamalar

pWnd ve nIDTool parametreleri aracı tanımlar. Bu araç daha önce önceki bir çağrısı CToolTipCtrl::AddToolaracılığıyla araç ipucu denetimine kaydedildiyse, parametresi tarafından str başvurulan nesneye aracın metni atanır.

CToolTipCtrl::GetTipBkColor

Araç ipucu penceresinde arka plan rengini alır.

COLORREF GetTipBkColor() const;

Dönüş Değeri

COLORREF Arka plan rengini temsil eden bir değer.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETTIPBKCOLORdavranışını uygular.

CToolTipCtrl::GetTipTextColor

Araç ipucu penceresindeki metin rengini alır.

COLORREF GetTipTextColor() const;

Dönüş Değeri

COLORREF Metin rengini temsil eden bir değer.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_GETTIPTEXTCOLORdavranışını uygular.

CToolTipCtrl::GetTitle

Geçerli araç ipucu denetiminin başlığını alır.

void GetTitle(PTTGETTITLE pttgt) const;

Parametreler

pttgt
[out] Araç ipucu denetimi hakkında bilgi içeren bir TTGETTITLE yapı işaretçisi. Bu yöntem döndürdüğünde pszTitle , yapı üyesi TTGETTITLE başlığın metnini gösterir.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TTM_GETTITLE .

CToolTipCtrl::GetToolCount

Araç ipucu denetimiyle kaydedilen araçların sayısını alır.

int GetToolCount() const;

Dönüş Değeri

Araç ipucu denetimiyle kaydedilen araçların sayısı.

CToolTipCtrl::GetToolInfo

Araç ipucu denetiminin bir araç hakkında koruduğu bilgileri alır.

BOOL GetToolInfo(
    CToolInfo& ToolInfo,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parametreler

ToolInfo
Aracın metnini alan bir TOOLINFO nesneye başvuru.

pWnd
Aracı içeren pencerenin işaretçisi.

nIDTool
Aracın kimliği.

Dönüş Değeri

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

Açıklamalar

Tarafından hwnd başvuruda CToolInfo bulunan TOOLINFO yapının ve uId üyeleri aracı tanımlar. Bu araç önceki bir çağrısı AddToolTOOLINFO aracılığıyla araç ipucu denetimine kaydedildiyse, yapı araçla ilgili bilgilerle doldurulur.

CToolTipCtrl::HitTest

Belirli bir aracın sınırlayıcı dikdörtgeni içinde olup olmadığını belirlemek için bir noktayı test eder ve varsa araç hakkındaki bilgileri alır.

BOOL HitTest(
    CWnd* pWnd,
    CPoint pt,
    LPTOOLINFO lpToolInfo) const;

Parametreler

pWnd
Aracı içeren pencerenin işaretçisi.

pt
Test edilecek noktanın koordinatlarını içeren bir CPoint nesnenin işaretçisi.

lpToolInfo
TOOLINFO Araç hakkında bilgi içeren yapı işaretçisi.

Dönüş Değeri

İsabet testi bilgileri tarafından belirtilen nokta aracın sınırlayıcı dikdörtgeninin içindeyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu işlev sıfır olmayan bir değer döndürürse, ile işaret edilen lpToolInfo yapı, dikdörtgeninin içinde noktanın yer aldığı araçla ilgili bilgilerle doldurulur.

Yapı TTHITTESTINFO aşağıdaki gibi tanımlanır:

typedef struct _TT_HITTESTINFO { // tthti
    HWND hwnd;   // handle of tool or window with tool
    POINT pt;    // client coordinates of point to test
    TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;

• hwnd

  Aracın tutamacını belirtir.

• pt

  Nokta aracın sınırlayıcı dikdörtgenindeyse noktanın koordinatlarını belirtir.

• ti

  Araç hakkında bilgi. Yapı hakkında TOOLINFO daha fazla bilgi için bkz CToolTipCtrl::GetToolInfo. .

CToolTipCtrl::Pop

Görüntülenen araç ipucu penceresini görünümden kaldırır.

void Pop();

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_POPdavranışını uygular.

CToolTipCtrl::Popup

Geçerli araç ipucu denetiminin son fare iletisinin koordinatlarında görüntülenmesine neden olur.

void Popup();

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan iletiyi gönderir TTM_POPUP .

Örnek

Aşağıdaki kod örneği bir araç ipucu penceresi görüntüler.

{
   // Display the most recent tooltip.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
   m_toolTip->Popup();
}

CToolTipCtrl::RelayEvent

İşlenmek üzere bir araç ipucu denetimine fare iletisi geçirir.

void RelayEvent(LPMSG lpMsg);

Parametreler

lpMsg
Geçiş için iletiyi içeren bir MSG yapıya işaretçi.

Açıklamalar

Araç ipucu denetimi yalnızca tarafından RelayEventgönderilen aşağıdaki iletileri işler:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Örnek

örneğine CPropertySheet::GetTabControlbakın.

CToolTipCtrl::SetDelayTime

Bir araç ipucu denetimi için gecikme süresini ayarlar.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parametreler

nDelay
Yeni gecikme süresini milisaniye cinsinden belirtir.

dwDuration
Hangi süre değerinin alınacağını belirten bayrak. Geçerli değerlerin açıklaması için bkz CToolTipCtrl::GetDelayTime .

iTime
Belirtilen gecikme süresi (milisaniye cinsinden).

Açıklamalar

Gecikme süresi, araç ipucu penceresi görüntülenmeden önce imlecin bir araçta kalması gereken süredir. Varsayılan gecikme süresi 500 milisaniyedir.

CToolTipCtrl::SetMargin

Araç ipucu penceresi için üst, sol, alt ve sağ kenar boşluklarını ayarlar.

void SetMargin(LPRECT lprc);

Parametreler

lprc
Ayarlanacak kenar boşluğu bilgilerini içeren bir RECT yapının adresi. Yapının üyeleri RECT sınırlayıcı bir dikdörtgen tanımlamaz. Kenar boşluğu bilgilerinin açıklaması için bkz CToolTipCtrl::GetMargin .

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_SETMARGINdavranışını uygular.

CToolTipCtrl::SetMaxTipWidth

Araç ipucu penceresi için en yüksek genişliği ayarlar.

int SetMaxTipWidth(int iWidth);

Parametreler

iWidth
Ayarlanacak en büyük araç ipucu penceresi genişliği.

Dönüş Değeri

Önceki maksimum uç genişliği.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_SETMAXTIPWIDTHdavranışını uygular.

CToolTipCtrl::SetTipBkColor

Araç ipucu penceresinde arka plan rengini ayarlar.

void SetTipBkColor(COLORREF clr);

Parametreler

clr
Yeni arka plan rengi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_SETTIPBKCOLORdavranışını uygular.

CToolTipCtrl::SetTipTextColor

Araç ipucu penceresinde metin rengini ayarlar.

void SetTipTextColor(COLORREF clr);

Parametreler

clr
Yeni metin rengi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_SETTIPTEXTCOLORdavranışını uygular.

CToolTipCtrl::SetTitle

Araç ipucuna standart bir simge ve başlık dizesi ekler.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parametreler

uIcon
Windows SDK'sında TTM_SETTITLE bölümüne bakınicon.

lpstrTitle
Başlık dizesi işaretçisi.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TTM_SETTITLEdavranışını uygular.

CToolTipCtrl::SetToolInfo

Araç ipucunun bir araç için koruduğu bilgileri ayarlar.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parametreler

lpToolInfo
Ayarlanacağı bilgileri belirten bir TOOLINFO yapı işaretçisi.

CToolTipCtrl::SetToolRect

Bir araç için yeni bir sınırlayıcı dikdörtgen ayarlar.

void SetToolRect(
    CWnd* pWnd,
    UINT_PTR nIDTool,
    LPCRECT lpRect);

Parametreler

pWnd
Aracı içeren pencerenin işaretçisi.

nIDTool
Aracın kimliği.

lpRect
Yeni sınırlayıcı dikdörtgeni belirten bir RECT yapı işaretçisi.

CToolTipCtrl::SetWindowTheme

Araç ipucu penceresinin görsel stilini ayarlar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametreler

pszSubAppName
Ayarlanacağı görsel stilini içeren bir Unicode dizesi işaretçisi.

Dönüş Değeri

Dönüş değeri kullanılmaz.

Açıklamalar

Bu üye işlevi, Windows SDK'sında açıklandığı gibi iletinin TTM_SETWINDOWTHEME işlevselliğine öykünmektedir.

CToolTipCtrl::Update

Geçerli aracı yeniden çizilmeye zorlar.

void Update();

CToolTipCtrl::UpdateTipText

Bu denetimin araçları için araç ipucu metnini güncelleştirir.

void UpdateTipText(
    LPCTSTR lpszText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

void UpdateTipText(
    UINT nIDText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parametreler

lpszText
Aracın metnine yönelik işaretçi.

pWnd
Aracı içeren pencerenin işaretçisi.

nIDTool
Aracın kimliği.

nIDText
Aracın metnini içeren dize kaynağının kimliği.

Ayrıca bkz.

CWnd Sınıf
Hiyerarşi Grafiği
CToolBar Sınıf