Classe CToolTipCtrl

Incapsula la funzionalità di un "controllo descrizione comando", una piccola finestra popup che visualizza una singola riga di testo che descrive lo scopo di uno strumento in un'applicazione.

Sintassi

class CToolTipCtrl : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CToolTipCtrl::CToolTipCtrl	Costruisce un oggetto CToolTipCtrl.

Metodi pubblici

Nome	Descrizione
CToolTipCtrl::Activate	Attiva e disattiva il controllo descrizione comando.
CToolTipCtrl::AddTool	Registra uno strumento con il controllo tooltip.
CToolTipCtrl::AdjustRect	Converte tra il rettangolo di visualizzazione del testo di un controllo descrizione comando e il relativo rettangolo di finestra.
CToolTipCtrl::Create	Crea un controllo descrizione comando e lo collega a un CToolTipCtrl oggetto .
CToolTipCtrl::CreateEx	Crea un controllo descrizione comando con gli stili estesi di Windows specificati e lo associa a un CToolTipCtrl oggetto .
CToolTipCtrl::DelTool	Rimuove uno strumento dal controllo descrizione comando.
CToolTipCtrl::GetBubbleSize	Recupera le dimensioni della descrizione comando.
CToolTipCtrl::GetCurrentTool	Recupera informazioni, ad esempio dimensioni, posizione e testo, della finestra della descrizione comando visualizzata dal controllo descrizione comando corrente.
CToolTipCtrl::GetDelayTime	Recupera le durate iniziali, popup e rishow che sono attualmente impostate per un controllo descrizione comando.
CToolTipCtrl::GetMargin	Recupera i margini superiore, sinistro, inferiore e destro impostati per una finestra della descrizione comando.
CToolTipCtrl::GetMaxTipWidth	Recupera la larghezza massima per una finestra della descrizione comando.
CToolTipCtrl::GetText	Recupera il testo gestito da un controllo descrizione comando per uno strumento.
CToolTipCtrl::GetTipBkColor	Recupera il colore di sfondo in una finestra della descrizione comando.
CToolTipCtrl::GetTipTextColor	Recupera il colore del testo in una finestra della descrizione comando.
CToolTipCtrl::GetTitle	Recupera il titolo del controllo descrizione comando corrente.
CToolTipCtrl::GetToolCount	Recupera un conteggio degli strumenti gestiti da un controllo descrizione comando.
CToolTipCtrl::GetToolInfo	Recupera le informazioni gestite da un controllo descrizione comando su uno strumento.
CToolTipCtrl::HitTest	Verifica un punto per determinare se si trova all'interno del rettangolo di delimitazione dello strumento specificato. In tal caso, recupera informazioni sullo strumento.
CToolTipCtrl::Pop	Rimuove una finestra della descrizione comando visualizzata dalla visualizzazione.
CToolTipCtrl::Popup	Fa sì che il controllo della descrizione comando corrente sia visualizzato alle coordinate dell'ultimo messaggio del mouse.
CToolTipCtrl::RelayEvent	Passa un messaggio del mouse a un controllo descrizione comando per l'elaborazione.
CToolTipCtrl::SetDelayTime	Imposta le durate iniziali, popup e rishow per un controllo descrizione comando.
CToolTipCtrl::SetMargin	Imposta i margini superiore, sinistro, inferiore e destro per una finestra della descrizione comando.
CToolTipCtrl::SetMaxTipWidth	Imposta la larghezza massima per una finestra della descrizione comando.
CToolTipCtrl::SetTipBkColor	Imposta il colore di sfondo in una finestra della descrizione comando.
CToolTipCtrl::SetTipTextColor	Imposta il colore del testo in una finestra della descrizione comando.
CToolTipCtrl::SetTitle	Aggiunge un'icona standard e una stringa di titolo a una descrizione comando.
CToolTipCtrl::SetToolInfo	Imposta le informazioni gestite da una descrizione comando per uno strumento.
CToolTipCtrl::SetToolRect	Imposta un nuovo rettangolo di delimitazione per uno strumento.
CToolTipCtrl::SetWindowTheme	Imposta lo stile di visualizzazione della finestra della descrizione comando.
CToolTipCtrl::Update	Forza il ridisegno dello strumento corrente.
CToolTipCtrl::UpdateTipText	Imposta il testo della descrizione comando per uno strumento.

Osservazioni:

Uno "strumento" è una finestra, ad esempio una finestra o un controllo figlio, o un'area rettangolare definita dall'applicazione all'interno dell'area client di una finestra. Una descrizione comando è nascosta la maggior parte del tempo, che appare solo quando l'utente posiziona il cursore su uno strumento e lo lascia per circa un secondo. La descrizione comando viene visualizzata vicino al cursore e scompare quando l'utente fa clic su un pulsante del mouse o sposta il cursore dallo strumento.

CToolTipCtrl fornisce la funzionalità per controllare l'ora iniziale e la durata della descrizione comando, le larghezze dei margini che circondano il testo della descrizione comando, la larghezza della finestra della descrizione comando stessa e il colore di sfondo e testo della descrizione comando. Un singolo controllo descrizione comando può fornire informazioni per più strumenti.

La CToolTipCtrl classe fornisce la funzionalità del controllo descrizione comando comune di Windows. Questo controllo (e quindi la CToolTipCtrl classe ) è disponibile solo per i programmi in esecuzione in Windows 95/98 e Windows NT versioni 3.51 e successive.

Per altre informazioni sull'abilitazione delle descrizioni comando, vedere Tool Tips in Windows not Derived from .For more information about enabling tooltips, see Tool Tips in Windows not Derived from CFrameWnd.

Per altre informazioni sull'uso CToolTipCtrldi , vedere Controlli e uso di CToolTipCtrl.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CToolTipCtrl

Requisiti

Intestazione: afxcmn.h

CToolTipCtrl::Activate

Chiamare questa funzione per attivare o disattivare un controllo descrizione comando.

void Activate(BOOL bActivate);

Parametri

bActivate
Specifica se il controllo della descrizione comando deve essere attivato o disattivato.

Osservazioni:

Se bActivate è TRUE, il controllo viene attivato; se FALSE, viene disattivato.

Quando un controllo descrizione comando è attivo, le informazioni sulla descrizione comando appaiono quando il cursore si trova su uno strumento registrato con il controllo; quando è inattivo, le informazioni sulla descrizione comando non vengono visualizzate, anche quando il cursore si trova su uno strumento.

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Registra uno strumento con il controllo tooltip.

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);

Parametri

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDText
ID della risorsa stringa che contiene il testo per lo strumento.

lpRectTool
Puntatore a una RECT struttura contenente le coordinate del rettangolo di delimitazione dello strumento. Le coordinate sono relative all'angolo superiore sinistro dell'area client della finestra identificata da pWnd.

nIDTool
ID dello strumento.

lpszText
Puntatore al testo dello strumento. Se questo parametro contiene il valore LPSTR_TEXTCALLBACK, TTN_NEEDTEXT i messaggi di notifica passano all'elemento padre della finestra a cui pWnd punta.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

I lpRectTool parametri e nIDTool devono essere entrambi validi oppure se lpRectTool è NULL, nIDTool devono essere 0.

Un controllo descrizione comando può essere associato a più strumenti. Chiamare questa funzione per registrare uno strumento con il controllo descrizione comando, in modo che le informazioni archiviate nella descrizione comando vengano visualizzate quando il cursore si trova sullo strumento.

Nota

Non è possibile impostare una descrizione comando su un controllo statico utilizzando AddTool.

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Converte tra il rettangolo di visualizzazione del testo di un controllo descrizione comando e il relativo rettangolo di finestra.

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

Parametri

lprc
Puntatore a una RECT struttura che contiene un rettangolo della finestra della descrizione comando o un rettangolo di visualizzazione del testo.

bLarger
Se TRUE, lprc viene usato per specificare un rettangolo di visualizzazione del testo e riceve il rettangolo della finestra corrispondente. Se FALSE, lprc viene usato per specificare un rettangolo di finestra e riceve il rettangolo di visualizzazione del testo corrispondente.

Valore restituito

Diverso da zero se il rettangolo viene regolato correttamente; in caso contrario, 0.

Osservazioni:

Questa funzione membro calcola il rettangolo di visualizzazione del testo di un controllo descrizione comando dal relativo rettangolo della finestra o il rettangolo della finestra della descrizione comando necessario per visualizzare un rettangolo di visualizzazione del testo specificato.

Questa funzione membro implementa il comportamento del messaggio TTM_ADJUSTRECTWin32 , come descritto in Windows SDK.

CToolTipCtrl::Create

Crea un controllo descrizione comando e lo collega a un CToolTipCtrl oggetto .

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

Parametri

pParentWnd
Specifica la finestra padre del controllo descrizione comando, in genere un oggetto CDialog. Non deve essere NULL.

dwStyle
Specifica lo stile del controllo descrizione comando. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Diverso da zero se l'oggetto CToolTipCtrl viene creato correttamente; in caso contrario, 0.

Osservazioni:

Si costruisce un oggetto CToolTipCtrl in due passaggi. Chiamare prima di tutto il costruttore per costruire l'oggetto CToolTipCtrl e quindi chiamare Create per creare il controllo descrizione comando e associarlo all'oggetto CToolTipCtrl .

Il dwStyle parametro può essere qualsiasi combinazione di stili di finestra. Inoltre, un controllo descrizione comando ha due stili specifici della classe: TTS_ALWAYSTIP e TTS_NOPREFIX.

Style	Significato
TTS_ALWAYSTIP	Specifica che la descrizione comando verrà visualizzata quando il cursore si trova su uno strumento, indipendentemente dal fatto che la finestra del proprietario del controllo descrizione comando sia attiva o inattiva. Senza questo stile, il controllo descrizione comando viene visualizzato quando la finestra del proprietario dello strumento è attiva, ma non quando è inattiva.
TTS_NOPREFIX	Questo stile impedisce al sistema di rimuovere il carattere di e commerciale (&) da una stringa. Se un controllo descrizione comando non dispone dello TTS_NOPREFIX stile, il sistema rimuove automaticamente i caratteri e commerciale, consentendo a un'applicazione di usare la stessa stringa di una voce di menu e come testo in un controllo descrizione comando.

Un controllo descrizione comando ha gli stili di WS_POPUP finestra e WS_EX_TOOLWINDOW , indipendentemente dal fatto che vengano specificati durante la creazione del controllo.

Per creare un controllo descrizione comando con stili di windows estesi, chiamare CToolTipCtrl::CreateEx invece di Create.

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Crea un controllo (una finestra figlio) e lo associa all'oggetto CToolTipCtrl .

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

Parametri

pParentWnd
Puntatore alla finestra padre del controllo.

dwStyle
Specifica lo stile del controllo descrizione comando. Per altre informazioni, vedere la sezione Osservazioni di Create .

dwStyleEx
Specifica lo stile esteso del controllo da creare. Per un elenco degli stili di Windows estesi, vedi il dwExStyle parametro per CreateWindowEx in Windows SDK.

Valore restituito

Diverso da zero se ha esito positivo altrimenti 0.

Osservazioni:

Usare CreateEx invece di Create applicare stili di Windows estesi, specificati dalla prefazione WS_EX_dello stile esteso di Windows.

CToolTipCtrl::CToolTipCtrl

Costruisce un oggetto CToolTipCtrl.

CToolTipCtrl();

Osservazioni:

È necessario chiamare Create dopo aver costruito l'oggetto .

Esempio

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Rimuove lo strumento specificato da pWnd e nIDTool dalla raccolta di strumenti supportati da un controllo descrizione comando.

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

Parametri

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDTool
ID dello strumento.

CToolTipCtrl::GetBubbleSize

Recupera le dimensioni della descrizione comando.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parametri

lpToolInfo
Puntatore alla struttura della TOOLINFO descrizione comando.

Valore restituito

Dimensioni della descrizione comando.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETBUBBLESIZEWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetCurrentTool

Recupera informazioni, ad esempio dimensioni, posizione e testo, della finestra della descrizione comando visualizzata dal controllo descrizione comando corrente.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parametri

lpToolInfo
[out] Puntatore a una TOOLINFO struttura che riceve informazioni sulla finestra della descrizione comando corrente.

Valore restituito

TRUE se le informazioni vengono recuperate correttamente; in caso contrario, FALSE.

Osservazioni:

Questo metodo invia il TTM_GETCURRENTTOOL messaggio, descritto in Windows SDK.

Esempio

Nell'esempio di codice seguente vengono recuperate informazioni sulla finestra della descrizione comando corrente.

{
    //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

Recupera la durata iniziale, popup e mostra le durate attualmente impostate per un controllo descrizione comando.

int GetDelayTime(DWORD dwDuration) const;

Parametri

dwDuration
Flag che specifica quale valore di durata verrà recuperato. Questo parametro può avere uno dei valori seguenti:

• TTDT_AUTOPOP Recuperare il periodo di tempo in cui la finestra della descrizione comando rimane visibile se il puntatore è stazionario all'interno del rettangolo di delimitazione di uno strumento.

• TTDT_INITIAL Recuperare l'intervallo di tempo in cui il puntatore deve rimanere fermo all'interno del rettangolo di delimitazione di uno strumento prima che venga visualizzata la finestra della descrizione comando.

• TTDT_RESHOW Recuperare il tempo necessario per visualizzare le finestre di descrizione comando successive quando il puntatore passa da uno strumento a un altro.

Valore restituito

Tempo di ritardo specificato, espresso in millisecondi

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETDELAYTIMEWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetMargin

Recupera i margini superiore, sinistro, inferiore e destro impostati per una finestra della descrizione comando.

void GetMargin(LPRECT lprc) const;

Parametri

lprc
Indirizzo di una RECT struttura che riceverà le informazioni sul margine. I membri della RECT struttura non definiscono un rettangolo di delimitazione. Ai fini di questo messaggio, i membri della struttura vengono interpretati come segue:

Member	Rappresentazione
top	Distanza tra il bordo superiore e la parte superiore del testo della descrizione comando, in pixel.
left	Distanza tra il bordo sinistro e l'estremità sinistra del testo della punta, in pixel.
bottom	Distanza tra il bordo inferiore e la parte inferiore del testo della punta, in pixel.
right	Distanza tra il bordo destro e la fine destra del testo della punta, in pixel.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETMARGINWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetMaxTipWidth

Recupera la larghezza massima per una finestra della descrizione comando.

int GetMaxTipWidth() const;

Valore restituito

Larghezza massima per una finestra della descrizione comando.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETMAXTIPWIDTHWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetText

Recupera il testo gestito da un controllo descrizione comando per uno strumento.

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

Parametri

str
Riferimento a un CString oggetto che riceve il testo dello strumento.

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDTool
ID dello strumento.

Osservazioni:

I pWnd parametri e nIDTool identificano lo strumento. Se tale strumento è stato registrato in precedenza con il controllo della descrizione comando tramite una chiamata precedente a CToolTipCtrl::AddTool, all'oggetto a cui fa riferimento il str parametro viene assegnato il testo dello strumento.

CToolTipCtrl::GetTipBkColor

Recupera il colore di sfondo in una finestra della descrizione comando.

COLORREF GetTipBkColor() const;

Valore restituito

Valore COLORREF che rappresenta il colore di sfondo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETTIPBKCOLORWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetTipTextColor

Recupera il colore del testo in una finestra della descrizione comando.

COLORREF GetTipTextColor() const;

Valore restituito

Valore COLORREF che rappresenta il colore del testo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_GETTIPTEXTCOLORWin32 , come descritto in Windows SDK.

CToolTipCtrl::GetTitle

Recupera il titolo del controllo descrizione comando corrente.

void GetTitle(PTTGETTITLE pttgt) const;

Parametri

pttgt
[out] Puntatore a una TTGETTITLE struttura che contiene informazioni sul controllo descrizione comando. Quando termina, il pszTitle membro della TTGETTITLE struttura punta al testo del titolo.

Osservazioni:

Questo metodo invia il TTM_GETTITLE messaggio, descritto in Windows SDK.

CToolTipCtrl::GetToolCount

Recupera un conteggio degli strumenti registrati con il controllo descrizione comando.

int GetToolCount() const;

Valore restituito

Conteggio degli strumenti registrati con il controllo descrizione comando.

CToolTipCtrl::GetToolInfo

Recupera le informazioni gestite da un controllo descrizione comando su uno strumento.

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

Parametri

ToolInfo
Riferimento a un TOOLINFO oggetto che riceve il testo dello strumento.

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDTool
ID dello strumento.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

I hwnd membri e uId della TOOLINFO struttura a cui fa CToolInfo riferimento identificano lo strumento. Se tale strumento è stato registrato con il controllo descrizione comando tramite una chiamata precedente a AddTool, la TOOLINFO struttura viene compilata con informazioni sullo strumento.

CToolTipCtrl::HitTest

Verifica un punto per determinare se si trova all'interno del rettangolo di delimitazione dello strumento specificato e, in tal caso, recuperare informazioni sullo strumento.

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

Parametri

pWnd
Puntatore alla finestra che contiene lo strumento.

pt
Puntatore a un CPoint oggetto contenente le coordinate del punto da testare.

lpToolInfo
Puntatore alla TOOLINFO struttura che contiene informazioni sullo strumento.

Valore restituito

Diverso da zero se il punto specificato dalle informazioni di hit test si trova all'interno del rettangolo di delimitazione dello strumento; in caso contrario, 0.

Osservazioni:

Se questa funzione restituisce un valore diverso da lpToolInfo zero, la struttura a cui punta viene riempita con informazioni sullo strumento all'interno del cui rettangolo si trova il punto.

La TTHITTESTINFO struttura è definita come segue:

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

  Specifica l'handle dello strumento.

• pt

  Specifica le coordinate di un punto se il punto si trova nel rettangolo di delimitazione dello strumento.

• ti

  Informazioni sullo strumento. Per altre informazioni sulla TOOLINFO struttura, vedere CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Rimuove una finestra della descrizione comando visualizzata dalla visualizzazione.

void Pop();

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_POPWin32 , come descritto in Windows SDK.

CToolTipCtrl::Popup

Fa sì che il controllo della descrizione comando corrente sia visualizzato alle coordinate dell'ultimo messaggio del mouse.

void Popup();

Osservazioni:

Questo metodo invia il TTM_POPUP messaggio, descritto in Windows SDK.

Esempio

Nell'esempio di codice seguente viene visualizzata una finestra della descrizione comando.

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

CToolTipCtrl::RelayEvent

Passa un messaggio del mouse a un controllo descrizione comando per l'elaborazione.

void RelayEvent(LPMSG lpMsg);

Parametri

lpMsg
Puntatore a una MSG struttura che contiene il messaggio da inoltrare.

Osservazioni:

Un controllo descrizione comando elabora solo i messaggi seguenti, che vengono inviati da RelayEvent:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Imposta il tempo di ritardo per un controllo descrizione comando.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parametri

nDelay
Specifica il nuovo tempo di ritardo, espresso in millisecondi.

dwDuration
Flag che specifica quale valore di durata verrà recuperato. Vedere CToolTipCtrl::GetDelayTime per una descrizione dei valori validi.

iTime
Tempo di ritardo specificato, espresso in millisecondi.

Osservazioni:

Il tempo di ritardo è l'intervallo di tempo in cui il cursore deve rimanere su uno strumento prima che venga visualizzata la finestra della descrizione comando. Il tempo di ritardo predefinito è 500 millisecondi.

CToolTipCtrl::SetMargin

Imposta i margini superiore, sinistro, inferiore e destro per una finestra della descrizione comando.

void SetMargin(LPRECT lprc);

Parametri

lprc
Indirizzo di una RECT struttura che contiene le informazioni sul margine da impostare. I membri della RECT struttura non definiscono un rettangolo di delimitazione. Vedere CToolTipCtrl::GetMargin per una descrizione delle informazioni sul margine.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_SETMARGINWin32 , come descritto in Windows SDK.

CToolTipCtrl::SetMaxTipWidth

Imposta la larghezza massima per una finestra della descrizione comando.

int SetMaxTipWidth(int iWidth);

Parametri

iWidth
Larghezza massima della finestra della descrizione comando da impostare.

Valore restituito

Larghezza massima precedente della mancia.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_SETMAXTIPWIDTHWin32 , come descritto in Windows SDK.

CToolTipCtrl::SetTipBkColor

Imposta il colore di sfondo in una finestra della descrizione comando.

void SetTipBkColor(COLORREF clr);

Parametri

clr
Nuovo colore di sfondo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_SETTIPBKCOLORWin32 , come descritto in Windows SDK.

CToolTipCtrl::SetTipTextColor

Imposta il colore del testo in una finestra della descrizione comando.

void SetTipTextColor(COLORREF clr);

Parametri

clr
Nuovo colore del testo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_SETTIPTEXTCOLORWin32 , come descritto in Windows SDK.

CToolTipCtrl::SetTitle

Aggiunge un'icona standard e una stringa di titolo a una descrizione comando.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parametri

uIcon
Vedere icon in TTM_SETTITLE Windows SDK.

lpstrTitle
Puntatore alla stringa del titolo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TTM_SETTITLEWin32 , come descritto in Windows SDK.

CToolTipCtrl::SetToolInfo

Imposta le informazioni gestite da una descrizione comando per uno strumento.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parametri

lpToolInfo
Puntatore a una TOOLINFO struttura che specifica le informazioni da impostare.

CToolTipCtrl::SetToolRect

Imposta un nuovo rettangolo di delimitazione per uno strumento.

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

Parametri

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDTool
ID dello strumento.

lpRect
Puntatore a una RECT struttura che specifica il nuovo rettangolo di delimitazione.

CToolTipCtrl::SetWindowTheme

Imposta lo stile di visualizzazione della finestra della descrizione comando.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametri

pszSubAppName
Puntatore a una stringa Unicode che contiene lo stile di visualizzazione da impostare.

Valore restituito

Il valore restituito non viene utilizzato.

Osservazioni:

Questa funzione membro emula la funzionalità del TTM_SETWINDOWTHEME messaggio, come descritto in Windows SDK.

CToolTipCtrl::Update

Forza il ridisegno dello strumento corrente.

void Update();

CToolTipCtrl::UpdateTipText

Aggiorna il testo della descrizione comando per gli strumenti di questo controllo.

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

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

Parametri

lpszText
Puntatore al testo dello strumento.

pWnd
Puntatore alla finestra che contiene lo strumento.

nIDTool
ID dello strumento.

nIDText
ID della risorsa stringa che contiene il testo per lo strumento.

Vedi anche

CWnd Classe
Grafico della gerarchia
CToolBar Classe