Interfaccia BuildingBlockGalleryContentControl
Rappresenta una raccolta di blocchi predefiniti del documento che possono essere inseriti in un documento.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Sintassi
'Dichiarazione
<GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")> _
Public Interface BuildingBlockGalleryContentControl _
Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable, _
ISupportInitialize
[GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : ContentControlBase,
IBindableComponent, IComponent, IDisposable, ISupportInitialize
Il tipo BuildingBlockGalleryContentControl espone i seguenti membri.
Proprietà
Nome | Descrizione | |
---|---|---|
Application | Ottiene un oggetto Microsoft.Office.Interop.Word.Application che rappresenta l'istanza corrente di Microsoft Office Word. | |
BindingContext | Ottiene o imposta la raccolta di l per IBindableComponent. (Ereditato da IBindableComponent) | |
BuildingBlockCategory | Ottiene o imposta la categoria di blocchi predefiniti visualizzati in BuildingBlockGalleryContentControl. | |
BuildingBlockType | Ottiene o imposta il tipo di blocchi predefiniti visualizzati in BuildingBlockGalleryContentControl. | |
Container | Infrastruttura. (Ereditato da ContentControlBase) | |
ContainerComponent | Infrastruttura. (Ereditato da ContentControlBase) | |
Creator | Ottiene un Integer a 32 bit che indica l'applicazione in cui è stato creato l'oggetto BuildingBlockGalleryContentControl. | |
DataBindings | Ottiene la raccolta di associazione dati oggetti per questo IBindableComponent. (Ereditato da IBindableComponent) | |
DefaultDataSourceUpdateMode | Ottiene o imposta l'oggetto DataSourceUpdateMode predefinito per ContentControlBase. (Ereditato da ContentControlBase) | |
DefaultTextStyle | Ottiene il nome dello stile carattere da utilizzare per la formattazione del testo in BuildingBlockGalleryContentControl. | |
ID | Ottiene un numero univoco che identifica il controllo contenuto. (Ereditato da ContentControlBase) | |
InnerObject | Ottiene l'oggetto Microsoft.Office.Interop.Word.ContentControl sottostante per l'oggetto Microsoft.Office.Tools.Word.ContentControlBase. (Ereditato da ContentControlBase) | |
LockContentControl | Ottiene o imposta un valore che specifica la possibilità o meno di eliminare BuildingBlockGalleryContentControl dal documento. | |
LockContents | Ottiene o imposta un valore che specifica la possibilità o meno di modificare il contenuto di BuildingBlockGalleryContentControl. | |
Parent | Ottiene l'elemento padre di BuildingBlockGalleryContentControl. | |
ParentContentControl | Ottiene il controllo contenuto padre di un oggetto BuildingBlockGalleryContentControl annidato all'interno di un altro controllo contenuto. | |
PlaceholderText | Ottiene o imposta il testo visualizzato in BuildingBlockGalleryContentControl fino a quando il testo non viene modificato mediante un'azione dell'utente o altre operazioni. | |
Range | Ottiene un oggetto Range che rappresenta il contenuto di BuildingBlockGalleryContentControl. | |
ShowingPlaceholderText | Ottiene un valore che specifica se il testo segnaposto è attualmente visualizzato o meno da BuildingBlockGalleryContentControl. | |
Site | ottiene o imposta ISite associato IComponent. (Ereditato da IComponent) | |
Tag | Ottiene o imposta una stringa da associare a BuildingBlockGalleryContentControl. | |
Temporary | Ottiene o imposta un valore che specifica se l'oggetto BuildingBlockGalleryContentControl viene o meno eliminato automaticamente dal documento in caso di modifica del controllo. | |
Text | Ottiene o imposta il testo nell'oggetto BuildingBlockGalleryContentControl. | |
Title | Ottiene o imposta il titolo della classe BuildingBlockGalleryContentControl. |
In alto
Metodi
Nome | Descrizione | |
---|---|---|
BeginInit | Segnala l'oggetto che l'inizializzazione è iniziale. (Ereditato da ISupportInitialize) | |
Copy | Effettua una copia di BuildingBlockGalleryContentControl dal documento e la aggiunge agli Appunti. | |
Cut | Rimuove l'oggetto BuildingBlockGalleryContentControl dal documento e lo aggiunge agli Appunti. | |
Delete | Elimina dal documento un controllo contenuto creato in modo dinamico e lo rimuove da ControlCollection nel documento. (Ereditato da ContentControlBase) | |
Dispose | Esegue le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le risorse non gestite. (Ereditato da IDisposable) | |
EndInit | segnala l'oggetto che l'inizializzazione è completa. (Ereditato da ISupportInitialize) | |
SetPlaceholderText | Visualizza il testo contenuto in Microsoft.Office.Interop.Word.BuildingBlock, in Range o in una stringa come testo segnaposto nell'oggetto BuildingBlockGalleryContentControl. |
In alto
Eventi
Nome | Descrizione | |
---|---|---|
Added | Si verifica dopo l'aggiunta di un controllo contenuto al documento. (Ereditato da ContentControlBase) | |
BindingContextChanged | Si verifica quando il valore della proprietà BindingContext di ContentControlBase cambia. (Ereditato da ContentControlBase) | |
ContentUpdating | Si verifica poco prima che Microsoft Office Word aggiorni automaticamente il testo di un controllo contenuto associato a una web part XML personalizzata. (Ereditato da ContentControlBase) | |
Deleting | Si verifica poco prima dell'eliminazione del controllo contenuto dal documento. (Ereditato da ContentControlBase) | |
Disposed | rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent) | |
Entering | Si verifica quando l'utente fa clic nel controllo contenuto oppure quando il cursore viene spostato nel controllo contenuto a livello di codice. (Ereditato da ContentControlBase) | |
Exiting | Si verifica quando l'utente fa clic all'esterno del controllo contenuto oppure quando il cursore viene spostato all'esterno del controllo contenuto a livello di codice. (Ereditato da ContentControlBase) | |
StoreUpdating | Si verifica poco prima che Microsoft Office Word aggiorni i dati in una web part XML personalizzata associata al controllo contenuto, vale a dire dopo la modifica del testo nel controllo contenuto. (Ereditato da ContentControlBase) | |
Validated | Si verifica in caso di esito positivo della convalida del controllo contenuto. (Ereditato da ContentControlBase) | |
Validating | Si verifica in caso di convalida del contenuto del controllo contenuto. (Ereditato da ContentControlBase) |
In alto
Note
BuildingBlockGalleryContentControl visualizza un elenco di blocchi predefiniti del documento che possono essere inseriti in un documento.Un blocco predefinito del documento è un elemento di contenuto creato per essere utilizzato più volte, ad esempio un frontespizio comune, una tabella formattata o un'intestazione.Per scegliere i blocchi predefiniti da visualizzare, utilizzare le proprietà BuildingBlockCategory e BuildingBlockType.
Per ulteriori informazioni sui blocchi predefiniti del documento, vedere Novità per gli sviluppatori in Word 2007.
[!NOTA]
Questa interfaccia è implementata dal Runtime di Visual Studio Tools per Office. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.
Controlli del contenuto
BuildingBlockGalleryContentControl è uno degli otto tipi di controlli contenuto utilizzabili per la progettazione di documenti e modelli in Microsoft Office Word.I controlli contenuto dispongono di un'interfaccia utente (UI) con controllo di input come un form.Tali controlli contenuto possono essere utilizzati per impedire la modifica di sezioni protette del documento o del modello e inoltre possono essere associati a un'origine dati.Per ulteriori informazioni, vedere Controlli del contenuto.
Utilizzo
Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4 e .NET Framework 4.5. Nei progetti destinati a .NET Framework 3.5 questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.
Esempi
Nell'esempio di codice seguente viene aggiunto un nuovo oggetto BuildingBlockGalleryContentControl all'inizio del documento.BuildingBlockGalleryContentControl visualizza i blocchi predefiniti di equazione forniti da Microsoft Office Word.
Questa versione è valida per una personalizzazione a livello di documento.Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto, quindi chiamare il metodo AddBuildingBlockControlAtSelection dal metodo ThisDocument_Startup.
Dim buildingBlockGalleryControl1 As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl
Private Sub AddBuildingBlockGalleryControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
buildingBlockGalleryControl1 = Me.Controls.AddBuildingBlockGalleryContentControl( _
"buildingBlockGalleryControl1")
With buildingBlockGalleryControl1
.PlaceholderText = "Choose an equation"
.BuildingBlockCategory = "Built-In"
.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
End With
End Sub
private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;
private void AddBuildingBlockControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
buildingBlockControl1 = this.Controls.AddBuildingBlockGalleryContentControl(
"buildingBlockControl1");
buildingBlockControl1.PlaceholderText = "Choose an equation";
buildingBlockControl1.BuildingBlockCategory = "Built-In";
buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}
Questa versione è valida per un componente aggiuntivo a livello di applicazione.Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddBuildingBlockControlAtSelection dal metodo ThisAddIn_Startup.
Dim buildingBlockGalleryControl1 As BuildingBlockGalleryContentControl
Private Sub AddBuildingBlockGalleryControlAtSelection()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
vstoDoc.Paragraphs(1).Range.Select()
buildingBlockGalleryControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl( _
"buildingBlockGalleryControl1")
With buildingBlockGalleryControl1
.PlaceholderText = "Choose an equation"
.BuildingBlockCategory = "Built-In"
.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
End With
End Sub
private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;
private void AddBuildingBlockControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
buildingBlockControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl(
"buildingBlockControl1");
buildingBlockControl1.PlaceholderText = "Choose an equation";
buildingBlockControl1.BuildingBlockCategory = "Built-In";
buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}
Vedere anche
Riferimenti
Spazio dei nomi Microsoft.Office.Tools.Word
Altre risorse
Procedura: aggiungere controlli del contenuto ai documenti di Word
Procedura: proteggere parti di documenti mediante i controlli del contenuto
Procedura dettagliata: creazione di un modello utilizzando i controlli del contenuto