Classe CSplitterWnd

Articolo
06/10/2015

Fornisce la funzionalità di una finestra con separatore, una finestra che contiene più riquadri.

class CSplitterWnd : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CSplitterWnd::CSplitterWnd	Chiamare per costruire un oggetto CSplitterWnd.

Metodi pubblici

Nome	Descrizione
CSplitterWnd::ActivateNext	Esegue il riquadro successivo o il comando precedente del riquadro.
CSplitterWnd::CanActivateNext	Verifica se il riquadro successivo o il comando precedente del riquadro è attualmente possibile.
CSplitterWnd::Create	Chiamare per creare una finestra del separatore dinamico e per allegarlaoggetto CSplitterWnd.
CSplitterWnd::CreateScrollBarCtrl	Crea un controllo barra di scorrimento condiviso.
CSplitterWnd::CreateStatic	Chiamata per creare una finestra con separatore statico e per allegarlaoggetto CSplitterWnd.
CSplitterWnd::CreateView	Chiamata per creare un riquadro in una finestra con separatore.
CSplitterWnd::DeleteColumn	Elimina una colonna dalla finestra con separatore.
CSplitterWnd::DeleteRow	Elimina una riga dalla finestra con separatore.
CSplitterWnd::DeleteView	Eliminare una visualizzazione dalla finestra con separatore.
CSplitterWnd::DoKeyboardSplit	Esegue il comando spaccati della tastiera, generalmente "divisione della finestra."
CSplitterWnd::DoScroll	Performs è sincronizzato lo scorrimento di windows divise.
CSplitterWnd::DoScrollBy	Scorre separano le finestre da un determinato numero di pixel.
CSplitterWnd::GetActivePane	Determina il riquadro attivo dallo stato attivo o dalla visualizzazione attiva in un frame.
CSplitterWnd::GetColumnCount	Restituisce il numero di colonne corrente del riquadro.
CSplitterWnd::GetColumnInfo	Restituisce le informazioni di colonna specificata.
CSplitterWnd::GetPane	Restituisce il riquadro a righe e colonne specificate.
CSplitterWnd::GetRowCount	Restituisce il numero di righe nel riquadro.
CSplitterWnd::GetRowInfo	Restituisce informazioni sulla riga specificata.
CSplitterWnd::GetScrollStyle	Restituisce lo stile condiviso barra di scorrimento.
CSplitterWnd::IdFromRowCol	Restituisce la finestra figlio ID del riquadro a righe e colonne specificate.
CSplitterWnd::IsChildPane	Chiamare per determinare se la finestra è attualmente un riquadro figlio di questa finestra con separatore.
CSplitterWnd::IsTracking	Determina se la barra di divisione attualmente spostare.
CSplitterWnd::RecalcLayout	Chiamare per visualizzare la finestra con separatore dopo avere modificato le dimensioni della colonna o riga.
CSplitterWnd::SetActivePane	Imposta un riquadro sia quello attivo in un frame.
CSplitterWnd::SetColumnInfo	Chiamare per impostare le informazioni sulle colonne specificate.
CSplitterWnd::SetRowInfo	Chiamata per impostare le informazioni sulla riga.
CSplitterWnd::SetScrollStyle	Specifica il nuovo stile della barra di scorrimento per il supporto della barra di scorrimento della finestra con separatore.
CSplitterWnd::SplitColumn	Indica dove una finestra cornice si suddivide verticalmente.
CSplitterWnd::SplitRow	Indica dove una finestra cornice si suddivide in orizzontale.

Metodi protetti

Nome	Descrizione
CSplitterWnd::OnDraw	Chiamato dal framework per disegnare la finestra con separatore.
CSplitterWnd::OnDrawSplitter	Esegue il rendering di un'immagine di una finestra divisa.
CSplitterWnd::OnInvertTracker	Esegue il rendering dell'immagine di una finestra divisa per essere la stessa dimensione e la forma della finestra cornice.

Note

Un riquadro è in genere un oggetto specifico dell'applicazione derivata da CView, ma può essere qualsiasi oggetto CWnd con l'id appropriata della finestra figlio

Un oggetto CSplitterWnd in genere è incorporato in un oggetto padre CMDIChildWnd o CFrameWnd. Creare un oggetto CSplitterWnd effettuando le operazioni seguenti:

Importare una variabile membro CSplitterWnd nel frame padre.
Eseguire l'override della funzione membro padre CFrameWnd::OnCreateClient frame.
Da OnCreateClientignorata, chiamare la funzione membro CreateStatic o CreaCSplitterWnd.

Chiamare la funzione membro Crea per creare una finestra del separatore dinamico. Una finestra del separatore dinamico in genere utilizzata per creare e scorrere una serie di diversi riquadri, o visualizzazioni, lo stesso documento. Il framework crea automaticamente un riquadro iniziale per il separatore, il framework crea, viene ridimensionato ed elimina i riquadri aggiuntivi mentre l'utente opera i controlli finestra con separatore.

Quando si chiama Crea, specificare l'altezza della riga e la larghezza di una colonna minima che determina quando i riquadri sono troppo piccoli completamente essere visualizzato. Dopo avere chiamato Crea, è possibile modificare questi valori minimi chiamando le funzioni membro SetRowInfo e SetColumnInfo.

Anche utilizzare le funzioni membro SetRowInfo e SetColumnInfo per impostare una larghezza "servizi" per una colonna e l'altezza "servizi" per una riga. Quando il framework visualizzata una finestra con separatore, innanzitutto visualizzare il frame padre, la finestra con separatore. Il framework presenta quindi i riquadri di colonne e righe in base alle dimensioni ottimali, eseguito dall'alto a sinistraangolo inferiore destro dell'area client della finestra con separatore.

Tutti i riquadri in una finestra del separatore dinamico devono essere la stessa classe. Le applicazioni comuni che supportano le finestre separator dinamico includono Microsoft Word e Microsoft Excel.

Utilizzare la funzione membro CreateStatic per creare una finestra con separatore statico. L'utente può modificare solo la dimensione dei riquadri in una finestra con separatore statico, non il numero o ordine.

È necessario specificamente creare riquadri statici del separatore quando si crea il separatore statico. Accertarsi di creare tutti i riquadri prima del termine padre della funzione membro OnCreateClient frame, o il framework non viene visualizzata la finestra correttamente.

La funzione membro CreateStatic automaticamente inizializza un separatore statico con altezza della riga e la larghezza di una colonna minima di 0. Dopo avere chiamato Crea, regolare i minimi chiamando le funzioni membro SetRowInfo e SetColumnInfo. Anche utilizzare SetColumnInfo e SetRowInfo dopo avere chiamato CreateStatic per indicare le dimensioni ottimali si desidera riquadro.

I singoli riquadri di un separatore statico appartengono spesso le classi diverse. Per esempi di finestre con separatore statico, vedere l'editor di immagini e il File Manager di Windows.

Una finestra con separatore supporta le barre di scorrimento speciali (oltre alle barre di scorrimento che i riquadri possono avere). Le barre di scorrimento sono elementi figlio dell'oggetto CSplitterWnd e condivise con i riquadri.

Creare le barre di scorrimento speciali quando si crea una finestra con separatore. Ad esempio, CSplitterWnd con una riga, due colonne e lo stile WS_VSCROLL visualizzare una barra di scorrimento verticale condivisa da due riquadri. Quando l'utente sposta la barra di scorrimento, i messaggi WM_VSCROLL vengono inviati a entrambi i riquadri. Quando i riquadri di impostare la posizione della barra di scorrimento, la barra di scorrimento condivisa è impostata su.

Per ulteriori informazioni sulle finestre con separatore, vedere: