RibbonEditBox Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Eingabefeld auf einem Menüband dar.

public interface class RibbonEditBox : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("14396b39-63c4-4fc2-92fe-cbccdbe5f306")]
public interface RibbonEditBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("14396b39-63c4-4fc2-92fe-cbccdbe5f306")>]
type RibbonEditBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonEditBox
Implements IComponent, IDisposable, RibbonControl

Attribute: GuidAttribute

Implementiert: RibbonComponent RibbonControl IComponent IDisposable

Hinweise

Das RibbonEditBox Steuerelement zeigt ein beschriftetes Feld an, in dem Benutzer Text eingeben und bearbeiten können.

Visual Studio erstellt ein RibbonEditBox Objekt, wenn Sie ein EditBox-Steuerelement von der Registerkarte Steuerelemente des Office-Menübands der Toolbox auf das Menüband Designer ziehen.

Sie können eine RibbonEditBox zur Laufzeit erstellen, indem Sie die CreateRibbonEditBox -Methode des RibbonFactory -Objekts verwenden.

Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:

Mithilfe der Factory-Eigenschaft der Ribbon-Klasse. Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.
Mithilfe der Globals.Factory.GetRibbonFactory-Methode. Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.

Einige Eigenschaften dieses Steuerelements können nur festgelegt werden, bevor das Menüband in die Office-Anwendung geladen wird. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Übersicht über das Menübandobjektmodell.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Visual Studio Tools for Office Runtime Overview.

Verbrauch

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

Enabled	Ruft einen Wert ab, der angibt, ob das RibbonControl aktiviert ist, oder legt einen Wert fest. (Geerbt von RibbonControl)
Id	Ruft eine Zeichenfolge ab, die Microsoft Office zum Identifizieren dieses RibbonControl-Objekts verwendet. (Geerbt von RibbonControl)
Image	Ruft das auf dem Eingabefeld angezeigte Bild ab, oder legt dieses fest.
ImageName	Ruft den Namen ab, mit dem die Schaltfläche im LoadImage-Ereignishandler identifiziert wird, oder legt ihn fest.
KeyTip	Ruft die Tastenkombination für dieses RibbonEditBox ab oder legt sie fest.
Label	Ruft den Text ab, der in einem Menü auf RibbonEditBox angezeigt wird, oder legt diesen fest.
MaxLength	Ruft einen Wert ab, der die maximale Anzahl der pro Eintrag erlaubten Zeichen in diesem RibbonEditBox angibt, oder legt diesen Wert fest.
Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent)
OfficeImageId	Ruft das Bild ab bzw. legt das Bild fest, das auf der Schaltfläche angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
Parent	Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent)
Ribbon	Ruft das Ribbon-Objekt der obersten Ebene ab, das die Hierarchie der Steuerelemente enthält. (Geerbt von RibbonComponent)
RibbonUI	Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Geerbt von RibbonComponent)
ScreenTip	Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonEditBox richtet, oder legt diesen fest.
ShowImage	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das RibbonEditBox zugeordnete Bild sichtbar ist.
ShowLabel	Ruft einen Wert ab, der angibt, ob die Bezeichnung für dieses RibbonEditBox sichtbar ist, oder legt diesen Wert fest.
SizeString	Ruft eine Zeichenfolge ab, die die Größe des RibbonEditBox bestimmt, oder legt diese fest.
SuperTip	Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonEditBox richtet, oder legt diesen fest.
Tag	Ruft anwendungsspezifische Daten ab, die diesem RibbonComponent zugeordnet sind, oder legt diese fest. (Geerbt von RibbonComponent)
Text	Ruft Text ab, der in RibbonEditBox angezeigt wird, wenn das Bearbeitungsfeld zum ersten Mal angezeigt wird, oder legt diesen Text fest.
Visible	Ruft einen Wert ab, der angibt, ob das RibbonControl sichtbar ist, oder legt den Wert fest. (Geerbt von RibbonControl)

Methoden

PerformDynamicLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements auf, wenn die RibbonComponent-Schnittstelle über ein dynamisches übergeordnetes Element verfügt (z.B. ein dynamisches Menü), und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
PerformLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode auf, wenn RibbonComponent über ein übergeordnetes Element verfügt und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
ResumeLayout()	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
SuspendLayout()	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Geerbt von RibbonComponent)

Ereignisse

TextChanged

Tritt auf, wenn ein Benutzer den Text im RibbonEditBox ändert.

Gilt für: