Classe ContentControl (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rappresenta un controllo contenuto relativo a un documento.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Sintassi

<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As ContentControl

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

Note

Un oggetto ContentControl costituisce un controllo mutevole che può rappresentare uno qualsiasi degli otto tipi di controlli utilizzabili in Microsoft Office Word. Se ad esempio si crea un oggetto ContentControl con funzionalità iniziale di controllo testo normale, sarà possibile modificarlo in fase di esecuzione in modo che si comporti come una casella combinata. In Visual Studio Tools per Office non è possibile utilizzare in questo modo altre classi di controlli contenuto. Un oggetto RichTextContentControl, ad esempio, può rappresentare unicamente un controllo RTF. Per ulteriori informazioni sui controlli contenuto, vedere Controlli contenuto.

Per creare ContentControl, utilizzare uno dei metodi AddContentControl. Non è possibile aggiungere ContentControl a un documento in fase di progettazione

Nella creazione di ContentControl è necessario specificare il tipo di controllo contenuto che si desidera creare. In alternativa è possibile basare il nuovo controllo su un controllo contenuto esistente. Una volta creato un oggetto ContentControl è possibile modificare il tipo di controllo contenuto da esso rappresentato utilizzando la proprietà Type.

Se utilizzati quando il controllo è impostato su un tipo di controllo che non può utilizzare il membro, alcuni membri ContentControl generano un'eccezione. Il tentativo di utilizzare la proprietà DateCalendarType su un oggetto ContentControl che non rappresenta una selezione data genera un'eccezione.