Informazioni di riferimento generali sul controllo

  • Articolo

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.

Funzioni

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 utilizzata 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.

Macro

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 di 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.

Messaggi

Argomento Contenuto
CCM_DPISCALE Abilita il ridimensionamento automatico di punti per pollice (dpi) nei controlli Visualizzazione albero, controlli Visualizzazione elenco, 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 CCM_edizione Standard TVERSION più recente.
CCM_edizione Standard TUNICODEFORMAT 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_edizione Standard TVERSION Questo messaggio viene usato per informare il controllo che si prevede un comportamento associato a una versione specifica.
CCM_edizione Standard TWINDOWTHEME 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 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 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_RELEAedizione Standard DCAPTURE 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_edizione Standard TCURSOR Notifica alla finestra padre di un controllo che il controllo imposta il cursore in risposta a un messaggio NM_edizione Standard TCURSOR. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_edizione Standard TFOCUS 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.
INITCOMMONCONTROL edizione Standard X 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.
NMMOU edizione Standard 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 utilizzate con NM_TOOLTIPSCREATED codice di notifica.
READERMODEINFO Contiene informazioni necessarie per inizializzare la funzione DoReaderMode.

Costanti

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.