Struttura FINDREPLACEA (commdlg.h)

Contiene informazioni usate dalle funzioni FindText e ReplaceText per inizializzare le finestre di dialogo Trova e Sostituisci . Il messaggio registrato FINDMSGSTRING usa questa struttura per passare l'input di ricerca o sostituzione dell'utente alla finestra proprietario di una finestra di dialogo Trova o Sostituisci .

Sintassi

typedef struct tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

Members

lStructSize

Tipo: DWORD

Lunghezza, in byte, della struttura.

hwndOwner

Tipo: HWND

Handle nella finestra che possiede la finestra di dialogo. La procedura della finestra specificata riceve messaggi FINDMSGSTRING dalla finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido, ma non deve essere NULL.

hInstance

Tipo: HINSTANCE

Se il flag FR_ENABLETEMPLATEHANDLE è impostato nei Flag, hInstance è un handle per un oggetto memoria contenente un modello di finestra di dialogo. Se il flag FR_ENABLETEMPLATE è impostato, hInstance è un handle su un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName . Se nessun flag è impostato, questo membro viene ignorato.

Flags

Tipo: DWORD

Set di flag di bit che è possibile usare per inizializzare la finestra di dialogo. La finestra di dialogo imposta questi flag quando invia il messaggio registrato FINDMSGSTRING per indicare l'input dell'utente. Questo membro può essere uno o più dei valori seguenti.

lpstrFindWhat

Tipo: LPTSTR

Stringa di ricerca digitata dall'utente nel controllo Trova cosa modificare. È necessario allocare dinamicamente il buffer o usare una matrice globale o statica in modo che non esce dall'ambito prima della chiusura della finestra di dialogo. Il buffer deve essere di almeno 80 caratteri. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel controllo Trova cosa modificare. Se un messaggio FINDMSGSTRING specifica il flag FR_FINDNEXT , lpstrFindWhat contiene la stringa da cercare. I flag FR_DOWN, FR_WHOLEWORD e FR_MATCHCASE indicano la direzione e il tipo di ricerca. Se un messaggio FINDMSGSTRING specifica i flag FR_REPLACE o FR_REPLACE , lpstrFindWhat contiene la stringa da sostituire.

lpstrReplaceWith

Tipo: LPTSTR

Stringa di sostituzione digitata dall'utente nel controllo Sostituisci con modifica. È necessario allocare dinamicamente il buffer o usare una matrice globale o statica in modo che non eseghi l'ambito prima della chiusura della finestra di dialogo. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel controllo Sostituisci con modifica.

Se un messaggio FINDMSGSTRING specifica i flag FR_REPLACE o FR_REPLACEALL , lpstrReplaceWith contiene la stringa di sostituzione .

La funzione FindText ignora questo membro.

wFindWhatLen

Tipo: WORD

Lunghezza, in byte, del buffer a cui punta il membro lpstrFindWhat .

wReplaceWithLen

Tipo: WORD

Lunghezza, in byte, del buffer a cui punta il membro lpstrReplaceWith .

lCustData

Tipo: LPARAM

Dati definiti dall'applicazione che il sistema passa alla routine hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio WM_INITDIALOG alla routine hook, il parametro lParam del messaggio è un puntatore alla struttura FINDREPLACE specificata al momento della creazione del dialogo. La procedura hook può usare questo puntatore per ottenere il valore lCustData .

lpfnHook

Tipo: LPFRHOOKPROC

Puntatore a una routine hook FRHookProc in grado di elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag FR_ENABLEHOOK non sia impostato nel membro Flags . Se la routine hook restituisce FALSE in risposta al messaggio di WM_INITDIALOG , la procedura hook deve visualizzare la finestra di dialogo. In caso contrario, la finestra di dialogo non verrà visualizzata. A tale scopo, eseguire prima qualsiasi altra operazione di disegno e quindi chiamare le funzioni ShowWindow e UpdateWindow .

lpTemplateName

Tipo: LPCTSTR

Nome della risorsa modello della finestra di dialogo nel modulo identificato dal membro hInstance . Questo modello viene sostituito con il modello della finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, può trattarsi di un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag FR_ENABLETEMPLATE non sia impostato nel membro Flags .

Commenti

Requisiti

Vedi anche

Libreria delle finestre di dialogo comuni

Informazioni concettuali

FRHookProc

Findtext

MAKEINTRESOURCE

Riferimento

ReplaceText

Showwindow

WM_INITDIALOG