Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questa sezione contiene informazioni di riferimento sugli elementi di programmazione che si applicano a più controlli, non solo a un controllo specifico. Sono disponibili funzioni, macro, messaggi, notifiche e strutture supportate dalla maggior parte dei controlli. Ad esempio, la maggior parte dei controlli usa le notifiche NM_HOVER per elaborare i clic del mouse.
Panoramiche
| Argomento | Contenuto |
|---|---|
| Informazioni sui controlli comuni | I controlli comuni sono un set di finestre implementate dalla libreria di controlli comune, ovvero una DLL inclusa nel sistema operativo Windows. |
| Domande frequenti su controlli comuni | Queste domande frequenti forniscono risposte ad alcune domande comuni sui controlli comuni. |
Functions
| Argomento | Contenuto |
|---|---|
| DoReaderMode | Abilita la modalità lettore in una finestra. |
| DPA_Clone | Duplica una matrice DPA (Dynamic Pointer Array). |
| DPA_Create | Crea un DPA. |
| DPA_CreateEx | Crea un DPA usando una determinata dimensione e una posizione dell'heap specificati. |
| DPA_DeleteAllPtrs | Rimuove tutti gli elementi da un DPA e riduce di conseguenza il DPA. |
| DPA_DeletePtr | Rimuove un elemento da un DPA. Il DPA si riduce se necessario per contenere l'elemento rimosso. |
| DPA_Destroy | Libera una matrice DPA (Dynamic Pointer Array). |
| DPA_DestroyCallback | Chiama pfnCB su ogni elemento del DPA, quindi libera il DPA. |
| DPA_EnumCallback | Scorre l'array DPA (Dynamic Pointer Array) e chiama pfnCB per ogni elemento. |
| DPA_GetPtr | Ottiene un elemento da un DPA. |
| DPA_GetPtrIndex | Ottiene l'indice di un elemento corrispondente trovato in un DPA. |
| DPA_GetSize | Ottiene le dimensioni di un DPA. |
| DPA_Grow | Modifica il numero di puntatori in un DPA. |
| DPA_InsertPtr | Inserisce un nuovo elemento in una posizione specificata in un DPA. Se necessario, il DPA si espande per contenere il nuovo elemento. |
| DPA_LoadStream | Carica il DPA da un flusso chiamando la funzione di callback specificata per leggere ogni elemento. |
| DPA_Merge | Combina il contenuto di due DPA. |
| DPA_SaveStream | Salva il DPA in un flusso scrivendo un'intestazione e quindi chiamando la funzione di callback specificata per scrivere ogni elemento. |
| DPA_Search | Trova un elemento in un DPA. |
| DPA_SetPtr | Assegna un valore a un elemento in un DPA. |
| DPA_Sort | Ordina gli elementi in una matrice DPA (Dynamic Pointer Array). |
| DrawShadowText | Disegna testo con ombreggiatura. |
| DrawTextExPrivWrap | Disegna testo formattato nel rettangolo specificato. Questa funzione esegue il wrapping di una chiamata a DrawTextEx. |
| DrawTextWrap | Disegna testo formattato nel rettangolo specificato. Formatta il testo in base al metodo specificato (espandendo le schede, giustificando i caratteri, le righe di interruzione e così via). Questa funzione esegue il wrapping di una chiamata a DrawText. |
| DSA_Clone | Duplica una matrice di struttura dinamica (DSA). |
| DSA_Create | Crea un oggetto DSA. |
| DSA_DeleteAllItems | Elimina tutti gli elementi da un DSA. |
| DSA_DeleteItem | Elimina un elemento da un DSA. |
| DSA_Destroy | Libera un DSA. |
| DSA_DestroyCallback | Scorre un DSA, chiamando una funzione di callback specificata in ogni elemento. Al raggiungimento della fine della matrice, il DSA viene liberato. |
| DSA_EnumCallback | Scorre il DSA e chiama pfnCB per ogni elemento. |
| DSA_GetItem | Ottiene un elemento da un DSA. |
| DSA_GetItemPtr | Ottiene un puntatore a un elemento da un DSA. |
| DSA_GetSize | Ottiene le dimensioni del DSA. |
| DSA_InsertItem | Inserisce un nuovo elemento in un DSA. Se necessario, il DSA si espande per contenere il nuovo elemento. |
| DSA_SetItem | Imposta il contenuto di un elemento in un DSA. |
| DSA_Sort | Ordina gli elementi in un DSA. |
| ExtTextOutWrap | Disegna testo utilizzando il tipo di carattere, il colore di sfondo e il colore del testo attualmente selezionati. Facoltativamente, è possibile specificare le dimensioni da utilizzare per ritagliare, opacità o entrambi. Questa funzione esegue il wrapping di una chiamata a ExtTextOut. |
| GetEffectiveClientRect | Calcola le dimensioni di un rettangolo nell'area client che contiene tutti i controlli specificati. |
| GetMUILanguage | Ottiene la lingua attualmente in uso dai controlli comuni per un determinato processo. |
| GetTextExtentPoint32Wrap | Calcola la larghezza e l'altezza della stringa di testo specificata. Questa funzione esegue il wrapping di una chiamata a GetTextExtentPoint. |
| InitCommonControls | Registra e inizializza determinate classi comuni della finestra di controllo. Questa funzione è obsoleta. Le nuove applicazioni devono usare la funzione InitCommonControlsEx . |
| InitCommonControlsEx | Registra classi di controllo comuni specifiche dalla DLL del controllo comune. |
| InitMUILanguage | Consente a un'applicazione di specificare una lingua da usare con i controlli comuni diversi dal linguaggio di sistema. |
| LoadIconMetric | Carica una risorsa icona specificata con una metrica di sistema specificata dal client. |
| LoadIconWithScaleDown | Carica un'icona. Se l'icona non è una dimensione standard, questa funzione riduce le dimensioni di un'immagine più grande anziché aumentare le dimensioni di un'immagine più piccola. |
| MirrorIcon | Inverte le icone (mirror) in modo che vengano visualizzate correttamente in un contesto di dispositivo con mirroring. |
| PFNDACOMPARE | Definisce il prototipo per la funzione di confronto usata da DSA_Sort. |
| PFNDACOMPARECONST | Definisce il prototipo per la funzione di confronto utilizzata da DSA_Sort quando gli elementi confrontati sono oggetti costanti. |
| PFNDAENUMCALLBACK | Definisce il prototipo per la funzione di callback usata dalle funzioni DSA e DPA. |
| PFNDAENUMCALLBACKCONST | Definisce il prototipo per la funzione di callback usata dalle funzioni DSA e DPA quando gli elementi coinvolti sono puntatori a dati costanti. |
| PFNDPACOMPARE | Definisce il prototipo per la funzione di confronto usata da DPA_Sort e DPA_Search. |
| PFNDPACOMPARECONST | Definisce il prototipo per la funzione di confronto utilizzata da DPA_Sort o DPA_Search quando gli elementi confrontati sono oggetti costanti. |
| PFNDPAENUMCALLBACK | Definisce il prototipo per la funzione di callback usata da DPA_EnumCallback. |
| PFNDPAMERGE | Definisce il prototipo per la funzione di merge utilizzata da DPA_Merge. |
| PFNDPAMERGECONST | Definisce il prototipo per la funzione di merge utilizzata da DPA_Merge, utilizzando valori costanti. |
| PFNDPASTREAM | Definisce il prototipo per la funzione di callback usata da DPA_LoadStream e DPA_SaveStream. |
| PFNDSAENUMCALLBACK | Definisce il prototipo per la funzione di callback utilizzata da DSA_DestroyCallback. |
| ReaderScroll | Funzione di callback definita dall'applicazione usata quando il puntatore del mouse viene spostato all'interno della parte della finestra in modalità lettore dichiarata come area di scorrimento attiva. |
| ShowHideMenuCtl | Imposta o rimuove l'attributo del segno di spunta della voce di menu specificata e mostra o nasconde il controllo corrispondente. La funzione aggiunge un segno di spunta alla voce di menu specificata se non ne ha una e quindi visualizza il controllo corrispondente. Se la voce di menu ha già un segno di spunta, la funzione rimuove il segno di spunta e nasconde il controllo corrispondente. |
| Str_GetPtr | Copia una stringa da un buffer a un altro. |
| Str_SetPtrW | Imposta ppszCurrent su una copia di pszNew e libera il valore precedente, se necessario. |
| TranslateDispatch | Usato dal client della funzione DoReaderMode per intercettare e gestire in modo esplicito eventuali messaggi di Windows destinati all'area di scorrimento della finestra in modalità lettore. Si tratta di una funzione di callback definita dall'applicazione. |
Macros
| Argomento | Contenuto |
|---|---|
| DPA_AppendPtr | Inserisce un nuovo elemento alla fine di un DPA. |
| DPA_FastDeleteLastPtr | Elimina l'ultimo puntatore da un DPA. |
| DPA_FastGetPtr | Ottiene il valore del puntatore specificato in DPA. |
| DPA_GetPtrCount | Ottiene il numero di puntatori in un DPA. |
| DPA_GetPtrPtr | Ottiene il puntatore alla matrice di puntatore interna di un DPA. |
| DPA_SetPtrCount | Imposta il numero di puntatori in un DPA. |
| DPA_SortedInsertPtr | Inserisce un nuovo elemento prima o dopo un elemento esistente specificato. |
| DSA_AppendItem | Aggiunge un nuovo elemento alla fine di un DSA. |
| DSA_GetItemCount | Ottiene il numero di elementi in un DSA. |
| FORWARD_WM_NOTIFY | Invia o pubblica il messaggio di WM_NOTIFY . |
| HANDLE_WM_NOTIFY | Chiama una funzione che elabora il messaggio WM_NOTIFY . |
| INDEXTOSTATEIMAGEMASK | Prepara l'indice di un'immagine di stato in modo che un controllo visualizzazione albero o un controllo visualizzazione elenco possa utilizzare l'indice per recuperare l'immagine di stato per un elemento. |
Messages
| Argomento | Contenuto |
|---|---|
| CCM_DPISCALE | Abilita la scalabilità automatica di punti per pollice (dpi) in controlliTree-View, controlliList-View, controlli ComboBoxEx, controlli Intestazione, Pulsanti, Controlli barra degli strumenti, Controlli animazione ed Elenchi di immagini. |
| CCM_GETUNICODEFORMAT | Ottiene il flag di formato carattere Unicode per il controllo . |
| CCM_GETVERSION | Ottiene il numero di versione per un controllo impostato dal messaggio di CCM_SETVERSION più recente. |
| CCM_SETUNICODEFORMAT | Imposta il flag di formato carattere Unicode per il controllo . Questo messaggio consente di modificare il set di caratteri utilizzato dal controllo in fase di esecuzione invece di dover ricreare il controllo. |
| CCM_SETVERSION | Questo messaggio viene usato per informare il controllo che si prevede un comportamento associato a una versione specifica. |
| CCM_SETWINDOWTHEME | Imposta lo stile di visualizzazione di un controllo . |
| WM_NOTIFY | Inviato da un controllo comune alla finestra padre quando si è verificato un evento o il controllo richiede alcune informazioni. |
| WM_NOTIFYFORMAT | Determina se una finestra accetta strutture ANSI o Unicode nel messaggio di notifica WM_NOTIFY .
WM_NOTIFYFORMAT i messaggi vengono inviati da un controllo comune alla relativa finestra padre e dalla finestra padre al controllo comune. |
Notifications
| Argomento | Contenuto |
|---|---|
| NM_CHAR | Il codice di notifica NM_CHAR viene inviato da un controllo quando viene elaborato un tasto di carattere. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_CUSTOMDRAW | Notifica alla finestra padre di un controllo informazioni sulle operazioni di disegno personalizzate. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_CUSTOMTEXT | Notifica alla finestra padre di un controllo informazioni sulle operazioni di testo personalizzate. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_FONTCHANGED | Inviato da un controllo visualizzazione elenco quando il controllo ha modificato un tipo di carattere. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_GETCUSTOMSPLITRECT | Inviato da un controllo pulsante al relativo elemento padre per ottenere le misurazioni per i due rettangoli che costituiscono il pulsante di divisione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_HOVER | Inviato da un controllo quando il mouse passa il mouse su un elemento. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_KEYDOWN | Inviato da un controllo quando il controllo ha lo stato attivo della tastiera e l'utente preme un tasto. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_KILLFOCUS | Notifica alla finestra padre di un controllo che il controllo ha perso lo stato attivo di input. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_LDOWN | Notifica alla finestra padre di un controllo che il pulsante sinistro del mouse è stato premuto. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_NCHITTEST | Inviato da un controllo rebar quando il controllo riceve un messaggio di WM_NCHITTEST . Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_OUTOFMEMORY | Notifica alla finestra padre di un controllo che il controllo non è riuscito a completare un'operazione perché non è disponibile memoria sufficiente. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_RDOWN | Attualmente non supportata. |
| NM_RELEASEDCAPTURE | Notifica alla finestra padre di un controllo che il controllo sta rilasciando l'acquisizione del mouse. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_RETURN | Notifica alla finestra padre di un controllo che il controllo ha lo stato attivo per l'input e che l'utente ha premuto INVIO. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_SETCURSOR | Notifica alla finestra padre di un controllo che il controllo imposta il cursore in risposta a un messaggio di NM_SETCURSOR . Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_SETFOCUS | Notifica alla finestra padre di un controllo che il controllo ha ricevuto lo stato attivo per l'input. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_THEMECHANGED | Notifica alla finestra padre di un controllo che il tema è stato modificato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_TOOLTIPSCREATED | Notifica alla finestra padre di un controllo che il controllo ha creato un controllo descrizione comando. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
| NM_TVSTATEIMAGECHANGING | Inviato da un controllo visualizzazione albero alla relativa finestra padre che sta cambiando l'immagine di stato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY . |
Strutture
| Argomento | Contenuto |
|---|---|
| COLORSCHEME | Contiene informazioni per il disegno dei pulsanti in una barra degli strumenti o in una barra di ripristino. |
| DPASTREAMINFO | Contiene un elemento di flusso utilizzato dalla funzione di callback PFNDPASTREAM . |
| INITCOMMONCONTROLSEX | Contiene informazioni usate per caricare classi di controllo comuni dalla libreria a collegamento dinamico (DLL). Questa struttura viene utilizzata con la funzione InitCommonControlsEx . |
| NMCHAR | Contiene informazioni utilizzate con i messaggi di notifica dei caratteri. |
| NMCUSTOMSPLITRECTINFO | Contiene informazioni sui due rettangoli di un pulsante di divisione. Inviato con la notifica di NM_GETCUSTOMSPLITRECT . |
| NMCUSTOMTEXT | Contiene informazioni utilizzate con una notifica di testo personalizzata. |
| NMHDR | Contiene informazioni su un messaggio di notifica. |
| NMKEY | Contiene informazioni utilizzate con i messaggi di notifica della chiave. |
| NMMOUSE | Contiene informazioni utilizzate con i messaggi di notifica del mouse. |
| NMOBJECTNOTIFY | Contiene informazioni utilizzate con i codici di notifica TBN_GETOBJECT, TCN_GETOBJECT e PSN_GETOBJECT . |
| NMTOOLTIPSCREATED | Contiene informazioni usate con NM_TOOLTIPSCREATED codice di notifica. |
| READERMODEINFO | Contiene informazioni necessarie per inizializzare la funzione DoReaderMode . |
Constants
| Argomento | Contenuto |
|---|---|
| Costanti CDRF | Queste costanti vengono usate come valori restituiti da un controllo in risposta a un codice di notifica NM_CUSTOMDRAW . |
| Stili | Questa sezione elenca gli stili di controllo comuni. Tranne dove indicato, questi stili si applicano ai controlli intestazione, ai controlli della barra degli strumenti e alle finestre di stato. |
| Classi di finestre | In questa sezione sono elencati i nomi delle classi della finestra forniti dalla libreria di controlli comuni. |