📄 cnbutton.cpp
字号:
// ST_ALIGN_VERT Icon/bitmap on the top, text on the bottom
// ST_ALIGN_HORIZ_RIGHT Icon/bitmap on the right, text on the left
// By default, CNButton buttons have ST_ALIGN_HORIZ alignment.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
// BTNST_INVALIDALIGN
// Alignment type not supported.
//
DWORD CNButton::SetAlign(BYTE byAlign, BOOL bRepaint)
{
switch (byAlign)
{
case ST_ALIGN_HORIZ:
case ST_ALIGN_HORIZ_RIGHT:
case ST_ALIGN_VERT:
m_byAlign = byAlign;
if (bRepaint) Invalidate();
return BTNST_OK;
break;
} // switch
return BTNST_INVALIDALIGN;
} // End of SetAlign
// This function sets the state of the checkbox.
// If the button is not a checkbox, this function has no meaning.
//
// Parameters:
// [IN] nCheck
// 1 to check the checkbox.
// 0 to un-check the checkbox.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::SetCheck(int nCheck, BOOL bRepaint)
{
if (m_bIsCheckBox)
{
if (nCheck == 0) m_nCheck = 0;
else m_nCheck = 1;
if (bRepaint) Invalidate();
} // if
return BTNST_OK;
} // End of SetCheck
// This function returns the current state of the checkbox.
// If the button is not a checkbox, this function has no meaning.
//
// Return value:
// The current state of the checkbox.
// 1 if checked.
// 0 if not checked or the button is not a checkbox.
//
int CNButton::GetCheck()
{
return m_nCheck;
} // End of GetCheck
// This function sets all colors to a default value.
//
// Parameters:
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::SetDefaultColors(BOOL bRepaint)
{
m_crColors[BTNST_COLOR_BK_IN] = ::GetSysColor(COLOR_BTNFACE);
m_crColors[BTNST_COLOR_FG_IN] = ::GetSysColor(COLOR_BTNTEXT);
m_crColors[BTNST_COLOR_BK_OUT] = ::GetSysColor(COLOR_BTNFACE);
m_crColors[BTNST_COLOR_FG_OUT] = ::GetSysColor(COLOR_BTNTEXT);
m_crColors[BTNST_COLOR_BK_FOCUS] = ::GetSysColor(COLOR_BTNFACE);
m_crColors[BTNST_COLOR_FG_FOCUS] = ::GetSysColor(COLOR_BTNTEXT);
if (bRepaint) Invalidate();
return BTNST_OK;
} // End of SetDefaultColors
// This function sets the color to use for a particular state.
//
// Parameters:
// [IN] byColorIndex
// Index of the color to set. Can be one of the following values:
// BTNST_COLOR_BK_IN Background color when mouse is over the button
// BTNST_COLOR_FG_IN Text color when mouse is over the button
// BTNST_COLOR_BK_OUT Background color when mouse is outside the button
// BTNST_COLOR_FG_OUT Text color when mouse is outside the button
// BTNST_COLOR_BK_FOCUS Background color when the button is focused
// BTNST_COLOR_FG_FOCUS Text color when the button is focused
// [IN] crColor
// New color.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
// BTNST_INVALIDINDEX
// Invalid color index.
//
DWORD CNButton::SetColor(BYTE byColorIndex, COLORREF crColor, BOOL bRepaint)
{
if (byColorIndex >= BTNST_MAX_COLORS) return BTNST_INVALIDINDEX;
// Set new color
m_crColors[byColorIndex] = crColor;
if (bRepaint) Invalidate();
return BTNST_OK;
} // End of SetColor
// This functions returns the color used for a particular state.
//
// Parameters:
// [IN] byColorIndex
// Index of the color to get. Can be one of the following values:
// BTNST_COLOR_BK_IN Background color when mouse is over the button
// BTNST_COLOR_FG_IN Text color when mouse is over the button
// BTNST_COLOR_BK_OUT Background color when mouse is outside the button
// BTNST_COLOR_FG_OUT Text color when mouse is outside the button
// BTNST_COLOR_BK_FOCUS Background color when the button is focused
// BTNST_COLOR_FG_FOCUS Text color when the button is focused
// [OUT] crpColor
// A pointer to a COLORREF that will receive the color.
//
// Return value:
// BTNST_OK
// Function executed successfully.
// BTNST_INVALIDINDEX
// Invalid color index.
//
DWORD CNButton::GetColor(BYTE byColorIndex, COLORREF* crpColor)
{
if (byColorIndex >= BTNST_MAX_COLORS) return BTNST_INVALIDINDEX;
// Get color
*crpColor = m_crColors[byColorIndex];
return BTNST_OK;
} // End of GetColor
// This function sets the hilight logic for the button.
// Applies only to flat buttons.
//
// Parameters:
// [IN] bAlwaysTrack
// If TRUE the button will be hilighted even if the window that owns it, is
// not the active window.
// If FALSE the button will be hilighted only if the window that owns it,
// is the active window.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::SetAlwaysTrack(BOOL bAlwaysTrack)
{
m_bAlwaysTrack = bAlwaysTrack;
return BTNST_OK;
} // End of SetAlwaysTrack
// This function sets the cursor to be used when the mouse is over the button.
//
// Parameters:
// [IN] nCursorId
// ID number of the cursor resource.
// Pass NULL to remove a previously loaded cursor.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
// BTNST_INVALIDRESOURCE
// Failed loading the specified resource.
//
DWORD CNButton::SetBtnCursor(int nCursorId, BOOL bRepaint)
{
HINSTANCE hInstResource = NULL;
// Destroy any previous cursor
if (m_hCursor)
{
::DestroyCursor(m_hCursor);
m_hCursor = NULL;
} // if
// Load cursor
if (nCursorId)
{
hInstResource = AfxFindResourceHandle(MAKEINTRESOURCE(nCursorId), RT_GROUP_CURSOR);
// Load cursor resource
m_hCursor = (HCURSOR)::LoadImage(hInstResource, MAKEINTRESOURCE(nCursorId), IMAGE_CURSOR, 0, 0, 0);
// Repaint the button
if (bRepaint) Invalidate();
// If something wrong
if (m_hCursor == NULL) return BTNST_INVALIDRESOURCE;
} // if
return BTNST_OK;
} // End of SetBtnCursor
// This function sets if the button border must be drawn.
// Applies only to flat buttons.
//
// Parameters:
// [IN] bDrawBorder
// If TRUE the border will be drawn.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::DrawBorder(BOOL bDrawBorder, BOOL bRepaint)
{
m_bDrawBorder = bDrawBorder;
// Repaint the button
if (bRepaint) Invalidate();
return BTNST_OK;
} // End of DrawBorder
// This function sets if the focus rectangle must be drawn for flat buttons.
//
// Parameters:
// [IN] bDrawFlatFocus
// If TRUE the focus rectangle will be drawn also for flat buttons.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::DrawFlatFocus(BOOL bDrawFlatFocus, BOOL bRepaint)
{
m_bDrawFlatFocus = bDrawFlatFocus;
// Repaint the button
if (bRepaint) Invalidate();
return BTNST_OK;
} // End of DrawFlatFocus
void CNButton::InitToolTip()
{
if (m_ToolTip.m_hWnd == NULL)
{
// Create ToolTip control
m_ToolTip.Create(this);
// Create inactive
m_ToolTip.Activate(FALSE);
// Enable multiline
m_ToolTip.SendMessage(TTM_SETMAXTIPWIDTH, 0, 400);
} // if
} // End of InitToolTip
// This function sets the text to show in the button tooltip.
//
// Parameters:
// [IN] nText
// ID number of the string resource containing the text to show.
// [IN] bActivate
// If TRUE the tooltip will be created active.
//
void CNButton::SetTooltipText(int nText, BOOL bActivate)
{
CString sText;
// Load string resource
sText.LoadString(nText);
// If string resource is not empty
if (sText.IsEmpty() == FALSE) SetTooltipText((LPCTSTR)sText, bActivate);
} // End of SetTooltipText
// This function sets the text to show in the button tooltip.
//
// Parameters:
// [IN] lpszText
// Pointer to a null-terminated string containing the text to show.
// [IN] bActivate
// If TRUE the tooltip will be created active.
//
void CNButton::SetTooltipText(LPCTSTR lpszText, BOOL bActivate)
{
// We cannot accept NULL pointer
if (lpszText == NULL) return;
// Initialize ToolTip
InitToolTip();
// If there is no tooltip defined then add it
if (m_ToolTip.GetToolCount() == 0)
{
CRect rectBtn;
GetClientRect(rectBtn);
m_ToolTip.AddTool(this, lpszText, rectBtn, 1);
} // if
// Set text for tooltip
m_ToolTip.UpdateTipText(lpszText, this, 1);
m_ToolTip.Activate(bActivate);
} // End of SetTooltipText
// This function enables or disables the button tooltip.
//
// Parameters:
// [IN] bActivate
// If TRUE the tooltip will be activated.
//
void CNButton::ActivateTooltip(BOOL bActivate)
{
// If there is no tooltip then do nothing
if (m_ToolTip.GetToolCount() == 0) return;
// Activate tooltip
m_ToolTip.Activate(bActivate);
} // End of EnableTooltip
// This function returns if the button is the default button.
//
// Return value:
// TRUE
// The button is the default button.
// FALSE
// The button is not the default button.
//
BOOL CNButton::GetDefault()
{
return m_bIsDefault;
} // End of GetDefault
// This function enables the transparent mode.
// Note: this operation is not reversible.
// DrawTransparent should be called just after the button is created.
// Do not use trasparent buttons until you really need it (you have a bitmapped
// background) since each transparent button makes a copy in memory of its background.
// This may bring unnecessary memory use and execution overload.
//
// Parameters:
// [IN] bRepaint
// If TRUE the control will be repainted.
//
void CNButton::DrawTransparent(BOOL bRepaint)
{
m_bDrawTransparent = TRUE;
// Restore old bitmap (if any)
if (m_dcBk.m_hDC != NULL && m_pbmpOldBk != NULL)
{
m_dcBk.SelectObject(m_pbmpOldBk);
} // if
m_bmpBk.DeleteObject();
m_dcBk.DeleteDC();
// Repaint the button
if (bRepaint) Invalidate();
} // End of DrawTransparent
// This function sets the URL that will be opened when the button is clicked.
//
// Parameters:
// [IN] lpszURL
// Pointer to a null-terminated string that contains the URL.
// Pass NULL to removed any previously specified URL.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::SetURL(LPCTSTR lpszURL)
{
// Remove any existing URL
memset(m_szURL, 0, sizeof(m_szURL));
if (lpszURL)
{
// Store the URL
_tcsncpy(m_szURL, lpszURL, _MAX_PATH);
} // if
return BTNST_OK;
} // End of SetURL
// This function associates a menu to the button.
// The menu will be displayed clicking the button.
//
// Parameters:
// [IN] nMenu
// ID number of the menu resource.
// Pass NULL to remove any menu from the button.
// [IN] hParentWnd
// Handle to the window that owns the menu.
// This window receives all messages from the menu.
// [IN] bRepaint
// If TRUE the control will be repainted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
// BTNST_INVALIDRESOURCE
// Failed loading the specified resource.
//
DWORD CNButton::SetMenu(UINT nMenu, HWND hParentWnd, BOOL bRepaint)
{
HINSTANCE hInstResource = NULL;
// Destroy any previous menu
if (m_hMenu)
{
::DestroyMenu(m_hMenu);
m_hMenu = NULL;
m_hParentWndMenu = NULL;
m_bMenuDisplayed = FALSE;
} // if
// Load menu
if (nMenu)
{
// Find correct resource handle
hInstResource = AfxFindResourceHandle(MAKEINTRESOURCE(nMenu), RT_MENU);
// Load menu resource
m_hMenu = ::LoadMenu(hInstResource, MAKEINTRESOURCE(nMenu));
m_hParentWndMenu = hParentWnd;
// If something wrong
if (m_hMenu == NULL) return BTNST_INVALIDRESOURCE;
} // if
// Repaint the button
if (bRepaint) Invalidate();
return BTNST_OK;
} // End of SetMenu
// This function is called every time the button background needs to be painted.
// If the button is in transparent mode this function will NOT be called.
// This is a virtual function that can be rewritten in CNButton-derived classes
// to produce a whole range of buttons not available by default.
//
// Parameters:
// [IN] pDC
// Pointer to a CDC object that indicates the device context.
// [IN] pRect
// Pointer to a CRect object that indicates the bounds of the
// area to be painted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::OnDrawBackground(CDC* pDC, LPCRECT pRect)
{
COLORREF crColor;
if (m_bMouseOnButton || m_bIsPressed)
crColor = m_crColors[BTNST_COLOR_BK_IN];
else
{
if (m_bIsFocused)
crColor = m_crColors[BTNST_COLOR_BK_FOCUS];
else
crColor = m_crColors[BTNST_COLOR_BK_OUT];
} // else
CBrush brBackground(crColor);
pDC->FillRect(pRect, &brBackground);
return BTNST_OK;
} // End of OnDrawBackground
// This function is called every time the button border needs to be painted.
// If the button is in standard (not flat) mode this function will NOT be called.
// This is a virtual function that can be rewritten in CNButton-derived classes
// to produce a whole range of buttons not available by default.
//
// Parameters:
// [IN] pDC
// Pointer to a CDC object that indicates the device context.
// [IN] pRect
// Pointer to a CRect object that indicates the bounds of the
// area to be painted.
//
// Return value:
// BTNST_OK
// Function executed successfully.
//
DWORD CNButton::OnDrawBorder(CDC* pDC, LPCRECT pRect)
{
if (m_bIsPressed)
pDC->Draw3dRect(pRect, ::GetSysColor(COLOR_BTNSHADOW), ::GetSysColor(COLOR_BTNHILIGHT));
else
pDC->Draw3dRect(pRect, ::GetSysColor(COLOR_BTNHILIGHT), ::GetSysColor(COLOR_BTNSHADOW));
return BTNST_OK;
} // End of OnDrawBorder
#undef BS_TYPEMASK
void CNButton::setText(UINT nID)
{
CString str;
str.LoadString(nID);
SetWindowText(str);
}
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -