You are on page 1of 55

Introduccin a la vista Backstage de Office 2010 para programadores

de acceso p do pe so a adas e

Al usar este
sitio
acepta el uso de cookies para anlisis, contenido personalizado y publicidad.
Office
2010

Saber ms

Extender la funcionalidad Guardar en


la Web en la vista Backstage de Office
Centro de desarrollo
2010

Iniciar sesin

Introduccin a VBA en Office 2010

Inicio

Cmo usar el validador de formato de


Productos
Documentacin
archivos binarios de Microsoft Office

Descargas

Herramientas

Desarrollo de Office > Escritorio de Office > Microsoft


> Office 2010and
> Artculos
tcnicos > Introduccin a la vista Backstage de Office 2010 para programadores
Office 2010
Interoperability
Implementation
Notes

Introduccin a la vista Backstage de


Office 2010 para programadores
Instrucciones para Office 2010 Mobile
Service (parte 1 de 3)
Instrucciones sobre Office 2010
Mobile Service (parte 2 de 3)
Instrucciones sobre Office 2010
Mobile Service (parte 3 de 3)
Office Open XML, ECMA-376, and
ISO/IEC 29500
Extensibilidad de la cinta de opciones
en Office 2010: activacin de fichas y
ajuste de escala automtico
Soluciones de interfaz de usuario con
las versiones 2007 y 2010 de
Microsoft Office como destino
Understanding Graphics in Office
Binary File Formats
Understanding Office Binary File
Formats
Novedades para programadores de
Office 2010

Introduccin a la vista
Backstage de Office
2010 para
programadores
Office 2010

Resumen: Microsoft Office 2010 presenta la vista Backstage de


Microsoft Office, la novedad ms reciente de la interfaz de usuario
de Office Fluent y una caracterstica complementaria de la cinta de
opciones. Examine los componentes que conforman la vista
Backstage y explore los escenarios que muestran cmo ampliar esta
vista en diferentes aplicaciones de Office.
ltima modificacin: jueves, 21 de julio de 2011
Hace referencia a: Excel 2010| Office 2007| Office 2010| Open
XML| PowerPoint 2010| SharePoint Server 2010| VBA| Word 2010
Frank Rice, Microsoft Corporation
Abril de 2010
Se aplica a: Microsoft Access 2010, Microsoft Excel 2010, Microsoft
InfoPath 2010, Microsoft OneNote 2010, Microsoft PowerPoint 2010,
Microsoft Project 2010, Microsoft Publisher 2010, Microsoft
SharePoint Designer 2010, Microsoft Visio 2010, Microsoft Word 2010
Contenido
Introduccin a la vista Backstage de Microsoft Office 14
Fluent
Glosario de trminos de la vista Backstage
Componentes de la vista Backstage
Extensibilidad de la vista Backstage
Personalizacin de la vista Backstage mediante archivos
con formato Open XML
Personalizacin de la vista Backstage mediante un
complemento COM compartido
Preguntas ms frecuentes
Descripciones, atributos e informacin secundaria de los
controles de la vista Backstage
Conclusin
Recursos adicionales

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Introduccin a la vista Backstage de Microsoft Office 14


Fluent
En la versin 2007 de Microsoft Office system, el acceso a la
funcionalidad de nivel de archivo se obtena a travs del men de
Office que estaba disponible al hacer clic en el botn de Office.
En Microsoft Office 2010, el botn de Office se sustituy por una
pestaa Archivo. Al hacer clic enella, se llega a la vista Backstage
de Microsoft Office. Esta vista le ayuda a descubrir y usar las
caractersticas que no forman parte de las caractersticas de
creacin de la cinta de opciones. La cinta de opciones, la
minibarra de herramientas y las galeras le ayudan a trabajar en
los documentos, mientras que la vista Backstage le ayuda a
trabajar con los documentos.
La vista Backstage es un elemento totalmente extensible para los
programadores, de modo que las organizaciones pueden
personalizar la interfaz de usuario para que se ajuste a sus
propias necesidades. Lo mejor de todo es que la interfaz de
usuario de Backstage se puede personalizar con los mismos
archivos, devoluciones de llamadas y muchos de los controles que
se usan en la cinta de opciones. Esto significa que los
programadores que ya saben cmo personalizar la interfaz de
usuario de la cinta de opciones pueden usar estos mismos
conocimientos para crear una interfaz de usuario de Backstage
acorde con las necesidades de la organizacin.
La interfaz de usuario de Backstage existe en todas las
aplicaciones de Microsoft Office 2010 compatibles con la interfaz
de usuario de Office Fluent: Microsoft Access 2010, Microsoft Excel
2010, Microsoft InfoPath 2010, Microsoft OneNote 2010, Microsoft
PowerPoint 2010, Microsoft Project 2010, Microsoft Publisher 2010,
Microsoft SharePoint Designer 2010, Microsoft Visio 2010 y
Microsoft Word 2010. En las siguientes secciones se describe la
estructura de la nueva interfaz de usuario y se examinan los
detalles necesarios para implementar su propia interfaz de usuario
de Backstage personalizada.
Glosario de trminos de la vista Backstage
A continuacin figuran los trminos comunes que se usan en este
artculo:
Vista Backstage Modelo de interfaz de usuario de pantalla
completa que expone la funcionalidad en el nivel del archivo
del documento activo. Forma parte de la interfaz de usuario
de Microsoft Office Fluent, que reemplaza al sistema anterior
de mens en capas, barras de herramientas y paneles de
tareas.
Comando definitivo Comando que le lleva de la vista
Backstage al documento. Cuando se invocan, los comandos
definitivos cierran la vista Backstage. Algunos ejemplos de
estos comandos son Guardar, Guardar como e Imprimir.
Comando rpido Comando que existe en la barra de
navegacin izquierda y proporciona acceso rpido a las
funciones ms habituales. Algunos ejemplos de estos
comandos son Guardar, Guardar como y Cerrar.
Ficha Pgina de la vista Backstage dedicada a una tarea en
particular. La vista Backstage consta de un conjunto de fichas
de nivel superior. La primera ficha (superior) es la
predeterminada. Si no se especifica ninguna ubicacin, las
fichas personalizadas se agregan a la parte inferior de la
barra de navegacin, debajo de todas las fichas y comandos
rpidos existentes. La vista Backstage permite un mximo de
255fichas.
Grupo Contenedor de la interfaz de usuario que se usa para
organizar las funciones relacionadas dentro de las fichas de
Backstage por grupos.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Componentes de la vista Backstage


En esta seccin, examinar los componentes de la vista Backstage.
Si se observa la figura1, una de las primeras cosas que notar
despus de iniciar una aplicacin de Office 2010 es la nueva
pestaa Archivo, que reemplaza al botn de Office. Al hacer clic
en la pestaa Archivo se muestra la vista Backstage. Tambin
puede abrir esta vista presionando las teclas Alt+A.
Figura 1. La nueva pestaa Archivo

En el lado izquierdo de la vista Backstage se encuentra la barra de


navegacin, que incluye comandos rpidos (como Guardar y
Abrir) y pestaas (como Informacin y Reciente), tal y como se
muestra en la figura2.
Figura 2. La vista Backstage

Los comandos rpidos proporcionan acceso a tareas de uso


frecuente que no estn asociadas explcitamente con las pestaas.
Una ficha agrupa las funciones relacionadas con una tarea comn
y las distribuye en una o dos columnas en un conjunto de grupos
(como Modo de compatibilidad y Permisos).
Extensibilidad de la vista Backstage
Adems de brindar al usuario una mejor experiencia con las
propiedades de documentos, la creacin y las funciones de
resultados, la vista Backstage es un lugar al que los

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

departamentos de TI y los programadores de terceros pueden


conectarse para proporcionar funciones de administracin de
documentos personalizadas. Existen algunos escenarios tpicos de
extensibilidad de la vista Backstage:
Un proveedor de soluciones desea agregar datos de lnea de
negocio a la vista Backstage:
Es posible que el proveedor de soluciones desee
crear una ficha completamente nueva para mostrar
una gran cantidad de informacin relacionada con el
archivo activo.
Es posible que el proveedor de soluciones desee
agregar un grupo a una ficha existente
(especialmente la ficha Informacin) para que la
informacin sea todo lo visible que se pueda.
Es posible que el proveedor de soluciones desee mostrar
nuevas funciones en la vista Backstage:
Es posible que el proveedor de soluciones desee
crear una nueva ficha centrada en estas funciones
personalizadas (por ejemplo, administracin de
correo electrnico no deseado).
Es posible que el proveedor de soluciones desee
agregar funciones personalizadas a una ficha
existente porque esa ficha es un lugar lgico para la
nueva caracterstica, o puede querer usarla como
comando rpido porque la funcin en cuestin se
usar con frecuencia y se puede representar con un
solo botn.
Los programadores familiarizados con la extensibilidad de la
interfaz de usuario de la cinta de opciones deben sentirse
cmodos con la extensibilidad de la vista Backstage, ya que usa
bsicamente los mismos archivos y estructuras. Los componentes
se agregan a la vista Backstage mediante XML y las funciones se
asocian a tales componentes mediante procedimientos de
devolucin de llamada.

Nota
Para obtener ms informacin acerca de la extensibilidad
de la cinta de opciones, vea la serie de artculos en tres
partes titulada Customizing the 2007 Office Fluent
Ribbon for Developers (Part 1 of 3).

Definicin del contenido y la estructura de la vista Backstage


personalizada mediante XML
Al igual que con la interfaz de usuario de la cinta de opciones, la
estructura y los componentes de la vista Backstage se definen
usando el formato XML. En el siguiente ejemplo se muestra el
formato general de un archivo de formato XML que personaliza la
vista en Word 2010. En las siguientes secciones se describe este
formato ms detalladamente. Este formato da como resultado la
vista Backstage personalizada que se muestra en la figura3.
Figura 3. La ficha de Backstage personalizada creada en
este ejemplo

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Nota
El XML para modificar la interfaz de usuario de la cinta de
opciones tambin se incluye para mostrar que coexiste en
el mismo archivo XML que el formato de la vista Backstage.

XML

Copiar

<?xml version="1.0" encoding="utf-8" ?>


<customUI
xmlns="http://schemas.microsoft.com/office/2009/07/custom
onLoad="OnLoad">
<backstage>
<tab id="testArea" insertAfterMso="TabInfo"
label="Sample Scenarios" columnWidthPercent="30" >
<firstColumn>
<group id="grpOne" label="Group One"
helperText="This is helper text for Group One">
<primaryItem>
<button id="firstButton" label="Primary
Button" onAction="SampleCallback" />
</primaryItem>
<topItems>
<layoutContainer id="layoutOne"
layoutChildren="vertical">
<editBox id="firstEBox" label="Sample
Edit Box" text="This is sample text"
alignLabel="topRight" />
<button id="sampleButton" label="Sample
Definitive Button" isDefinitive="true"
imageMso="FileDocumentInspect" />
</layoutContainer>
</topItems>
</group>
<group id="grpTwo" label="Group Two"
visible="true" >
<primaryItem>
<menu id="menuOne" label="DropDown
Menu">
<menuGroup id="menuGrpOne" >
<button id="btnOne" label="Button
one" />
<button id="btnTwo" label="Button
two" />
<checkBox id="chkBoxOne"
label="Sample Check Box" />
</menuGroup>
</menu>
</primaryItem>
<topItems>
<editBox id="secondEBox" text="Disabled
Edit Box" enabled="false"/>
<imageControl id="imgControlOne"
imageMso="BlogHomePage"/>
<groupBox id="grpBox" label="Group Box
with Check Boxes and Radio Group">
<checkBox id="chkBox1" label="A
Check Box" />
<checkBox id="chkBox2"
label="Disabled Check Box" enabled="false" />
<radioGroup id="rdoGrp" label="Nested
Radio Group" >
<radioButton id="firstRadioBtn"

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores


label="1st Radio Button"/>
<radioButton id="secondRadioBtn"
label="2nd Radio Button"/>
</radioGroup>
</groupBox>
</topItems>
</group>
</firstColumn>
<secondColumn>
<group id="grpThree" label="Group Three"
visible="true">
<topItems>
<comboBox id="firstCBox" label="Sample
Combo Box" >
<item id="itema" label="Cat"/>
<item id="itemb" label="Dog"/>
<item id="itemc" label="Fish"/>
</comboBox>
<layoutContainer id="layoutTwo"
layoutChildren="vertical">
<editBox id="thirdEBox" label="Part
of vertical layout" />
<editBox id="fourthEBox" label="Part
of vertical layout" />
<editBox id="fifthEBox" label="Part
of vertical layout" />
</layoutContainer>
<layoutContainer id="layoutThree"
layoutChildren="horizontal">
<button id="anotherButton"
label="Horizontal layout" imageMso="NewAppointment" />
<hyperlink id="hyperLink" label="You
can place a link here"/>
<button id="lastButton"
label="Horizontal layout" />
</layoutContainer>
</topItems>
</group>
</secondColumn>
</tab>
</backstage>

El elemento <backstage> delimita las estructuras personalizadas


de la interfaz de usuario de Backstage. Jerrquicamente, el
elemento <backstage> es uno de los cuatro elementos de nivel
superior permitidos dentro del elemento <customUI>. Los otros
elementos permitidos en el mismo nivel son <ribbon>,
<contextMenus> y <commands>.
Dentro del elemento <backstage>, se pueden hospedar
comandos rpidos (representados con el elemento <button>) y
<tabs>; en este ejemplo, Backstage contiene un solo elemento
<tab>. El elemento <tab> incluye varios atributos, entre los que
se encuentran los siguientes:
id Identificador de la ficha.
insertAfterMso Identificador de la ficha integrada tras la que
se debe insertar la ficha personalizada. En este ejemplo, la
ficha personalizada se agrega despus de la ficha Info.
label Texto que aparece en la ficha; en este ejemplo, la
etiqueta de la ficha es Sample Scenarios.
columnWidthPercent Especifica el ancho de la primera
columna en el rea con fichas como un porcentaje. El ancho
de las dos columnas hacen un total de 100%, de modo que
si la primera columna se establece en 30%, la secunda
columna constituye el 70% del ancho total.
Esta ficha tiene una etiqueta y va despus de la ficha Info
integrada.

Nota
Todos los atributos en el formato de personalizacin XML
de la interfaz de usuario de Microsoft Office Fluent usan la

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

misma convencin Camel, que pone en maysculas el


carcter inicial de todas las palabras excepto el de la
primera; entre los ejemplos se incluyen onAction y
insertBeforeMso.

Cada elemento <tab> puede tener una o dos columnas; en este


caso, la ficha personalizada Sample Scenarios contiene dos
columnas. Adems, cada columna puede hospedar varios
elementos <group>; en este ejemplo, existen dos grupos en la
primera columna (denominados Group One y Group Two) y un
solo grupo (Group Three) en la segunda columna. El elemento
<group> tambin permite varios atributos, como id, label,
visible, enabled y helperText, entre otros.

Nota
Ms adelante en este artculo encontrar una lista de
elementos de control y atributos asociados, elementos
secundarios y otra informacin.

Como concepto, los grupos de Backstage personalizados son


similares a los grupos de la cinta de opciones, con dos diferencias
notorias. Primero, y al contrario que un grupo de la cinta de
opciones, no se necesita un grupo de Backstage para colocar el
contenido exactamente en (hasta) tres filas; en este ejemplo,
existen varios elementos <layoutContainer> que proporcionan la
estructura y funciones de diseo enriquecidas, pero sin la
restriccin de tres filas. Este elemento contiene un atributo
layoutChildren que permite especificar si los objetos secundarios
se orientan horizontal o verticalmente. En segundo lugar, y al
contrario que un grupo de la cinta de opciones de nuevo, un
grupo de Backstage puede incluir un elemento <primaryItem>
opcional, que puede ser <button> o <menu>. El <primaryItem>
constituye el punto central de enfoque de un grupo, que puede
ser un botn (como el botn principal dentro de Group One) o
un men (como el men desplegable dentro de Group Two).
Si se observa el elemento <button> del ejemplo, uno de los
atributos que contiene es isDefinitive. Cuando este atributo se
establece como verdadero, al hacer clic en el botn se activa la
devolucin de llamada correspondiente y, a continuacin, se
cierra la vista Backstage y se vuelve al documento. Viendo el resto
del XML, hay varios componentes definidos con diferentes
atributos. La ficha personalizada que aparece como resultado es
similar a la de la figura3.
Uso de devoluciones de llamada para agregar funciones
Observando nuevamente el ejemplo, al hacer clic en el botn, se
activa la subrutina de devolucin de llamada indicada en el
atributo onAction. En el siguiente ejemplo se muestra una
devolucin de llamada simple que se puede activar con el botn.
VB

Copiar

Sub SampleCallback(ByVal control As IRibbonControl)


MsgBox "You clicked the " & control.Id & " button.
"
End Sub

En esta instancia, cuando se llama al procedimiento, Microsoft


Office pasa un objeto IRibbonControl que representa el control
que llama. Entre las propiedades del objeto IRibbonControl se

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

incluyen Id y Tag. Como se muestra en el cdigo, la propiedad


Id permite llamar al mismo procedimiento desde diferentes
controles. Todos los procedimientos de devolucin de llamada
toman el objeto IRibbonControl y tambin pueden incluir otras
propiedades, como el estado presionado de un botn de
alternancia.
En las siguientes secciones se enumeran los pasos para
personalizar la vista Backstage en el nivel de documento
(modificando un archivo con formato Open XML) y en el nivel de
aplicacin (usando un complemento COM creado en cdigo
administrado en Microsoft Visual Studio). Para obtener el
procedimiento para personalizar la vista Backstage en el nivel de
documento, puede usar el XML descrito en la seccin anterior. El
complemento COM usa un XML diferente para modificar la vista
Backstage.
Personalizacin de la vista Backstage mediante archivos
con formato Open XML
En el nivel de documento, el proceso de personalizacin de la
interfaz de usuario de Microsoft Office Fluent usando el formato
XML implica los pasos descritos a continuacin. Puede seguir
estos pasos usando el formato XML descrito en la seccin
anterior.

Nota
A pesar de que debe conocer lo que est sucediendo
dentro de la estructura de archivos Office Open XML,
puede omitir estos pasos. Puede sacar partido de la
herramienta Office 2007 Custom UI Editor, con la que
puede abrir un documento, insertarle una interfaz de
usuario personalizada (con una parte con Office 2007 u
Office 2010 como destino) y, a continuacin, guardar el
documento junto con el formato XML. Esta herramienta
realiza los pasos que se muestran en este ejemplo
automticamente y, adems, le permite agregar iconos
personalizados a la carpeta customUI y hacer referencia a
stos fcilmente.

Para definir el contenido y la estructura de la vista


Backstage mediante archivos con formato Open XML
1. Cree una carpeta en el escritorio denominada customUI.
2. Cree el archivo de personalizacin en cualquier editor de
texto; para ello, escriba el formato XML con el que se
agreguen nuevos componentes a la interfaz de usuario de
Microsoft Office Fluent, se modifiquen los componentes
existentes o se oculten. Use el formato XML del ejemplo
que se mostr anteriormente en este artculo. Guarde el
archivo como customUI14.xml en la carpeta que ha
creado.
3. Valide el formato XML usando el esquema de interfaz de
usuario de Microsoft Office Fluent personalizado (opcional).
4. Cree un documento en Microsoft Word 2010 y, a
continuacin, gurdelo como archivo habilitado para
macros de Open XML con la extensin .docm. Si desea
agregar cdigo que reaccione cuando el usuario interacte
con la personalizacin de la interfaz de usuario de
Microsoft Office Fluent, deber guardar el documento en
un formato habilitado para macros.
5. Cierre Word.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

6. En el Explorador de Microsoft Windows, agregue la


extensin de nombre de archivo .zip al nombre de archivo
del documento y, a continuacin, haga doble clic en el
archivo para abrirlo como una carpeta comprimida.
7. Agregue el archivo de personalizacin al contenedor
arrastrando la carpeta customUI del escritorio a la carpeta
.zip.
8. Arrastre la carpeta _rels de la carpeta .zip al escritorio. En
el escritorio aparecer una carpeta denominada _rels, que
contiene el archivo .rels.
9. Abra la carpeta nueva y, a continuacin, abra el archivo
.rels en un editor de texto.
10. Entre el elemento <Relationship> final y el elemento
<Relationships> de cierre, agregue el cdigo que crea una
relacin entre el archivo de documento y el archivo de
personalizacin, tal y como se muestra en el siguiente
ejemplo. Asegrese de especificar los nombres de carpeta y
de archivo correctamente (el atributo Id proporciona un
identificador de relacin nico para el archivo customUI; su
valor es arbitrario, siempre que sea nico).
XML

Copiar

<Relationship
Type="http://schemas.microsoft.com/office/2010/rela
Target="/customUI/customUI14.xml"
Id="customUIRelID" />

11. Guarde el archivo .rels y, a continuacin, arrstrelo a la


carpeta _rels del archivo comprimido para reemplazar el
archivo .rels existente.
12. Quite la extensin .zip y, a continuacin, abra el
documento.
Para agregar devoluciones de llamada al libro para
proporcionar funciones de vista Backstage
1. Haga clic en la ficha Programador y, a continuacin, en
Visual Basic.

Nota
Si no puede ver la ficha Programador, debe
especificar esta opcin. Para hacerlo en la aplicacin,
haga clic en el botn de Microsoft Office, en
Opciones, en Personalizar cinta de opciones y, a
continuacin, en el cuadro Personalizar la cinta de
opciones, seleccione la opcin Programador. ste
es un ajuste global que le identifica como
programador en todas las aplicaciones de Office que
implementan la interfaz de usuario de Microsoft
Office Fluent.

2. En el Editor de Visual Basic, haga doble clic en


ThisDocument para abrir la ventana de cdigo.
3. Escriba la funcin de VBA como se muestra en el siguiente
ejemplo.
VB

Copiar

Sub SampleCallback(ByVal control As

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores


IRibbonControl)
MsgBox "You clicked the " & control.Id & "
button. "
End Sub

4. Guarde el documento y, a continuacin, cierre el Editor de


Visual Basic.
5. Haga clic en el botn de Microsoft Office y, a continuacin,
en la pestaa Escenarios de ejemplo.
6. Haga clic en el botn marcado como Primary Button. La
figura4 muestra el cuadro de dilogo.
Figura 4. Este cuadro de dilogo se abre tras hacer
clic en el botn Primary

Personalizacin de la vista Backstage mediante un


complemento COM compartido
Tambin puede usar complementos COM para cambiar la interfaz
de usuario de Microsoft Office Fluent. Si decide crear un
complemento COM que incorpore la personalizacin de la
interfaz de usuario y use cdigo administrado, dispone de dos
opciones. Puede crear un complemento COM estndar mediante
la plantilla Complemento compartido que se incluye con
Microsoft Visual Studio2008, o bien, si tiene Microsoft Visual
Studio2005 Tools para Office Second Edition instalado, puede
crear un complemento COM que presente varias ventajas con
respecto al complemento compartido estndar.
Entre otras ventajas, los complementos creados con Microsoft
Visual Studio 2005 Tools para Office Second Edition se ejecutan
en dominios de aplicacin independientes y el modelo de
programacin de estos complementos es ms simple y ms fcil
de mantener que el que usa la plantilla de complementos
compartidos. Para obtener ms informacin, vea el tema sobre
cmo migrar un complemento compartido a un
complemento de Visual Studio 2005 Tools para Office
System SE.
Sin embargo, en los siguientes pasos crear un complemento
COM de Microsoft Word administrado usando un complemento
compartido estndar. Para obtener ms informacin acerca de
cmo crear una interfaz de usuario de Microsoft Office Fluent
personalizada mediante un complemento COM compartido y
Microsoft Visual Studio 2005 Tools para Office Second Edition,
vea el artculo sobre cmo personalizar la cinta de Office
Fluent 2007 para programadores (parte 1 de 3).
El complemento COM crea la ficha Backstage personalizada,
como se muestra en la figura5.
Figura 5. La ficha Vista Backstage personalizada muestra
varias tcnicas con controles

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Para cambiar la interfaz de usuario de Microsoft Office


Fluent creando un complemento COM compartido
1. Inicie Microsoft Visual Studio 2008.
2. En el men Archivo, seleccione Nuevo y, a continuacin,
haga clic en Proyecto.
3. En el cuadro de dilogo Nuevo proyecto, en el panel
Tipos de proyecto, expanda Otros tipos de proyecto,
haga clic en Extensibilidad y, a continuacin, seleccione
Complemento compartido.
4. En el cuadro Nombre, escriba BackStageCOMAddin y, a
continuacin, haga clic en Aceptar para crear el proyecto.
5. En la primera pgina del Asistente para complementos
compartidos, haga clic en Siguiente.
6. En la pgina Seleccione un lenguaje de programacin,
seleccione Visual C# o Visual Basic y, a continuacin,
haga clic en Siguiente.
7. En la pgina Seleccione una aplicacin host, desactive
todas las selecciones excepto Microsoft Word y, a
continuacin, haga clic en Siguiente.
8. En la pgina Especifique un nombre y una descripcin,
escriba BackStageCOMAddin como nombre y Actualizar
la vista Backstage de Word como descripcin y, a
continuacin, haga clic en Siguiente.
9. En la pgina Elija las opciones del complemento,
seleccione Me gustara que mi complemento se cargue
cuando lo haga la aplicacin host, haga clic en
Siguiente y, a continuacin, en Finalizar.
Visual Studio crear una solucin con dos proyectos: el
complemento en s y un proyecto de instalacin (el proyecto de
instalacin le permite instalar el complemento en los equipos de
otros usuarios y, adems, facilita la instalacin y desinstalacin del
complemento en tiempo de diseo).
Para interactuar con Word 2010 y el modelo de objetos de
Microsoft Office Fluent, debe tener referencias a bibliotecas de
tipos como se indica a continuacin.
Para agregar referencias a bibliotecas de tipos
1. En el Explorador de soluciones, expanda la carpeta
Referencias. Si no puede ver la carpeta Referencias, en el
men Proyecto, haga clic en Mostrar todos los archivos.
2. Elimine la referencia Microsoft.Office.Core.
3. Haga clic con el botn secundario en la carpeta
Referencias y, a continuacin, haga clic en Agregar
referencia.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

4. Haga clic en la pestaa COM, seleccione Biblioteca de


objetos de Microsoft Office 14.0 y, a continuacin, haga
clic en Aceptar.
5. En la parte superior de la pantalla de cdigo, agregue las
instrucciones como se muestra en los siguientes ejemplos.
C#

VB

Copiar

using Office = Microsoft.Office.Core;


using Word = Microsoft.Office.Interop.Word;

Para crear el archivo XML de personalizacin


1. En el men Proyecto, haga clic en Agregar nuevo
elemento.
2. En el cuadro de dilogo Agregar nuevo elemento,
seleccione Archivo XML. Asigne el nombre
customUI14.xml al nuevo archivo y, a continuacin, haga
clic en Agregar.
3. En el nuevo archivo XML, agregue formato XML como se
muestra en el siguiente ejemplo.
XML

Copiar

<customUI
xmlns="http://schemas.microsoft.com/office/2009/07/
onLoad="OnLoad">
<backstage>
<tab id="testArea" label="Sample Scenarios"
columnWidthPercent="30" insertAfterMso="TabInfo"
visible="true" >
<firstColumn>
<group id="grpOne" label="Group One">
<primaryItem>
<button id="btnSimToggleButton"
label="Simulate Toggle Button"
getImage="toggleImage"
onAction="simToggleButton"/>
</primaryItem>
<topItems>
<layoutContainer id="layoutOne"
layoutChildren="vertical">
<editBox id="eboxTextTarget"
label="Text From Button"
getText="getToggledText" alignLabel="topRight" />
<button id="btnInsertText2Doc"
label="Insert Text Into Document"
isDefinitive="true" onAction="insertText2Doc"/>
<editBox id="eboxTextSource"
label="Gets Inserted into Document" text="Hello
World" onChange="getInsertText"/>
</layoutContainer>
</topItems>
</group>
<group id="grpTwo" label="Group Two"
getVisible="getInitGroupVisibility" >
<primaryItem>
<menu id="menuOne" label="Drop Down
Menu">
<menuGroup id="menuGrpOne" >
<button id="btnShowEditBox"
getLabel="getHideShowEBoxLabel"
onAction="showHideEditBox"/>
<button id="menuButtonTwo"
label="Swap Images" onAction="SwapImages"/>
<checkBox
id="chkEnableDisableEBox"
getLabel="switchChkBoxLabel"
onAction="chkEnable"/>
</menuGroup>
</menu>
</primaryItem>
<topItems>
<editBox id="eboxEnabledDisabled"
text="Hello World"
getEnabled="getEBoxEnabledState"/>
<editBox id="eboxShownHidden"
text="See me now?"
getVisible="getEBoxVisibility"/>
<imageControl id="imgControlOne"
getImage="getControlImage"/>
<groupBox id="grpBox" label="Group

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores


Box">
<checkBox id="chkBox1"
getLabel="getChkBox1Label"
onAction="grpChkBox1Action"/>
<checkBox id="chkBox2"
getLabel="getChkBox2Label"
onAction="grpChkBox2Action"/>
<radioGroup id="rdoGrp"
label="Nested Radio Group"
getEnabled="getrdoEnableByChkBox"
onAction="radioGrpAction">
<radioButton id="firstRadioBtn"
label="1st Radio Button"/>
<radioButton
id="secondRadioBtn" label="2nd Radio Button"/>
</radioGroup>
</groupBox>
<editBox id="eboxVisiblebyChkBox"
text="See me"
getVisible="getEBoxVisibleByChkBox"/>
</topItems>
</group>
</firstColumn>
<secondColumn>
<group id="grpThree" label="Group Three"
visible="true">
<topItems>
<layoutContainer id="layoutTwo"
layoutChildren="vertical">
<comboBox id="cboPopulateBox"
label="Populate Edit Box"
onChange="populateEBox">
<item id="item1" label="one"/>
<item id="item2" label="two"/>
<item id="item3"
label="three"/>
</comboBox>
<editBox id="eboxPopulate"
getLabel="getEBoxLabel" getText="getCBOXText"/>
</layoutContainer>
<layoutContainer id="layoutThree"
layoutChildren="vertical">
<button id="btnHideGroup"
getLabel="getHideGroupBtnLabel"
onAction="hideGroup"/>
</layoutContainer>
</topItems>
</group>
</secondColumn>
</tab>
</backstage>
</customUI>

4. Guarde y cierre el archivo.


La forma ms sencilla de usar el archivo XML es considerarlo
como un recurso dentro del archivo de recursos del proyecto.
Para agregar el archivo XML como recurso del proyecto
1. En Explorador de soluciones, seleccione customUI14.xml.
2. En la ventana Propiedades, seleccione la propiedad Accin
de compilacin y, a continuacin, seleccione Recurso
incrustado en la lista de opciones.
3. En el men Proyecto, haga clic en Propiedades de
BackStageCOMAddin.
4. Haga clic en la pestaa Recursos.
5. En el Explorador de soluciones, arrastre customUI14.xml a
la superficie de diseo Recursos.
Mediante esta accin se crea un nuevo recurso basado en
el archivo con el contenido XML. A partir de ahora, el
archivo customUI.xml se almacena automticamente como
un recurso de la aplicacin y este contenido se puede
recuperar mediante caractersticas de lenguaje de Visual
Basic o Visual C#.
6. Cierre la ventana Recursos. Cuando se le solicite, haga clic
en S para guardar el cuadro dilogo de recursos.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Para obtener acceso al host de aplicacin y trabajar con la


vista Backstage
1. En el Explorador de soluciones, haga clic con el botn
secundario en Connect.cs o en Connect.vb y, a
continuacin, haga clic en Ver cdigo.
2. Busque la declaracin existente para la variable
applicationObject y cmbiela para que haga referencia a
un objeto Word.Application; es decir, cambie la
declaracin para que tenga el aspecto de los siguientes
ejemplos.
C#

VB

Copiar

private Word.Application applicationObject;

3. Cambie la lnea existente en el mtodo OnConnection,


que crea una instancia del objeto Word.Application.
C#

VB

Copiar

applicationObject =(Word.Application)application;

4. (Slo en Visual Basic) Cambie la lnea de cdigo cercana


a la parte superior de la clase que comienza por
Implements, para agregar compatibilidad para
implementar el nombre de espacios IRibbonExtensibility
como se muestra en el siguiente ejemplo y, a continuacin,
presione Entrar. Visual Basic inserta el procedimiento
GetCustomUI automticamente.
VB

Copiar

Implements Extensibility.IDTExtensibility2,
IRibbonExtensibility

5. (Slo C#) Al final de la instruccin public class Connect :,


agregue una coma y, a continuacin, escriba el nombre de
interfaz, como se muestra en el siguiente ejemplo.
C#

Copiar

IRibbonExtensibility

6. (Slo C#) Haga clic con el botn secundario en la interfaz


que ha agregado, haga clic en Implementar interfaz y, a
continuacin, en Implementar interfaz explcitamente.
De este modo, se agrega un procedimiento de cdigo
auxiliar para el nico miembro de la interfaz
IRibbonExtensibility: GetCustomUI.
7. Cambie el mtodo GetCustomUI de modo que tenga el
aspecto del siguiente ejemplo.
C#

VB

Copiar

string IRibbonExtensibility.GetCustomUI(string
RibbonID)
{
return SpecStatusResource.customUI14;
}

Importante
GetCustomUI se implementa para que devuelva la
cadena XML para la personalizacin de la interfaz de
usuario y no debe usarse para la inicializacin. En
particular, no debe intentar mostrar cuadros de

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

dilogo o ventanas de mensaje en la


implementacin de GetCustomUI. El lugar ms
adecuado para realizar la inicializacin es en el
mtodo OnConnection (para complementos
compartidos) o en el mtodo ThisAddIn_Startup
(para complementos creados mediante Microsoft
Visual Studio 2005 Tools para Office Second
Edition).

8. Agregue el siguiente mtodo a la clase. Se llama a este


mtodo cuando se carga la interfaz de usuario de la cinta
de opciones y crea una variable que hace referencia a esta
interfaz y, a continuacin, vuelve a dibujar la cinta de
opciones.
C#

VB

Copiar

IRibbonUI myRibbon;
public void OnLoad(IRibbonUI ribbon)
{
myRibbon = ribbon;
myRibbon.Invalidate();
}

Preguntas ms frecuentes
A continuacin se recogen las preguntas ms frecuentes
relacionadas con la vista Backstage.
Cul es el nmero mximo de fichas personalizadas que puedo
agregar a la vista Backstage?
El lmite mximo de nmero de fichas es de 255.
Puedo especificar dnde deseo agregar una ficha?
Puede especificar si una ficha personalizada se muestra
antes o despus de una ficha existente.
Puedo cambiar el orden de las fichas existentes?
No puede cambiar el orden de las fichas existentes. Slo
puede especificar el orden relativo de las fichas insertando
una ficha antes o despus de otra.
Puedo modificar el diseo de columna de las fichas existentes?
No puede cambiar los diseos de columna de ninguna
ficha existente que no haya sido creada por usted.
Dnde puedo agregar grupos?
Puede agregar un nuevo grupo a cualquier columna de
una ficha existente. Tambin puede especificar si el grupo
nuevo se muestra antes o despus de un grupo existente.
Una restriccin a este respecto es que no puede agregar
ms grupos a las fichas que contienen un control
taskFormGroup, como la ficha Compartir.
Puedo cambiar el orden de los grupos existentes?
No puede cambiar el orden de los grupos existentes.
nicamente puede especificar rdenes relativos para los
grupos nuevos que cree.
Cuando agrego varios complementos COM que modifican la vista
Backstage de una aplicacin de Microsoft Office, cmo s el
orden en el que se implementan?
El orden de prioridad entre las modificaciones en conflicto
es que tiene precedencia la ltima que se carg.
Descripciones, atributos e informacin secundaria de los
controles de la vista Backstage

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

La siguiente referencia XML contiene detalles acerca de los


controles que se incluyen como parte de la vista Backstage.
Backstage
Representa el elemento <backstage>

Atributo

Tipo

Firma de devolucin de llamada

onShow

Callback

VBA: Sub OnShow(contextObject As


Object)
C#: void OnShow(object contextObject)
Visual Basic: Sub OnShow(contextObject
As Object)
C++: HRESULT OnShow([in] Object
*pContextObject)

onHide

Callback

VBA: Sub OnHide(contextObject As


Object)
C#: void OnHide(object contextObject)
Visual Basic: Sub OnHide(contextObject
As Object)
C++: HRESULT OnHide([in] Object
*pContextObject)

Elementos secundarios: tab, button

Botn
Representa un control button.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

*expand

String

No es aplicable

*layout

String

No es aplicable

tag

String

No es aplicable

*insertAfterMso

Nombre
integrado
(String)

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

*insertBeforeMso

Nombre
integrado
(String)

No es aplicable

*insertAfterQ

Nombre
completo
(String)

No es aplicable

*insertBeforeQ

Nombre
completo
(String)

No es aplicable

*description

String

No es aplicable

*getDescription

Callback

VBA: Sub
GetDescription(control As
IRibbonControl, ByRef
returnedVal)
C#: string
GetDescription(IRibbonControl
control)
Visual Basic: Function
GetDescription(control As
IRibbonControl) As String
C++: HRESULT
GetDescription([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control


As IRibbonControl, ByRef
returnedVal)
C#: bool
GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

C++: HRESULT GetLabel([in]


IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)
visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetKeytip(IRibbonControl
control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

*screentip

String

No es aplicable

*getScreentip

Callback

VBA: Sub GetScreentip(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetScreentip(IRibbonControl
control)
Visual Basic: Function
GetScreentip(control As
IRibbonControl) As String
C++: HRESULT
GetScreentip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

*supertip

String

No es aplicable

*getSupertip

Callback

VBA: Sub GetSupertip(control


As IRibbonControl, ByRef
returnedVal)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

C#: string
GetSupertip(IRibbonControl
control)
Visual Basic: Function
GetSupertip(control As
IRibbonControl) As String
C++: HRESULT GetSupertip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)
onAction

Callback

VBA: Sub OnAction(control As


IRibbonControl)
C#: void
OnAction(IRibbonControl
control)
Visual Basic: Sub
OnAction(control As
IRibbonControl)
C++: HRESULT OnAction([in]
IRibbonControl *pControl)

isDefinitive

Boolean

No es aplicable

image

String

No es aplicable

imageMso

Nombre
integrado
(String)

No es aplicable

getImage

Callback

VBA: Sub GetImage(control As


IRibbonControl, ByRef
returnedBitmap)
C#: Bitmap
GetImage(IRibbonControl
control)
Visual Basic: Function
GetImage(control As
IRibbonControl) As Bitmap
C++: HRESULT GetImage([in]
IRibbonControl *pControl, [out,
retval] IPictureDisp **
ppdispImage)

* No se usa en todas las implementaciones


Elementos secundarios: ninguno

Categora
Representa un contenedor de categoras.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function GetLabel(control
As IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out, retval]
BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As IRibbonControl)
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out, retval]
BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: task

Casilla de verificacin
Representa un control checkBox.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

(String)
tag

String

No es aplicable

*expand

String

No es aplicable

*layout

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonControl control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

keytip

Token

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetKeytip(IRibbonControl control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

onAction

Callback

VBA: Sub OnAction(control As


IRibbonControl, isPressed As
Boolean)
C#: void OnAction(IRibbonControl
control, bool isPressed)
Visual Basic: Sub
OnAction(control As
IRibbonControl, isPressed As
Boolean)
C++: HRESULT OnAction([in]
IRibbonControl *pControl, [in]
BSTR VARIANT_BOOL
*pvarPressed)

getPressed

Callback

VBA: Sub GetPressed(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetPressed(IRibbonControl
control)
Visual Basic: Function
GetPressed(control As
IRibbonControl) As Boolean
C++: HRESULT GetPressed([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

description

String

No es aplicable

getDescription

Callback

VBA: Sub GetDescription(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetDescription(IRibbonControl
control)
Visual Basic: Function
GetDescription(control As
IRibbonControl) As String
C++: HRESULT GetDescription([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

*screentip

String

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

*getScreentip

Callback

VBA: Sub GetScreentip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetScreentip(IRibbonControl
control)
Visual Basic: Function
GetScreentip(control As
IRibbonControl) As String
C++: HRESULT GetScreentip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

*supertip

String

No es aplicable

*getSupertip

Callback

VBA: Sub GetSupertip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetSupertip(IRibbonControl
control)
Visual Basic: Function
GetSupertip(control As
IRibbonControl) As String
C++: HRESULT GetSupertip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

* No se usa en todas las implementaciones


Elementos secundarios: ninguno

Cuadro combinado
Representa un control comboBox.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

alignLabel

String

No es aplicable

expand

String

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

layout

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef returnedVal)
C#: bool
GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

getItemCount

Callback

VBA: Sub GetItemCount(control As


IRibbonControl, ByRef returnedVal)
C#: int
GetItemCount(IRibbonControl
control)
Visual Basic: Function
GetItemCount(control As
IRibbonControl) as Integer
C++: HRESULT GetItemCount([in]
IRibbonControl *pControl, [out,
retval] LONG *returnedVal)

getItemID

Callback

VBA: Sub GetItemID(control As


IRibbonControl, itemIndex as
Integer, ByRef returnedVal)
C#: string
GetItemID(IRibbonControl control,
int itemIndex)
Visual Basic: Function
GetItemID(control As
IRibbonControl, itemIndex as
Integer) as String
C++: HRESULT GetItemID([in]
IRibbonControl *pControl, [in]
LONG cIndex, [out, retval] BSTR
*pbstrReturnedVal)

getItemLabel

Callback

VBA: Sub GetItemLabel(control As


IRibbonControl, itemIndex as
Integer, ByRef returnedVal)
C#: string
GetItemLabel(IRibbonControl
control, int itemIndex)
Visual Basic: Function
GetItemLabel(control As
IRibbonControl, itemIndex as
Integer) as String
C++: HRESULT GetItemLabel([in]

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

IRibbonControl *pControl, [in]


LONG cIndex, [out, retval] BSTR
*pbstrReturnedVal)
label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

onChange

Callback

VBA: Sub OnChange(control As


IRibbonControl, text As String)
C#: void
OnChange(IRibbonControl control,
string text)
Visual Basic: Sub
OnChange(control As
IRibbonControl, text As String)
C++: HRESULT OnChange([in]
IRibbonControl *pControl, [in]
BSTR *pbstrText)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef returnedVal)
C#: string
GetKeytip(IRibbonControl control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

sizeString

String

No es aplicable

getText

Callback

VBA: Sub GetText(control As


IRibbonControl, ByRef returnedVal)
C#: string GetText(IRibbonControl
control)
Visual Basic: Function
GetText(control As IRibbonControl)
As String
C++: HRESULT GetText([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

Elementos secundarios: item

customUI
La etiqueta raz de todas las personalizaciones de la interfaz de
usuario de Fluent.

Atributo

Tipo

Firma de devolucin de llamada

onLoad

Callback

VBA: Sub OnLoad(ribbon As


IRibbonUI)
C#: void OnLoad(IRibbonUI ribbon)
Visual Basic: Sub OnLoad(ribbon As
IRibbonUI)
C++: HRESULT OnLoad([in] IRibbonUI
*pRibbon)

loadImage

Callback

VBA: Sub LoadImage(imageId As


String, ByRef image)
C#: IPictureDisp LoadImage(string
image_id)
Visual Basic: Function
LoadImage(imageId As String) As
IPictureDisp
C++: HRESULT LoadImage([in] BSTR
*pbstrImageId, [out, retval] IPictureDisp
** ppdispImage) *pRibbon)

Elementos secundarios: commands, ribbon, backstage

Desplegable
Representa un control dropDown.

Atributo

Tipo

Firma de devolucin de llam

id

Id

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

expand

String

No es aplicable

layout

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control


IRibbonControl, ByRef returne
C#: bool GetEnabled(IRibbon
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([i
IRibbonControl *pControl, [o
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

getItemCount

Callback

VBA: Sub GetItemCount(cont


IRibbonControl, ByRef returne
C#: int GetItemCount(IRibbon
control)
Visual Basic: Function
GetItemCount(control As
IRibbonControl) as Integer
C++: HRESULT GetItemCoun
IRibbonControl *pControl, [o
retval] LONG *returnedVal)

getItemID

Callback

VBA: Sub GetItemID(control A


IRibbonControl, itemIndex as
ByRef returnedVal)
C#: string GetItemID(IRibbon
control, int itemIndex)
Visual Basic: Function
GetItemID(control As IRibbon
itemIndex as Integer) as Strin
C++: HRESULT GetItemID([in
IRibbonControl *pControl, [in
cIndex, [out, retval] BSTR
*pbstrReturnedVal)

getItemLabel

Callback

VBA: Sub GetItemLabel(contr


IRibbonControl, itemIndex as

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

ByRef returnedVal)
C#: string
GetItemLabel(IRibbonControl
int itemIndex)
Visual Basic: Function
GetItemLabel(control As
IRibbonControl, itemIndex as
Integer) as String
C++: HRESULT GetItemLabel
IRibbonControl *pControl, [in
cIndex, [out, retval] BSTR
*pbstrReturnedVal)
getSelectedItemIndex

Callback

VBA: Sub
GetSelectedItemIndex(contro
IRibbonControl, ByRef returne
C#: int
GetSelectedItemIndex(IRibbon
control)
Visual Basic: Function
GetSelectedItemIndex(contro
IRibbonControl) as Integer
C++: HRESULT
GetSelectedItemIndex([in]
IRibbonControl *pControl, [o
retval] LONG *returnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returne
C#: string GetLabel(IRibbonC
control)
Visual Basic: Function
GetLabel(control As IRibbonC
As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control A


IRibbonControl, ByRef returne
C#: bool GetVisible(IRibbonC
control)
Visual Basic: Function
GetVisible(control As IRibbon
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [o
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

onAction

Callback

VBA: Sub OnAction(control A


IRibbonControl, itemID As St

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

itemIndex As Integer)
C#: void OnAction(IRibbonCo
control, string itemID, int item
Visual Basic: Sub OnAction(co
As IRibbonControl, itemID As
itemIndex As Integer)
C++: HRESULT OnAction([in]
IRibbonControl *pControl, [in
*selectedID, [in] LONG
cSelectedIndex)
keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control A


IRibbonControl, ByRef returne
C#: string GetKeytip(IRibbonC
control)
Visual Basic: Function
GetKeytip(control As IRibbon
As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

sizeString

String

No es aplicable

screentip

String

No es aplicable

getScreentip

Callback

VBA: Sub GetScreentip(contro


IRibbonControl, ByRef returne
C#: string
GetScreentip(IRibbonControl
Visual Basic: Function
GetScreentip(control As
IRibbonControl) As String
C++: HRESULT GetScreentip(
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

supertip

String

No es aplicable

getSupertip

Callback

VBA: Sub GetSupertip(contro


IRibbonControl, ByRef returne
C#: string
GetSupertip(IRibbonControl c
Visual Basic: Function
GetSupertip(control As
IRibbonControl) As String
C++: HRESULT GetSupertip([
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

Elementos secundarios: item

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Cuadro de edicin
Representa el control editBox.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

alignLabel

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) As Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

expand

String

No es aplicable

layout

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As IRibbonControl)
As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

keytip

Token

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef returnedVal)
C#: string GetKeytip(IRibbonControl
control)
Visual Basic: Function
GetKeytip(control As IRibbonControl)
As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

maxLength

Entero
positivo

No es aplicable

onChange

Callback

VBA: Sub OnChange(control As


IRibbonControl, text As String)
C#: void OnChange(IRibbonControl
control, string text)
Visual Basic: Sub OnChange(control
As IRibbonControl, text As String)
C++: HRESULT OnChange([in]
IRibbonControl *pControl, [in] BSTR
*pbstrText)

sizeString

String

No es aplicable

getText

Callback

VBA: Sub GetText(control As


IRibbonControl, ByRef returnedVal)
C#: string GetText(IRibbonControl
control)
Visual Basic: Function GetText(control
As IRibbonControl) As String
C++: HRESULT GetText([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As IRibbonControl)
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: ninguno

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Grupo
Representa el contenedor de grupos.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

insertAfterMso

Nombre
integrado
(String)

No es aplicable

insertBeforeMso

Nombre
integrado
(String)

No es aplicable

insertAfterQ

Nombre
completo
(String)

No es aplicable

insertBeforeQ

Nombre
completo
(String)

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)
getStyle

Callback

VBA: Sub GetStyle(control As


IRibbonControl, ByRef
returnedVal)
C#: BackstageGroupStyle
GetStyle(IRibbonControl control)
Visual Basic: Function
GetStyle(control As
IRibbonControl) As
BackstageGroupStyle
C++: HRESULT GetStyle([in]
IRibbonControl *pControl, [out,
retval] BackstageGroupStyle
*pbstrReturnedVal)

helperText

String

getHelperText

No es aplicable
VBA: Sub GetHelperText(control
As IRibbonControl, ByRef
returnedVal)
C#: string
GetHelperText(IRibbonControl
control)
Visual Basic: Function
GetHelperText(control As
IRibbonControl) As String
C++: HRESULT
GetHelperText([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

showLabel

Boolean

No es aplicable

getShowLabel

Callback

VBA: Sub GetShowLabel(control


As IRibbonControl, ByRef
returnedVal)
C#: bool
GetShowLabel(IRibbonControl
control)
Visual Basic: Function
GetShowLabel(control As
IRibbonControl) As Boolean
C++: HRESULT
GetShowLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Elementos secundarios: primaryItem, topItems, bottomItems

Cuadro de grupo
Representa el contenedor groupBox.
Atributos:

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

expand

String

No es aplicable

layout

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function GetLabel(control
As IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out, retval]
BSTR *pbstrReturnedVal)

Elementos secundarios: button, checkbox, editBox, dropdown,


radioGroup, comboBox, hyperlink, labelControl, groupBox,
layoutContainer, imageControl

Hipervnculo
Representa un control hyperlink.
Atributos:

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

completo
(String)
idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

alignLabel

String

No es aplicable

expand

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) As Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef returnedVal)
C#: string GetKeytip(IRibbonControl
control)
Visual Basic: Function
GetKeytip(control As IRibbonControl)
As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

layout

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As IRibbonControl)
As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

target

String

No es aplicable

getTarget

Callback

VBA: Sub GetTarget(control As


IRibbonControl, ByRef returnedVal)
C#: string GetTarget(IRibbonControl
control)
Visual Basic: Function
GetTarget(control As IRibbonControl)
As String
C++: HRESULT GetTarget([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As IRibbonControl)
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: ninguno

Control de imagen
Representa un control imageControl.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetEnabled(IRibbonControl

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) As Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)
image

String

No es aplicable

imageMso

Nombre
integrado
(String)

No es aplicable

getImage

Callback

VBA: Sub GetImage(control As


IRibbonControl, ByRef
returnedBitmap)
C#: Bitmap GetImage(IRibbonControl
control)
Visual Basic: Function
GetImage(control As IRibbonControl)
As Bitmap
C++: HRESULT GetImage([in]
IRibbonControl *pControl, [out,
retval] IPictureDisp ** ppdispImage)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As IRibbonControl)
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: ninguno

Elemento
Representa el elemento en un control dropDown o comboBox.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

label

String

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function GetLabel(control
As IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out, retval]
BSTR *pbstrReturnedVal)

Elementos secundarios: ninguno

Control de etiqueta
Representa el control labelControl.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

alignLabel

String

No es aplicable

expand

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) As Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

layout

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

IRibbonControl, ByRef returnedVal)


C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As IRibbonControl)
As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)
visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef returnedVal)
C#: bool GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As IRibbonControl)
As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: ninguno

Contenedor de diseo
Representa el contenedor layoutContainer.

Atributo

Tipo

Firma de devolucin
de llamada

id

Id

No es aplicable

idQ

Nombre completo
(String)

No es aplicable

idMso

Nombre integrado
(String)

No es aplicable

tag

String

No es aplicable

align

String

No es aplicable

expand

String

No es aplicable

layoutChildren

String

No es aplicable

Elementos secundarios: button, checkbox, editBox, dropdown,


radioGroup, comboBox, hyperlink, labelControl, groupBox,
layoutContainer, imageControl

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Men
Representa el control menu.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

*description

String

No es aplicable

*getDescription

Callback

VBA: Sub GetDescription(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetDescription(IRibbonControl
control)
Visual Basic: Function
GetDescription(control As
IRibbonControl) As String
C++: HRESULT
GetDescription([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

tag

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) As Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

image

String

No es aplicable

imageMso

Nombre

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

integrado
(String)
getImage

Callback

VBA: Sub GetImage(control As


IRibbonControl, ByRef
returnedBitmap)
C#: Bitmap
GetImage(IRibbonControl
control)
Visual Basic: Function
GetImage(control As
IRibbonControl) As Bitmap
C++: HRESULT GetImage([in]
IRibbonControl *pControl, [out,
retval] IPictureDisp **
ppdispImage)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetKeytip(IRibbonControl
control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonControl
control)
Visual Basic: GetVisible(control
As IRibbonControl) As Boolean

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

C++: HRESULT GetVisible([in]


IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)
*screentip

String

No es aplicable

*getScreentip

Callback

VBA: Sub GetScreentip(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetScreentip(IRibbonControl
control)
Visual Basic: Function
GetScreentip(control As
IRibbonControl) As String
C++: HRESULT GetScreentip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

*supertip

String

No es aplicable

*getSupertip

Callback

VBA: Sub GetSupertip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetSupertip(IRibbonControl
control)
Visual Basic: Function
GetSupertip(control As
IRibbonControl) As String
C++: HRESULT GetSupertip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

* No se usa en todas las implementaciones


Elementos secundarios: menuGroup

Grupo de mens
Representa el contenedor menuGroup.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

tag

String

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function GetLabel(control
As IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out, retval]
BSTR *pbstrReturnedVal)

itemSize

String

No es aplicable

Elementos secundarios: button, checkbox, menu

Elemento principal
Representa un contenedor primaryItem.
Atributos: ninguno
Elementos secundarios: button, menu

Botn de opciones
Representa el botn en un control radioGroup.

Atributo

Tipo

Firma de devolucin de llamada

id

Id

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returnedVal)
C#: string GetLabel(IRibbonControl
control)
Visual Basic: Function GetLabel(control
As IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out, retval]
BSTR *pbstrReturnedVal)

Elementos secundarios: ninguno

Grupo de opciones
Representa el contenedor del control radioButton.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Atributo

Tipo

Firma de devolucin de llam

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

alignLabel

String

No es aplicable

expand

String

No es aplicable

layout

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control


IRibbonControl, ByRef returne
C#: bool GetEnabled(IRibbon
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([i
IRibbonControl *pControl, [o
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

getItemCount

Callback

VBA: Sub GetItemCount(cont


IRibbonControl, ByRef returne
C#: int GetItemCount(IRibbon
control)
Visual Basic: Function
GetItemCount(control As
IRibbonControl) as Integer
C++: HRESULT GetItemCoun
IRibbonControl *pControl, [o
retval] LONG *returnedVal)

getItemID

Callback

VBA: Sub GetItemID(control A


IRibbonControl, itemIndex As
Integer, ByRef returnedVal)
C#: string GetItemID(IRibbon
control, int itemIndex)
Visual Basic: Function
GetItemID(control As IRibbon
itemIndex as Integer) as Strin
C++: HRESULT GetItemID([in

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

IRibbonControl *pControl, [in


cIndex, [out, retval] BSTR
*pbstrReturnedVal)
getItemLabel

Callback

VBA: Sub GetItemLabel(contr


IRibbonControl, itemIndex As
Integer, ByRef returnedVal)
C#: string
GetItemLabel(IRibbonControl
int itemIndex)
Visual Basic: Function
GetSelectedItemIndex(contro
IRibbonControl, itemIndex as
Integer) as String
C++: HRESULT
GetSelectedItemIndex([in]
IRibbonControl *pControl, [in
cIndex, [out, retval] BSTR
*pbstrReturnedVal)

getSelectedItemIndex

Callback

VBA: Sub
GetSelectedItemIndex(contro
IRibbonControl, ByRef returne
C#: int
GetSelectedItemIndex(IRibbon
control)
Visual Basic: Function
GetSelectedItemIndex(contro
IRibbonControl) as Integer
C++: HRESULT
GetSelectedItemIndex([in]
IRibbonControl *pControl, [o
retval] LONG *returnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef returne
C#: string GetLabel(IRibbonC
control)
Visual Basic: Function
GetLabel(control As IRibbonC
As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control A


IRibbonControl, ByRef returne
C#: bool GetVisible(IRibbonC
control)
Visual Basic: Function
GetVisible(control As IRibbon
As Boolean

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

C++: HRESULT GetVisible([in]


IRibbonControl *pControl, [o
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)
onAction

Callback

VBA: Sub OnAction(control A


IRibbonControl)
C#: void OnAction(IRibbonCo
control)
Visual Basic: Sub OnAction(co
As IRibbonControl)
C++: HRESULT OnAction([in]
IRibbonControl *pControl)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control A


IRibbonControl, ByRef returne
C#: string GetKeytip(IRibbonC
control)
Visual Basic: Function
GetKeytip(control As IRibbon
As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [o
retval] BSTR *pbstrReturnedV

Elementos secundarios: radioButton

Ficha
Representa el contenedor principal de los controles de la vista
Backstage relacionados.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

insertAfterMso

Nombre
integrado
(String)

No es aplicable

insertBeforeMso

Nombre

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

integrado
(String)
insertAfterQ

Nombre
completo
(String)

No es aplicable

insertBeforeQ

Nombre
completo
(String)

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub
GetEnabled(control As
IRibbonControl, ByRef
returnedVal)
C#: bool
GetEnabled(IRibbonContr
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as
Boolean
C++: HRESULT
GetEnabled([in]
IRibbonControl *pContro
[out, retval] BSTR
VARIANT_BOOL
*pvarReturnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(contro


As IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT
GetLabel([in]
IRibbonControl *pContro
[out, retval] BSTR
*pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub
GetVisible(control As
IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonContro
control)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Visual Basic: Function


GetVisible(control As
IRibbonControl) As
Boolean
C++: HRESULT
GetVisible([in]
IRibbonControl *pContro
[out, retval] BSTR
VARIANT_BOOL
*pvarReturnedVal)
keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub
GetKeytip(control As
IRibbonControl, ByRef
returnedVal)
C#: string
GetKeytip(IRibbonControl
control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT
GetKeytip([in]
IRibbonControl *pContro
[out, retval] BSTR
*pbstrReturnedVal)

title

String

No es aplicable

getTitle

Callback

VBA: Sub GetTitle(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetTitle(IRibbonControl
control)
Visual Basic: Function
GetTitle(control As
IRibbonControl) As String
C++: HRESULT GetTitle([i
IRibbonControl *pContro
[out, retval] BSTR
*pbstrReturnedVal)

columnWidthPercent

Positive
Integer

No es aplicable

firstColumnMinWidth

Positive
Integer

No es aplicable

firstColumnMaxWidth

Positive
Integer

No es aplicable

secondColumnMinWidth

Positive
Integer

No es aplicable

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

secondColumnMaxWidth

Positive
Integer

No es aplicable

Elementos secundarios: firstColumn, secondColumn

Tarea
Representa el contenedor de tareas.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

enabled

Boolean

No es aplicable

getEnabled

Callback

VBA: Sub GetEnabled(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetEnabled(IRibbonControl
control)
Visual Basic: Function
GetEnabled(control As
IRibbonControl) as Boolean
C++: HRESULT GetEnabled([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonControl control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

keytip

Token

No es aplicable

getKeytip

Callback

VBA: Sub GetKeytip(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetKeytip(IRibbonControl control)
Visual Basic: Function
GetKeytip(control As
IRibbonControl) As String
C++: HRESULT GetKeytip([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

description

String

No es aplicable

getDescription

Callback

VBA: Sub GetDescription(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetDescription(IRibbonControl
control)
Visual Basic: Function
GetDescription(control As
IRibbonControl) As String
C++: HRESULT GetDescription([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

image

String

No es aplicable

imageMso

Nombre
integrado
(String)

No es aplicable

getImage

Callback

VBA: Sub GetImage(control As


IRibbonControl, ByRef
returnedBitmap)
C#: Bitmap
GetImage(IRibbonControl control)

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Visual Basic: Function


GetImage(IRibbonControl control)
As Bitmap
C++: HRESULT GetImage([in]
IRibbonControl *pControl, [out,
retval] IPictureDisp **
ppdispImage)

Elementos secundarios: group

Grupo de formularios de tareas


Representa un contenedor taskFormGroup.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

insertAfterMso

Nombre
integrado
(String)

No es aplicable

insertBeforeMso

Nombre
integrado
(String)

No es aplicable

insertAfterQ

Nombre
completo
(String)

No es aplicable

insertBeforeQ

Nombre
completo
(String)

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

C++: HRESULT GetLabel([in]


IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)
visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool
GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

helperText

String

No es aplicable

getHelperText

Callback

VBA: Sub GetHelperText(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetHelperText(IRibbonControl
control)
Visual Basic: Function
GetHelperText(control As
IRibbonControl) As String
C++: HRESULT
GetHelperText([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

showLabel

Boolean

No es aplicable

getShowLabel

Callback

VBA: Sub GetShowLabel(control


As IRibbonControl, ByRef
returnedVal)
C#: bool
GetShowLabel(IRibbonControl
control)
Visual Basic: Function
GetShowLabel(control As
IRibbonControl) As Boolean
C++: HRESULT
GetShowLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: category

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Grupo de tareas
Representa un contenedor taskGroup.

Atributo

Tipo

Firma de devolucin de
llamada

id

Id

No es aplicable

idQ

Nombre
completo
(String)

No es aplicable

idMso

Nombre
integrado
(String)

No es aplicable

tag

String

No es aplicable

insertAfterMso

Nombre
integrado
(String)

No es aplicable

insertBeforeMso

Nombre
integrado
(String)

No es aplicable

insertAfterQ

Nombre
completo
(String)

No es aplicable

insertBeforeQ

Nombre
completo
(String)

No es aplicable

label

String

No es aplicable

getLabel

Callback

VBA: Sub GetLabel(control As


IRibbonControl, ByRef
returnedVal)
C#: string
GetLabel(IRibbonControl
control)
Visual Basic: Function
GetLabel(control As
IRibbonControl) As String
C++: HRESULT GetLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

visible

Boolean

No es aplicable

getVisible

Callback

VBA: Sub GetVisible(control As


IRibbonControl, ByRef
returnedVal)
C#: bool

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

GetVisible(IRibbonControl
control)
Visual Basic: Function
GetVisible(control As
IRibbonControl) As Boolean
C++: HRESULT GetVisible([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)
helperText

String

No es aplicable

getHelperText

Callback

VBA: Sub GetHelperText(control


As IRibbonControl, ByRef
returnedVal)
C#: string
GetHelperText(IRibbonControl
control)
Visual Basic: Function
GetHelperText(control As
IRibbonControl) As String
C++: HRESULT
GetHelperText([in]
IRibbonControl *pControl, [out,
retval] BSTR *pbstrReturnedVal)

showLabel

Boolean

No es aplicable

getShowLabel

Callback

VBA: Sub GetShowLabel(control


As IRibbonControl, ByRef
returnedVal)
C#: bool
GetShowLabel(IRibbonControl
control)
Visual Basic: Function
GetShowLabel(control As
IRibbonControl) As Boolean
C++: HRESULT
GetShowLabel([in]
IRibbonControl *pControl, [out,
retval] BSTR VARIANT_BOOL
*pvarReturnedVal)

Elementos secundarios: category


Conclusin
La extensibilidad de la vista Backstage brinda una oportunidad
inigualable para proporcionar a los usuarios un conjunto de
mens y opciones personalizados y dedicados. Y lo mejor de todo
es que puede usar la experiencia y las estructuras que us al
personalizar la interfaz de usuario de la cinta de opciones. Desde
aqu les animo a que exploren los diferentes componentes que
conforman la interfaz de usuario de Microsoft Office Fluent para
crear aplicaciones personalizadas para su organizacin.
Recursos adicionales
En las siguientes ubicaciones podr encontrar ms informacin
acerca de los temas tratados en este artculo.

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]

Introduccin a la vista Backstage de Office 2010 para programadores

Personalizacin de la cinta de Office Fluent 2007 para


programadores (parte 1 de 3)
Portal de programadores de interfaz de usuario de
Office Fluent
Agradecimientos: Gracias a mi editora, Linda Cannon, por su
ayuda en la preparacin de este artculo para su publicacin.

Le result til esta pgina?


Sus comentarios sobre este contenido son muy importantes.
Hganos saber su opinin.
S

No

Centros

Otros sitios de Office

Windows

Office.com para consumidores

MicrosoftAzure

Office 365 para usuarios y


administradores

Visual Studio
MSDN

Espaa - Espaol

Office, SharePoint, Exchange,


Lync y Project para
profesionales de TI

Condiciones de uso

Marcas comerciales

Privacidad y cookies

2015 Microsoft

https://msdn.microsoft.com/es-es/library/office/ee691833(v=office.14).aspx#odc_Office2010Introduction2OutSpaceUI_IntroductionMicrosoftOffice14FluentOutSpaceUI[31/03/2015 17:50:16]