CMFCTabToolTipInfo 結構

發行項
10/12/2023

此結構提供使用者將滑鼠停留在 MDI 索引標籤上的資訊。

語法

struct CMFCTabToolTipInfo

成員

資料成員

名稱	描述
CMFCTabToolTipInfo：：m_nTabIndex	指定索引標籤控制項的索引。
CMFCTabToolTipInfo：：m_pTabWnd	索引標籤控制項的指標。
CMFCTabToolTipInfo：：m_strText	工具提示文字。

備註

結構的指標 CMFCTabToolTipInfo 會當做AFX_WM_ON_GET_TAB_TOOLTIP訊息的參數傳遞。啟用 MDI 索引標籤，且使用者將滑鼠停留在索引標籤控制項上時，就會產生此訊息。

範例

下列範例示範如何在 CMFCTabToolTipInfo MDITabsDemo 範例中使用 MFC 索引標籤式 MDI 應用程式。

LRESULT CMainFrame::OnGetTabToolTip(WPARAM /*wp*/, LPARAM lp)
{
   CMFCTabToolTipInfo *pInfo = (CMFCTabToolTipInfo*)lp;
   ASSERT(pInfo != NULL);

   if (pInfo)
   {
      ASSERT_VALID(pInfo->m_pTabWnd);
      if (!pInfo->m_pTabWnd->IsMDITab())
      {
         return 0;
      }
      pInfo->m_strText.Format(_T("Tab #%d Custom Tooltip"), pInfo->m_nTabIndex + 1);
   }

   return 0;
}

繼承階層架構

CMFCTabToolTipInfo

需求

標頭： afxbasetabctrl.h

CMFCTabToolTipInfo：：m_nTabIndex

指定索引標籤控制項的索引。

int m_nTabIndex;

備註

使用者暫留的索引標籤索引。

範例

下列範例示範如何在 m_nTabIndex MDITabsDemo 範例中使用 MFC 索引標籤式 MDI 應用程式。

LRESULT CMainFrame::OnGetTabToolTip(WPARAM /*wp*/, LPARAM lp)
{
   CMFCTabToolTipInfo *pInfo = (CMFCTabToolTipInfo*)lp;
   ASSERT(pInfo != NULL);

   if (pInfo)
   {
      ASSERT_VALID(pInfo->m_pTabWnd);
      if (!pInfo->m_pTabWnd->IsMDITab())
      {
         return 0;
      }
      pInfo->m_strText.Format(_T("Tab #%d Custom Tooltip"), pInfo->m_nTabIndex + 1);
   }

   return 0;
}

CMFCTabToolTipInfo：：m_pTabWnd

索引標籤控制項的指標。

CMFCBaseTabCtrl* m_pTabWnd;

範例

下列範例示範如何在 m_pTabWnd MDITabsDemo 範例中使用 MFC 索引標籤式 MDI 應用程式。

LRESULT CMainFrame::OnGetTabToolTip(WPARAM /*wp*/, LPARAM lp)
{
   CMFCTabToolTipInfo *pInfo = (CMFCTabToolTipInfo*)lp;
   ASSERT(pInfo != NULL);

   if (pInfo)
   {
      ASSERT_VALID(pInfo->m_pTabWnd);
      if (!pInfo->m_pTabWnd->IsMDITab())
      {
         return 0;
      }
      pInfo->m_strText.Format(_T("Tab #%d Custom Tooltip"), pInfo->m_nTabIndex + 1);
   }

   return 0;
}

CMFCTabToolTipInfo：：m_strText

工具提示文字。

CString m_strText;

備註

如果字串是空的，則不會顯示工具提示。

範例

下列範例示範如何在 m_strText MDITabsDemo 範例中使用 MFC 索引標籤式 MDI 應用程式。

LRESULT CMainFrame::OnGetTabToolTip(WPARAM /*wp*/, LPARAM lp)
{
   CMFCTabToolTipInfo *pInfo = (CMFCTabToolTipInfo*)lp;
   ASSERT(pInfo != NULL);

   if (pInfo)
   {
      ASSERT_VALID(pInfo->m_pTabWnd);
      if (!pInfo->m_pTabWnd->IsMDITab())
      {
         return 0;
      }
      pInfo->m_strText.Format(_T("Tab #%d Custom Tooltip"), pInfo->m_nTabIndex + 1);
   }

   return 0;
}

另請參閱

階層架構圖表
 類別

共用方式為