Klasa CMFCColorBar

Artykuł
02/27/2013

CMFCColorBar Klasy reprezentuje dokowania pasek sterowania, który można wybrać kolory w dokumencie lub aplikacji.

class CMFCColorBar : public CMFCPopupMenuBar

Członkowie

Konstruktorzy chronieni

Nazwa	Opis
CMFCColorBar::CMFCColorBar	Konstrukcje CMFCColorBar obiektu.

Metody publiczne

Nazwa	Opis
CMFCColorBar::ContextToSize	Oblicza marginesów pionowych i poziomych, które są wymagane do zawierają przyciski sterowania pasek koloru i następnie dostosowuje położenie tych przycisków.
CMFCColorBar::CreateControl	Tworzy okno Kontrola pasek koloru, dołącza go do CMFCColorBar obiektu i zmienia rozmiar formantu określonej palety kolorów zawierają.
CMFCColorBar::Create	Tworzy okno Kontrola pasek koloru i dołącza go do CMFCColorBar obiektu.
CMFCColorBar::EnableAutomaticButton	Pokazuje lub ukrywa przycisk automatyczne.
CMFCColorBar::EnableOtherButton	Włącza lub wyłącza wyświetlanie okna dialogowego, który umożliwia użytkownikowi wybranie więcej kolorów.
CMFCColorBar::GetColor	Pobiera aktualnie wybrany kolor.
CMFCColorBar::GetCommandID	Pobiera identyfikator polecenia bieżącego formantu paska koloru.
CMFCColorBar::GetHighlightedColor	Pobiera kolor oznacza, że przycisk kolor ma fokus; przycisk jest hot.
CMFCColorBar::GetHorzMargin	Pobiera poziomy margines jest odstęp między lewej lub prawej kolor komórki i granice obszaru klienta.
CMFCColorBar::GetVertMargin	Pobiera pionowy margines jest odstęp między górnej lub dolnej komórki kolorów i granice obszaru klienta.
CMFCColorBar::IsTearOff	Wskazuje, czy bieżący pasek koloru dokujące.
CMFCColorBar::SetColor	Ustawia aktualnie wybrany kolor.
CMFCColorBar::SetColorName	Określa nową nazwę określonego koloru.
CMFCColorBar::SetCommandID	Ustawia nowy identyfikator polecenia dla formantu paska koloru.
CMFCColorBar::SetDocumentColors	Ustawia listę kolorów, które są używane w bieżącym dokumencie.
CMFCColorBar::SetHorzMargin	Ustawia margines poziomej jest odstęp między lewej lub prawej kolor komórki i granice obszaru klienta.
CMFCColorBar::SetVertMargin	Ustawia pionowe margines jest odstęp między górną lub dolną komórkę kolorów i granice obszaru klienta.

Metody chronione

Nazwa	Opis
CMFCColorBar::AdjustLocations	Dopasowuje położenie przycisków kolor formantu paska koloru.
CMFCColorBar::AllowChangeTextLabels	Wskazuje, czy tekst etykiety przycisków kolor można zmienić.
CMFCColorBar::AllowShowOnList	Wskazuje, czy pasek koloru obiektu formantu można pojawiają się na liście narzędzi podczas procesu dostosowywania.
CMFCColorBar::CalcSize	Wywołana przez RAM jako część procesu obliczania układu.
CMFCColorBar::CreatePalette	Initalizes paletę kolorów w określonej tablicy kolorów.
CMFCColorBar::GetColorGridSize	Oblicza liczbę wierszy i kolumn w siatce formantu paska koloru.
CMFCColorBar::GetExtraHeight	Oblicza dodatkowe wysokość bieżący pasek koloru wymaga, aby wyświetlić elementy interfejsu użytkownika różne takich jak innych przycisku, kolory dokumentu i tak dalej.
CMFCColorBar::InitColors	Inicjuje tablicę kolorów w palecie określonych lub domyślna paleta systemu.
CMFCColorBar::OnKey	Wywołana przez ramy, gdy użytkownik naciśnie przycisk klawiatury.
CMFCColorBar::OnSendCommand	Wywołana przez ramy zamknąć Hierarchia formantów menu podręczne.
CMFCColorBar::OnUpdateCmdUI	Wywołana przez RAM, aby włączyć lub wyłączyć element interfejsu użytkownika kontroli pasek kolorów przed wyświetleniem elementu.
CMFCColorBar::OpenColorDialog	Otwiera okno dialogowe Kolor.
CMFCColorBar::Rebuild	Całkowicie odrysowania formantu paska koloru.
CMFCColorBar::SelectPalette	Ustawia logiczne paletę kontekstu urządzenia określonego przycisku nadrzędnym bieżącego formantu pasek koloru z palety.
CMFCColorBar::SetPropList	Zestawy m_pWndPropList chroniony członek danych na określony wskaźnik do siatki właściwości formantu.
CMFCColorBar::ShowCommandMessageString	Żądania będącego właścicielem kontroli pasek koloru do aktualizacji wiersza wiadomości na pasku stanu okna ramki.

Chronionych danych członków

Nazwa	Opis
m_bInternal	Pole logiczne Określa, czy zdarzenia myszy są przetwarzane.Zazwyczaj zdarzenia myszy są przetwarzane, kiedy to pole jest TRUE i dostosowywania tryb jest FALSE.
m_bIsEnabled	Wartość logiczna wskazująca, czy formant jest włączony.
m_bIsTearOff	Wartość logiczna wskazująca, czy formant pasek koloru obsługuje dokowania.
m_BoxSize	A CSize obiekt, który określa rozmiar komórki w siatce paska koloru.
m_bShowDocColorsWhenDocked	Wartość logiczna wskazująca, czy pokazywać kolorów dokumentu, kiedy jest zadokowany pasek koloru.Aby uzyskać więcej informacji, zobacz CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Boolean, która wskazuje, czy wyświetlać okno dialogowe standardowego systemu kolorów lub CMFCColorDialog okno dialogowe.Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	A COLORREF przechowujący bieżący kolor automatyczny.Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.
m_ColorNames	CMap obiekt, który kojarzy zestaw RGB kolory z ich nazwy.
m_colors	A CArray z COLORREF wartości, które zawiera kolory, które są wyświetlane w formancie pasek koloru.
m_ColorSelected	A COLORREF czyli wartości koloru, użytkownik ma aktualnie wybranego formantu paska koloru.
m_lstDocColors	A CList z COLORREF wartości, które zawiera kolory, które są aktualnie używane w dokumencie.
m_nCommandID	Całkowitą bez znaku jest identyfikator polecenia przycisku kolor.
m_nHorzMargin	Liczba całkowita, która jest pozioma margines między przyciskami kolor siatki kolorów.
m_nHorzOffset	Liczba całkowita, która jest przesunięcie w poziomie do Centrum przycisk Kolor.Ta wartość jest istotne, jeśli przycisk wyświetla tekst lub obraz poza kolor.
m_nNumColumns	Całkowitą liczbę kolumn w siatce formantu kolor paska kolorów.
m_nNumColumnsVert	Całkowitą liczbę kolumn w siatce zorientowanego pionowo kolorów.
m_nNumRowsHorz	Całkowitą liczbę kolumn w siatce poziomo kolorów.
m_nRowHeight	Całkowitą wysokość wiersza przycisków kolor siatki kolorów.
m_nVertMargin	Całkowitą pionową margines między przyciskami kolor siatki kolorów.
m_nVertOffset	Liczba całkowita, która jest przesunięcie w pionie do Centrum przycisk Kolor.Ta wartość jest istotne, jeśli przycisk wyświetla tekst lub obraz poza kolor.
m_Palette	A CPalette kolorów, które są używane w formancie pasek koloru.
m_pParentBtn	Wskaźnik do CMFCColorButton obiektu nadrzędnego bieżącego przycisku.Jeśli przycisk Kolor jest w hierarchii formantów z paska narzędzi lub w formancie kolor siatki właściwości, wartość ta jest znaczny.
m_pParentRibbonBtn	Wskaźnik do CMFCRibbonColorButton obiekt, który jest na Wstążce i jest przycisk nadrzędnym bieżącego przycisku.Jeśli przycisk Kolor jest w hierarchii formantów z paska narzędzi lub w formancie kolor siatki właściwości, wartość ta jest znaczny.
m_pWndPropList	Wskaźnik do CMFCPropertyGridCtrl obiektu.
m_strAutoColor	A CString czyli tekst jest wyświetlany na Automatyczne przycisku.Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableAutomaticButton.
m_strDocColors	A CString czyli tekst jest wyświetlany na przycisku kolory dokumentu.Aby uzyskać więcej informacji, zobacz CMFCColorBar::SetDocumentColors.
m_strOtherColor	A CString czyli tekst jest wyświetlany na innych przycisku.Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.

Uwagi

Zazwyczaj nie można utworzyć CMFCColorBar bezpośrednio obiekt.Zamiast tego Klasa CMFCColorMenuButton (używane w menu i paski narzędzi) lub Klasa CMFCColorButton tworzy CMFCColorBar obiektu.

CMFCColorBar Klasy zapewnia następujące funkcje:

Automatycznie dopasowuje listę kolorów dokumentu.
Zapisuje i przywraca jej stan oraz stan dokumentu.
Zarządza przycisku "automatyczne".
Używa Klasa CMFCColorPickerCtrl formantu, aby wybrać kolor niestandardowy.
Obsługuje stanu "Zdzierane" (jeśli jest tworzony przy użyciu Klasa CMFCColorMenuButton).

Włączenie CMFCColorBar funkcje w aplikacji:

Utwórz przycisk menu regularnych i przypisać mu identyfikator, na przykład ID_CHAR_COLOR.
W klasie ramki okna, należy zastąpić CFrameWndEx::OnShowPopupMenu metody i Zamień regularnych menu przycisku z Klasa CMFCColorMenuButton obiektu (wywołując CMFCToolBar::ReplaceButton).
Ustaw wszystkie style i włączyć lub wyłączyć funkcje CMFCColorBar obiektu podczas Klasa CMFCColorMenuButton tworzenie.CMFCColorMenuButton Obiektu dynamicznie tworzy CMFCColorBar obiektu po wywołania RAM CreatePopupMenu metody.

Po kliknięciu przycisku paska koloru formantu używa ramach ON_COMMAND makro powiadomić nadrzędny formantu paska koloru.W makrze parametr identyfikator polecenia jest wartość przypisana do przycisku paska koloru formantu w kroku 1 (ID_CHAR_COLOR w tym przykładzie).For more information, see the Klasa CMFCColorMenuButton, Klasa CMFCColorButton, Klasa CMFCColorPickerCtrl, Klasa CFrameWndEx, and Klasa CMFCToolBar classes.

Przykład

Poniższy przykład ilustruje sposób skonfigurować pasek koloru przy użyciu różnych metod w CMFCColorBar klasy.Metody ustawić marginesy poziome i pionowe, inny przycisk Włącz, utwórz okno Kontrola pasek koloru i ustawia kolor zaznaczonego.W tym przykładzie jest częścią nowych formantów próbki.

    CMFCColorBar m_wndColorBar;


...


    // set the margins
    m_wndColorBar.SetHorzMargin(0);
    m_wndColorBar.SetVertMargin(0);
    // enable the display of a dialog box that 
    // lets the user select more colors
    m_wndColorBar.EnableOtherButton(_T("Other..."));
    // create a color bar control window
    m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
    // set the currently selected color
    m_wndColorBar.SetColor(RGB(255, 0, 0));