Udostępnij za pośrednictwem

CToolBarCtrl Klasa

  • Artykuł

Udostępnia funkcje typowej kontrolki paska narzędzi systemu Windows.

Składnia

class CToolBarCtrl : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CToolBarCtrl::CToolBarCtrl CToolBarCtrl Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CToolBarCtrl::AddBitmap Dodaje co najmniej jeden obraz przycisku mapy bitowej do listy obrazów przycisków dostępnych dla kontrolki paska narzędzi.
CToolBarCtrl::AddButtons Dodaje jeden lub więcej przycisków do kontrolki paska narzędzi.
CToolBarCtrl::AddString Dodaje nowy ciąg przekazany jako identyfikator zasobu do wewnętrznej listy ciągów paska narzędzi.
CToolBarCtrl::AddStrings Dodaje nowy ciąg lub ciągi, przekazywane jako wskaźnik do buforu NULLciągów rozdzielanych, do wewnętrznej listy ciągów paska narzędzi.
CToolBarCtrl::AutoSize Zmienia rozmiar kontrolki paska narzędzi.
CToolBarCtrl::ChangeBitmap Zmienia mapę bitową przycisku w bieżącej kontrolce paska narzędzi.
CToolBarCtrl::CheckButton Sprawdza lub czyści dany przycisk w kontrolce paska narzędzi.
CToolBarCtrl::CommandToIndex Pobiera indeks zerowy dla przycisku skojarzonego z określonym identyfikatorem polecenia.
CToolBarCtrl::Create Tworzy kontrolkę paska narzędzi i dołącza ją do CToolBarCtrl obiektu.
CToolBarCtrl::CreateEx Tworzy kontrolkę paska narzędzi z określonymi stylami rozszerzonymi systemu Windows i dołącza ją do CToolBarCtrl obiektu.
CToolBarCtrl::Customize Wyświetla okno dialogowe Dostosowywanie paska narzędzi.
CToolBarCtrl::DeleteButton Usuwa przycisk z kontrolki paska narzędzi.
CToolBarCtrl::EnableButton Włącza lub wyłącza określony przycisk w kontrolce paska narzędzi.
CToolBarCtrl::GetAnchorHighlight Pobiera ustawienie wyróżnienia kotwicy dla paska narzędzi.
CToolBarCtrl::GetBitmap Pobiera indeks mapy bitowej skojarzonej z przyciskiem na pasku narzędzi.
CToolBarCtrl::GetBitmapFlags Pobiera flagi skojarzone z mapą bitową paska narzędzi.
CToolBarCtrl::GetButton Pobiera informacje o określonym przycisku w kontrolce paska narzędzi.
CToolBarCtrl::GetButtonCount Pobiera liczbę przycisków aktualnie w kontrolce paska narzędzi.
CToolBarCtrl::GetButtonInfo Pobiera informacje dotyczące przycisku na pasku narzędzi.
CToolBarCtrl::GetButtonSize Pobiera bieżącą szerokość i wysokość przycisków paska narzędzi w pikselach.
CToolBarCtrl::GetColorScheme Pobiera schemat kolorów bieżącej kontrolki paska narzędzi.
CToolBarCtrl::GetDisabledImageList Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania wyłączonych przycisków.
CToolBarCtrl::GetDropTarget IDropTarget Pobiera interfejs kontrolki paska narzędzi.
CToolBarCtrl::GetExtendedStyle Pobiera style rozszerzone dla kontrolki paska narzędzi.
CToolBarCtrl::GetHotImageList Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania przycisków "hot". Gdy wskaźnik myszy znajduje się nad nim, zostanie wyróżniony przycisk gorąca.
CToolBarCtrl::GetHotItem Pobiera indeks gorącego elementu na pasku narzędzi.
CToolBarCtrl::GetImageList Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania przycisków w ich domyślnym stanie.
CToolBarCtrl::GetInsertMark Pobiera bieżący znacznik wstawiania dla paska narzędzi.
CToolBarCtrl::GetInsertMarkColor Pobiera kolor używany do rysowania znacznika wstawiania dla paska narzędzi.
CToolBarCtrl::GetItemRect Pobiera prostokąt ograniczenia przycisku w kontrolce paska narzędzi.
CToolBarCtrl::GetMaxSize Pobiera całkowity rozmiar wszystkich widocznych przycisków i separatorów na pasku narzędzi.
CToolBarCtrl::GetMaxTextRows Pobiera maksymalną liczbę wierszy tekstowych wyświetlanych na przycisku paska narzędzi.
CToolBarCtrl::GetMetrics Pobiera metryki kontrolki paska narzędzi.
CToolBarCtrl::GetPadding Pobiera dopełnienie w poziomie i w pionie bieżącej kontrolki paska narzędzi.
CToolBarCtrl::GetPressedImageList Pobiera listę obrazów używa bieżącej kontrolki paska narzędzi do reprezentowania przycisków w stanie naciśniętym.
CToolBarCtrl::GetRect Pobiera prostokąt ograniczenia dla określonego przycisku paska narzędzi.
CToolBarCtrl::GetRows Pobiera liczbę wierszy przycisków aktualnie wyświetlanych na pasku narzędzi.
CToolBarCtrl::GetState Pobiera informacje o stanie określonego przycisku w kontrolce paska narzędzi, takie jak włączenie, naciśnięcie lub sprawdzenie.
CToolBarCtrl::GetString Pobiera ciąg paska narzędzi.
CToolBarCtrl::GetStyle Pobiera style używane obecnie dla kontrolki paska narzędzi.
CToolBarCtrl::GetToolTips Pobiera uchwyt kontrolki porad narzędzia, jeśli istnieje, skojarzony z kontrolką paska narzędzi.
CToolBarCtrl::HideButton Ukrywa lub wyświetla określony przycisk w kontrolce paska narzędzi.
CToolBarCtrl::HitTest Określa, gdzie punkt znajduje się w kontrolce paska narzędzi.
CToolBarCtrl::Indeterminate Ustawia lub czyści nieokreślony (szary) stan określonego przycisku w kontrolce paska narzędzi.
CToolBarCtrl::InsertButton Wstawia przycisk w kontrolce paska narzędzi.
CToolBarCtrl::InsertMarkHitTest Pobiera informacje o znaczniku wstawiania dla punktu na pasku narzędzi.
CToolBarCtrl::IsButtonChecked Informuje, czy określony przycisk w kontrolce paska narzędzi jest zaznaczony.
CToolBarCtrl::IsButtonEnabled Informuje, czy określony przycisk w kontrolce paska narzędzi jest włączony.
CToolBarCtrl::IsButtonHidden Informuje, czy określony przycisk w kontrolce paska narzędzi jest ukryty.
CToolBarCtrl::IsButtonHighlighted Sprawdza stan wyróżnienia przycisku paska narzędzi.
CToolBarCtrl::IsButtonIndeterminate Informuje, czy stan określonego przycisku w kontrolce paska narzędzi jest nieokreślony (szary).
CToolBarCtrl::IsButtonPressed Informuje, czy określony przycisk w kontrolce paska narzędzi jest naciśnięty.
CToolBarCtrl::LoadImages Ładuje mapy bitowe do listy obrazów kontrolki paska narzędzi.
CToolBarCtrl::MapAccelerator Mapuje znak akceleratora na przycisk paska narzędzi.
CToolBarCtrl::MarkButton Ustawia stan wyróżnienia danego przycisku w kontrolce paska narzędzi.
CToolBarCtrl::MoveButton Przenosi przycisk z jednego indeksu do innego.
CToolBarCtrl::PressButton Naciska lub zwalnia określony przycisk w kontrolce paska narzędzi.
CToolBarCtrl::ReplaceBitmap Zastępuje istniejącą mapę bitową w bieżącej kontrolce paska narzędzi nową mapą bitową.
CToolBarCtrl::RestoreState Przywraca stan kontrolki paska narzędzi.
CToolBarCtrl::SaveState Zapisuje stan kontrolki paska narzędzi.
CToolBarCtrl::SetAnchorHighlight Ustawia ustawienie wyróżnienia kotwicy dla paska narzędzi.
CToolBarCtrl::SetBitmapSize Ustawia rozmiar obrazów map bitowych do dodania do kontrolki paska narzędzi.
CToolBarCtrl::SetButtonInfo Ustawia informacje dotyczące istniejącego przycisku na pasku narzędzi.
CToolBarCtrl::SetButtonSize Ustawia rozmiar przycisków do dodania do kontrolki paska narzędzi.
CToolBarCtrl::SetButtonStructSize Określa rozmiar TBBUTTON struktury.
CToolBarCtrl::SetButtonWidth Ustawia minimalną i maksymalną szerokość przycisku w kontrolce paska narzędzi.
CToolBarCtrl::SetCmdID Ustawia identyfikator polecenia, który ma zostać wysłany do okna właściciela po naciśnięciu określonego przycisku.
CToolBarCtrl::SetColorScheme Ustawia schemat kolorów bieżącej kontrolki paska narzędzi.
CToolBarCtrl::SetDisabledImageList Ustawia listę obrazów, która będzie używana przez kontrolkę paska narzędzi do wyświetlania wyłączonych przycisków.
CToolBarCtrl::SetDrawTextFlags Ustawia flagi w funkcji DrawTextWin32 , która służy do rysowania tekstu w określonym prostokątze, sformatowanego zgodnie z ustawionymi flagami.
CToolBarCtrl::SetExtendedStyle Ustawia style rozszerzone dla kontrolki paska narzędzi.
CToolBarCtrl::SetHotImageList Ustawia listę obrazów, która będzie używana przez kontrolkę paska narzędzi do wyświetlania przycisków "hot".
CToolBarCtrl::SetHotItem Ustawia gorący element na pasku narzędzi.
CToolBarCtrl::SetImageList Ustawia listę obrazów, która będzie używana przez pasek narzędzi do wyświetlania przycisków znajdujących się w ich domyślnym stanie.
CToolBarCtrl::SetIndent Ustawia wcięcie pierwszego przycisku w kontrolce paska narzędzi.
CToolBarCtrl::SetInsertMark Ustawia bieżący znacznik wstawiania dla paska narzędzi.
CToolBarCtrl::SetInsertMarkColor Ustawia kolor używany do rysowania znacznika wstawiania dla paska narzędzi.
CToolBarCtrl::SetMaxTextRows Ustawia maksymalną liczbę wierszy tekstowych wyświetlanych na przycisku paska narzędzi.
CToolBarCtrl::SetMetrics Ustawia metryki kontrolki paska narzędzi.
CToolBarCtrl::SetOwner Ustawia okno w celu odbierania komunikatów powiadomień z kontrolki paska narzędzi.
CToolBarCtrl::SetPadding Ustawia dopełnienie w poziomie i w pionie bieżącej kontrolki paska narzędzi.
CToolBarCtrl::SetPressedImageList Ustawia listę obrazów używaną przez bieżącą kontrolkę paska narzędzi do reprezentowania przycisków w stanie naciśniętym.
CToolBarCtrl::SetRows Ustawia liczbę wierszy przycisków wyświetlanych na pasku narzędzi.
CToolBarCtrl::SetState Ustawia stan określonego przycisku w kontrolce paska narzędzi.
CToolBarCtrl::SetStyle Ustawia style kontrolki paska narzędzi.
CToolBarCtrl::SetToolTips Kojarzy kontrolkę porad narzędzia z kontrolką paska narzędzi.
CToolBarCtrl::SetWindowTheme Ustawia styl wizualny kontrolki paska narzędzi.

Uwagi

Ta kontrolka CToolBarCtrl (i dlatego klasa) jest dostępna tylko dla programów działających w systemach Windows 95/98 i Windows NT w wersji 3.51 lub nowszej.

Typowa kontrolka paska narzędzi systemu Windows to prostokątne okno podrzędne zawierające co najmniej jeden przycisk. Te przyciski mogą wyświetlać obraz mapy bitowej, ciąg lub oba te przyciski. Gdy użytkownik wybierze przycisk, wysyła komunikat polecenia do okna właściciela paska narzędzi. Zazwyczaj przyciski na pasku narzędzi odpowiadają elementom w menu aplikacji; zapewniają one bardziej bezpośredni sposób uzyskiwania dostępu do poleceń aplikacji przez użytkownika.

CToolBarCtrl obiekty zawierają kilka ważnych wewnętrznych struktur danych: listę map bitowych obrazów przycisków lub listę obrazów, listę ciągów etykiet przycisku oraz listę TBBUTTON struktur, które kojarzą obraz i/lub ciąg z pozycją, stylem, stanem i identyfikatorem polecenia przycisku. Każdy z elementów tych struktur danych jest określany przez indeks oparty na zerze. Aby można było użyć CToolBarCtrl obiektu, należy skonfigurować te struktury danych. Lista ciągów może być używana tylko dla etykiet przycisków; nie można pobrać ciągów z paska narzędzi.

Aby użyć CToolBarCtrl obiektu, zazwyczaj należy wykonać następujące kroki:

  1. Skonstruuj CToolBarCtrl obiekt.

  2. Wywołaj metodę Create , aby utworzyć wspólną kontrolkę paska narzędzi systemu Windows i dołączyć ją do CToolBarCtrl obiektu. Określ styl paska narzędzi przy użyciu stylów, takich jak TBSTYLE_TRANSPARENT przezroczysty pasek narzędzi lub TBSTYLE_DROPDOWN pasek narzędzi obsługujący przyciski stylu listy rozwijanej.

  3. Określ sposób wyświetlania przycisków na pasku narzędzi:

    • Aby użyć obrazów mapy bitowej dla przycisków, dodaj mapy bitowe przycisku do paska narzędzi, wywołując metodę AddBitmap.

    • Aby użyć obrazów wyświetlanych z listy obrazów dla przycisków, określ listę obrazów, wywołując metodę SetImageList, SetHotImageListlub SetDisabledImageList.

    • Aby użyć etykiet ciągów dla przycisków, dodaj ciągi do paska narzędzi, wywołując AddString i/lub AddStrings.

  4. Dodaj struktury przycisków do paska narzędzi, wywołując polecenie AddButtons.

  5. Jeśli chcesz, aby wskazówki dotyczące narzędzi dla przycisku paska narzędzi w oknie właściciela, które nie jest elementem , musisz obsługiwać TTN_NEEDTEXT komunikaty w oknie właściciela paska narzędzi zgodnie z opisem CFrameWndw temacie Obsługa powiadomień porad dotyczących narzędzi. Jeśli okno nadrzędne paska narzędzi pochodzi z CFrameWndprogramu , wskazówki dotyczące narzędzi są wyświetlane bez dodatkowego nakładu pracy, ponieważ CFrameWnd udostępnia domyślną procedurę obsługi.

  6. Jeśli chcesz, aby użytkownik mógł dostosować pasek narzędzi, obsłuż komunikaty powiadomień o dostosowywaniu w oknie właściciela zgodnie z opisem w temacie Obsługa powiadomień dostosowywania.

Możesz użyć SaveState polecenia , aby zapisać bieżący stan kontrolki paska narzędzi w rejestrze i RestoreState przywrócić stan na podstawie informacji wcześniej przechowywanych w rejestrze. Oprócz zapisywania stanu paska narzędzi między użyciem aplikacji aplikacje zazwyczaj przechowują stan przed rozpoczęciem dostosowywania paska narzędzi przez użytkownika w przypadku, gdy użytkownik później chce przywrócić pasek narzędzi do stanu pierwotnego.

Obsługa programu Internet Explorer w wersji 4.0 lub nowszej

Aby obsługiwać funkcje wprowadzone w programie Internet Explorer, wersja 4.0 lub nowsza, MFC zapewnia obsługę list obrazów oraz przezroczyste i płaskie style dla kontrolek paska narzędzi.

Przezroczysty pasek narzędzi umożliwia klientowi wyświetlanie na pasku narzędzi. Aby utworzyć przezroczysty pasek narzędzi, użyj stylów TBSTYLE_FLAT i TBSTYLE_TRANSPARENT . Przezroczyste paski narzędzi zawierają funkcję śledzenia na gorąco; oznacza to, że gdy wskaźnik myszy przechodzi przez gorący przycisk na pasku narzędzi, wygląd przycisku zmienia się. Paski narzędzi utworzone przy użyciu tylko TBSTYLE_FLAT stylu będą zawierać przyciski, które nie są przezroczyste.

Obsługa listy obrazów umożliwia kontrolę nad większą elastycznością zachowania domyślnego, gorących obrazów i wyłączonych obrazów. Użyj symboli GetImageList, GetHotImageListi GetDisabledImageList z przezroczystym paskiem narzędzi, aby manipulować obrazem zgodnie z jego stanem:

Aby uzyskać więcej informacji na temat korzystania z programu CToolBarCtrl, zobacz Controls and Using CToolBarCtrl.

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CToolBarCtrl

Wymagania

Nagłówek: afxcmn.h

CToolBarCtrl::AddBitmap

Dodaje co najmniej jeden obraz przycisku do listy obrazów przycisków przechowywanych w kontrolce paska narzędzi.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parametry

nNumButtons
Liczba obrazów przycisków na mapie bitowej.

nBitmapID
Identyfikator zasobu mapy bitowej zawierającej obraz przycisku lub obrazy do dodania.

pBitmap
Wskaźnik do CBitmap obiektu zawierającego obraz przycisku lub obrazy do dodania.

Wartość zwracana

Indeks oparty na zera pierwszego nowego obrazu, jeśli się powiedzie; w przeciwnym razie - 1.

Uwagi

Za pomocą interfejsu API CreateMappedBitmap systemu Windows można mapować kolory przed dodaniem mapy bitowej do paska narzędzi. Jeśli wskaźnik zostanie przekazany do CBitMap obiektu, musisz upewnić się, że mapa bitowa nie zostanie zniszczona do momentu zniszczenia paska narzędzi.

CToolBarCtrl::AddButtons

Dodaje jeden lub więcej przycisków do kontrolki paska narzędzi.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parametry

nNumButtons
Liczba przycisków do dodania.

lpButtons
Adres tablicy TBBUTTON struktur, które zawierają informacje o przyciskach do dodania. Musi istnieć taka sama liczba elementów w tablicy, co przyciski określone przez nNumButtons.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Wskaźnik lpButtons wskazuje tablicę TBBUTTON struktur. Każda TBBUTTON struktura kojarzy dodany przycisk ze stylem, obrazem i/lub ciągiem, identyfikatorem polecenia, stanem i danymi zdefiniowanymi przez użytkownika:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

Członkowie są następująco:

  • iBitmap

    Zerowy indeks obrazu przycisku, -1, jeśli nie ma obrazu dla tego przycisku.

  • idCommand

    Identyfikator polecenia skojarzony z przyciskiem . Ten identyfikator jest wysyłany w WM_COMMAND komunikacie po wybraniu przycisku. Jeśli element członkowski fsStyle ma TBSTYLE_SEP wartość, ten element członkowski musi mieć wartość zero.

  • fsState

    Flagi stanu przycisku. Może to być kombinacja wartości wymienionych poniżej:

    • TBSTATE_CHECKED Przycisk ma TBSTYLE_CHECKED styl i jest naciskany.

    • TBSTATE_ENABLED Przycisk akceptuje dane wejściowe użytkownika. Przycisk, który nie ma tego stanu, nie akceptuje danych wejściowych użytkownika i jest szary.

    • TBSTATE_HIDDEN Przycisk nie jest widoczny i nie może odbierać danych wejściowych użytkownika.

    • TBSTATE_INDETERMINATE Przycisk jest szary.

    • TBSTATE_PRESSED Przycisk jest naciskany.

    • TBSTATE_WRAP Podział wiersza jest zgodny z przyciskiem . Przycisk musi również mieć TBSTATE_ENABLED stan .

  • fsStyle

    Styl przycisku. Może to być kombinacja wartości wymienionych poniżej:

    • TBSTYLE_BUTTON Tworzy standardowy przycisk wypychania.

    • TBSTYLE_CHECK Tworzy przycisk przełączający się między naciśniętymi i nieskompresowanym stanem za każdym razem, gdy użytkownik kliknie go. Przycisk ma inny kolor tła, gdy jest w stanie naciśniętym.

    • TBSTYLE_CHECKGROUP Tworzy przycisk sprawdzania, który pozostaje naciśnięty do momentu naciśnięcia innego przycisku w grupie.

    • TBSTYLE_GROUP Tworzy przycisk, który pozostaje naciśnięty do momentu naciśnięcia innego przycisku w grupie.

    • TBSTYLE_SEP Tworzy separator, zapewniając małą lukę między grupami przycisków. Przycisk, który ma ten styl, nie otrzymuje danych wejściowych użytkownika.

  • dwData

    Dane zdefiniowane przez użytkownika.

  • iString

    Zerowy indeks ciągu, który ma być używany jako etykieta przycisku, -1, jeśli nie ma ciągu dla tego przycisku.

Obraz i/lub ciąg, którego indeks musi być wcześniej dodany do listy kontrolki paska narzędzi przy użyciu , AddBitmapAddString, i/lub AddStrings.

CToolBarCtrl::AddString

Dodaje nowy ciąg przekazany jako identyfikator zasobu do wewnętrznej listy ciągów paska narzędzi.

int AddString(UINT nStringID);

Parametry

nStringID
Identyfikator zasobu ciągu, który ma zostać dodany do listy ciągów kontrolki paska narzędzi.

Wartość zwracana

Indeks oparty na zera pierwszego nowego ciągu dodany, jeśli zakończy się powodzeniem; w przeciwnym razie -1.

CToolBarCtrl::AddStrings

Dodaje nowy ciąg lub ciągi do listy ciągów dostępnych dla kontrolki paska narzędzi.

int AddStrings(LPCTSTR lpszStrings);

Parametry

lpszStrings
Adres buforu zawierającego co najmniej jeden NULLciąg zakończony do dodania do listy ciągów paska narzędzi. Ostatni ciąg musi zostać zakończony dwoma NULL znakami.

Wartość zwracana

Indeks oparty na zera pierwszego nowego ciągu dodany, jeśli zakończy się powodzeniem; w przeciwnym razie -1.

Uwagi

Ciągi w buforze muszą być oddzielone znakiem NULL . Musisz upewnić się, że ostatni ciąg ma dwa NULL terminatory. Aby poprawnie sformatować ciąg stały, możesz zapisać go w następujący sposób:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

or:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Nie należy przekazywać CString obiektu do tej funkcji, ponieważ nie można mieć więcej niż jednego NULL znaku w obiekcie CString.

CToolBarCtrl::AutoSize

Zmienia rozmiar całej kontrolki paska narzędzi.

void AutoSize();

Uwagi

Tę funkcję należy wywołać, gdy rozmiar okna nadrzędnego zmieni się lub gdy rozmiar paska narzędzi zmieni się (np. po ustawieniu przycisku lub rozmiaru mapy bitowej lub dodaniu ciągów).

CToolBarCtrl::ChangeBitmap

Zmienia mapę bitową przycisku w bieżącej kontrolce paska narzędzi.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parametry

idButton
[in] Identyfikator polecenia przycisku, który ma otrzymać nową mapę bitową.

iBitmap
[in] Zerowy indeks obrazu na liście obrazów bieżącego formantu paska narzędzi.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Jeśli ta metoda zakończy się pomyślnie, system wyświetli określony obraz w określonym przycisku.

Ta metoda wysyła TB_CHANGEBITMAP komunikat opisany w zestawie SDK systemu Windows.

Przykład

Poniższy przykład kodu zmienia mapę bitową przycisku Zapisz plik na mapę bitową przycisku Informacje .

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Sprawdza lub czyści dany przycisk w kontrolce paska narzędzi.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parametry

nID
Identyfikator polecenia przycisku w celu sprawdzenia lub wyczyszczenia.

bCheck
TRUE aby sprawdzić przycisk, FALSE aby go wyczyścić.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Gdy przycisk został zaznaczony, wydaje się, że został naciśnięty. Jeśli chcesz zmienić więcej niż jeden stan przycisku, rozważ wywołanie SetState zamiast tego.

CToolBarCtrl::CommandToIndex

Pobiera indeks zerowy dla przycisku skojarzonego z określonym identyfikatorem polecenia.

UINT CommandToIndex(UINT nID) const;

Parametry

nID
Identyfikator polecenia, którego indeks przycisku chcesz znaleźć.

Wartość zwracana

Indeks oparty na zera dla przycisku skojarzonego z identyfikatorem polecenia.

Uwagi

CToolBarCtrl::Create

Tworzy kontrolkę paska narzędzi i dołącza ją do CToolBarCtrl obiektu.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwStyle
Określa styl kontrolki paska narzędzi. Paski narzędzi muszą zawsze mieć WS_CHILD styl. Ponadto można określić dowolną kombinację stylów paska narzędzi i stylów okien zgodnie z opisem w sekcji Uwagi.

rect
Opcjonalnie określa rozmiar i położenie kontrolki paska narzędzi. Może to być CRect obiekt lub RECT struktura.

pParentWnd
Określa okno nadrzędne kontrolki paska narzędzi. Nie może to być NULL.

nID
Określa identyfikator kontrolki paska narzędzi.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Utworzysz element CToolBarCtrl w dwóch krokach. Najpierw wywołaj konstruktor, a następnie wywołaj Createmetodę , która tworzy kontrolkę paska narzędzi i dołącza ją do CToolBarCtrl obiektu. Zastosuj następujące style okna do kontrolki paska narzędzi.

  • WS_CHILD Zawsze

  • WS_VISIBLE Zwykle

  • WS_DISABLED Rzadko

Zobacz CreateWindow w zestawie Windows SDK, aby uzyskać opis stylów okien.

Opcjonalnie zastosuj kombinację typowych stylów kontrolek zgodnie z opisem w zestawie Windows SDK.

Zastosuj kombinację stylów paska narzędzi do samej kontrolki lub przycisków. Style są opisane w temacie Kontrolka paska narzędzi i Style przycisków w zestawie Windows SDK.

Aby użyć rozszerzonych stylów paska narzędzi, wywołaj metodę SetExtendedStyle po wywołaniu metody Create. Aby utworzyć pasek narzędzi z rozszerzonymi stylami okien, wywołaj metodę CToolBarCtrl::CreateEx zamiast Create.

Kontrolka paska narzędzi automatycznie ustawia rozmiar i położenie okna paska narzędzi. Wysokość jest oparta na wysokości przycisków na pasku narzędzi. Szerokość jest taka sama jak szerokość obszaru klienta okna nadrzędnego. Style CCS_TOP i CCS_BOTTOM określają, czy pasek narzędzi jest umieszczony wzdłuż górnej lub dolnej części obszaru klienta. Domyślnie pasek narzędzi ma CCS_TOP styl.

CToolBarCtrl::CreateEx

Tworzy kontrolkę (okno podrzędne) i kojarzy ją z obiektem CToolBarCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

dwExStyle
Określa rozszerzony styl tworzonej kontrolki. Aby uzyskać listę rozszerzonych stylów systemu Windows, zobacz dwExStyle parametr dla CreateWindowEx w zestawie Windows SDK.

dwStyle
Określa styl kontrolki paska narzędzi. Paski narzędzi muszą zawsze mieć WS_CHILD styl. Ponadto można określić dowolną kombinację stylów paska narzędzi i stylów okien zgodnie z opisem w sekcji Uwagi .Create

rect
Odwołanie do RECT struktury opisującej rozmiar i położenie okna do utworzenia w współrzędnych pParentWndklienta .

pParentWnd
Wskaźnik do okna, który jest elementem nadrzędnym kontrolki.

nID
Identyfikator okna podrzędnego kontrolki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Create Zamiast CreateEx stosować rozszerzone style systemu Windows określone w rozszerzonym prefiksie WS_EX_stylu systemu Windows. CreateEx tworzy kontrolkę z rozszerzonymi stylami systemu Windows określonymi przez dwExStyle. Ustaw style rozszerzone specyficzne dla kontrolki przy użyciu polecenia SetExtendedStyle. Na przykład użyj polecenia CreateEx , aby ustawić takie style jak WS_EX_CONTEXTHELP, ale użyj polecenia SetExtendedStyle , aby ustawić takie style jak TBSTYLE_EX_DRAWDDARROWS. Aby uzyskać więcej informacji, zobacz style opisane w sekcji Style rozszerzone paska narzędzi w zestawie Windows SDK.

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl Tworzy obiekt.

CToolBarCtrl();

Uwagi

Musisz wywołać metodę Create , aby pasek narzędzi był użyteczny.

CToolBarCtrl::Customize

Wyświetla okno dialogowe Dostosowywanie paska narzędzi.

void Customize();

Uwagi

To okno dialogowe umożliwia użytkownikowi dostosowywanie paska narzędzi przez dodawanie i usuwanie przycisków. Aby zapewnić obsługę dostosowywania, okno nadrzędne paska narzędzi musi obsługiwać komunikaty powiadomień dostosowywania zgodnie z opisem w temacie Obsługa powiadomień dostosowywania. Pasek narzędzi musi również zostać utworzony przy użyciu stylu, zgodnie z opisem CCS_ADJUSTABLE w temacie CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Usuwa przycisk z kontrolki paska narzędzi.

BOOL DeleteButton(int nIndex);

Parametry

nIndex
Indeks na podstawie zera przycisku do usunięcia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

CToolBarCtrl::EnableButton

Włącza lub wyłącza określony przycisk w kontrolce paska narzędzi.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parametry

nID
Identyfikator polecenia przycisku do włączenia lub wyłączenia.

bEnable
TRUE aby włączyć przycisk; FALSE aby wyłączyć przycisk.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Po włączeniu przycisku można go nacisnąć i zaznaczyć. Jeśli chcesz zmienić więcej niż jeden stan przycisku, rozważ wywołanie SetState zamiast tego.

CToolBarCtrl::GetAnchorHighlight

Pobiera ustawienie wyróżnienia kotwicy dla paska narzędzi.

BOOL GetAnchorHighlight() const;

Wartość zwracana

Jeśli niezerowe, wyróżnianie zakotwiczenia jest włączone. Jeśli zero, wyróżnianie kotwicy jest wyłączone.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETANCHORHIGHLIGHTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetBitmap

Pobiera indeks mapy bitowej skojarzonej z przyciskiem na pasku narzędzi.

int GetBitmap(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku, którego indeks mapy bitowej ma zostać pobrany.

Wartość zwracana

Zwraca indeks mapy bitowej, jeśli się powiedzie, lub zero w przeciwnym razie.

Uwagi

Implementuje funkcjonalność TB_GETBITMAP zestawu Windows SDK.

CToolBarCtrl::GetBitmapFlags

Pobiera flagi mapy bitowej z paska narzędzi.

UINT GetBitmapFlags() const;

Wartość zwracana

Flaga UINT TBBF_LARGE ustawiona, jeśli wyświetlacz może obsługiwać duże mapy bitowe paska narzędzi, wyczyść w przeciwnym razie.

Uwagi

Należy go wywołać po utworzeniu paska narzędzi, ale przed dodaniem map bitowych do paska narzędzi. Wartość zwracana wskazuje, czy wyświetlacz obsługuje duże mapy bitowe, czy nie. Jeśli ekran obsługuje duże mapy bitowe, a jeśli zdecydujesz się ich używać, wywołaj metodę SetBitmapSize i SetButtonSize przed dodaniem dużej mapy bitowej przy użyciu polecenia AddBitmap.

CToolBarCtrl::GetButton

Pobiera informacje o określonym przycisku w kontrolce paska narzędzi.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parametry

nIndex
Zerowy indeks przycisku, dla którego mają być pobierane informacje.

lpButton
TBBUTTON Adres struktury, która ma otrzymać kopię informacji o przycisku. Zobacz CToolBarCtrl::AddButtons , aby uzyskać informacje o TBBUTTON strukturze.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CToolBarCtrl::GetButtonCount

Pobiera liczbę przycisków aktualnie w kontrolce paska narzędzi.

int GetButtonCount() const;

Wartość zwracana

Liczba przycisków.

CToolBarCtrl::GetButtonInfo

Pobiera informacje dotyczące przycisku na pasku narzędzi.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parametry

nID
Identyfikator przycisku.

ptbbi
Wskaźnik do TBBUTTONINFO struktury, która odbiera informacje o przycisku.

Wartość zwracana

Indeks na podstawie zera przycisku, jeśli się powiedzie; w przeciwnym razie -1.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETBUTTONINFOWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetButtonSize

Pobiera rozmiar przycisku paska narzędzi.

DWORD GetButtonSize() const;

Wartość zwracana

Wartość zawierająca DWORD odpowiednio wartości szerokości i wysokości w polach LOWORD i HIWORD.

CToolBarCtrl::GetButtonText

Pobiera tekst wyświetlania określonego przycisku w bieżącej kontrolce paska narzędzi.

CString GetButtonText(int idButton) const;

Parametry

idButton
[in] Identyfikator przycisku, którego tekst wyświetlany jest pobierany.

Wartość zwracana

Element CString zawierający tekst wyświetlany określonego przycisku.

Uwagi

Ta metoda wysyła TB_GETBUTTONTEXT komunikat opisany w zestawie SDK systemu Windows.

CToolBarCtrl::GetColorScheme

Pobiera schemat kolorów bieżącej kontrolki paska narzędzi.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parametry

lpColorScheme
[out] Wskaźnik do COLORSCHEME struktury, która odbiera informacje o schemacie kolorów. Gdy ta metoda zwraca, struktura opisuje kolor wyróżnienia i kolor cienia kontrolki paska narzędzi.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Ta metoda wysyła TB_GETCOLORSCHEME komunikat opisany w zestawie SDK systemu Windows.

CToolBarCtrl::GetDisabledImageList

Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania wyłączonych przycisków.

CImageList* GetDisabledImageList() const;

Wartość zwracana

Wskaźnik do CImageList obiektu lub NULL jeśli nie ustawiono listy wyłączonych obrazów.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETDISABLEDIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK. Implementacja GetDisabledImageList MFC używa CImageList obiektu zawierającego obrazy przycisków kontrolki paska narzędzi, a nie dojścia do listy obrazów.

CToolBarCtrl::GetDropTarget

IDropTarget Pobiera interfejs kontrolki paska narzędzi.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parametry

ppDropTarget
Wskaźnik do wskaźnika interfejsu IDropTarget . Jeśli wystąpi błąd, NULL wskaźnik zostanie umieszczony w tym adresie.

Wartość zwracana

Zwraca wartość wskazującą HRESULT powodzenie lub niepowodzenie operacji.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETOBJECTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetExtendedStyle

Pobiera style rozszerzone dla kontrolki paska narzędzi.

DWORD GetExtendedStyle() const;

Wartość zwracana

Element DWORD reprezentujący style rozszerzone używane obecnie dla kontrolki paska narzędzi. Aby uzyskać listę stylów, zobacz Style rozszerzone paska narzędzi w zestawie Windows SDK.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETEXTENDEDSTYLEWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetHotImageList

Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania przycisków "hot". Gdy wskaźnik myszy znajduje się nad nim, zostanie wyróżniony przycisk gorąca.

CImageList* GetHotImageList() const;

Wartość zwracana

Wskaźnik do CImageList obiektu lub NULL jeśli nie ustawiono listy wyłączonych obrazów.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETHOTIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK. Gdy wskaźnik myszy znajduje się nad nim, zostanie wyróżniony przycisk gorąca.

CToolBarCtrl::GetHotItem

Pobiera indeks gorącego elementu na pasku narzędzi.

int GetHotItem() const;

Wartość zwracana

Indeks oparty na zerach elementu gorącego na pasku narzędzi.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETHOTITEMWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetImageList

Pobiera listę obrazów używaną przez kontrolkę paska narzędzi do wyświetlania przycisków w ich domyślnym stanie.

CImageList* GetImageList() const;

Wartość zwracana

Wskaźnik do obiektu lub NULL jeśli żadna CImageList lista obrazów nie jest ustawiona.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetInsertMark

Pobiera bieżący znacznik wstawiania dla paska narzędzi.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parametry

ptbim
Wskaźnik do TBINSERTMARK struktury, która odbiera znacznik wstawiania.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETINSERTMARKWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetInsertMarkColor

Pobiera kolor używany do rysowania znacznika wstawiania dla paska narzędzi.

COLORREF GetInsertMarkColor() const;

Wartość zwracana

COLORREF Wartość zawierająca bieżący kolor znacznika wstawiania.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETINSERTMARKCOLORWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetItemRect

Pobiera prostokąt ograniczenia przycisku w kontrolce paska narzędzi.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametry

nIndex
Zerowy indeks przycisku, dla którego mają być pobierane informacje.

lpRect
RECT Adres struktury lub CRect obiektu, który odbiera współrzędne prostokąta ograniczenia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja nie pobiera prostokąta ograniczenia dla przycisków, których stan jest ustawiony na TBSTATE_HIDDEN.

CToolBarCtrl::GetMaxSize

Pobiera całkowity rozmiar wszystkich widocznych przycisków i separatorów na pasku narzędzi.

BOOL GetMaxSize(LPSIZE pSize) const;

Parametry

pSize
Wskaźnik do SIZE struktury, która odbiera rozmiar elementów.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETMAXSIZEWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetMaxTextRows

Pobiera maksymalną liczbę wierszy tekstowych wyświetlanych na przycisku paska narzędzi.

int GetMaxTextRows() const;

Wartość zwracana

Maksymalna liczba wierszy tekstowych wyświetlanych na przycisku paska narzędzi.

CToolBarCtrl::GetMetrics

Pobiera metryki CToolBarCtrl obiektu.

void GetMetrics(LPTBMETRICS ptbm) const;

Parametry

ptbm
Wskaźnik do TBMETRICS struktury CToolBarCtrl obiektu.

Uwagi

Ta funkcja składowa emuluje funkcjonalność komunikatu TB_GETMETRICS zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetPadding

Pobiera dopełnienie w poziomie i w pionie bieżącej kontrolki paska narzędzi.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parametry

pnHorzPadding
[out] Liczba całkowita, która otrzymuje dopełnienie poziome kontrolki paska narzędzi w pikselach.

pnVertPadding
[out] Liczba całkowita, która otrzymuje pionową dopełnienie kontrolki paska narzędzi w pikselach.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Ta metoda wysyła TB_GETPADDING komunikat opisany w zestawie SDK systemu Windows.

CToolBarCtrl::GetPressedImageList

Pobiera listę obrazów używa bieżącej kontrolki paska narzędzi do reprezentowania przycisków w stanie naciśniętym.

CImageList* GetPressedImageList();

Wartość zwracana

Wskaźnik do elementu CImageList zawierającego listę obrazów dla bieżącej kontrolki lub NULL jeśli nie ustawiono takiej listy obrazów.

Uwagi

Ta metoda wysyła TB_GETPRESSEDIMAGELIST komunikat opisany w zestawie SDK systemu Windows.

CToolBarCtrl::GetRect

Pobiera prostokąt ograniczenia dla określonego przycisku paska narzędzi.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parametry

nID
Identyfikator przycisku.

lpRect
Wskaźnik do RECT struktury w celu odbierania informacji o powiązanym prostokątze.

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETRECTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetRows

Pobiera liczbę wierszy przycisków wyświetlanych obecnie przez kontrolkę paska narzędzi.

int GetRows() const;

Wartość zwracana

Liczba wierszy przycisków wyświetlanych obecnie na pasku narzędzi.

Uwagi

Należy pamiętać, że liczba wierszy będzie zawsze taka, chyba że pasek narzędzi został utworzony ze stylem TBSTYLE_WRAPABLE .

CToolBarCtrl::GetState

Pobiera informacje o stanie określonego przycisku w kontrolce paska narzędzi, takie jak włączenie, naciśnięcie lub sprawdzenie.

int GetState(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku, dla którego mają być pobierane informacje.

Wartość zwracana

Informacje o stanie przycisku w przypadku powodzenia lub -1 w przeciwnym razie. Informacje o stanie przycisku mogą być kombinacją wartości wymienionych w CToolBarCtrl::AddButtonspliku .

Uwagi

Ta funkcja jest szczególnie przydatna, jeśli chcesz pobrać więcej niż jeden ze stanów przycisku. Aby pobrać tylko jeden stan, użyj jednej z następujących funkcji składowych: IsButtonEnabled, , IsButtonCheckedIsButtonPressed, IsButtonHiddenlub IsButtonIndeterminate. Jednak funkcja składowa GetState jest jedynym sposobem wykrywania TBSTATE_WRAP stanu przycisku.

CToolBarCtrl::GetString

Pobiera ciąg paska narzędzi.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parametry

nString
Indeks ciągu.

lpstrString
Wskaźnik do buforu używanego do zwracania ciągu.

cchMaxLen
Długość buforu w bajtach.

str
Ciąg.

Wartość zwracana

Długość ciągu, jeśli przebiegnie pomyślnie, -1, jeśli nie.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_GETSTRINGWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::GetStyle

Pobiera style aktualnie stosowane do kontrolki paska narzędzi.

DWORD GetStyle() const;

Wartość zwracana

Element DWORD zawierający kombinację stylów kontrolek paska narzędzi zgodnie z opisem w zestawie Windows SDK.

CToolBarCtrl::GetToolTips

Pobiera uchwyt kontrolki porad narzędzia, jeśli istnieje, skojarzony z kontrolką paska narzędzi.

CToolTipCtrl* GetToolTips() const;

Wartość zwracana

Wskaźnik do obiektu skojarzonego CToolTipCtrl z tym paskiem narzędzi lub NULL jeśli pasek narzędzi nie ma skojarzonej kontrolki porad narzędzia.

Uwagi

Ponieważ kontrolka paska narzędzi zwykle tworzy i utrzymuje własną kontrolkę porad narzędzi, większość programów nie musi wywoływać tej funkcji.

CToolBarCtrl::HitTest

Określa, gdzie punkt znajduje się w kontrolce paska narzędzi.

int HitTest(LPPOINT ppt) const;

Parametry

ppt
Wskaźnik do POINT struktury zawierającej współrzędną x testu trafienia w x elemencie i współrzędną y testu trafienia w elemencie y członkowskim. Współrzędne są względne względem obszaru klienta paska narzędzi.

Wartość zwracana

Wartość całkowita wskazująca lokalizację punktu na pasku narzędzi. Jeśli wartość ma wartość zero lub wartość dodatnią, ta wartość zwracana jest indeksem zerowym elementu nieparatora, w którym znajduje się punkt.

Jeśli wartość zwracana jest ujemna, punkt nie leży w obrębie przycisku. Wartość bezwzględna wartości zwracanej jest indeksem elementu separatora lub najbliższego elementu nieparatora.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_HITTESTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::HideButton

Ukrywa lub wyświetla określony przycisk w kontrolce paska narzędzi.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parametry

nID
Identyfikator polecenia przycisku, aby ukryć lub pokazać.

bHide
TRUE aby ukryć przycisk, FALSE aby go pokazać.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Jeśli chcesz zmienić więcej niż jeden stan przycisku, rozważ wywołanie SetState zamiast tego.

CToolBarCtrl::Indeterminate

Ustawia lub czyści nieokreślony stan określonego przycisku w kontrolce paska narzędzi.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parametry

nID
Identyfikator polecenia przycisku, którego stan nieokreślony ma zostać ustawiony lub wyczyszczony.

bIndeterminate
TRUE aby ustawić nieokreślony stan dla określonego przycisku, FALSE aby go wyczyścić.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Nieokreślone przyciski są wyświetlane w kolorze szarym, na przykład sposób, w jaki przycisk pogrubienia na pasku narzędzi edytora wyrazów będzie wyglądał, gdy zaznaczony tekst zawiera zarówno pogrubienie, jak i zwykłe znaki. Jeśli chcesz zmienić więcej niż jeden stan przycisku, rozważ wywołanie SetState zamiast tego.

CToolBarCtrl::InsertButton

Wstawia przycisk w kontrolce paska narzędzi.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parametry

nIndex
Indeks przycisku oparty na wartości zerowej. Ta funkcja wstawia nowy przycisk po lewej stronie tego przycisku.

lpButton
Adres struktury zawierającej TBBUTTON informacje o przycisku do wstawienia. Zobacz CToolBarCtrl::AddButtons opis TBBUTTON struktury.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Obraz i/lub ciąg, którego indeks musi być wcześniej dodany do listy kontrolki paska narzędzi przy użyciu , AddBitmapAddString, i/lub AddStrings.

CToolBarCtrl::InsertMarkHitTest

Pobiera informacje o znaczniku wstawiania dla punktu na pasku narzędzi.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parametry

ppt
Wskaźnik do POINT struktury zawierającej współrzędne testu trafienia względem obszaru klienta paska narzędzi.

ptbim
Wskaźnik do TBINSERTMARK struktury, która odbiera informacje o znaczniku wstawiania.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_INSERTMARKHITTESTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::IsButtonChecked

Określa, czy określony przycisk w kontrolce paska narzędzi jest zaznaczony.

BOOL IsButtonChecked(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku na pasku narzędzi.

Wartość zwracana

Niezerowe, jeśli przycisk jest zaznaczony; w przeciwnym razie zero.

Uwagi

Rozważ wywołanie metody GetState , jeśli chcesz pobrać więcej niż jeden stan przycisku.

CToolBarCtrl::IsButtonEnabled

Określa, czy określony przycisk w kontrolce paska narzędzi jest włączony.

BOOL IsButtonEnabled(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku na pasku narzędzi.

Wartość zwracana

Niezerowe, jeśli przycisk jest włączony; w przeciwnym razie zero.

Uwagi

Rozważ wywołanie metody GetState , jeśli chcesz pobrać więcej niż jeden stan przycisku.

CToolBarCtrl::IsButtonHidden

Określa, czy określony przycisk w kontrolce paska narzędzi jest ukryty.

BOOL IsButtonHidden(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku na pasku narzędzi.

Wartość zwracana

Nonzero, jeśli przycisk jest ukryty; w przeciwnym razie zero.

Uwagi

Rozważ wywołanie metody GetState , jeśli chcesz pobrać więcej niż jeden stan przycisku.

CToolBarCtrl::IsButtonHighlighted

Sprawdza stan wyróżnienia przycisku paska narzędzi.

BOOL IsButtonHighlighted(int nID) const;

Parametry

nID
[in] Identyfikator polecenia dla przycisku paska narzędzi.

Wartość zwracana

Dodatnia liczba całkowita, jeśli przycisk jest wyróżniony, 0, jeśli przycisk nie jest wyróżniony lub -1, jeśli wystąpi błąd.

CToolBarCtrl::IsButtonIndeterminate

Określa, czy określony przycisk w kontrolce paska narzędzi jest nieokreślony.

BOOL IsButtonIndeterminate(int nID) const;

Parametry

nID
[in] Identyfikator polecenia przycisku na pasku narzędzi.

Wartość zwracana

Dodatnia liczba całkowita, jeśli przycisk jest nieokreślony, zero, jeśli przycisk nie jest nieokreślony, lub -1, jeśli wystąpi błąd.

Uwagi

Nieokreślone przyciski są wyświetlane wygaszone, takie jak sposób pogrubienia przycisku na pasku narzędzi edytora wyrazów, gdy zaznaczony tekst zawiera zarówno pogrubione, jak i zwykłe znaki. Rozważ wywołanie metody GetState , jeśli chcesz pobrać więcej niż jeden stan przycisku.

CToolBarCtrl::IsButtonPressed

Określa, czy określony przycisk w kontrolce paska narzędzi jest naciśnięty.

BOOL IsButtonPressed(int nID) const;

Parametry

nID
Identyfikator polecenia przycisku na pasku narzędzi.

Wartość zwracana

Nonzero, jeśli przycisk jest naciśnięty, w przeciwnym razie zero.

Uwagi

Rozważ wywołanie metody GetState , jeśli chcesz pobrać więcej niż jeden stan przycisku.

CToolBarCtrl::LoadImages

Ładuje mapy bitowe do listy obrazów kontrolki paska narzędzi.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parametry

iBitmapID
Identyfikator mapy bitowej zawierającej obrazy do załadowania. Aby określić własny zasób mapy bitowej, ustaw ten parametr na identyfikator zasobu mapy bitowej i ustaw wartość hInst NULL. Zasób mapy bitowej zostanie dodany do listy obrazów jako pojedynczy obraz. Możesz dodać standardowe, zdefiniowane przez system mapy bitowe, ustawiając hinst HINST_COMMCTRL parametr na i ustawiając ten parametr na jeden z następujących identyfikatorów:

Identyfikator mapy bitowej opis
IDB_HIST_LARGE_COLOR Mapy bitowe eksploratora o dużym rozmiarze
IDB_HIST_SMALL_COLOR Mapy bitowe eksploratora o małym rozmiarze
IDB_STD_LARGE_COLOR Standardowe mapy bitowe o dużym rozmiarze
IDB_STD_SMALL_COLOR Standardowe mapy bitowe o małym rozmiarze
IDB_VIEW_LARGE_COLOR Wyświetlanie map bitowych o dużym rozmiarze
IDB_VIEW_SMALL_COLOR Wyświetlanie map bitowych o małym rozmiarze

hinst
Wystąpienie programu obsługuje aplikację wywołującą. Ten parametr może być HINST_COMMCTRL ładowany do standardowej listy obrazów.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_LOADIMAGESWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::MapAccelerator

Mapuje znak akceleratora na przycisk paska narzędzi.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parametry

chAccel
Znak akceleratora do zamapowania. Ten znak jest tym samym znakiem, który jest podkreślony w tekście przycisku.

pIDBtn
Wskaźnik UINT , który odbiera identyfikator polecenia przycisku odpowiadającego akceleratorowi określonemu w elemeratorze chAccel.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_MAPACCELERATORWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::MarkButton

Ustawia stan wyróżnienia danego przycisku w kontrolce paska narzędzi.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parametry

nID
Identyfikator przycisku.

fHighlight
Określa stan wyróżnienia, który ma zostać ustawiony. Domyślnie . TRUE Jeśli ustawiono FALSEwartość , przycisk jest ustawiony na jego stan domyślny.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_MARKBUTTONWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::MoveButton

Przenosi przycisk z jednego indeksu do innego.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parametry

nOldPos
Indeks na podstawie zera przycisku, który ma zostać przeniesiony.

nNewPos
Zerowy indeks miejsca docelowego przycisku.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_MOVEBUTTONWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::PressButton

Naciska lub zwalnia określony przycisk w kontrolce paska narzędzi.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parametry

nID
[in] Identyfikator polecenia przycisku, aby nacisnąć lub zwolnić.

bPress
[in] TRUE aby nacisnąć określony przycisk; FALSE aby zwolnić określony przycisk. Domyślna wartość to TRUE.

Wartość zwracana

TRUE jeśli metoda zakończy się powodzeniem; w przeciwnym razie, FALSE.

Uwagi

Jeśli chcesz zmienić więcej niż jeden stan przycisku, rozważ wywołanie SetState zamiast tego.

Ta metoda wysyła TB_PRESSBUTTON komunikat opisany w zestawie SDK systemu Windows.

CToolBarCtrl::ReplaceBitmap

Zastępuje istniejącą mapę bitową w bieżącej kontrolce paska narzędzi nową mapą bitową.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parametry

pReplaceBitmap
[in] Wskaźnik do struktury, która opisuje mapę bitową TBREPLACEBITMAP do zastąpienia i nową mapę bitową.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Ta metoda wysyła TB_REPLACEBITMAP komunikat opisany w zestawie SDK systemu Windows.

Przykład

Poniższy przykład kodu zastępuje mapę bitową dla standardowego paska narzędzi inną mapą bitową.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Przywraca stan kontrolki paska narzędzi z lokalizacji w rejestrze określonym przez parametry.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametry

hKeyRoot
Identyfikuje obecnie otwarty klucz w rejestrze lub dowolny z następujących wstępnie zdefiniowanych wartości dojścia zarezerwowanego:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
NULLWskazuje ciąg -terminated zawierający nazwę podklucza, z którym jest skojarzona wartość. Ten parametr może być NULL wskaźnikiem do pustego ciągu. Jeśli parametr ma NULLwartość , wartość zostanie dodana do klucza określonego hKeyRoot przez parametr .

lpszValueName
Wskazuje ciąg zawierający nazwę wartości do pobrania. Jeśli wartość o tej nazwie nie jest jeszcze obecna w kluczu, funkcja dodaje ją do klucza.

CToolBarCtrl::SaveState

Zapisuje stan kontrolki paska narzędzi w lokalizacji w rejestrze określonym przez parametry.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametry

hKeyRoot
Identyfikuje obecnie otwarty klucz w rejestrze lub dowolny z następujących wstępnie zdefiniowanych wartości dojścia zarezerwowanego:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
NULLWskazuje ciąg -terminated zawierający nazwę podklucza, z którym jest skojarzona wartość. Ten parametr może być NULL wskaźnikiem do pustego ciągu. Jeśli parametr ma NULLwartość , wartość zostanie dodana do klucza określonego hKeyRoot przez parametr .

lpszValueName
Wskazuje ciąg zawierający nazwę wartości do ustawienia. Jeśli wartość o tej nazwie nie jest jeszcze obecna w kluczu, funkcja dodaje ją do klucza.

CToolBarCtrl::SetAnchorHighlight

Ustawia ustawienie wyróżnienia kotwicy dla paska narzędzi.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parametry

fAnchor
[in] Określa, czy wyróżnianie zakotwiczenia jest włączone lub wyłączone. Jeśli ta wartość jest niezerowa, wyróżnianie kotwicy zostanie włączone. Jeśli ta wartość jest równa zero, wyróżnianie zakotwiczenia zostanie wyłączone

Wartość zwracana

Poprzednie ustawienie zakotwiczenia. Jeśli wyróżnienie zostało włączone, ta wartość jest niezerowa. Jeśli wyróżnianie nie zostało włączone, ta wartość jest równa zero.

Uwagi

Ta metoda implementuje zachowanie komunikatu TB_SETANCHORHIGHLIGHTWin32 zgodnie z opisem w zestawie Windows SDK.

CToolBarCtrl::SetBitmapSize

Ustawia rozmiar rzeczywistych obrazów map bitowych do dodania do kontrolki paska narzędzi.

BOOL SetBitmapSize(CSize size);

Parametry

size
Szerokość i wysokość w pikselach obrazów map bitowych.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja musi być wywoływana tylko przed dodaniem map bitowych do paska narzędzi. Jeśli aplikacja nie ustawi jawnie rozmiaru mapy bitowej, wartość domyślna to 16 o 15 pikseli.

CToolBarCtrl::SetButtonInfo

Ustawia informacje dotyczące istniejącego przycisku na pasku narzędzi.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parametry

nID
Identyfikator przycisku.

ptbbi
Wskaźnik do TBBUTTONINFO struktury, która odbiera informacje o przycisku.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Funkcja składowa implementuje zachowanie komunikatu TB_SETBUTTONINFOWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetButtonSize

Ustawia rozmiar przycisków w kontrolce paska narzędzi.

BOOL SetButtonSize(CSize size);

Parametry

size
Szerokość i wysokość przycisków w pikselach.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Rozmiar przycisku musi być zawsze co najmniej tak duży, jak rozmiar mapy bitowej, który ujęty. Ta funkcja musi być wywoływana tylko przed dodaniem map bitowych do paska narzędzi. Jeśli aplikacja nie ustawi jawnie rozmiaru przycisku, wartość domyślna to 24 do 22 pikseli.

Przykład

Zobacz przykład dla elementu CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Określa rozmiar TBBUTTON struktury.

void SetButtonStructSize(int nSize);

Parametry

nSize
Rozmiar w bajtach TBBUTTON struktury.

Uwagi

Jeśli chcesz przechowywać dodatkowe dane w TBBUTTON strukturze, możesz utworzyć nową strukturę z TBBUTTON, dodać potrzebne elementy członkowskie lub utworzyć nową strukturę zawierającą TBBUTTON strukturę jako pierwszy element członkowski. Następnie wywołasz tę funkcję, aby poinformować pasek narzędzi o rozmiarze nowej struktury.

Zobacz CToolBarCtrl::AddButtons , aby uzyskać więcej informacji na temat TBBUTTON struktury.

CToolBarCtrl::SetButtonWidth

Ustawia minimalną i maksymalną szerokość przycisku w kontrolce paska narzędzi.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parametry

cxMin
Minimalna szerokość przycisku w pikselach. Przyciski paska narzędzi nigdy nie będą węższe niż ta wartość.

cxMax
Maksymalna szerokość przycisku w pikselach. Jeśli tekst przycisku jest zbyt szeroki, kontrolka wyświetla ją z punktami wielokropka.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETBUTTONWIDTHWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetCmdID

Ustawia identyfikator polecenia, który zostanie wysłany do okna właściciela po naciśnięciu określonego przycisku.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parametry

nIndex
Zerowy indeks przycisku, którego identyfikator polecenia ma zostać ustawiony.

nID
Identyfikator polecenia, na który ma być ustawiony wybrany przycisk.

Wartość zwracana

Zwraca wartość nonzero, jeśli operacja powiodła się; w przeciwnym razie zero.

CToolBarCtrl::SetColorScheme

Ustawia schemat kolorów bieżącej kontrolki paska narzędzi.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parametry

lpColorScheme
[in] Wskaźnik do COLORSCHEME struktury, która opisuje kolor wyróżnienia i kolor cienia kontrolki paska narzędzi.

Uwagi

Ta metoda nie ma wpływu na ustawienie motywu wizualizacji systemu Windows Vista.

Ta metoda wysyła TB_SETCOLORSCHEME komunikat opisany w zestawie SDK systemu Windows.

Przykład

Poniższy przykład kodu ustawia schemat kolorów dla bieżącej kontrolki paska narzędzi. Przykładowy kod sprawia, że lewe i górne krawędzie każdego przycisku narzędzia są czerwone, a prawe i dolne krawędzie są niebieskie. Gdy użytkownik naciśnie przycisk, czerwone krawędzie przycisku obracają się na niebiesko, a jego niebieskie krawędzie są czerwone.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Ustawia listę obrazów, która będzie używana przez kontrolkę paska narzędzi do wyświetlania wyłączonych przycisków.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parametry

pImageList
Wskaźnik do obiektu zawierającego CImageList obrazy, które mają być używane przez kontrolkę paska narzędzi do wyświetlania wyłączonych obrazów przycisków.

Wartość zwracana

Wskaźnik do obiektu, który był wcześniej używany przez kontrolkę CImageList paska narzędzi do wyświetlania wyłączonych obrazów przycisków.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETDISABLEDIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK. Implementacja SetDisabledImageList MFC używa CImageList obiektu zawierającego wyłączone obrazy przycisków kontrolki paska narzędzi, a nie dojścia do listy obrazów.

CToolBarCtrl::SetDrawTextFlags

Ustawia flagi w funkcji DrawTextWin32 , która służy do rysowania tekstu w określonym prostokątze, sformatowanego zgodnie z ustawionymi flagami.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parametry

dwMask
Kombinacja co najmniej jednej DT_ flagi określonej w funkcji DrawTextWin32, która wskazuje, które bity będą dwDTFlags używane podczas rysowania tekstu.

dwDTFlags
Kombinacja co najmniej jednej DT_ flagi określonej w funkcji DrawTextWin32, która wskazuje sposób rysowania tekstu przycisku. Ta wartość jest przekazywana do DrawText momentu narysowania tekstu przycisku.

Wartość zwracana

Flagi DWORD rysunku zawierającego poprzedni tekst.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETDRAWTEXTFLAGSWin32 zgodnie z opisem w zestawie WINDOWS SDK. Ta funkcja składowa ustawia flagi w funkcji DrawTextWin32 , która rysuje tekst w określonym prostokątze sformatowane zgodnie z ustawionymi flagami.

CToolBarCtrl::SetExtendedStyle

Ustawia style rozszerzone dla kontrolki paska narzędzi.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parametry

dwExStyle
Wartość określająca nowe style rozszerzone. Ten parametr może być kombinacją stylów rozszerzonych paska narzędzi.

Wartość zwracana

Element DWORD reprezentujący poprzednie style rozszerzone. Aby uzyskać listę stylów, zobacz Style rozszerzone paska narzędzi w zestawie Windows SDK.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETEXTENDEDSTYLEWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetHotImageList

Ustawia listę obrazów, która będzie używana przez kontrolkę paska narzędzi do wyświetlania przycisków "hot".

CImageList* SetHotImageList(CImageList* pImageList);

Parametry

pImageList
Wskaźnik do obiektu zawierającego CImageList obrazy, które mają być używane przez kontrolkę paska narzędzi do wyświetlania obrazów przycisków gorących.

Wartość zwracana

Wskaźnik do obiektu, który był wcześniej używany przez kontrolkę CImageList paska narzędzi do wyświetlania obrazów przycisków gorących.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETHOTIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

Implementacja SetHotImageList MFC używa CImageList obiektu zawierającego gorące obrazy przycisków kontrolki paska narzędzi, a nie dojścia do listy obrazów. Gdy wskaźnik znajduje się nad nim, zostanie wyróżniony gorący przycisk.

CToolBarCtrl::SetHotItem

Ustawia gorący element na pasku narzędzi.

int SetHotItem(int nHot);

Parametry

nHot
Numer indeksu opartego na zerach elementu, który zostanie wykonany na gorąco. Jeśli ta wartość to -1, żadna z elementów nie będzie gorąca.

Wartość zwracana

Indeks poprzedniego gorącego elementu lub -1, jeśli nie było gorącego elementu.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETHOTITEMWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetImageList

Ustawia listę obrazów, która będzie używana przez pasek narzędzi do wyświetlania przycisków znajdujących się w ich domyślnym stanie.

CImageList* SetImageList(CImageList* pImageList);

Parametry

pImageList
Wskaźnik do obiektu zawierającego CImageList obrazy, które mają być używane przez kontrolkę paska narzędzi do wyświetlania obrazów przycisków w ich domyślnym stanie.

Wartość zwracana

Wskaźnik do obiektu, który był wcześniej używany przez kontrolkę CImageList paska narzędzi do wyświetlania obrazów przycisków w ich domyślnym stanie.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETIMAGELISTWin32 zgodnie z opisem w zestawie WINDOWS SDK.

Implementacja SetImageList MFC używa CImageList obiektu zawierającego obrazy przycisków kontrolki paska narzędzi, a nie dojścia do listy obrazów.

CToolBarCtrl::SetIndent

Ustawia wcięcie pierwszego przycisku w kontrolce paska narzędzi.

BOOL SetIndent(int iIndent);

Parametry

iIndent
Wartość określająca wcięcie w pikselach.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CToolBarCtrl::SetInsertMark

Ustawia bieżący znacznik wstawiania dla paska narzędzi.

void SetInsertMark(TBINSERTMARK* ptbim);

Parametry

ptbim
Wskaźnik do TBINSERTMARK struktury zawierającej znacznik wstawiania.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETINSERTMARKWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetInsertMarkColor

Ustawia kolor używany do rysowania znacznika wstawiania dla paska narzędzi.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parametry

clrNew
Wartość zawierająca COLORREF nowy kolor znacznika wstawiania.

Wartość zwracana

Wartość zawierająca COLORREF poprzedni kolor znacznika wstawiania.

Uwagi

Ta funkcja składowa implementuje zachowanie komunikatu TB_SETINSERTMARKCOLORWin32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetMaxTextRows

Ustawia maksymalną liczbę wierszy tekstowych wyświetlanych na przycisku paska narzędzi.

BOOL SetMaxTextRows(int iMaxRows);

Parametry

iMaxRows
Maksymalna liczba wierszy do ustawienia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CToolBarCtrl::SetMetrics

Ustawia metryki CToolBarCtrl obiektu.

void SetMetrics(LPTBMETRICS ptbm);

Parametry

ptbm
Wskaźnik do TBMETRICS struktury CToolBarCtrl obiektu.

Uwagi

Ta funkcja składowa emuluje funkcjonalność komunikatu TB_SETMETRICS zgodnie z opisem w zestawie WINDOWS SDK.

CToolBarCtrl::SetOwner

Ustawia okno właściciela kontrolki paska narzędzi.

void SetOwner(CWnd* pWnd);

Parametry

pWnd
Wskaźnik do obiektu pochodnego CWnd lub CWnd, który będzie nowym oknem właściciela kontrolki paska narzędzi.

Uwagi

Okno właściciela to okno, które odbiera powiadomienia z paska narzędzi.

CToolBarCtrl::SetPadding

Ustawia dopełnienie w poziomie i w pionie bieżącej kontrolki paska narzędzi.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parametry

nHorzPadding
[in] Określa dopełnienie poziome kontrolki paska narzędzi w pikselach.

nVertPadding
[in] Określa pionowe wypełnienie kontrolki paska narzędzi w pikselach.

Wartość zwracana

Wyraz DWORD , którego niski wyraz zawiera poprzednią wartość dopełniania poziomego i którego wysokie słowo zawiera poprzednią wartość dopełnienia pionowego. Wartości wypełnienia są mierzone w pikselach.

Uwagi

Ta metoda wysyła TB_SETPADDING komunikat opisany w zestawie SDK systemu Windows.

Przykład

Poniższy przykład kodu ustawia dopełnienie w poziomie i w pionie bieżącej kontrolki paska narzędzi na 20 pikseli.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Ustawia listę obrazów używaną przez bieżącą kontrolkę paska narzędzi do reprezentowania przycisków w stanie naciśniętym.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parametry

iImageID
[in] Indeks na podstawie zera listy obrazów. Ustaw ten parametr na zero, jeśli używasz tylko jednej listy obrazów.

pImageList
[in] Wskaźnik do elementu CImageList zawierającego nową listę obrazów.

Wartość zwracana

Wskaźnik do elementu CImageList zawierającego poprzednią listę obrazów dla bieżącej kontrolki lub NULL jeśli nie ustawiono takiej listy obrazów.

Uwagi

Ta metoda wysyła TB_SETPRESSEDIMAGELIST komunikat opisany w zestawie SDK systemu Windows.

Przykład

Poniższy przykład kodu ustawia naciśniętą listę obrazów tak samo jak domyślna lista obrazów.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Prosi kontrolkę paska narzędzi o zmianę rozmiaru żądanej liczby wierszy.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parametry

nRows
Żądano liczby wierszy.

bLarger
Informuje, czy należy użyć większej liczby wierszy lub mniejszej liczby wierszy, jeśli nie można zmienić rozmiaru paska narzędzi na żądaną liczbę wierszy.

lpRect
CRect Wskazuje obiekt lub RECT strukturę, która otrzyma nowy prostokąt ograniczenia paska narzędzi.

Uwagi

Jeśli pasek narzędzi nie może zmienić rozmiaru na żądaną liczbę lub wiersze, zmieni rozmiar na następny większy lub następny mniejszy prawidłowy rozmiar, w zależności od wartości bLarger. Jeśli bLarger wartość to TRUE, nowa liczba wierszy będzie większa niż żądana liczba. Jeśli bLarger wartość to FALSE, nowa liczba wierszy będzie mniejsza niż żądana liczba.

Dana liczba wierszy jest prawidłowa dla paska narzędzi, jeśli przyciski można rozmieścić tak, aby wszystkie wiersze miały taką samą liczbę przycisków (chyba że ostatni wiersz). Na przykład pasek narzędzi zawierający cztery przyciski nie może mieć rozmiaru do trzech wierszy, ponieważ dwa ostatnie wiersze musiałyby być krótsze. Jeśli podjęto próbę rozmiaru do trzech wierszy, otrzymasz cztery wiersze, jeśli bLarger wartość to TRUE i dwa wiersze, jeśli bLarger to FALSE.

Jeśli na pasku narzędzi znajdują się separatory, reguły dla których dana liczba wierszy jest prawidłowa, są bardziej skomplikowane. Układ jest obliczany tak, aby grupy przycisków (przyciski z separatorem przed pierwszym i ostatnim przyciskiem w grupie) nigdy nie zostały podzielone na kilka wierszy, chyba że grupa nie może zmieścić się w jednym wierszu.

Jeśli grupa nie pasuje do jednego wiersza, następna grupa rozpocznie się w następnym wierszu, nawet jeśli zmieści się w wierszu, w którym zakończyła się duża grupa. Celem tej reguły jest zwiększenie rozstania między dużymi grupami. Wynikowe separatory pionowe są liczone jako wiersze.

Należy również pamiętać, że SetRows funkcja składowa zawsze wybiera układ, który powoduje najmniejszy rozmiar paska narzędzi. Utworzenie paska narzędzi ze TBSTYLE_WRAPABLE stylem, a następnie zmiana rozmiaru kontrolki spowoduje po prostu zastosowanie metody opisanej powyżej, biorąc pod uwagę szerokość kontrolki.

Tę funkcję można wywołać tylko dla pasków narzędzi utworzonych za pomocą TBSTYLE_WRAPABLE stylu.

CToolBarCtrl::SetState

Ustawia stan określonego przycisku w kontrolce paska narzędzi.

BOOL SetState(
    int nID,
    UINT nState);

Parametry

nID
Identyfikator polecenia przycisku.

nState
Flagi stanu. Może to być kombinacja wartości wymienionych dla stanów przycisków w .CToolBarCtrl::AddButtons

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Ta funkcja jest szczególnie przydatna, jeśli chcesz ustawić więcej niż jeden stan przycisku. Aby ustawić tylko jeden stan, użyj jednej z następujących funkcji składowych: EnableButton, , CheckButtonHideButton, lub PressButtonIndeterminate.

CToolBarCtrl::SetStyle

Ustawia style kontrolki paska narzędzi.

void SetStyle(DWORD dwStyle);

Parametry

dwStyle
Element DWORD zawierający kombinację stylów kontrolek paska narzędzi zgodnie z opisem w zestawie Windows SDK.

CToolBarCtrl::SetToolTips

Kojarzy kontrolkę porad narzędzia z kontrolką paska narzędzi.

void SetToolTips(CToolTipCtrl* pTip);

Parametry

pTip
Wskaźnik do CToolTipCtrl obiektu.

CToolBarCtrl::SetWindowTheme

Ustawia styl CToolBarCtrl wizualny obiektu.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametry

pszSubAppName
Wskaźnik do ciągu Unicode, który zawiera styl wizualizacji paska narzędzi do ustawienia.

Wartość zwracana

Wartość zwracana nie jest używana.

Uwagi

Ta funkcja składowa emuluje funkcjonalność komunikatu TB_SETWINDOWTHEME zgodnie z opisem w zestawie WINDOWS SDK.

Zobacz też

Przykład MFC CMNCTRL1
Przykład MFC MFCIE
CWnd Klasa
Wykres hierarchii
CToolBar Klasa