Klasa CMFCRibbonCheckBox
Klasa CMFCRibbonCheckBox implementuje pole wyboru, które można dodać do panelu wstążki, paska narzędzi szybkiego dostępu lub menu podręcznego.
Składnia
class CMFCRibbonCheckBox : public CMFCRibbonButton
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCRibbonCheckBox::CMFCRibbonCheckBox | Konstruktor. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCRibbonCheckBox::GetCompactSize | (Przesłonięcia) CMFCRibbonButton::GetCompactSize. |
| CMFCRibbonCheckBox::GetIntermediateSize | (Przesłonięcia) CMFCRibbonButton::GetIntermediateSize.) |
| CMFCRibbonCheckBox::GetRegularSize | (Przesłonięcia) CMFCRibbonButton::GetRegularSize.) |
| CMFCRibbonCheckBox::IsDrawTooltipImage | (Przesłania CMFCRibbonButton::IsDrawTooltipImage). |
| CMFCRibbonCheckBox::OnDraw | (Przesłonięcia) CMFCRibbonButton::OnDraw. |
| CMFCRibbonCheckBox::OnDrawMenuImage | (Przesłonięcia) CMFCRibbonBaseElement::OnDrawMenuImage.) |
| CMFCRibbonCheckBox::OnDrawOnList | (Przesłania CMFCRibbonButton::OnDrawOnList). |
| CMFCRibbonCheckBox::SetACCData | (Przesłonięcia) CMFCRibbonButton::SetACCData.) |
Uwagi
Aby użyć elementu CMFCRibbonCheckBox w aplikacji, dodaj następujący konstruktor do kodu:
CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)
gdzie nID to identyfikator polecenia pola wyboru i lpszText jest etykietą tekstową pola wyboru.
Pole wyboru można dodać do panelu wstążki przy użyciu polecenia CMFCRibbonPanel::Add.
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxribboncheckbox.h
CMFCRibbonCheckBox::CMFCRibbonCheckBox
Konstruktor obiektu pola wyboru wstążki
CMFCRibbonCheckBox(
UINT nID,
LPCTSTR lpszText);
Parametry
Nid
[in] Określa identyfikator polecenia.
lpszText
[in] Określa etykietę tekstową.
Wartość zwracana
Tworzy obiekt pola wyboru wstążki.
Przykład
W poniższym przykładzie pokazano, jak utworzyć obiekt CMFCRibbonCheckBox klasy.
strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);
CMFCRibbonCheckBox::GetCompactSize
Po zastąpieniu pobiera kompaktowy rozmiar pola wyboru.
virtual CSize GetCompactSize(CDC* pDC);
Parametry
PDC
[in] Wskaźnik do kontrolera CDC skojarzonego z polem wyboru.
Wartość zwracana
CSize Zwraca obiekt zawierający kompaktowy rozmiar pola wyboru.
Uwagi
Jeśli nie zostanie zastąpiony, zwraca pośredni rozmiar pola wyboru.
CMFCRibbonCheckBox::GetIntermediateSize
Pobiera pośredni rozmiar pola wyboru.
virtual CSize GetIntermediateSize(CDC* pDC);
Parametry
PDC
[in] Wskaźnik do kontrolera CDC skojarzonego z tym polem wyboru.
Wartość zwracana
CSize Obiekt zawierający pośredni rozmiar pola wyboru.
Uwagi
Jeśli nie zostanie zastąpiona, oblicza rozmiar pośredni jako domyślny rozmiar pola wyboru ( AFX_CHECK_BOX_DEFAULT_SIZE) oraz rozmiar tekstu oraz marginesy.
CMFCRibbonCheckBox::GetRegularSize
Pobiera zwykły rozmiar pola wyboru.
virtual CSize GetRegularSize(CDC* pDC);
Parametry
PDC
[in] Wskaźnik do obiektu CDC skojarzonego z tym polem wyboru.
Wartość zwracana
CSize Zwraca obiekt, który zawiera zwykły rozmiar pola wyboru.
Uwagi
Jeśli nie zostanie zastąpiony, zwraca pośredni rozmiar pola wyboru.
CMFCRibbonCheckBox::IsDrawTooltipImage
Wskazuje, czy istnieje obraz etykietki narzędzia skojarzony z polem wyboru.
virtual BOOL IsDrawTooltipImage() const;
Wartość zwracana
Zwraca wartość TRUE, jeśli istnieje obraz etykietki narzędzia skojarzony z polem wyboru lub FALSE, jeśli nie.
Uwagi
CMFCRibbonCheckBox::OnDraw
Wywoływana przez strukturę w celu narysowania pola wyboru przy użyciu określonego kontekstu urządzenia.
virtual void OnDraw(CDC* pDC);
Parametry
PDC
[in] Wskaźnik do CDC, w którym ma być rysowanie pola wyboru.
Uwagi
CMFCRibbonCheckBox::OnDrawMenuImage
Wywoływana przez strukturę w celu narysowania obrazu menu dla pola wyboru.
virtual BOOL OnDrawMenuImage(CDC*, CRect);
Parametry
[in] CDC*
Wskaźnik do kontrolera CDC skojarzonego z polem wyboru.
CRect
[in] CRect Obiekt określający prostokąt, w którym ma być rysujący obraz menu.
Wartość zwracana
Zwraca wartość TRUE, jeśli obraz został narysowany lub FAŁSZ, jeśli nie.
Uwagi
Jeśli nie zostanie zastąpiony, zwraca wartość FALSE.
CMFCRibbonCheckBox::OnDrawOnList
Wywoływana przez strukturę, aby narysować pole wyboru w polu listy poleceń.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parametry
PDC
[in] Wskaźnik do kontekstu urządzenia, w którym ma być rysowanie pola wyboru.
strText
[in] Tekst wyświetlany.
nTextOffset
[in] Odległość w pikselach od lewej strony pola listy do tekstu wyświetlanego.
Rect
[in] Prostokąt wyświetlania pola wyboru.
bIsSelected
[in] WARTOŚĆ TRUE, jeśli pole wyboru jest zaznaczone lub FAŁSZ, jeśli nie.
bHighlighted
[in] WARTOŚĆ TRUE, jeśli pole wyboru jest wyróżnione lub FAŁSZ, jeśli nie.
Uwagi
CMFCRibbonCheckBox::SetACCData
Ustawia dane ułatwień dostępu dla pola wyboru.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parametry
PParent
Okno nadrzędne pola wyboru.
data
Dane ułatwień dostępu dla pola wyboru.
Wartość zwracana
Zawsze zwraca wartość TRUE.
Uwagi
Domyślnie ta metoda ustawia dane ułatwień dostępu dla pola wyboru i zawsze zwraca wartość TRUE. Zastąpij tę metodę, aby ustawić dane ułatwień dostępu i zwrócić wartość wskazującą powodzenie lub niepowodzenie.