How to set the desired font to the selected text in textframe?

Question

Hi,
I want to change the font(let's say Times New Roman) of selected text in textframe when I click on  menu-item of my plug-in.
I went through the Adobe Text Engine documentation and  tried some code for setting font but failed. I don't see any member function in IFont class to set desired font, so unable to move forward.
plz see the code. I would like to know one more thing that how can we set a particular font for a textframe?
TextRangesRef rangesRef = NULL;
result = sAIDocument->GetTextSelection(&rangesRef);
aisdk::check_ai_error(result);
ITextRanges ranges(rangesRef);
if (ranges.GetSize() > 0)
     ITextRange range = ranges.Item(0);
     ICharFeatures features = range.GetUniqueLocalCharFeatures();
     IFont  font;                     // I don't see any method to put desired font.
   // features.SetFont(); 
Thanks.
D.A

Answer 1

First, get the font:
AIFontKey fontKey = 0;
AIErr error = sAIFont->FindFont("Times New Roman Regular", kAIAnyFontTechnology, kNativeAIScript, 0, &fontKey);
// do something with error
ATE::FontRef fontRef = 0;
error = sAIFont->FontFromFontKey(fontKey, &fontRef);
// do something with error
ATE::IFont font(fontRef);
Then, apply it like this:
ATE::TextRangeRef textRangeRef = 0;
AIErr error = sAITextFrame->GetATETextRange(handle_to_artwork, &textRangeRef);
// check error
ATE::ITextRange textRange(textRangeRef);
ATE::ICharFeatures charFeatures = textRange.GetUniqueLocalCharFeatures();
charFeatures.SetFont(font);
textRange.ReplaceOrAddLocalCharFeatures(charFeatures);
There are a few other ways to set the text, but you need to understand how character & paragraph styles interact with each other to understand the differneces. This is the most straight forward way to do it though.