ReplaceText

Funkcja ReplaceText tworzy zdefiniowanych w systemie niemodalny okno dialogowe, które pozwala określić ciąg do wyszukania i ciąg zamiany, jak również opcje sterowania Znajdź i Zastąp operacji.

(HWND ReplaceText 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 okna dialogowego lub go zamknąć.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać informacje o błąd rozszerzony, wywołać funkcję CommDlgExtendedError , która może zwracać jeden z następujących kodów błędów:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOADRESFAILURE CDERR_NOHOOK
CDERR_LOADSTRFAILURE CDERR_NOTEMPLATE
CDERR_LOCKRESFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO

Uwagi

Funkcja ReplaceText nie jest sprawdzana zamieniania tekstu. 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 ReplaceText, 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 przycisków Znajdź następny, Zamień lub Zamień wszystko 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 Zamienianie , 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. Funkcja IsDialogMessage zwraca wartość wskazującą, czy okno dialogowe Zamienianie przetwarzania wiadomości.

Okno dialogowe Zamienianie można zapewnić procedura haka FRHookProc . 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, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG