FindText

Sistem tanımlı bir engelleyici olmayan FindText işlev oluşturur bir dize arayın ve bir belgede metin için arama yaparken kullanılacak seçenekleri belirlemek sağlar, Bul iletişim kutusu.

hwnd FindText) LPFINDREPLACE  lpfr / / yapısına ile başlatma / / veri);
 

Parametreleri

lpfr
İletişim kutusu başlatmak için kullanılan bilgileri içeren bir FINDREPLACE yapısı için işaretçi. İletişim kutusu kullanıcının giriş uygulamanız hakkında bilgi göndermek için bu yapıyı kullanır. Daha fazla bilgi için aşağıdaki açıklamalar bölümüne bakın.

Dönüş değerleri

İşlev başarılı olursa, dönüş iletişim kutusuna pencere tanıtıcısı değerdir. Sen-ebilmek kullanma pencere tanıtıcısı ile iletişim kurmak veya iletişim kutusunu kapatmak için.

İşlev başarısız olursa, dönüş değeri null olur. Uzatılmış hata bilgilerini almak için CommDlgExtendedError işlevini çağırın. CommDlgExtendedError aşağıdaki hata kodlarından birini döndürebilir:

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

Açıklamalar

FindText işlevi bir arama işlemini gerçekleştirmez. Bunun yerine, iletişim kutusu, iletişim kutusunun sahibi penceresinin pencere yordamı kayıtlı FINDMSGSTRING iletileri gönderir. İletişim kutusu oluşturduğunuzda, sahibi penceresini FINDREPLACE yapısı hwndOwner üyesi tanımlar.

FindTextçağırmadan önce FINDMSGSTRING ileti tanımlayıcısı almak için RegisterWindowMessage işlevini çağırmalısınız. İletişim kutusu yordamı, kullanıcı FindNext düğmesini tıklattığında ya da iletişim kutusunu kapatmadan iletileri göndermek için bu tanımlayıcıyı kullanır. FINDMSGSTRING iletisinin lParam parametresinin FINDREPLACE yapısı için işaretçi içerir. Bu yapının bayrakları üye mesajı neden olan olayı gösterir. Kullanıcının giriş yapısı diğer üyeleri gösterir .

Bul iletişim kutusu oluşturursanız, istemcileri iletişim kutusunun doğru sekme ve esc tuşları gibi klavye girişi işler sağlamak da uygulamanızın ana mesajı döngü IsDialogMessage işlevini kullanmanız gerekir. IsDialogMessage Bul iletişim kutusundaki ileti işleme olup olmadığını gösteren bir değeri döndürür.

FRHookProc kanca işlemi için Bul iletişim kutusu sağlayabilir. Kanca işlemi iletişim kutusuna gönderilen iletileri işleyebilir. Bir kanca işlemi etkinleştirmek için fr_enablehook bayrak bayrak FINDREPLACE yapısı içinde kümesinin ve lpfnHook üye kancası yordamı adresini belirtin.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Desteklenmeyen.
Header:Commdlg.h ilan etti.
İçe Library:Comdlg32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusundaki işlevler, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index