共用方式為


CMFCRibbonBaseElement 類別

CMFCRibbonBaseElement 類別是可以加入 功能區列中所有項目的基底類別。 功能區項目的範例為 Office 功能區按鈕、核取方塊和功能區上下拉式方塊。

class CMFCRibbonBaseElement : public CObject

Members

Bb983027.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CMFCRibbonBaseElement

建構 CMFCRibbonBaseElement 物件。

Bb983027.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CMFCRibbonBaseElement::AddToKeyList

將功能區項目的 keytip 到字元陣列 keytips。

CMFCRibbonBaseElement::AddToListBox

將功能區項目加入至指定的功能區命令清單方塊。

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

表示功能區項目是否可以加入至快速存取工具列。

CMFCRibbonBaseElement::CanBeCompacted

表示功能區項目的大小是否可以是壓縮的。

CMFCRibbonBaseElement::CanBeStretched

表示功能區項目的高度是否可垂直加入至功能區列的高度。

CMFCRibbonBaseElement::CanBeStretchedHorizontally

表示功能區項目的寬度是否可以變更。

CMFCRibbonBaseElement::CleanUpSizes

清除功能區項目的大小設定。

CMFCRibbonBaseElement::ClosePopupMenu

關閉功能區項目的快顯功能表。

CMFCRibbonBaseElement::CopyFrom

複製指定的 CMFCRibbonBaseElement 的狀態設定為目前的物件。

CMFCRibbonBaseElement::DestroyCtrl

終結功能區項目。

CMFCRibbonBaseElement::DrawImage

繪製功能區項目的影像。

CMFCRibbonBaseElement::Find

如果它指向目前的物件,傳回指定之指標功能區項目。

CMFCRibbonBaseElement::FindByData

其中包含指定之資料,擷取指標功能區項目。

CMFCRibbonBaseElement::FindByID

如果該項目是由指定的命令 ID.,決定要擷取指標功能區項目

CMFCRibbonBaseElement::FindByOriginal

如果其原始的功能區項目符合指定的功能區項目,擷取指標功能區項目。

CMFCRibbonBaseElement::GetCompactSize

傳回功能區項目的袖珍型。

CMFCRibbonBaseElement::GetData

擷取使用者定義的資料與功能區項目。

CMFCRibbonBaseElement::GetDescription

傳回功能區項目的描述。

CMFCRibbonBaseElement::GetDroppedDown

;如果它的快顯功能表的下拉式,擷取指標功能區項目。

CMFCRibbonBaseElement::GetElements

將目前的功能區項目加入至指定的陣列。

CMFCRibbonBaseElement::GetElementsByID

如果目前的功能區項目包含指定的命令 ID.,將目前的功能區項目加入至指定的陣列。

CMFCRibbonBaseElement::GetHighlighted

如果,它會反白顯示,擷取指標功能區項目。

CMFCRibbonBaseElement::GetID

傳回功能區項目的命令 ID。

CMFCRibbonBaseElement::GetImageSize

傳回功能區項目的影像大小。

CMFCRibbonBaseElement::GetIntermediateSize

傳回功能區項目大小以及它的中繼狀態的。

CMFCRibbonBaseElement::GetKeys

傳回 keytip 與功能區項目。

CMFCRibbonBaseElement::GetKeyTipRect

擷取功能區項目 keytip 界限的矩形。

CMFCRibbonBaseElement::GetKeyTipSize

擷取 keytip 文字的大小。

CMFCRibbonBaseElement::GetLocationInGroup

在功能區群組中表示功能區項目的顯示位置。

CMFCRibbonBaseElement::GetMenuKeys

傳回 keytips 與按鈕。

CMFCRibbonBaseElement::GetNotifyID

擷取功能區項目的告知命令 ID。

CMFCRibbonBaseElement::GetOriginal

擷取原始功能區項目。

CMFCRibbonBaseElement::GetParentCategory

擷取功能區項目的功能區類別。

CMFCRibbonBaseElement::GetParentPanel

擷取包含功能區項目的功能區面板。

CMFCRibbonBaseElement::GetParentRibbonBar

擷取功能區項目的父功能區列。

CMFCRibbonBaseElement::GetParentWnd

擷取功能區項目的父視窗。

CMFCRibbonBaseElement::GetPressed

目前,如果使用者按下它,擷取指標功能區項目。

CMFCRibbonBaseElement::GetQuickAccessToolBarID

其位於快速存取工具列時,擷取功能區項目的命令 ID。

CMFCRibbonBaseElement::GetRect

傳回功能區項目的週框 (Bounding Rectangle)。

CMFCRibbonBaseElement::GetRegularSize

傳回功能區項目的一般大小。

CMFCRibbonBaseElement::GetSize

傳回功能區項目的目前大小。

CMFCRibbonBaseElement::GetText

傳回與關聯的文字功能區項目。

CMFCRibbonBaseElement::GetToolTipText

傳回功能區項目的工具提示文字。

CMFCRibbonBaseElement::GetTopLevelRibbonBar

擷取功能區項目的最上層功能區列。

CMFCRibbonBaseElement::HasCompactMode

指定功能區項目是否具有簡潔的方式。

CMFCRibbonBaseElement::HasFocus

表示父項目是否具有鍵盤焦點。

CMFCRibbonBaseElement::HasIntermediateMode

指定功能區項目是否有中繼的方式。

CMFCRibbonBaseElement::HasLargeMode

指定功能區項目是否具有大型的方式。

CMFCRibbonBaseElement::HasMenu

表示功能區項目是否有名為的功能表。

CMFCRibbonBaseElement::HitTest

如果指定的點,它是位於,擷取指標功能區項目。

CMFCRibbonBaseElement::IsAlignByColumn

表示功能區項目是垂直對齊其他功能區項目。

CMFCRibbonBaseElement::IsAlwaysLargeImage

表示功能區項目影像大小是否一定會很大。

CMFCRibbonBaseElement::IsAutoRepeatMode

表示功能區項目是否在自動重複模式。

CMFCRibbonBaseElement::IsChecked

指定功能區項目是否已選取。

CMFCRibbonBaseElement::IsCompactMode

指定功能區項目是以精簡模式。

CMFCRibbonBaseElement::IsDefaultMenuLook

 

CMFCRibbonBaseElement::IsDisabled

指定功能區項目是否停用。

CMFCRibbonBaseElement::IsDroppedDown

判斷功能區項目是否顯示快顯功能表和卸除下方。

CMFCRibbonBaseElement::IsFocused

指定功能區項目是否具有焦點。

CMFCRibbonBaseElement::IsGalleryIcon

表示功能區項目是否在功能區上圖庫中。

CMFCRibbonBaseElement::IsHighlighted

指定功能區項目是否會反白顯示。

CMFCRibbonBaseElement::IsIntermediateMode

表示功能區項目的目前影像是否為中間的大小。

CMFCRibbonBaseElement::IsLargeMode

表示功能區項目的目前影像是否為完整大小。

CMFCRibbonBaseElement::IsMenuMode

表示功能區項目是否在功能表中。

CMFCRibbonBaseElement::IsPressed

指出使用者是按一下功能區項目。

CMFCRibbonBaseElement::IsQATMode

表示功能區項目是否在快速存取工具列中。

CMFCRibbonBaseElement::IsSeparator

表示功能區項目是否顯示分隔符號。

CMFCRibbonBaseElement::IsShowGroupBorder

表示功能區項目是否在顯示一般框線的群組中。

CMFCRibbonBaseElement::IsShowTooltipOnBottom

指出工具提示是否會顯示在功能區項目之下。

CMFCRibbonBaseElement::IsTabStop

表示功能區項目可以選擇是否使用鍵盤。

CMFCRibbonBaseElement::IsTextAlwaysOnRight

表示功能區項目中的文字是否在右邊顯示。

CMFCRibbonBaseElement::IsVisible

表示功能區項目目前是否顯示。

CMFCRibbonBaseElement::IsWholeRowHeight

表示功能區項目的顯示 heigth 是否與包含該功能區面板的顯示高度。

CMFCRibbonBaseElement::NotifyCommand

會將命令傳送告知給功能區項目的父視窗。

CMFCRibbonBaseElement::NotifyHighlightListItem

告知功能區列的父視窗,當使用者在清單中反白顯示的一個功能區項目時。

CMFCRibbonBaseElement::OnAddToQAToolbar

將功能區項目加入至指定的快速存取工具列。

CMFCRibbonBaseElement::OnAfterChangeRect

更新功能區項目的工具提示。

CMFCRibbonBaseElement::OnAutoRepeat

更新功能區項目以回應所維持的使用者輸入。

CMFCRibbonBaseElement::OnCalcTextSize

計算文字大小功能區項目的。

CMFCRibbonBaseElement::OnChangeMenuHighlight

呼叫框架,當焦點位於功能表上提供的功能區項目變更。

CMFCRibbonBaseElement::OnDraw

呼叫框架繪製功能區項目。

CMFCRibbonBaseElement::OnDrawKeyTip

呼叫框架繪製功能區項目的 keytip。

CMFCRibbonBaseElement::OnDrawMenuImage

呼叫由架構,在繪製功能區項目的功能表影像。

CMFCRibbonBaseElement::OnDrawOnList

呼叫框架會在命令清單方塊中的功能區項目。

CMFCRibbonBaseElement::OnKey

呼叫,便會由架構使用者按下時 keytip 和功能區項目具有焦點。

CMFCRibbonBaseElement::OnMenuKey

CMFCRibbonBaseElement::OnRTLChanged

呼叫由架構,在設定重新導向。

CMFCRibbonBaseElement::OnShow

呼叫由架構來顯示或隱藏功能區項目。

CMFCRibbonBaseElement::OnShowPopupMenu

呼叫框架,在功能區項目顯示快顯功能表。

CMFCRibbonBaseElement::PostMenuCommand

CMFCRibbonBaseElement::Redraw

更新功能區項目的顯示。

CMFCRibbonBaseElement::SetACCData

設定協助工具資料為功能區項目。

CMFCRibbonBaseElement::SetCompactMode

將功能區項目的顯示大小。

CMFCRibbonBaseElement::SetData

相關聯的資料項目與功能區項目。

CMFCRibbonBaseElement::SetDefaultMenuLook

 

CMFCRibbonBaseElement::SetDescription

將功能區項目的描述。

CMFCRibbonBaseElement::SetID

將功能區項目的命令 ID。

CMFCRibbonBaseElement::SetInitialMode

將功能區項目的初始顯示大小。

CMFCRibbonBaseElement::SetKeys

將功能區項目的 keytip。

CMFCRibbonBaseElement::SetOriginal

將功能區項目的功能區項目。

CMFCRibbonBaseElement::SetParentCategory

將功能區項目的父分類。

CMFCRibbonBaseElement::SetParentMenu

將功能區項目的父功能表容器。

CMFCRibbonBaseElement::SetParentRibbonBar

將功能區項目的父功能區列。

CMFCRibbonBaseElement::SetRect

設定的維度。FOT 顯示功能區項目的矩形。

CMFCRibbonBaseElement::SetText

將功能區項目的文字。

CMFCRibbonBaseElement::SetTextAlwaysOnRight

在右邊設定功能區項目的文字顯示。

CMFCRibbonBaseElement::SetToolTipText

將功能區項目的工具提示文字。

CMFCRibbonBaseElement::SetVisible

將功能區項目的可視性狀態。

CMFCRibbonBaseElement::StretchHorizontally

自動縮放功能區項目的寬度。

CMFCRibbonBaseElement::StretchToWholeRow

變更功能區項目的顯示高度為指定的資料列高度。

CMFCRibbonBaseElement::UpdateTooltipInfo

您可以使用功能區項目的命令,資源更新工具提示文字。

Bb983027.collapse_all(zh-tw,VS.110).gif受保護的方法

名稱

描述

CMFCRibbonBaseElement::OnProcessKey

呼叫框架,當使用者按下快速鍵。

CMFCRibbonBaseElement::OnSetFocus

呼叫框架,在功能區項目接收或失去輸入焦點。

備註

CMFCRibbonBaseElement 類別定義所有功能區項目的通用包括命令 ID、文字標籤、工具提示文字、項目可以取得焦點時,的描述和狀態的屬性 (反白顯示,則按下,停用,選取、、或向下)。

功能區項目的影像大小是由 RibbonImageType 成員定義,可以是下列其中一個值:

  • RibbonImageLarge

  • RibbonImageSmall

根據其大小,功能區項目顯示大型或小型影像。

範例

下列範例會在 CMFCRibbonBaseElement 類別會示範如何使用各種方法。 這個範例將示範如何在 CMFCRibbonStatusBar 類別取得 CMFCRibbonBaseElement 物件,設定功能區項目的描述,請將文字,設定 keytip,並將功能區項目的工具提示文字。 這個程式碼片段是 繪製用戶端範例的一部分。

    // CMFCRibbonStatusBar m_wndStatusBar
    CMFCRibbonBaseElement* pPane = m_wndStatusBar.FindByID(nID);


...


        pPane->SetDescription(_T("a pane"));
        // CString strText
        pPane->SetText(strText);
        pPane->SetKeys(_T("p"));
        pPane->SetToolTipText(_T("this is a pane"));

繼承階層架構

CObject

   CMFCRibbonBaseElement

需求

標題: afxbaseribbonelement.h

請參閱

參考

階層架構圖

其他資源

MFC 類別