FindText

Funkcja FindText tworzy niemodalny zdefiniowanych w systemie znaleźć okno dialogowe, które pozwala określić ciąg znaków do wyszukiwania i opcje, aby używać podczas wyszukiwania tekstu w dokumencie.

(HWND FindText LPFINDREPLACE  lpfr / / wskaźnika do struktury inicjujące / / danych);
 

Parametry

lpfr

Wskaźnik do struktury FINDREPLACE , który zawiera informacje używane do inicjowania okna dialogowego. Okno dialogowe używa tej struktury do wysyłania informacji o danych wprowadzonych przez użytkownika do aplikacji. Aby uzyskać więcej informacji zobacz następującą sekcję Uwagi.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojście do okna dialogowe. Dojście do okna można używać do komunikowania się z lub zamknąć okno dialogowe.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać informacje o błąd rozszerzony, wywołania funkcji CommDlgExtendedError . CommDlgExtendedError mogą zwracać jeden z następujących kodów błędów:

Uwagi

Funkcja FindText nie wykonuje operację wyszukiwania. Zamiast tego okna dialogowego wysyła wiadomości FINDMSGSTRING zarejestrowane procedury okna w oknie właściciela okna dialogowego. Tworząc okno dialogowe, członek hwndOwner struktury FINDREPLACE identyfikuje okna właściciela.

Przed wywołaniem metody FindText, należy wywołać funkcję RegisterWindowMessage , aby uzyskać identyfikator wiadomości FINDMSGSTRING. Procedura pole dialogowe używa tego identyfikatora wysyłać wiadomości, gdy użytkownik kliknie przyciskdalej znaleźćlub zamykania okna dialogowego. Parametr fikcyjnymi wiadomości FINDMSGSTRING zawiera wskaźnik do struktury FINDREPLACE . Flagi członkiem tej struktury wskazuje zdarzenie spowodowane wiadomości. Inni członkowie struktury wskazują dane wejściowe użytkownika .

Tworząc okno dialogowe Znajdowanie , muszą również użyć funkcji IsDialogMessage w pętli głównym przesłaniem aplikacji, do zapewnienia, aby oknie dialogowym poprawnie przetwarza klawiatury, takich jak klawisze tab i esc. IsDialogMessage zwraca wartość, która wskazuje, czy w oknie dialogowym Znajdowanie przetwarzania wiadomości.

Procedura haka FRHookProc może przewidywać okno dialogowe Znajdowanie . Procedura haka może przetwarzać wiadomości wysłane do okna dialogowego. Aby włączyć procedurę haka, ustawić flagę FR_ENABLEHOOK Członkowskich flag struktury FINDREPLACE i określić adres procedura haka członka lpfnHook.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Należy użyć comdlg32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne funkcje pole dialogowe, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index