CEdit::SetCueBanner

Ustawia tekst jest wyświetlany jako sygnalizacji tekstu lub porada, w edycji kontrolować, kiedy formant jest pusty.

BOOL SetCueBanner(
     LPCWSTR lpszText
);
BOOL SetCueBanner(
     LPCWSTR lpszText, 
     BOOL fDrawWhenFocused = FALSE
);

Parametry

  • [w]lpszText
    Wskaźnik, aby ciąg zawierający sygnalizacji do wyświetlania w formancie edycyjnym.

  • [w]fDrawWhenFocused
    Jeśli false, gdy użytkownik kliknie formant edycji i zapewnia kontrolę fokus nie jest rysowana transparent sygnalizacji.

    Jeśli true, transparent sygnalizacji rysowania nawet wtedy, gdy formant ma fokus.Transparent sygnalizacji znika po uruchomieniu wpisz w kontroli.

    Wartością domyślną jest false.

Wartość zwracana

trueJeśli metoda jest pomyślne; w przeciwnym razie false.

Uwagi

Metoda ta wysyła EM_SETCUEBANNER wiadomości, która jest opisana w Windows SDK.Aby uzyskać więcej informacji, zobacz Edit_SetCueBannerTextFocused makro.

Wymagania

Nagłówek: afxwin.h

Ten formant jest obsługiwane w systemie Windows XP i nowszych.

Dodatkowe wymagania dla tej metody opisane w Wymagania formantów standardowych systemu Windows Vista dotyczące kompilacji.

Przykład

Poniższy przykład ilustruje CEdit::SetCueBanner metody.

    m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);

Zobacz też

Informacje

Klasa CEdit

Diagram hierarchii

CEdit::GetCueBanner

EM_SETCUEBANNER

Edit_SetCueBannerTextFocused