Blog di Laura Ciccarese : Ribbon

Word Custom Ribbon: aggiungere un'intestazione di pagina

laura — Thu, 26 Apr 2007 01:52:00 GMT

Oggi proseguiamo con la personalizzazione del ribbon di Word, aggiungendo un comando che permette di inserire o aggiornare l'intestazione di pagina del documento corrente.

L'esempio si basa sulle applicazioni descritte nel post precedente, Word Custom Ribbon: modifica stile, alle quali apporteremo le seguenti modifiche:

aggiungere un comando alla struttura del Ribbon.xml;
assegnare la dimensione massima al comando;
aggiungere la funzionalità relativa nel foglio ThisAddin.cs o ThisAddin.vb;
aggiungere la chiamata alla nuova funzionalità nella regione delle callbacks nel Ribbon.cs o Ribbon.vb.

Ribbon.xml

<button id ="aggiungiIntestazione01"

label ="Intestazione ufficiale"

screentip="aggiunge o aggiorna l'intestazione di pagina per la documentazione ufficiale"

size ="large"

onAction ="MyFunctions"

imageMso ="HeaderFooterEditHeader"/>

ThisAddin.cs

public void aggiungiIntestazione01()

{

//impostiamo la variabile per il documento attivo

Word.Document myDoc = Application.ActiveDocument;

//impostiamo la variabile per l'intestazione di pagina

Word.HeaderFooter myHeader = myDoc.Sections[1].Headers[Microsoft.Office.Interop.Word.WdHeaderFooterIndex.wdHeaderFooterPrimary];

try

{

//inseriamo e formattiamo l'intestazione di pagina

//inseriamo il nome del file completo di percorso (attenzione: se il documento

//non è ancora stato salvato, il nome del percorso non sarà disponibile:

if (myDoc.Saved == true)

myHeader.Range.Text = "Documento ufficiale - File:" + myDoc.Path + "'\'" + Application.ActiveDocument.Name;

else

myHeader.Range.Text = "Documento ufficiale - File:" + Application.ActiveDocument.Name;

myHeader.Range.Font.Name = "Bauhaus 93";

myHeader.Range.Font.Size = 9;

myHeader.Range.Font.Color = Word.WdColor.wdColorGray70;

myHeader.Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;

myHeader.Range.Underline = Word.WdUnderline.wdUnderlineThick;

}

catch (Exception ex)

{

MessageBox.Show(ex.ToString());

}

Ribbon.cs

public void MyFunctions(Office.IRibbonControl control)

{

//chiamata alle diverse funzioni corrispondenti ai diversi comandi del ribbon

//attualmente esiste un solo comandoswitch (control.Id)

switch(control.Id)

{

case "FormattaTitolo1":

Globals.ThisAddIn.FormattaTitolo1();

break;

case "aggiungiIntestazione01":

Globals.ThisAddIn.aggiungiIntestazione01();

break;

default:

// aggiungere codice per altre funzioni

break;

}

ThisAddin.vb

public void aggiungiIntestazione01()

{

//impostiamo la variabile per il documento attivo

Word.Document myDoc = Application.ActiveDocument;

//impostiamo la variabile per l'intestazione di pagina

Word.HeaderFooter myHeader = myDoc.Sections[1].Headers[Microsoft.Office.Interop.Word.WdHeaderFooterIndex.wdHeaderFooterPrimary];

try

{

//inseriamo e formattiamo l'intestazione di pagina

//inseriamo il nome del file completo di percorso (attenzione: se il documento

//non è ancora stato salvato, il nome del percorso non sarà disponibile:

if (myDoc.Saved == true)

myHeader.Range.Text = "Documento ufficiale - File:" + myDoc.Path + "'\'" + Application.ActiveDocument.Name;

else

myHeader.Range.Text = "Documento ufficiale - File:" + Application.ActiveDocument.Name;

myHeader.Range.Font.Name = "Bauhaus 93";

myHeader.Range.Font.Size = 9;

myHeader.Range.Font.Color = Word.WdColor.wdColorGray70;

myHeader.Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;

myHeader.Range.Underline = Word.WdUnderline.wdUnderlineThick;

}

catch (Exception ex)

{

MessageBox.Show(ex.ToString());

}

Ribbon.vb

Public Sub myFunctions(ByVal control As Office.IRibbonControl)

'chiamata alle diverse funzioni corrispondenti ai diversi comandi del ribbon

'attualmente esiste un solo comando

Select Case control.Id

Case "FormattaTitolo1"

Globals.ThisAddIn.FormattaTitolo1()

Case "aggiungiIntestazione01"

Globals.ThisAddIn.aggiungiIntestazione01()

Case Else

'aggiungere codice per altre funzioni

End Select

End Sub

Ecco il risultato:

Se il documento non è ancora stato salvato, nell'intestazione verrà inserito solo il nome geerico Documento1 e non il percorso:

Se il documento è stato salvato, nell'intestazione verrà inserito il nome del file e il percorso completo:

Come al solito, in allegato trovate le due applicazioni.

Ciao a tutti

Laura

Word Custom Ribbon: modifica stile

laura — Sat, 31 Mar 2007 02:15:00 GMT

Oggi vediamo un primo esempio sulla personalizzazione del Ribbon di Word 2007, con la creazione di una scheda aggiuntiva contenente, per il momento, un comando che modifica lo stile Titolo 1 nell'intero documento.

Le operazioni da eseguire sono molto simili a quelle già eseguite per Excel e descritte nei post precedenti, che riassumo sinteticamente:

aprire Visual Studio 2007 e creare un Word addin (in C# o Visual Basic);
aggiungere un item di tipo RibbonSupport che creerà la classe Ribbon1.cs (Ribbon1.vb per visual basic) e il file di struttura Ribbon1.xml (comune ad entrambi i linguaggi);
sostituire la struttura del Ribbon1.xml con la seguente:

Ribbon1.xml
<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui" onLoad="OnLoad">
<ribbon startFromScratch ="false">
<tabs>
<tab id="MenùAzienda"
label="Menù aziendale VB">
<group id="FormatoCarattere"
label="Formati carattere">
<button id ="FormattaTitolo1"
size ="normal"
label ="Formatta Titolo 1"
screentip ="Formatta il testo con stile Titolo 1"
supertip ="Porta lo stile Titolo 1 a 16 punti,carattere Arial Black, grassetto e corsivo"
onAction = "myFunctions"
imageMso ="ChangeStylesMenu"/>
</group>
</tab>
<tab idMso ="TabHome">
<group idMso="GroupFont" >
<comboBox idMso ="fontSize" visible ="false"/>
</group>
</tab>
</tabs>
</ribbon>
</customUI>

attivare il codice commentato (indicato con il commento TODO), nella classe Ribbon1.cs (e analogamente nella classe Ribbon1.vb)
aggiungere la callback myFunctions nella regione delle callbacks del file Ribbon1.cs (e Ribbon1.vb):

C#

#region Ribbon Callbacks
public void MyFunctions(Office.IRibbonControl control)
{
//chiamata alle diverse funzioni corrispondenti ai diversi comandi del ribbon
//attualmente esiste un solo comandoswitch (control.Id)
switch(control.Id)
{
case "FormattaTitolo1":
Globals.ThisAddIn.FormattaTitolo1();
break;
default:
// aggiungere codice per altre funzioni
break;
}
}
#endregion

VB
#Region "Ribbon Callbacks"
Public Sub myFunctions(ByVal control As Office.IRibbonControl)
'chiamata alle diverse funzioni corrispondenti ai diversi comandi del ribbon
'attualmente esiste un solo comando
Select Case control.Id
Case "FormattaTitolo1"
Globals.ThisAddIn.FormattaTitolo1()
Case Else
'aggiungere codice per altre funzioni
End Select
End Sub
#End Region

creare il metodo per l'esecuzione della funzionalità nella classe ThisAddin.cs (ThisAddin.vb per Visual Basic):

C#
public void FormattaTitolo1()
{
try
{
//impostiamo la variabile per il documento attivo
Word.Document myDoc = Application.ActiveDocument;
//impostiamo la variabile oggetto per passare il nome dello stile
object styleName = "Titolo 1";
//impostiamo la variabile per lo stile Titolo 1
Word.Style myStyle = myDoc.Styles.get_Item(ref styleName);
//impostiamo la variabile booleana
Boolean updAutom = false;
//rileviamo l'impostazione della proprietà "aggiorna automaticamente" dello stile Titolo 1
//in modo da poterla impostare a true prima di effettuare le modifiche
//e poterla poi riportare al valore precedente al termine delle modifiche
updAutom = myStyle.AutomaticallyUpdate;
//impostiamo a true l'aggiornamento automatico
myStyle.AutomaticallyUpdate.Equals(true);
//apportiamo le modifiche necessarie allo stile Titolo 1
myStyle.Font.Size = 22;
myStyle.Font.Name = "Tahoma";
myStyle.Font.Color = Word.WdColor.wdColorDarkRed;
myStyle.Font.Bold = 1;
myStyle.Font.Italic = 0;
//assegnamo un bordo inferiore al paragrafo
myStyle.ParagraphFormat.Borders[Word.WdBorderType.wdBorderBottom].LineStyle = Word.WdLineStyle.wdLineStyleSingle;
myStyle.ParagraphFormat.Borders[Word.WdBorderType.wdBorderBottom].LineWidth = Word.WdLineWidth.wdLineWidth100pt;
myStyle.ParagraphFormat.Borders[Word.WdBorderType.wdBorderBottom].Color= Word.WdColor.wdColorDarkRed;
//allinemanto centrato
myStyle.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;
//riportiamo l'opzione di aggiornamento automatico allo stato originale
myStyle.AutomaticallyUpdate = updAutom;
}
catch
{
MessageBox.Show("Operazione non riuscita");
}
}

VB
Public Sub FormattaTitolo1()
Dim myDoc As Word.Document
Dim myStyle As Word.Style
Dim updAutom As Boolean
Try
'impostiamo la variabile per il documento attivo
myDoc = Application.ActiveDocument
'impostiamo la variabile per lo stile da modificare
myStyle = myDoc.Styles('Titolo 1')
'rileviamo l'impostazione della proprietà "aggiorna automaticamente" dello stile Titolo 1
'in modo da poterla impostare a true prima di effettuare le modifiche
'e poterla poi riportare al valore precedente al termine delle modifiche
updAutom = myStyle.AutomaticallyUpdate
'impostiamo a true l'aggiornamento automatico
myStyle.AutomaticallyUpdate = True
'apportiamo le modifiche necessarie allo stile Titolo 1
With myStyle.Font
.Name = "Haettenschweiler"
.Color = Word.WdColor.wdColorDarkRed
.Size = 22
.Bold = False
.Italic = False
End With
'assegnamo un bordo inferiore al paragrafo
With myStyle.ParagraphFormat
.Borders(Word.WdBorderType.wdBorderBottom).LineStyle = Word.WdLineStyle.wdLineStyleSingle
.Borders(Word.WdBorderType.wdBorderBottom).LineWidth = Word.WdLineWidth.wdLineWidth100pt
.Borders(Word.WdBorderType.wdBorderBottom).Color = Word.WdColor.wdColorDarkRed
'allinemanto centrato
.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter
End With
'riportiamo l'opzione di aggiornamento automatico allo stato originale
myStyle.AutomaticallyUpdate = updAutom
Catch ex As Exception
MessageBox.Show("Operazione non riuscita")
End Try
End Sub

Per fare delle prove potete usare un qualsiasi documento con del testo che abbia, tra gli altri, lo stile Titolo 1, e vedere il risultato.

Io ho utilizzato il file WordCustomRibbon_01.docx (contenuto nell'allegato) che, oltre a prestarsi allo scopo, contiene tutto il codice necessario, da copiare e incollare nei nuovi progetti.

Il file contiene diversi titoli con lo stile Titolo 1 e una nuova scheda Menù Aziendale (nel mio caso sono due perchè ho caricato entrambi gli addins) con il comando Formatta Titolo 1:

Dopo aver fatto click sul comando, tutti i titoli assumono la formattazione assegnata:

Naturalmente, come sempre, in allegato trovate entrambe le applicazioni e il file per l'esempio.

Ciao a tutti

Laura

Materiale del Ready For a New Day

laura — Wed, 28 Mar 2007 00:45:00 GMT

Come promesso, ecco tutto il materiale relativo alla sessione di Office che ho tenuto a Bari il 23 Marzo:

la presentazione;
il progetto in C# e in Visual basic;
l'elenco dei controlli del Ribbon per excel, indispensabile per reperire i corretti id di tabs, gruppi e controlli vari ;
un file excel con le galleries di immagini Office da assegnare ai comandi personalizzati del Ribbon.

E' possibile scaricare il tutto all'indirizzo: http://www.dotnetside.org/files/folders/ready_for__a_new_day/category1218.aspx

Per poter accedere al download è necessario essere registrati al sito.

In particolare, il file con le galleries, reperibile anche su Internet, è in una versione personalizzata da me, come spiegato anche nel mio post: Office Icon Gallery

Un ringraziamento a Dotnetside, per avermi dato questa possibilità; a tutti i partecipanti, che hanno pazientemente subito la mia "corsa" finale mentre Tiziana mi diceva di "stringere"; e, in particolare, a Mighell e a Gerardo per aver risolto brillantemente il problema del monitor, che avrebbe potuto compromettere la sessione!

Grazie ancora a tutti

Laura

Assegnare immagini di formato diverso ad un comando del Ribbon

laura — Thu, 25 Jan 2007 21:32:00 GMT

Oggi vorrei completare il post .NET Ribbon con il codice necessario per assegnare ad un comando del Ribbon immagini di vario formato: ico, jpg, bmp, gif, ecc.

Scaricate (se non l'avete già fatto ) l'applicazione allegata al post Assegnare immagini personalizzate ad un comando del Ribbon e, seguendo le istruzioni del post, predisponete tre comandi sul tab personalizzato, e tre file di risorsa per le rispettive immagini (io ho utilizzato un file .ico, un file .gif e un file .bmp)

1. Modificare il file Ribbon1.xlm

Il file Ribbon1.xml dovrebbe avere la seguente struttura:

<tabs>

<tab id="SchedaPersonalizzata"

label ="Laura">

<group id="Immagini"

label="Immagini aziendali"

<toggleButton id="InserisciLogo01"

size="large"
label="Inserisci Logo Ufficiale"
screentip="Inserisce il logo ufficiale in corrispondenza del cursore"
onAction="OnToggleButton"
getImage ="GetMyImage" />
<toggleButton id="InserisciLogo02"
size="large"
label="Inserisci Logo per web"
screentip="Inserisce il logo web in corrispondenza del cursore"
onAction="OnToggleButton"
getImage ="GetMyImage" />
<toggleButton id="InserisciLogo03"
size="large"
label="Inserisci Logo interno"
screentip="Inserisce il logo per la documentazione interna in corrispondenza del cursore"
onAction="OnToggleButton"
getImage ="GetMyImage" />

</group>

</tab>

</tabs>

</ribbon>

</customUI>

2. Modificare la funzione GetMyImage

Modificate la funzione GetMyImage in modo da passare l'immagine corrispondente ad ogni controllo del Ribbon:

public stdole.IPictureDisp GetMyImage(Office.IRibbonControl control)

{

stdole.IPictureDisp pictureDisp = null;

switch (control.Id)

{

case "InserisciLogo01":
pictureDisp =
ImageConverter.Convert(GetResourceBitmap("sqltut.ico"));
break;
case "InserisciLogo02":
pictureDisp =
ImageConverter.Convert(GetResourceBitmap("Logo.bmp"));
break;
case "InserisciLogo03":
pictureDisp =
ImageConverter.Convert(GetResourceBitmap("Diavoletto.gif"));
break;

}

return pictureDisp;

}

3. Modificare la funzione GetResourceBitmap

Modificate la funzione che restituisce l'immagine in modo che gestisca la tipologia di immagini.ico separatamente dalle altre:

public static System.Drawing.Bitmap GetResourceBitmap(string resourceName)
{
Assembly asm = Assembly.GetExecutingAssembly();
string[] resources = asm.GetManifestResourceNames();
System.Drawing.Bitmap image = null;

foreach (string resource in resources)
{
if (resource.EndsWith(resourceName))
{
System.IO.Stream stream =
asm.GetManifestResourceStream(resource);
if (stream == null)
{
break;
}
string extension =
System.IO.Path.GetExtension(resourceName).ToLower();
switch (extension)
{
case ".ico":
image = new System.Drawing.Icon(stream).ToBitmap();
break;
default:
image = new System.Drawing.Bitmap(stream);
image.MakeTransparent();
break;
}
stream.Close();
break;
}
}
return image;
}

4. Provare per credere

Lanciate l'applicazione e il risultato, con le mie immagini, è il seguente:

Trovate l'applicazione completa in allegato

Chiedo ancora perdono agli utenti di Visual Basic che rimando all'articolo in uscita alla fine del mese ().

Ciao a tutti

Laura

Posizione delle schede nel Ribbon

laura — Sat, 20 Jan 2007 01:31:00 GMT

Vi piacerebbe avere la vostra scheda personalizzata in prima posizione nel Ribbon (lo so, non pensate ad altro, non mangiate, non ci dormite la notte....)

Ma adesso, la soluzione al vostro problema c'è: inserite l'attributo insertBeforeMso ="TabHome" al tag Tab nel file Ribbon.xml:

et voilà! (En français, s’il vous plait!)

La vostra "Scheda Personalizzata" si trova al primo posto!!!!

Alla prossima

Ciao a tutti

Laura

XML Notepad 2007

laura — Sun, 14 Jan 2007 20:26:00 GMT

Vi segnalo un interessante editor per file xml all'indirizzo:

http://www.microsoft.com/downloads/details.aspx?FamilyID=72D6AA49-787D-4118-BA5F-4F30FE913628&displaylang=en

Se preferite visualizzare la struttura del file sottoforma di albero cui aggiungere o eliminare voci, rinominare, ecc; può essere utile.

Dopo averlo installato, è possibile fare click destro su un file xml e utilizzare il nuovo editor:

Questo è quello che vi si presenta:

E' possibile aggiungere elementi e assegnarne i valori; visualizzare il risultato in modalità standard (XLS output), ecc.

Ad esempio, io ho aggiunto gli elementi e i valori relativi ad un nuovo comando per il ribbon:

e, dopo aver salvato, aprendo Excel, il ribbon risulta così modificato:

Un'altra funzionalità che può essere interessante (e che gli utenti di Word conoscono bene) è la possibilità di confrontare due file xml per visualizzarne le differenze, evidenziate con colori diversi descritti in una legneda:

Ciao a tutti

Laura

Assegnare immagini personalizzate ad un comando del Ribbon

laura — Sat, 13 Jan 2007 03:12:00 GMT

Oggi rispondo ad un quesito che sicuramente interessa molti: assegnare un’icona personalizzata ad un comando nel Ribbon.

Maggiori chiarimenti e dettagli saranno disponibili prossimamente in un articolo che sto preparando sul Ribbon, nel quale si analizza un caso studio completo; per il momento vi darò solo le indicazioni necessarie a rispondere velocemente a quanti hanno la necessità di risolvere il problema delle immagini non Office.

Supponiamo allora di voler assegnare l’icona “sqltut.ico” (o una qualsiasi, naturalmente) al comando “Insersci Logo” di una scheda personalizzata.

Operazioni da eseguire

1. indicare al Ribbon che l’icona da utilizzare per il nostro comando non è un’icona di Office;

2. convertire la nostra icona in un oggetto di tipo IPictureDisp, utilizzato dal Ribbon per assegnare immagini esterne.

Procedimento

Modifica del file Ribbon.xml

Oltre a correggere l’id e l’etichetta del tab e del gruppo di comandi, è necessario sostituire l’attributo relativo all’immagine statica:

imageMso="HappyFace"

con l’attributo che recupera l’immagine mediante la funzione GetMyImage:

getImage ="GetMyImage"

Il risultato sarà il seguente:

<tabs>

<tab id="SchedaPersonalizzata"

label ="Scheda Personalizzata">

<group id="Immagini"

label="Immagini aziendali">

<toggleButton id="InserisciLogo"

size="large"

label="Inserisci Logo"

screentip="Inserisce il logo aziendale nell’intestazione di pagina"

onAction="OnToggleButton"

getImage ="GetMyImage" />

</group>

</tab>

</tabs>

</ribbon>

</customUI>

Il Ribbon utilizzerà la funzione (callback) GetMyImage per passare l’id del comando e riceverne l’IPictureDisp da utilizzare per l’icona.

L'icona da utilizzare deve esssere inserita come risorsa nel progetto.

Caricamento dell’icona nelle risorse del progetto di Visual Studio

1. Doppio click su Proprietà nel Solution Explorer

2. Attivare il tab Resources

3. Fare click su Add resources

4. Fare click su Add from existing file

5. Chiudere la finestra delle risorse e fare click destro sul file corrispondente all’icona

6. Nella proprietà Build Action selezionare Embedded Resource (in tal modo, se si modifica nell’editor di Visual Studio, le modifiche saranno apportate istantaneamente)

L’icona viene aggiunta alle risorse del progetto:

Callback GetMyImage

Posizionare la funzione GetMyImage nella sezione callbacks del file Ribbon.cs, dopo la callback OnToggleButton:

Public Function GetMyImage (ByVal control As Office.IRibbonControl) As stdole.IPictureDisp

Dim pictureDisp As stdole.IPictureDisp

pictureDisp = Nothing

Select Case control.Id

Case " InserisciLogo "

pictureDisp = ImageConverter.Convert(GetResourceBitmap("sqltut.ico"))

End Select

Return pictureDisp

End Function

public stdole.IPictureDisp GetMyImage(Office.IRibbonControl control)

{

stdole.IPictureDisp pictureDisp = null;

switch (control.Id)

{

case "InserisciLogo":

pictureDisp =

ImageConverter.Convert(GetResourceBitmap("sqltut.ico"));

break;

}

return pictureDisp;

}

Funzioni per la conversione dell’immagine

Aggiungere il metodo GetResourceBitmap nella regione helper del Ribbon.cs

Public Shared Function GetResourceBitmap(ByVal resourceName As String) As System.Drawing.Bitmap

Dim asm As Assembly

Dim resources As String()

Dim image As System.Drawing.Bitmap

asm = Assembly.GetExecutingAssembly()

resources = asm.GetManifestResourceNames()

image = Nothing

For Each resource As String In resources

If (resource.EndsWith(resourceName)) Then

Dim stream As System.IO.Stream

stream = asm.GetManifestResourceStream(resource)

If (stream Is Nothing) Then

Exit For

End If

Dim extension As String

extension = System.IO.Path.GetExtension(resourceName).ToLower()

image = New System.Drawing.Icon(stream).ToBitmap()

stream.Close()

Exit For

End If

Return image

End Function

public static System.Drawing.Bitmap GetResourceBitmap(string resourceName)

{

Assembly asm = Assembly.GetExecutingAssembly();

string[] resources = asm.GetManifestResourceNames();

System.Drawing.Bitmap image = null;

foreach (string resource in resources)

{

if (resource.EndsWith(resourceName))

{

System.IO.Stream stream =

asm.GetManifestResourceStream(resource);

if (stream == null)

{

break;

}

string extension =

System.IO.Path.GetExtension(resourceName).ToLower();

image = new System.Drawing.Icon(stream).ToBitmap();

stream.Close();

break;

}

return image;

}

Aggiungere la classe ImageConverter alla fine del Ribbon.cs

Friend Class ImageConverter

Inherits System.Windows.Forms.AxHost

Sub New()

MyBase.New(Nothing)

End Sub

Public Shared Function Convert(ByVal image As System.Drawing.Image) As stdole.IPictureDisp

Return AxHost.GetIPictureDispFromPicture(image)

End Function

End Class

internal class ImageConverter : System.Windows.Forms.AxHost

{

private ImageConverter()

: base(null)

{

}

public static stdole.IPictureDisp Convert(System.Drawing.Image image)

{

return (stdole.IPictureDisp)

AxHost.GetIPictureDispFromPicture(image);

}

E, infine, non resta che compilare e lanciare l’applicazione:

In allegato trovate l'applicaizone in C# (chiedo perdono gli utenti di VB ([:'(]) ma nell'articolo ci saranno esempi con entrambi i linguaggi )

Che ne dite?

Buon divertimento a tutti!

Ciao

Laura

Office Icon Gallery

laura — Tue, 09 Jan 2007 21:46:00 GMT

Supponiamo che siate degli accaniti utilizzatori di icone: create comandi personalizzati a "go-go" e, di conseguenza, volete assegnare delle icone adeguate.

Che fate?

Avete due possibilità:

utilizzate l'elenco dei controlli che vi ho indicato nel post Elenco dei controlli del ribbon, cercate l'IdMso corrispondente al comando di Office la cui icona vi sembra adeguata, lo utilizzate incrociando le dita!!! (e si, perchè come già si è capito, non tutti i comandi dispongono di un'icona, anche se dispongono di un controlID!!!!
al 2° o 3° tentativo, volete prendere Office e buttarlo nel cestino (di Windows, si intende!), oppure volete linciare me che vi ho indicato questa strada (e questo già è peggio, almeno per me). Allora utilizzate il metodo descritto nel post Ribbon: creare comandi personalizzati utilizzando icone di comandi esistenti consistente nella visualizzazione del comando nella finestra Personalizza e della lettura del relativo nome. E' vero, dovete appuntarvi il nome del controllo ma almeno siete sicuri che l'icona ci sia!!!!

Diciamo, però, che nonostante questi due sistemi possano essere accettabili, sarebbe molto meglio poter visualizzare le icone disponibili in un'unica finestra, e magari non solo le icone dei comandi di Excel, ma tutte quelle di office, a prescindere dal comando cui sono associate perchè, dopotutto, a voi importa poco del comando, A VOI SERVE SOLO L'ICONA!!!!

E qui interviene la Icon Gallery che, non per niente, è il titolo di questo post!

Scaricate l'AddIn dal sito di MSDN

http://www.microsoft.com/downloads/details.aspx?familyid=12b99325-93e8-4ed4-8385-74d0f7661318&displaylang=en

e installatelo: durante la procedura vi si chiederà una posizione per il file che contiene le galleries: indicategliene una comoda.

Successivamente, aprite il file Office2007IconsGallery.xlsm che è stato inserito nella suddetta cartella, e apritelo:come per incanto, nella scheda Sviluppo vedrete apparire ben 9 Galleries contenenti decine e decine di icone!!!!!

(Se la scheda Sviluppo non è visualizzata (e non lo è per default!!), spuntate il flag sulla voce "Mostra barra sviluppo sulla scheda multifunzione" nella finestra Office > Opzioni > Impostazioni Generali).

GUARDATE E STUPITE!!!!!

Aprite una gallery

Fate click su quella che vi piace e vi apparirà una finestra con l'idMso: prendetene nota e utilizzatelo.

Ma qualche utente esigente potrebbe dire: "perchè devo prenderne nota, non potremmo, invece, fare in modo che l'idMso venga salvato negli appunti, così da poterlo utilizzare dove mi pare?"

Possiamo dargli torto?

Sicuramente no!!

Allora ho provveduto ad apportare una piccola modifica al codice del progetto VBA del file excel e, per la precisione, nel modulo RibbonX, che riporta le seguenti righe:

Originale

Sub OnAction(control As IRibbonControl, id As String, index As Integer)
If (control.Tag = "large") Then
id = Strings.Mid(id, 3)
End If
Dim form As New ControlInfoForm
form.nameX.Caption = "imageMso: " & id
Set form.Image1.Picture = Application.CommandBars.GetImageMso(id, 16, 16)
Set form.Image2.Picture = Application.CommandBars.GetImageMso(id, 32, 32) form.Show
End Sub

Aggiungendo le righe in rosso:

Modificato

Sub OnAction(control As IRibbonControl, id As String, index As Integer)
If (control.Tag = "large") Then
id = Strings.Mid(id, 3)
End If
Dim form As New ControlInfoForm
form.nameX.Caption = "imageMso: " & id
Set form.Image1.Picture = Application.CommandBars.GetImageMso(id, 16, 16)
Set form.Image2.Picture = Application.CommandBars.GetImageMso(id, 32, 32)
'codice per memorizzare l'id negli appunti di Office
Dim doId As DataObject
Set doId = New DataObject
doId.SetText id
doId.PutInClipboard
form.Show
End Sub

Se adesso provate a scegliere un'icona e, successivamente, aprite un nuovo file di excel o di word o di quello che volete voi, e incollate: ecco apparire l'agognato IdMso:

Direi che per ora può andare, no???

(Lo so, mi diverto con poco! )

Alla prossima

Ciao

Laura

Elenco dei controlli del Ribbon

laura — Sat, 23 Dec 2006 02:13:00 GMT

Nel mio precedente post (Creare comandi personalizzati utilizzando icone di comandi esistenti), ho illustrato come ricavare il nome di un'immagine di un controllo esistente di una applicaizone Office, per poterla utilizzare come immagine di un controllo personalizzato.

Certamente questo sistema risolve il problema ma, a mio avviso, sarebbe molto più comodo avere un bell'elenco di comandi con relativo control ID, o no??? .

E infatti, sono qui per questo: in allegato trovate un file zip con diversi elenchi per le varie applicazioni. Ciascun elenco è costituito da un file di Excel, con filtro sulle colonne, e contiene tutti gli ID dei menù, gruppi di comandi e comandi. Non resta che scaricarlo e divertirsi un pò, magari dopo le feste .

Sperando che possa esservi utile, non mi resta che ringraziare tutti voi per l'accoglienza e l'attenzione e augurarvi un Buon Natale e un Felice Anno Nuovo!

Ciao a tutti

Laura

Ribbon: creare comandi personalizzati utilizzando icone di comandi esistenti

laura — Sun, 10 Dec 2006 18:11:00 GMT

Nel post precedente (Tutorial sulla personalizzazione del Ribbon) abbiamo creato il comando Converti in valori, assegnando come icona quella che che il file Ribbon.XML propone per default: HappyFace

Certo sarebbe più opportuno assegnare un’icona diversa, scegliendone magari una attinente tra quelle assegnate ai comandi dell’applicazione; nel nostro caso, potrebbe essere adeguata quella del comando Incolla Valori.

Ma dove reperire l’identificativo di tali icone?

La risposta è data da l ControlID del comando, che corrisponde anche al nome dell’immagine che utilizza.

Tale ControlID si può rilevare all’interno della finestra Personalizza del menù Home:

Menù Home -> Excel Option -> Customize -> selezionare il gruppo di comandi Home -> spostare il mouse sul comando Incolla Valori e leggere il toolt tip che riporta, nell’ordine:

Il nome del menù in cui si trova il comando: Home
Il nome del gruppo: Clipboard
Il nome del controllo: Paste Values
Il ControlId (nelle parentesi): PasteValues

A questo punto, non ci resta che sostituire questo dato con quello relativo alla faccina che ride nel file di configurazione del Ribbon, e cioè:

imageMso="PasteValues”

al posto di

imageMso=“HappyFace”

Il file Ribbon1.XML verrebbe così modificato:

C# e VB

<tabs>

<tab idMso="TabAddIns"

<group id="MyGroup"

label="My group">

<toggleButton id="toggleButton1"

size="large"

label="My Button"

screentip="My Button Screentip"

onAction="OnToggleButton1"

imageMso="PasteValues" />

</group>

</tab>

</tabs>

</ribbon>

</customUI>

Il risultato è il seguente:

Che ne dite? Interessante, no?

Se volete provare, non dovete fare altro che scaricare le applicazioni di esempio allegate al post precedente e verificare con questa e con altre icone.

Buon lavoro a tutti e a presto

Laura

Tutorial sulla personalizzazione del Ribbon con i VSTO 2005 SE

laura — Wed, 06 Dec 2006 21:28:00 GMT

A proposito di Ribbon , ho preparato un piccolo tutorial sulla creazione di un nuovo menù sfruttando la novità di VSTO 2005 SE per office 2007: usare l'XML per personalizzare il Ribbon.

Nel tutorial troverete i passaggi necessari per lo sviluppo di un COM-AddIn per Excel (in versione C# e in versione Visual Basic), e le due applicazioni pronte e zippate in allegato.

Tutorial: Personalizzare il Ribbon con VSTO 2005 SE

Buon lavoro a tutti e a presto

Laura

Nuova Interfaccia Office 2007

laura — Thu, 23 Nov 2006 02:15:00 GMT

Il nuovo Microsoft Office System 2007 è sicuramente la più importante versione rilasciata da Microsoft dopo il 1995.

Le novità si dividono essenzialmente in due grandi categorie:

Interfaccia utente
Funzionalità

In questo post ci concentreremo sull’interfaccia, che è stata completamente rinnovata.

Il Ribbon

Si tratta della nuova, unica (o quasi!!), barra degli strumenti di Office.

Fino ad oggi la vita dell’utente Office era regolata dai menù e dai sottomenù:

Ogni menù era costituito da voci disposte verticalmente, a ciascuna delle quali corrispondeva un elenco ulteriore o l’apertura di una finestra di dialogo o di creazioni guidate.

Questo tipo di interfaccia aveva i suoi svantaggi, poiché costringeva i poveri utenti ad andare raminghi tra i menù e i sottomenù alla ricerca dello strumento agognato; nella speranza di avere tutto a portata di mano, poi, si vedevano barre degli strumenti aperte a “go-go” sullo schermo, ad occuparne una tale parte, tanto da essere presi in giro da amici e colleghi (perché guardate me? Io ne ho solo una decina tra quelle standard e quelle personalizzate, più due comandi che le chiudono o le riaprono tutte in un solo colpo quando ho bisogno di lavorare sul mio file).

E tutto questo per poi trovarsi di fronte ad una finestra di dialogo (sovrastante parte dell’area di lavoro) nella quale districarsi tra aree e schede, e, dopo aver effettuato scelte di ogni genere, selezionato opzioni, aggiunto check, per concludere in bellezza, accorgersi di aver sbagliato tutto e dover tornare indietro!

E si, era una vita dura (ma qualcuno ci era affezionato!)

E che dire dei Riquadri attività, tanto vituperati oggetti introdotti nella versione 2002?

Tra tutti gli utenti con cui ho interagito, ben pochi erano contenti di questa novità, che pure aveva i suoi pregi: il riquadro attività, infatti, sostituiva spesso finestre di dialogo e creazioni guidate standosene da parte in un angolo e, quando indesiderato, si faceva chiudere senza protestare per poi riapparire in punta di piedi (!).

Ma, con la nuova versione, ahimè, anche il Riquadro attività è scomparso quasi dappertutto (per cortesia, gioite con compostezza ), soppiantato da un diverso modo di intendere i menù: il Ribbon.

Costituito da una grande barra degli strumenti, che si adegua al menù selezionato, il Ribbon costituisce tutto ciò che l’utente di Office ha sempre desiderato:

strumentazione completa a portata di mano raggruppata in blocchi coerenti, senza dover cercare nei meandri dei menù
comandi più grandi, spesso completi di icona e testo (1)
descrizione estesa dei comandi con eventuale accesso diretto alla guida in linea relativa (invece di piccoli tool tip gialli) (2)
eventuale finestra di dialogo (se proprio la volete!), disponibile facendo click su una piccola freccia in basso a destra del gruppo di strumenti (3)

Menù aggiuntivi

Guardando il Ribbon, un osservatore attento potrebbe notare che mancano alcuni menù: dov’è il menù Tabella, oppure tutta la strumentazione relativa alle macro o, ancora, tutta la strumentazione relativa agli oggetti di disegno?

La risposta è la seguente: quando opportuno, appariranno!!

Infatti, se si prova a selezionare una tabella ecco apparire il menù adeguato, suddiviso in due sottomenù con relativi comandi: quasi una magia!

Galleries e Live Preview

Tutti i possibili fonts, gli stili, i tipi di grafico e molto altro ancora, sono disponibili in gruppi denominati Gallery. Passando con il mouse su ciascun elemento della Gallery, l’applicazione visualizza l’anteprima diretta sul testo o sull’oggetto selezionato:

Contextual tab

Quando opportuno, ad esempio selezionando un testo in word, a “portata di mouse” appare una piccola barra semitrasparente con gli strumenti adeguati alle modifiche: basta avvicinare o allontanare il mouse per vederla sparire o riapparire!

Comandi rapidi da tastiera

Per gli amanti della tastiera sono sempre valide le care vecchie combinazioni di tasti di scelta rapida ma, in aggiunta, è adesso possibile premere il tasto Alt per vedere apparire dei quadratini con lettere o numeri su ciascun menù e, successivamente, premendo una lettera corrispondente ad un menù, lettere o numeri corrispondenti ai comandi.

Ad esempio, premendo Tab e poi il tasto N si attiverà il menù Insert con la descrizione di tutti i suoi comandi e, sempre tenendo premuto Tab, si potrà inserire una tabella premendo il tasto T: bello, no?

Al volo

Se siete con il mouse sul Ribbon, muovendo la rotellina passerete da un menù al successivo o al precedente!

Quick Access Toolbar

Ma qualcuno potrebbe lecitamente chiedere: “E la personalizzazione? È possibile creare nuove barre degli strumenti o personalizzarne di esistenti aggiungendo propri comandi o altri comandi di Office?

La risposta è costituita dalla barra di accesso veloce (Quick Access Toolbar), posta al di sopra del Ribbon. Con un click sulla sua piccola freccia è possibile aggiungere comandi come già nelle versioni precedenti, ma non è possibile creare nuove barre personalizzate (Acc!)

Ma per chi non si accontenta di questa risposta (e ha ragione, neanche io mi accontenterei), posso solo rimandare ai prossimi post sulla personalizzazione con i VSTO (Visual Studio Tools for Office). Per ora, si deve pazientare!

A questo punto che altro dire…mi sembra che come panoramica possa bastare e concluderei dicendo che lo spirito della la nuova interfaccia di Office si possa riassumere in una frase:

“non è l’utente che deve andare verso i comandi ma i comandi verso l’utente”

Provare per credere e, per chi non lo avesse ancora sperimentato, può provarlo online all’indirizzo:

http://office.microsoft.com/it-it/products/HA101687261040.aspx

Dopo aver fatto click su Versione di test di Microsoft Office, si dovranno eseguire le seguenti operazioni:

attendere le verifiche del caso e fare click su Continuare
fare click su Registrazione ed effettuare la registrazione al sistema mediante account netPassport o Windows Live ID (in assenza del quale si dovrà effettuare la registrazione da zero)
se tutti i controlli hanno avuto esito positivo, fare click su Avvia versione di test e attendere (pazientemente!) il caricamento

A questo punto si potrà sceglier di aprire una delle applicazioni Office dall’elenco visualizzato sullo schermo.

Allora, “Buon lavoro a tutti!”

A presto

Laura